Interface HierarchyProxyManager

All Superinterfaces:

AutoCloseable, Closeable, HierarchyProfile, OsidProfile, OsidProxyManager, OsidProxyManager, Sourceable

public interface HierarchyProxyManager
extends OsidProxyManager, HierarchyProfile

The hierarchy manager provides access sessions to traverse and manage hierrachies of Ids. Methods in this manager accept a Proxy to pass information from server environments. The sessions included in this manager are:

• HierarchyTraversalSession: a basic session traversing a hierarchy
• HierarchyDesignSession: a session to design a hierarchy
• HierarchySequencingSession: a session to sequence nodes in a hierarchy
• HierarchyStructureNotificationSession: a session for notififcations within a hierarchy structure
• HierarchyLookupSession: a session looking up hiererachies
• HierarchyQuerySession: a session querying hiererachies
• HierarchySearchSession: a session for searching for hierarchies
• HierarchyAdminSession: a session for creating and deleting hierarchies
• HierarchyNotificationSession: a session for subscribing to changes in hierarchies

Method Summary

Modifier and Type	Method	Description
HierarchyAdminSession	getHierarchyAdminSession(Proxy proxy)	Gets the hierarchy administrative session.
HierarchyDesignSession	getHierarchyDesignSession(Proxy proxy)	Gets the OsidSession associated with the hierarchy design service.
HierarchyDesignSession	getHierarchyDesignSessionForHierarchy(Id hierarchyId, Proxy proxy)	Gets the OsidSession associated with the topology design service using for the given hierarchy.
HierarchyLookupSession	getHierarchyLookupSession(Proxy proxy)	Gets the OsidSession associated with the hierarchy lookup service.
HierarchyNotificationSession	getHierarchyNotificationSession(HierarchyReceiver hierarchyReceiver, Proxy proxy)	Gets the hierarchy notification session.
HierarchyQuerySession	getHierarchyQuerySession(Proxy proxy)	Gets the OsidSession associated with the hierarchy query service.
HierarchySearchSession	getHierarchySearchSession(Proxy proxy)	Gets the OsidSession associated with the hierarchy search service.
HierarchySequencingSession	getHierarchySequencingSession(Proxy proxy)	Gets the OsidSession associated with the hierarchy sequencing service.
HierarchySequencingSession	getHierarchySequencingSessionForHierarchy(Id hierarchyId, Proxy proxy)	Gets the OsidSession associated with the sequencing design service using for the given hierarchy.
HierarchyStructureNotificationSession	getHierarchyStructureNotificationSession(HierarchyStructureReceiver hierarchyStructureReceiver, Proxy proxy)	Gets the session for subscribing to notifications of changes within a hierarchy structure.
HierarchyStructureNotificationSession	getHierarchyStructureNotificationSessionForHierarchy(HierarchyStructureReceiver hierarchyStructureReceiver, Id hierarchyId, Proxy proxy)	Gets the session for subscribing to notifications of changes within a hierarchy structure for the given hierarchy.
HierarchyTraversalSession	getHierarchyTraversalSession(Proxy proxy)	Gets the OsidSession associated with the hierarchy traversal service.
HierarchyTraversalSession	getHierarchyTraversalSessionForHierarchy(Id hierarchyId, Proxy proxy)	Gets the OsidSession associated with the hierarchy traversal service for the given hierarchy.

Methods inherited from interface Closeable

close

Methods inherited from interface HierarchyProfile

getHierarchyRecordTypes, getHierarchySearchRecordTypes, supportsHierarchyAdmin, supportsHierarchyDesign, supportsHierarchyLookup, supportsHierarchyNotification, supportsHierarchyQuery, supportsHierarchyRecordType, supportsHierarchySearch, supportsHierarchySearchRecordType, supportsHierarchySequencing, supportsHierarchyStructureNotification, supportsHierarchyTraversal, supportsVisibleFederation

Modifier and Type	Method	Description
TypeList	getHierarchyRecordTypes()	Gets the supported Hierarchy types.
TypeList	getHierarchySearchRecordTypes()	Gets the supported Hierarchy search record types.
boolean	supportsHierarchyAdmin()	Tests if a hierarchy administration is supported.
boolean	supportsHierarchyDesign()	Tests if hierarchy design is supported.
boolean	supportsHierarchyLookup()	Tests if a hierarchy lookup is supported.
boolean	supportsHierarchyNotification()	Tests if hierarchy notification is supported.
boolean	supportsHierarchyQuery()	Tests if a hierarchy query is supported.
boolean	supportsHierarchyRecordType(Type hierarchyRecordType)	Tests if the given Hierarchy record type is supported.
boolean	supportsHierarchySearch()	Tests if a hierarchy search is supported.
boolean	supportsHierarchySearchRecordType(Type hierarchySearchRecordType)	Tests if the given Hierarchy search record type is supported.
boolean	supportsHierarchySequencing()	Tests if hierarchy sequencing is supported.
boolean	supportsHierarchyStructureNotification()	Tests if hierarchy structure notification is supported.
boolean	supportsHierarchyTraversal()	Tests if hierarchy traversal is supported.
boolean	supportsVisibleFederation()	Tests if federation is visible.

Methods inherited from interface OsidProfile

getBranch, getBranchId, getDescription, getDisplayName, getId, getLocales, getProxyRecordTypes, getReleaseDate, getVersion, supportsJournalBranching, supportsJournalRollback, supportsOSIDVersion, supportsProxyRecordType

Modifier and Type	Method	Description
Branch	getBranch()	Gets this service branch.
Id	getBranchId()	Gets the Branch Id representing this service branch.
DisplayText	getDescription()	Gets a description of this service implementation.
DisplayText	getDisplayName()	Gets a display name for this service implementation.
Id	getId()	Gets an identifier for this service implementation.
LocaleList	getLocales()	Gets the locales supported in this service.
TypeList	getProxyRecordTypes()	Gets the proxy record Types supported in this service.
DateTime	getReleaseDate()	Gets the date this service implementation was released.
Version	getVersion()	Gets the version of this service implementation.
boolean	supportsJournalBranching()	Test for support of a journal branching service.
boolean	supportsJournalRollback()	Test for support of a journaling rollback service.
boolean	supportsOSIDVersion(Version version)	Test for support of an OSID specification version.
boolean	supportsProxyRecordType(Type proxyRecordType)	Test for support of a proxy type.

Methods inherited from interface OsidProxyManager

close

Modifier and Type	Method	Description
void	close()	Close this manager.

Methods inherited from interface OsidProxyManager

changeBranch, initialize, rollbackService

Modifier and Type	Method	Description
void	changeBranch(Id branchId, Proxy proxy)	Changes the service branch.
void	initialize(OsidRuntimeManager runtime)	Initializes this manager.
JournalEntry	rollbackService(Date rollbackTime, Proxy proxy)	Rolls back this service to a point in time.

Methods inherited from interface Sourceable

getBranding, getBrandingIds, getLicense, getProvider, getProviderId

Modifier and Type	Method	Description
AssetList	getBranding()	Gets a branding, such as an image or logo, expressed using the Asset interface.
IdList	getBrandingIds()	Gets the branding asset Ids.
DisplayText	getLicense()	Gets the terms of usage.
Resource	getProvider()	Gets the Resource representing the provider.
Id	getProviderId()	Gets the Id of the provider.

Method Details

getHierarchyTraversalSession

HierarchyTraversalSession getHierarchyTraversalSession(Proxy proxy)
                                                throws OperationFailedException

Gets the OsidSession associated with the hierarchy traversal service.

Parameters:

proxy - a proxy

Returns:

a HierarchyTraversalSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchyTraversal() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchyTraversal()} is {@code true}.

getHierarchyTraversalSessionForHierarchy

HierarchyTraversalSession getHierarchyTraversalSessionForHierarchy(Id hierarchyId,
 Proxy proxy)
                                                            throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the hierarchy traversal service for the given hierarchy.

Parameters:

hierarchyId - the Id of the hierarchy

proxy - a proxy

Returns:

a HierarchyTraversalSession

Throws:

NotFoundException - hierarchyid not found

NullArgumentException - hierarchyId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchyTraversal() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchyTraversal()} and {@code supportsVisibleFederation()} are {@code true}.

getHierarchyDesignSession

HierarchyDesignSession getHierarchyDesignSession(Proxy proxy)
                                          throws OperationFailedException

Gets the OsidSession associated with the hierarchy design service.

Parameters:

proxy - a proxy

Returns:

a HierarchyDesignSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchyDesign() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchyDesign()} is {@code true}.

getHierarchyDesignSessionForHierarchy

HierarchyDesignSession getHierarchyDesignSessionForHierarchy(Id hierarchyId,
 Proxy proxy)
                                                      throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the topology design service using for the given hierarchy.

Parameters:

hierarchyId - the Id of the hierarchy

proxy - a proxy

Returns:

a HierarchyDesignSession

Throws:

NotFoundException - hierarchyId is not found

NullArgumentException - hierarchyId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchyDesign() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchyDesign()} and {@code supportsVisibleFederation()} are {@code true}.

getHierarchySequencingSession

HierarchySequencingSession getHierarchySequencingSession(Proxy proxy)
                                                  throws OperationFailedException

Gets the OsidSession associated with the hierarchy sequencing service.

Parameters:

proxy - a proxy

Returns:

a HierarchySequencingSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchySequencing() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchySequencing()} is {@code true}.

getHierarchySequencingSessionForHierarchy

HierarchySequencingSession getHierarchySequencingSessionForHierarchy(Id hierarchyId,
 Proxy proxy)
                                                              throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the sequencing design service using for the given hierarchy.

Parameters:

hierarchyId - the Id of the graph

proxy - a proxy

Returns:

a HierarchySequencingSession

Throws:

NotFoundException - hierarchyId is not found

NullArgumentException - hierarchyId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchySequencing() or supportsVisibleFederation() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchySequencing()} and {@code supportsVisibleFederation()} are {@code true}.

getHierarchyStructureNotificationSession

HierarchyStructureNotificationSession getHierarchyStructureNotificationSession(HierarchyStructureReceiver hierarchyStructureReceiver,
 Proxy proxy)
                                                                        throws OperationFailedException

Gets the session for subscribing to notifications of changes within a hierarchy structure.

Parameters:

hierarchyStructureReceiver - a receiver

proxy - a proxy

Returns:

a HierarchyStructureNotificationSession

Throws:

NullArgumentException - hierarchyStructureReceiver or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchyStructureNotification() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchyStructureNotification()} is {@code true}.

getHierarchyStructureNotificationSessionForHierarchy

HierarchyStructureNotificationSession getHierarchyStructureNotificationSessionForHierarchy(HierarchyStructureReceiver hierarchyStructureReceiver,
 Id hierarchyId,
 Proxy proxy)
                                                                                    throws NotFoundException,
OperationFailedException

Gets the session for subscribing to notifications of changes within a hierarchy structure for the given hierarchy.

Parameters:

hierarchyStructureReceiver - a receiver

hierarchyId - the Id of the hierarchy

proxy - a proxy

Returns:

a HierarchyStructureNotificationSession

Throws:

NotFoundException - hierarchyId is not found

NullArgumentException - hierarchyStructureReceiver, hierarchyId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchyStructureNotification() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchyStructureNotification()} and {@code supportsVisibleFederation()} are {@code true}.

getHierarchyLookupSession

HierarchyLookupSession getHierarchyLookupSession(Proxy proxy)
                                          throws OperationFailedException

Gets the OsidSession associated with the hierarchy lookup service.

Parameters:

proxy - a proxy

Returns:

a HierarchyLookupSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchyLookup() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchyLookup()} is {@code true}.

getHierarchyQuerySession

HierarchyQuerySession getHierarchyQuerySession(Proxy proxy)
                                        throws OperationFailedException

Gets the OsidSession associated with the hierarchy query service.

Parameters:

proxy - a proxy

Returns:

a HierarchyQuerySession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchyQuery() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchyQuery()} is {@code true}.

getHierarchySearchSession

HierarchySearchSession getHierarchySearchSession(Proxy proxy)
                                          throws OperationFailedException

Gets the OsidSession associated with the hierarchy search service.

Parameters:

proxy - a proxy

Returns:

a HierarchySearchSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchySearch() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchySearch()} is {@code true}.

getHierarchyAdminSession

HierarchyAdminSession getHierarchyAdminSession(Proxy proxy)
                                        throws OperationFailedException

Gets the hierarchy administrative session.

Parameters:

proxy - a proxy

Returns:

a HierarchyAdminSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchyAdmin() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchyAdmin()} is {@code true}.

getHierarchyNotificationSession

HierarchyNotificationSession getHierarchyNotificationSession(HierarchyReceiver hierarchyReceiver,
 Proxy proxy)
                                                      throws OperationFailedException

Gets the hierarchy notification session.

Parameters:

hierarchyReceiver - notification callback

proxy - a proxy

Returns:

a HierarchyNotificationSession

Throws:

NullArgumentException - hierarchyReceiver or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsHierarchyNotification() is false

Compliance:

optional - This method must be implemented if {@code supportsHierarchyNotification()} is {@code true}.