OSID Logo
OSID Specifications
hierarchy package
Version 3.0.0
Release Candidate Preview
Interfaceosid.hierarchy.HierarchyManager
Implementsosid.OsidManager
osid.hierarchy.HierarchyProfile
Description

The hierarchy manager provides access sessions to traverse and manage hierrachies of Ids. 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
MethodgetHierarchyTraversalSession
Description

Gets the OsidSession associated with the hierarchy traversal service.

Returnosid.hierarchy.HierarchyTraversalSessiona HierarchyTraversalSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchyTraversal() is false
ComplianceoptionalThis method must be implemented if supportsHierarchyTraversal() is true.
MethodgetHierarchyTraversalSessionForHierarchy
Description

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

Parametersosid.id.IdhierarchyIdthe Id of the hierarchy
Returnosid.hierarchy.HierarchyTraversalSessionthe new HierarchyTraversalSession
ErrorsNOT_FOUND hierarchyId not found
NULL_ARGUMENT hierarchyid is null
OPERATION_FAILED unable to complete request
UNIMPLEMENTED supportsHierarchyTraversal() or supportsVisibleFedaration() is false
ComplianceoptionalThis method must be implemented if supportsHierarchyTraversal() and supportsVisibleFederation() are true.
MethodgetHierarchyDesignSession
Description

Gets the OsidSession associated with the hierarchy design service.

Returnosid.hierarchy.HierarchyDesignSessiona HierarchyDesignSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchyDesign() is false
ComplianceoptionalThis method must be implemented if supportsHierarchyDesign() is true.
MethodgetHierarchyDesignSessionForHierarchy
Description

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

Parametersosid.id.IdhierarchyIdthe Id of the graph
Returnosid.hierarchy.HierarchyDesignSessiona HierarchyDesignSession
ErrorsNOT_FOUND hierarchyId is not found
NULL_ARGUMENT hierarchyId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchyDesign() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsHierarchyDesign() and supportsVisibleFederation() are true.
MethodgetHierarchySequencingSession
Description

Gets the OsidSession associated with the hierarchy sequencing service.

Returnosid.hierarchy.HierarchySequencingSessiona HierarchySequencingSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchySequencing() is false
ComplianceoptionalThis method must be implemented if supportsHierarchySequencing() is true.
MethodgetHierarchySequencingSessionForHierarchy
Description

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

Parametersosid.id.IdhierarchyIdthe Id of the graph
Returnosid.hierarchy.HierarchySequencingSessiona HierarchySequencingSession
ErrorsNOT_FOUND hierarchyId is not found
NULL_ARGUMENT hierarchyId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchySequencing() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsHierarchySequencing() and supportsVisibleFederation() are true.
MethodgetHierarchyStructureNotificationSession
Description

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

Parametersosid.hierarchy.HierarchyStructureReceiverhierarchyStructureReceivera receiver
Returnosid.hierarchy.HierarchyStructureNotificationSessiona HierarchyStructureNotificationSession
ErrorsNULL_ARGUMENT hierarchyStructureReceiver is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchyStructureNotification() is false
ComplianceoptionalThis method must be implemented if supportsHierarchyStructureNotification() is true.
MethodgetHierarchyStructureNotificationSessionForHierarchy
Description

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

Parametersosid.hierarchy.HierarchyStructureReceiverhierarchyStructureReceivera receiver
osid.id.IdhierarchyIdthe Id of the graph
Returnosid.hierarchy.HierarchyStructureNotificationSessiona HierarchyStructureNotificationSession
ErrorsNOT_FOUND hierarchyId is not found
NULL_ARGUMENT hierarchyStructureReceiver or hierarchyId is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchyStructureNotification() or supportsVisibleFederation() is false
ComplianceoptionalThis method must be implemented if supportsHierarchyStructureNotification() and supportsVisibleFederation() are true.
MethodgetHierarchyLookupSession
Description

Gets the OsidSession associated with the hierarchy lookup service.

Returnosid.hierarchy.HierarchyLookupSessiona HierarchyLookupSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchyLookup() is false
ComplianceoptionalThis method must be implemented if supportsHierarchyLookup() is true.
MethodgetHierarchyQuerySession
Description

Gets the OsidSession associated with the hierarchy query service.

Returnosid.hierarchy.HierarchyQuerySessiona HierarchyQuerySession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchyQuery() is false
ComplianceoptionalThis method must be implemented if supportsHierarchyQuery() is true.
MethodgetHierarchySearchSession
Description

Gets the OsidSession associated with the hierarchy search service.

Returnosid.hierarchy.HierarchySearchSessiona HierarchySearchSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchySearch() is false
ComplianceoptionalThis method must be implemented if supportsHierarchySearch() is true.
MethodgetHierarchyAdminSession
Description

Gets the hierarchy administrative session.

Returnosid.hierarchy.HierarchyAdminSessiona HierarchyAdminSession
ErrorsOPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchyAdmin() is false
ComplianceoptionalThis method must be implemented if supportsHierarchyAdmin() is true.
MethodgetHierarchyNotificationSession
Description

Gets a hierarchy notification session.

Parametersosid.hierarchy.HierarchyReceiverhierarchyReceivernotification callback
Returnosid.hierarchy.HierarchyNotificationSessiona HierarchyNotificationSession
ErrorsNULL_ARGUMENT hierarchyReceiver is null
OPERATION_FAILEDunable to complete request
UNIMPLEMENTED supportsHierarchyNotification() is false
ComplianceoptionalThis method must be implemented if supportsHierarchyNotification() is true.