oracle.ifs.beans

Class CompositeGroup

java.lang.Object

oracle.ifs.beans.LibraryObject

oracle.ifs.beans.TieLibraryObject

oracle.ifs.beans.PublicObject

oracle.ifs.beans.TiePublicObject

oracle.ifs.beans.DirectoryObject

oracle.ifs.beans.TieDirectoryObject

oracle.ifs.beans.DirectoryGroup

oracle.ifs.beans.TieDirectoryGroup

oracle.ifs.beans.CompositeGroup

All Implemented Interfaces:

Comparable, DirectoryObjectInterface, IfsEventHandler, LibraryObjectInterface, LooselyBoundedCacheable, PublicObjectInterface, Traceable

Direct Known Subclasses:

TieCompositeGroup

public class CompositeGroup
extends TieDirectoryGroup

A CompositeGroup is used to represent an encapsulation of a fixed number of DirectoryGroups, usually of a specific subclass.

Author:

Dave Long

(Published)

Field Summary

Fields

Modifier and Type	Field and Description
static String	CLASS_NAME The name of the ClassObject representing this class.
static String	MEMBERSHIPCOUNT_ATTRIBUTE The name of the attribute for the number of group members that comprise the composite.
static String	MEMBERSHIPKEY_ATTRIBUTE The name of the attribute for the key that identifies the distinct membership.

Fields inherited from class oracle.ifs.beans.DirectoryGroup

CONTENTQUOTA_ATTRIBUTE, GROUP_CLASS_DOMAIN_NAME, OWNERUNIQUENAME_ATTRIBUTE, WORLDGROUP_ID

Fields inherited from class oracle.ifs.beans.DirectoryObject

CREDENTIALMANAGER_ATTRIBUTE, DISTINGUISHEDNAME_ATTRIBUTE

Fields inherited from class oracle.ifs.beans.PublicObject

ACL_ATTRIBUTE, CREATEDATE_ATTRIBUTE, CREATOR_ATTRIBUTE, DELETOR_ATTRIBUTE, DESCRIPTION_ATTRIBUTE, EXPIRATIONDATE_ATTRIBUTE, FAMILY_ATTRIBUTE, FLAG_CATEGORY_EXISTS, FLAG_CONFIGURATIONCATEGORY_EXISTS, FLAG_MARKED, FLAG_NOINFERIOR, FLAG_NOSELECT, FLAG_NTFS_ARCHIVE, FLAG_NTFS_HIDDEN, FLAG_NTFS_READONLY, FLAG_NTFS_SYSTEM, FLAG_UNMARKED, FLAGS_ATTRIBUTE, LASTMODIFIER_ATTRIBUTE, LASTMODIFYDATE_ATTRIBUTE, LOCKENTRIES_ATTRIBUTE, LOCKOBJECT_ATTRIBUTE, NAME_ATTRIBUTE, OWNER_ATTRIBUTE, POLICYBUNDLE_ATTRIBUTE, POLICYLISTS_ATTRIBUTE, PRIMARYPARENTFOLDER_ATTRIBUTE, PROPERTYBUNDLE_ATTRIBUTE, RESOLVEDPUBLICOBJECT_ATTRIBUTE, SECURINGPUBLICOBJECT_ATTRIBUTE

Fields inherited from class oracle.ifs.beans.LibraryObject

DOMAIN_UNIQUENAME_DEFAULT_DELIMITER, m_ClassId, m_Id, m_Session

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CompositeGroup(LibrarySession session, Long id, Long classId, S_LibraryObjectData data) Construct a CompositeGroup object.

Method Summary

Modifier and Type	Method and Description
static CompositeGroup	findCompositeGroup(LibrarySession session, List<DirectoryGroup> members) Finds CompositeGroup that contains exactly the membership specified.
static CompositeGroup	findCompositeGroup(LibrarySession session, List<DirectoryGroup> members, CompositeGroupDefinition def) Finds CompositeGroup that contains exactly the membership specified.
static CompositeGroup	findOrCreateCompositeGroup(LibrarySession session, List<DirectoryGroup> members) Find or create a CompositeGroup that contains exactly the membership specified.
static CompositeGroup	findOrCreateCompositeGroup(LibrarySession session, List<DirectoryGroup> members, CompositeGroupDefinition def) Find or create a CompositeGroup that contains exactly the membership specified.
int	getMembershipCount() Returns the number of group members that comprise the composite.
long	getMembershipKey() Returns the key that identifies the distinct membership.
protected void	preCreate(LibraryObjectDefinition lodef) Extensibility point to perform actions prior to the creation of a PublicObject.
protected void	validateCompositeGroupMembers(DirectoryGroup[] mems) Validate the membership.
protected boolean	verifyMatchingMembership(DirectoryGroup[] mems) Verify that the specified membership matches the membership of this instance.

Methods inherited from class oracle.ifs.beans.DirectoryGroup

addMember, addMembers, auditUpdated, capabilities, constructDirectoryGroup, constructDirectoryGroupArray, constructDirectoryGroupVector, getAllMemberIds, getAllMembers, getAllMembers, getAllUserMembers, getAllUserMembers, getContentQuota, getDirectMemberIds, getDirectMembers, getDirectMembers, getWorldDirectoryGroup, isDirectMember, isMember, isValidEventType, isWorldGroup, postCreate, preFree, removeMember, removeMembers, reportGroupCreated, reportGroupFreed, reportGroupMembershipChanges, resetDirectMembers, setContentQuota, vectorDirectoryGroupElement, vectorToDirectoryGroupArray, verifyAddMemberCapability, verifyRemoveMemberCapability

Methods inherited from class oracle.ifs.beans.DirectoryObject

constructDirectoryObject, constructDirectoryObjectArray, constructDirectoryObjectVector, getAllAncestorIds, getAllAncestors, getAllAncestors, getCredentialManager, getDirectAncestors, getDirectAncestors, getDistinguishedName, isMemberOf, resetAllAncestors, resetDirectAncestors, setCredentialManager, setDistinguishedName, vectorDirectoryObjectElement, vectorToDirectoryObjectArray

Methods inherited from class oracle.ifs.beans.PublicObject

addAccess, addAttachment, addCategory, addFlags, addMessageList, addRelationship, auditPublicObjectLocked, auditPublicObjectUnlocked, canAcquireManualLock, canReleaseDavLock, canReleaseLock, canReleaseManualLock, checkAuditViewCapability, checkCapabilities, checkCapability, checkEffectiveAccess, checkEffectiveAccess, checkLockAccess, checkParentFolderCapability, checkVersioned, clearFlags, constructPublicObject, constructPublicObjectArray, constructPublicObjectVector, containsLockEntry, copy, coreAutoFolderingEnabled, createCategories, createDedicatedPolicyPropertyBundle, delete, deriveEffectiveAccessLevel, findAttachmentRelation, findOrAddActivityRecord, findOrAddActivityRecord, findOrAddActor, findOrAddActor, findOrAddMessageList, findOrAddMessageList, free, getAcl, getActivityRecord, getActor, getAllFolderPaths, getAllFolderPaths, getAllFolderPaths, getAnyFolderPath, getAnyFolderPath, getAnyFolderPath, getAttachmentRelation, getAttachmentRelations, getAttachments, getCapabilities, getCategories, getCategories, getCategories, getCategories, getCategories, getCategory, getConsumedStorage, getCreateDate, getCreator, getDefaultAccessLevel, getDefinitionForSimplePropertyUpdates, getDeletor, getDescription, getEffectiveAccessLevel, getEffectiveAccessLevel, getExpirationDate, getFamily, getFirstCategory, getFirstVersion, getFlags, getFolderReferences, getFolderReferences, getFolderReferencesSortSpecification, getLastModifier, getLastModifyDate, getLastVersion, getLeftwardRelationshipObjects, getLeftwardRelationshipObjects, getLeftwardRelationships, getLeftwardRelationships, getLeftwardRelationshipsCount, getLeftwardRelationshipsCount, getLinks, getLockEntries, getLockEntries, getLockObject, getLockRestrictions, getLockTypeAuditProperties, getMessageList, getNextVersion, getOwner, getPolicyBundle, getPolicyLists, getPreviousVersion, getPrimaryFolderPath, getPrimaryParentFolder, getPrimaryParentFolder, getRelations, getReservationComment, getReservationDate, getReservor, getResolvedPublicObject, getRestrictingLockEntries, getRightwardRelationshipObjects, getRightwardRelationshipObjects, getRightwardRelationships, getRightwardRelationships, getSecuringPublicObject, getSingletonVersionDescription, getVersionNumber, getVersions, getVersionSeries, getWorkingCopy, grantAccess, handleCopy, handleCreate, handleUnlockAll, hasActivityRecord, hasActor, hasAttachmentRelation, hasCategories, hasCategory, hasConfigurationCategories, hasMessageList, hasNameAttribute, hasPropertyBundleAttribute, isAttachment, isDeleted, isLatestVersion, isLocked, isLockingSupported, isOwner, isReserved, isReservedByCurrentUser, isVersionable, isVersioned, isWorkingCopy, listLeftwardRelationships, listRightwardRelationships, lock, lock, lock, lock, newVersion, postCopy, postSecurityChangedEvent, postUpdate, preCopy, preUpdate, putPolicy, reassociateLinks, removeAllPolicies, removeAttachment, removePolicy, removePolicy, removeRelationship, reserveNext, resetFolderReferences, resolveFolderReferenceSortSpecification, revokeAccess, revokeAllAccess, setAcl, setDescription, setExpirationDate, setFlags, setFolderReferencesSortSpecification, setLockEntries, setLockEntrySecurity, setOwner, setOwnerByName, setPolicyBundle, setPolicyLists, setSecuringPublicObject, toPublicObjectArray, undelete, unlock, unlock, unlockAll, unReserve, updateFlags, updateLock, vectorPublicObjectElement, vectorToPublicObjectArray, verifyAddRelationshipCapability, verifyCapabilities, verifyCapability, verifyDeleteCapability, verifyLockCapability, verifyRemoveRelationshipCapability, verifyUnlockCapability, verifyVersionSeries

Methods inherited from class oracle.ifs.beans.LibraryObject

added, addSimpleProperty, addSimpleProperty, applyProperties, auditCreated, canPurge, checkIfPropertyBundleSupported, checkRequiredAttributeSet, clearCopyContext, clearFreeContext, clearUpdateContext, compareTo, constructIdArray, constructIdArray, constructLibraryObject, constructLibraryObjectVector, createDedicatedPropertyBundle, createInstance, deriveDomainUniqueName, dispose, equals, equals, free, freeAll, get, getAttribute, getAttributeByUpperCaseName, getAttributes, getAttributesByUpperCaseNames, getAuditDomainContext, getAuditEventFolderContext, getClassId, getClassname, getClassName, getClassObject, getCommonName, getCommonNameAndClass, getCopyContext, getCreateContext, getData, getDefinition, getEffectivePolicyListElements, getEventualAttributeByUpperCaseName, getFreeContext, getId, getLabel, getName, getObjectReferenceAttribute, getOperationActionSpecificationContext, getPropertyBundle, getPropertyValue, getPublicObjectAttribute, getResourceString, getResourceString, getSchemaObjectAttribute, getSession, getSessionInterface, getSharedStateFactory, getSimpleObjectAttribute, getSimpleProperties, getSimpleProperty, getSimplePropertyValue, getStringIdentifier, getSystemObjectAttribute, getTraceLogger, getUpdateContext, handleAdminModeChange, handleEvent, handleFree, handleUpdate, hashCode, invalidateState, invokeOperation, invokeOperation, invokeServerMethod, isConnected, isCoreEventPostingEnabled, isInstanceOf, isPersistent, isTraced, lockRows, lookupInstanceLabel, performPostCreateExtensions, performPostFreeExtensions, performPostUpdateExtensions, performPreCreateExtensions, performPreFreeExtensions, performPreUpdateExtensions, postEvent, postEvent, postFree, prePostAuditEvent, putProperty, putProperty, removeAllProperties, removeAllSimpleProperties, removeAllSimpleProperties, removed, removeProperty, removeSimpleProperty, removeSimpleProperty, renderAsRandomAccessContent, renderAsReader, renderAsStream, setAttribute, setAttribute, setAttributes, setAttributes, setCopyContext, setFreeContext, setId, setName, setPropertyBundle, setPropertyValue, setUpdateContext, toString, trace, trustHandleCreate, trustHandleCreateAsAdmin, trustHandleFree, trustHandleFreeAsAdmin, trustHandleUpdate, trustHandleUpdateAsAdmin, update, updateAndExposeDefinition, validatePropertyValues, vectorLibraryObjectElement, vectorToLibraryObjectArray, verifyAdministrationMode, verifyConnected, verifyPersistent, verifySystemUserAccess, verifyTargetObject

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface oracle.ifs.common.LibraryObjectInterface

getAttributeByUpperCaseName, getClassId, getId, getSessionInterface

Methods inherited from interface oracle.ifs.common.Traceable

getTraceLogger, isTraced, trace

Field Detail

CLASS_NAME

public static final String CLASS_NAME

The name of the ClassObject representing this class.

See Also:

Constant Field Values

(Published)

MEMBERSHIPCOUNT_ATTRIBUTE

public static final String MEMBERSHIPCOUNT_ATTRIBUTE

The name of the attribute for the number of group members that comprise the composite.

See Also:

Constant Field Values

(Published)

MEMBERSHIPKEY_ATTRIBUTE

public static final String MEMBERSHIPKEY_ATTRIBUTE

The name of the attribute for the key that identifies the distinct membership.

See Also:

Constant Field Values

(Published)

Constructor Detail

CompositeGroup

protected CompositeGroup(LibrarySession session,
                         Long id,
                         Long classId,
                         S_LibraryObjectData data)
                  throws IfsException

Construct a CompositeGroup object.

Parameters:

session - current LibrarySession

id - object id

classId - class id

data - data component

Throws:

IfsException - if the operation fails

(Unpublished)

Method Detail

getMembershipCount

public int getMembershipCount()
                       throws IfsException

Returns the number of group members that comprise the composite.

Returns:

the number of group members that comprise the composite

Throws:

IfsException - if operation fails.

(Published)

getMembershipKey

public long getMembershipKey()
                      throws IfsException

Returns the key that identifies the distinct membership.

Returns:

the key that identifies the distinct membership

Throws:

IfsException - if operation fails.

(Published)

preCreate

protected void preCreate(LibraryObjectDefinition lodef)
                  throws IfsException

Extensibility point to perform actions prior to the creation of a PublicObject.

Set an option that indicates that Categories are NOT to be created from within S_PublicObject.

Overrides:

preCreate in class PublicObject

Parameters:

lodef - object definition that will be used to create the object

Throws:

IfsException - if the operation fails

validateCompositeGroupMembers

protected void validateCompositeGroupMembers(DirectoryGroup[] mems)
                                      throws IfsException

Validate the membership.

Parameters:

session - the session context

members - the direct members for the composite group

Throws:

IfsException - if operation fails.

(Published)

findCompositeGroup

public static CompositeGroup findCompositeGroup(LibrarySession session,
                                                List<DirectoryGroup> members)
                                         throws IfsException

Finds CompositeGroup that contains exactly the membership specified.

Parameters:

session - the session context

members - the direct members for the composite group

Returns:

the CompositeGroup that matches the specifications or null if one is not found

Throws:

IfsException - if operation fails.

(Published)

findCompositeGroup

public static CompositeGroup findCompositeGroup(LibrarySession session,
                                                List<DirectoryGroup> members,
                                                CompositeGroupDefinition def)
                                         throws IfsException

Finds CompositeGroup that contains exactly the membership specified.

Parameters:

session - the session context

members - the direct members for the composite group

def - the definition that identifies the type of CompositeGroup that is being sought

Returns:

the CompositeGroup that matches the specifications or null if one is not found

Throws:

IfsException - if operation fails.

(Published)

findOrCreateCompositeGroup

public static CompositeGroup findOrCreateCompositeGroup(LibrarySession session,
                                                        List<DirectoryGroup> members)
                                                 throws IfsException

Find or create a CompositeGroup that contains exactly the membership specified.

Parameters:

session - the session context

members - the direct members for the composite group

Returns:

the CompositeGroup that matches the specifications

Throws:

IfsException - if operation fails.

(Published)

findOrCreateCompositeGroup

public static CompositeGroup findOrCreateCompositeGroup(LibrarySession session,
                                                        List<DirectoryGroup> members,
                                                        CompositeGroupDefinition def)
                                                 throws IfsException

Find or create a CompositeGroup that contains exactly the membership specified.

Parameters:

session - the session context

members - the direct members for the composite group

def - the definition to use to create a new instance, if one cannot be found

Returns:

the CompositeGroup that matches the specifications

Throws:

IfsException - if operation fails.

(Published)

verifyMatchingMembership

protected boolean verifyMatchingMembership(DirectoryGroup[] mems)
                                    throws IfsException

Verify that the specified membership matches the membership of this instance.

Parameters:

members - the expected sorted membership

Returns:

true if the target instance refelcts the membership; false otherwise

Throws:

IfsException - if operation fails