Package com.sas.metadata.remote
Interface Tree
- All Superinterfaces:
CMetadata,MdObjectBase,MdObjectBaseUtil,MdObjectBaseXML,PrimaryType,Remote,Root
This type represents a tree that is the root node for a hierarchy of groups of metadata.
Example: create a Tree with name "Tree_Object", in repository "AAAAAAAA".
Attributes of Tree are:
Associations of Tree are:
Usage
To create an instance of this Tree, use thefactory
create methods. Example: create a Tree with name "Tree_Object", in repository "AAAAAAAA".
// create a store to contain your objects for this change. If you do not have an existing object // or store to use. You may obtain the store from another object by using Object.getObjectStore(). MdFactory factory; //where "factory" is a valid MdFactory instance MdObjectStore objectStore = factory.createObjectStore(); Tree myObject = (Tree) factory.createComplexMetadataObject(objectStore, "Tree_Object", MetadataObjects.TREE, "AAAAAAAA"); myObject.updateMetadataAll(); // Write object to server objectStore.dispose(); // dispose of the object store if it is no longer needed
Behavior
- Attributes and associations for this object can be retrieved by using the methods in
MdOMIUtil. - When changes are made to the object, either by setting an attribute or adding objects to a particular association,
they can be persisted to the metadata server with the
updateMetadataAllmethod. - If an object needs to be deleted, the
deletemethod can be used. This will flag the object as being deleted on the client, and will require an update call to persist the change to the server.
Dependencies
This class depends on objects being contained in an MdObjectStore. Object stores should be disposed of when they are no longer needed as this will help clean up memory. Disposing an object store will dispose of all objects contained within that store.- Since:
- 9.0
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringConstant used for the name of the AssociatedIdentity association.static final StringConstant used for the name of the AssociatedPSPortlet association.static final StringConstant used for the name of the Members association.static final StringConstant used for the name of the ParentTree association.static final StringConstant used for the name of the SoftwareComponents association.static final StringConstant used for the name of the SubTrees association.static final StringConstant used for the name of the TreeType attribute.Fields inherited from interface com.sas.metadata.remote.MdObjectBase
ATTRIBUTE_DESC_NAME, ATTRIBUTE_ID_NAME, ATTRIBUTE_METADATACREATED_NAME, ATTRIBUTE_METADATAUPDATED_NAME, ATTRIBUTE_NAME_NAMEFields inherited from interface com.sas.metadata.remote.PrimaryType
ASSOCIATION_FAVORITESCONTAINERS_NAME, ATTRIBUTE_ISHIDDEN_NAME, ATTRIBUTE_PUBLICTYPE_NAMEFields inherited from interface com.sas.metadata.remote.Root
ASSOCIATION_ACCESSCONTROLS_NAME, ASSOCIATION_CHANGES_NAME, ASSOCIATION_CUSTOMASSOCIATIONS_NAME, ASSOCIATION_DOCUMENTS_NAME, ASSOCIATION_EXTENSIONS_NAME, ASSOCIATION_EXTERNALIDENTITIES_NAME, ASSOCIATION_GROUPS_NAME, ASSOCIATION_IMPLEMENTORS_NAME, ASSOCIATION_KEYWORDS_NAME, ASSOCIATION_LOCALIZEDATTRIBUTES_NAME, ASSOCIATION_NOTES_NAME, ASSOCIATION_PRIMARYPROPERTYGROUP_NAME, ASSOCIATION_PROMPTS_NAME, ASSOCIATION_PROPERTIES_NAME, ASSOCIATION_PROPERTYSETS_NAME, ASSOCIATION_REFERENCEDOBJECTS_NAME, ASSOCIATION_RESPONSIBLEPARTIES_NAME, ASSOCIATION_SOURCETRANSFORMATIONS_NAME, ASSOCIATION_SPECSOURCETRANSFORMATIONS_NAME, ASSOCIATION_SPECTARGETTRANSFORMATIONS_NAME, ASSOCIATION_TARGETTRANSFORMATIONS_NAME, ASSOCIATION_TIMESTAMPS_NAME, ASSOCIATION_TREES_NAME, ASSOCIATION_TSOBJECTNAMESPACE_NAME, ASSOCIATION_USEDBYPROTOTYPES_NAME, ASSOCIATION_USINGPROTOTYPE_NAME, ASSOCIATION_VARIABLES_NAME, ATTRIBUTE_CHANGESTATE_NAME, ATTRIBUTE_LOCKEDBY_NAME, ATTRIBUTE_USAGEVERSION_NAME -
Method Summary
Modifier and TypeMethodDescriptionGets theIdentityforAssociatedIdentityGets the AssociationList ofAssociatedIdentitysgetAssociatedIdentitys(boolean fGoToServer) Gets the Associationlist ofAssociatedIdentitysGets thePSPortletforAssociatedPSPortletGets the AssociationList ofAssociatedPSPortletsgetAssociatedPSPortlets(boolean fGoToServer) Gets the Associationlist ofAssociatedPSPortletsGets the AssociationList ofMembersgetMembers(boolean fGoToServer) Gets the Associationlist ofMembersGets theTreeforParentTreeGets the AssociationList ofParentTreesgetParentTrees(boolean fGoToServer) Gets the Associationlist ofParentTreesGets the Association list ofSoftwareComponentsgetSoftwareComponents(boolean fGoToServer) Gets the Associationlist ofSoftwareComponentsGets the Association list ofSubTreesgetSubTrees(boolean fGoToServer) Gets the Associationlist ofSubTreesStringGets theStringvalue ofTreeTypeintGets the maximum length ofTreeTypeintGets the Metadata State ofTreeTypevoid(S) Adds the Associated objects to the predObjects which are:
AssociatedIdentity
AssociatedPSPortlet
Members
ParentTreevoid(S) This initializes the Required Objects(Roles) which are:voidsetAssociatedIdentity(Identity inObject) Sets theAssociatedIdentityslist 0th element to beinObject.voidSets theAssociatedIdentityslist to belist.voidsetAssociatedIdentitys(AssociationList list, int state) Sets theAssociatedIdentityslist to belist.voidsetAssociatedPSPortlet(PSPortlet inObject) Sets theAssociatedPSPortletslist 0th element to beinObject.voidSets theAssociatedPSPortletslist to belist.voidsetAssociatedPSPortlets(AssociationList list, int state) Sets theAssociatedPSPortletslist to belist.voidsetMembers(AssociationList list) Sets theMemberslist to belist.voidsetMembers(AssociationList inObjects, int state) Sets the entire AssociationList to match the passed in Vector, sets the state of the AssociationListvoidsetParentTree(Tree inObject) Sets theParentTreeslist 0th element to beinObject.voidSets theParentTreeslist to belist.voidsetParentTrees(AssociationList list, int state) Sets theParentTreeslist to belist.voidSets theSoftwareComponentslist to belist.voidsetSoftwareComponents(AssociationList inObjects, int state) Sets the entire SoftwareComponents list to match the passed in AssociationList, sets the state of the SoftwareComponentsvoidsetSubTrees(AssociationList list) Sets theSubTreeslist to belist.voidsetSubTrees(AssociationList inObjects, int state) Sets the entire SubTrees list to match the passed in AssociationList, sets the state of the SubTreesvoidsetTreeType(String inTreeType) Sets theTreeTypevalue and sets the state to MetadataState.LOCAL.voidsetTreeType(String inTreeType, int state) Sets theTreeTypeMetadata State.voidsetTreeTypeState(int state) Sets the Metadata State ofTreeType.Methods inherited from interface com.sas.metadata.remote.MdObjectBase
addElementToChangeList, clearChangeList, getChangeList, getCMetadataType, getDesc, getDescMaxLength, getDescState, getFQID, getId, getIdState, getMetadataCreated, getMetadataCreatedState, getMetadataUpdated, getMetadataUpdatedState, getName, getNameMaxLength, getNameState, getObjectStore, getPredAssociations, getRepositoryID, getRequiredAssociations, getState, isAssociationRequired, isNewObject, isPredAssociation, removeElementFromChangeList, resetObject, resetState, resetStates, setCMetadataType, setDesc, setDesc, setDescState, setFQID, setFQID, setId, setId, setIdState, setMetadataCreated, setMetadataCreated, setMetadataCreatedState, setMetadataUpdated, setMetadataUpdated, setMetadataUpdatedState, setName, setName, setNameState, setObjectStore, setStateMethods inherited from interface com.sas.metadata.remote.MdObjectBaseUtil
addMdObjectListener, delete, dispose, fireMdObjectModified, getAssociatedObjects, getAssociatedObjects, getAssociatedObjects, getAssociationNames, getAssocs, getAssocsWA, getAttributeNames, getAttrs, getAttrsStates, getAuthorizationUtil, getChangeManagementState, getChgMgtExternalIdentityImportType, getClientSideOnlyObject, getMdObjectAssociation, getPopulatedAssocs, getUpdatedAttrs, getViewList, isCheckedOut, isLocked, objectModified, removeMdObjectListener, setAttrs, setChangeManagementTargetRepository, setChgMgtExternalIdentityImportType, setClientSideOnlyObject, setMdObjectAssociation, touch, updateAssnsIdsMethods inherited from interface com.sas.metadata.remote.MdObjectBaseXML
closeUpdateMetadataXML, createEmptyXML, createObjectRefreshXML, createObjectXML, createObjectXML, createUpdateAssociationXML, createUpdateAssociationXML, createUpdateSimpleXML, doCreateUpdateXML, getUpdateSimpleSubstring, updateMetadataAllMethods inherited from interface com.sas.metadata.remote.PrimaryType
getFavoritesContainers, getFavoritesContainers, getIsHidden, getIsHiddenState, getPublicType, getPublicTypeMaxLength, getPublicTypeState, setFavoritesContainers, setFavoritesContainers, setIsHidden, setIsHidden, setIsHidden, setIsHidden, setIsHiddenState, setPublicType, setPublicType, setPublicTypeStateMethods inherited from interface com.sas.metadata.remote.Root
getAccessControls, getAccessControls, getChanges, getChanges, getChangeState, getChangeStateMaxLength, getChangeStateState, getCustomAssociations, getCustomAssociations, getDocuments, getDocuments, getExtensions, getExtensions, getExternalIdentities, getExternalIdentities, getGroups, getGroups, getImplementors, getImplementors, getKeywords, getKeywords, getLocalizedAttributes, getLocalizedAttributes, getLockedBy, getLockedByMaxLength, getLockedByState, getNotes, getNotes, getPrimaryPropertyGroup, getPrimaryPropertyGroups, getPrimaryPropertyGroups, getPrompts, getPrompts, getProperties, getProperties, getPropertySets, getPropertySets, getReferencedObjects, getReferencedObjects, getResponsibleParties, getResponsibleParties, getSourceTransformations, getSourceTransformations, getSpecSourceTransformations, getSpecSourceTransformations, getSpecTargetTransformations, getSpecTargetTransformations, getTargetTransformations, getTargetTransformations, getTimestamps, getTimestamps, getTrees, getTrees, getTSObjectNamespace, getTSObjectNamespaces, getTSObjectNamespaces, getUsageVersion, getUsageVersionState, getUsedByPrototypes, getUsedByPrototypes, getUsingPrototype, getUsingPrototypes, getUsingPrototypes, getVariables, getVariables, setAccessControls, setAccessControls, setChanges, setChanges, setChangeState, setChangeState, setChangeStateState, setCustomAssociations, setCustomAssociations, setDocuments, setDocuments, setExtensions, setExtensions, setExternalIdentities, setExternalIdentities, setGroups, setGroups, setImplementors, setImplementors, setKeywords, setKeywords, setLocalizedAttributes, setLocalizedAttributes, setLockedBy, setLockedBy, setLockedByState, setNotes, setNotes, setPrimaryPropertyGroup, setPrimaryPropertyGroups, setPrimaryPropertyGroups, setPrompts, setPrompts, setProperties, setProperties, setPropertySets, setPropertySets, setReferencedObjects, setReferencedObjects, setResponsibleParties, setResponsibleParties, setSourceTransformations, setSourceTransformations, setSpecSourceTransformations, setSpecSourceTransformations, setSpecTargetTransformations, setSpecTargetTransformations, setTargetTransformations, setTargetTransformations, setTimestamps, setTimestamps, setTrees, setTrees, setTSObjectNamespace, setTSObjectNamespaces, setTSObjectNamespaces, setUsageVersion, setUsageVersion, setUsageVersion, setUsageVersion, setUsageVersionState, setUsedByPrototypes, setUsedByPrototypes, setUsingPrototype, setUsingPrototypes, setUsingPrototypes, setVariables, setVariables
-
Field Details
-
ATTRIBUTE_TREETYPE_NAME
static final String ATTRIBUTE_TREETYPE_NAMEConstant used for the name of the TreeType attribute.TreeType: This attribute allows applications to store information about what the intended use of this tree is.
- See Also:
-
ASSOCIATION_ASSOCIATEDIDENTITY_NAME
static final String ASSOCIATION_ASSOCIATEDIDENTITY_NAMEConstant used for the name of the AssociatedIdentity association.AssociatedIdentity: The identity associated with this home folder.
- See Also:
-
ASSOCIATION_ASSOCIATEDPSPORTLET_NAME
static final String ASSOCIATION_ASSOCIATEDPSPORTLET_NAMEConstant used for the name of the AssociatedPSPortlet association.AssociatedPSPortlet: The object for which this tree contains hierarchical information.
- See Also:
-
ASSOCIATION_MEMBERS_NAME
static final String ASSOCIATION_MEMBERS_NAMEConstant used for the name of the Members association.Members: The members of this tree.
- See Also:
-
ASSOCIATION_PARENTTREE_NAME
static final String ASSOCIATION_PARENTTREE_NAMEConstant used for the name of the ParentTree association.ParentTree: The parent of this tree.
- See Also:
-
ASSOCIATION_SOFTWARECOMPONENTS_NAME
static final String ASSOCIATION_SOFTWARECOMPONENTS_NAMEConstant used for the name of the SoftwareComponents association.SoftwareComponents: *Unknown*
- See Also:
-
ASSOCIATION_SUBTREES_NAME
static final String ASSOCIATION_SUBTREES_NAMEConstant used for the name of the SubTrees association.SubTrees: *Unknown*
- See Also:
-
-
Method Details
-
initializeRequiredObjects
void initializeRequiredObjects() throws RemoteException(S) This initializes the Required Objects(Roles) which are:- Specified by:
initializeRequiredObjectsin interfaceMdObjectBaseUtil- Specified by:
initializeRequiredObjectsin interfacePrimaryType- Specified by:
initializeRequiredObjectsin interfaceRoot- Throws:
RemoteException- If error connecting/communicating to/with remote object.
-
initializePredObjects
void initializePredObjects() throws RemoteException(S) Adds the Associated objects to the predObjects which are:
AssociatedIdentity
AssociatedPSPortlet
Members
ParentTree- Specified by:
initializePredObjectsin interfaceMdObjectBase- Specified by:
initializePredObjectsin interfacePrimaryType- Specified by:
initializePredObjectsin interfaceRoot- Throws:
RemoteException- If error connecting/communicating to/with remote object.
-
getTreeType
String getTreeType() throws RemoteExceptionGets theStringvalue ofTreeType- Returns:
- The
TreeType - Throws:
RemoteException- If error connecting/communicating to/with remote object.
-
getTreeTypeState
int getTreeTypeState() throws RemoteExceptionGets the Metadata State ofTreeType- Returns:
- The State.
- Throws:
RemoteException- If error connecting/communicating to/with remote object.
-
getTreeTypeMaxLength
int getTreeTypeMaxLength() throws RemoteExceptionGets the maximum length ofTreeType- Returns:
- The max size
- Throws:
RemoteException- If error connecting/communicating to/with remote object.
-
getAssociatedIdentitys
Gets the AssociationList ofAssociatedIdentitys- Returns:
- Returns the AssociationList of
AssociatedIdentityswhich can be of type:
Identity
IdentityGroup
Person - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException
-
getAssociatedIdentity
Gets theIdentityforAssociatedIdentity- Returns:
- The
Identity(nullif not set) ofAssociatedIdentitywhich can be of type:
Identity
IdentityGroup
Person - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getAssociatedPSPortlets
Gets the AssociationList ofAssociatedPSPortlets- Returns:
- Returns the AssociationList of
AssociatedPSPortletswhich can be of type:
PSPortlet - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException
-
getAssociatedPSPortlet
Gets thePSPortletforAssociatedPSPortlet- Returns:
- The
PSPortlet(nullif not set) ofAssociatedPSPortletwhich can be of type:
PSPortlet - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getMembers
Gets the AssociationList ofMembers- Returns:
- Returns the AssociationList of
Memberswhich can be of type:
All types - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getParentTrees
Gets the AssociationList ofParentTrees- Returns:
- Returns the AssociationList of
ParentTreeswhich can be of type:
Tree - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException
-
getParentTree
Gets theTreeforParentTree- Returns:
- The
Tree(nullif not set) ofParentTreewhich can be of type:
Tree - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getSoftwareComponents
Gets the Association list ofSoftwareComponents- Returns:
- The AssociationList of
SoftwareComponentswhich can be of type:
SoftwareComponent
DeployedComponent
ConfiguredComponent
ServiceComponent
ServerComponent
LogicalServer
ServerContext - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getSubTrees
Gets the Association list ofSubTrees- Returns:
- The AssociationList of
SubTreeswhich can be of type:
Tree - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getAssociatedIdentitys
Gets the Associationlist ofAssociatedIdentitys- Parameters:
fGoToServer- boolean Get the value from the server.- Returns:
- Returns the AssociationList of
AssociatedIdentityswhich can be of type:
Identity
IdentityGroup
Person - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getAssociatedPSPortlets
Gets the Associationlist ofAssociatedPSPortlets- Parameters:
fGoToServer- boolean Get the value from the server.- Returns:
- Returns the AssociationList of
AssociatedPSPortletswhich can be of type:
PSPortlet - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getMembers
Gets the Associationlist ofMembers- Parameters:
fGoToServer- boolean Get the value from the server.- Returns:
- Returns the AssociationList of
Memberswhich can be of type:
All types - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getParentTrees
Gets the Associationlist ofParentTrees- Parameters:
fGoToServer- boolean Get the value from the server.- Returns:
- Returns the AssociationList of
ParentTreeswhich can be of type:
Tree - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getSoftwareComponents
Gets the Associationlist ofSoftwareComponents- Parameters:
fGoToServer- boolean Get the value from the server.- Returns:
- Returns the
SoftwareComponentswhich can be of type:
SoftwareComponent
DeployedComponent
ConfiguredComponent
ServiceComponent
ServerComponent
LogicalServer
ServerContext - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
getSubTrees
Gets the Associationlist ofSubTrees- Parameters:
fGoToServer- boolean Get the value from the server.- Returns:
- Returns the
SubTreeswhich can be of type:
Tree - Throws:
RemoteException- If error connecting/communicating to/with remote object.MdException- If error getting/setting part of the object.
-
setTreeType
void setTreeType(String inTreeType) throws RemoteException Sets theTreeTypevalue and sets the state to MetadataState.LOCAL.- Parameters:
inTreeType- String- Throws:
RemoteException- If error communicating with remote object.
-
setTreeType
void setTreeType(String inTreeType, int state) throws RemoteException Sets theTreeTypeMetadata State.- Parameters:
inTreeType- Stringstate- int- Throws:
RemoteException- If error communicating with remote object.
-
setTreeTypeState
void setTreeTypeState(int state) throws RemoteException Sets the Metadata State ofTreeType.- Parameters:
state- int- Throws:
RemoteException- If error communicating with remote object.
-
setAssociatedIdentitys
Sets theAssociatedIdentityslist to belist. Object of which can be of type:
Identity
IdentityGroup
Person- Parameters:
list- AssociationList- Throws:
RemoteException- If error communicating with remote object.
-
setAssociatedIdentitys
Sets theAssociatedIdentityslist to belist. Object of which can be of type:
Identity
IdentityGroup
Person- Parameters:
list- AssociationListstate- int- Throws:
RemoteException- If error communicating with remote object.
-
setAssociatedIdentity
Sets theAssociatedIdentityslist 0th element to beinObject.- Parameters:
inObject- Identity- Throws:
RemoteException- If error communicating with remote object.
-
setAssociatedPSPortlets
- Parameters:
list- AssociationList- Throws:
RemoteException- If error communicating with remote object.
-
setAssociatedPSPortlets
- Parameters:
list- AssociationListstate- int- Throws:
RemoteException- If error communicating with remote object.
-
setAssociatedPSPortlet
Sets theAssociatedPSPortletslist 0th element to beinObject.- Parameters:
inObject- PSPortlet- Throws:
RemoteException- If error communicating with remote object.
-
setMembers
Sets theMemberslist to belist. Objects of which can be of type:
All types- Parameters:
list- AssociationList- Throws:
RemoteException- If error communicating with remote object.
-
setMembers
Sets the entire AssociationList to match the passed in Vector, sets the state of the AssociationList- Parameters:
inObjects- AssociationListstate- int- Throws:
RemoteException- If error communicating with remote object.
-
setParentTrees
- Parameters:
list- AssociationList- Throws:
RemoteException- If error communicating with remote object.
-
setParentTrees
- Parameters:
list- AssociationListstate- int- Throws:
RemoteException- If error communicating with remote object.
-
setParentTree
Sets theParentTreeslist 0th element to beinObject.- Parameters:
inObject- Tree- Throws:
RemoteException- If error communicating with remote object.
-
setSoftwareComponents
Sets theSoftwareComponentslist to belist. Objects of which can be of type:
SoftwareComponent
DeployedComponent
ConfiguredComponent
ServiceComponent
ServerComponent
LogicalServer
ServerContext- Parameters:
list- AssociationList- Throws:
RemoteException- If error communicating with remote object.
-
setSoftwareComponents
Sets the entire SoftwareComponents list to match the passed in AssociationList, sets the state of the SoftwareComponents- Parameters:
inObjects- AssociationListstate- int- Throws:
RemoteException- If error communicating with remote object.
-
setSubTrees
- Parameters:
list- AssociationList- Throws:
RemoteException- If error communicating with remote object.
-
setSubTrees
Sets the entire SubTrees list to match the passed in AssociationList, sets the state of the SubTrees- Parameters:
inObjects- AssociationListstate- int- Throws:
RemoteException- If error communicating with remote object.
-