Interface ResourceManager

All Superinterfaces:

AutoCloseable, Closeable, OsidManager, OsidManager, OsidProfile, ResourceProfile, Sourceable

public interface ResourceManager
extends OsidManager, ResourceProfile

The resource manager provides access to resource lookup and creation sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are:

• ResourceLookupSession : a session to retrieve resources
• ResourceQuerySession : a session to query resources
• ResourceSearchSession : a session to search for resources
• ResourceAdminSession : a session to create and delete resources
• ResourceNotificationSession : a session to receive notifications pertaining to resource changes
• ResourceBinSession : a session to look up resource to bin mappings
• ResourceBinAssignmentSession : a session to manage resource to bin mappings
• ResourceSmartBinSession : a session to manage smart resource bins
• MembershipSession : a session to query memberships
• GroupSession : a session to retrieve group memberships
• GroupAssignmentSession : a session to manage groups
• GroupNotificationSession : a session to retrieve notifications on changes to group membership
• GroupHierarchySession : a session to view a group hierarchy
• RsourceAgentSession : a session to retrieve Resource and Agent mappings
• ResourceAgentAssignmentSession : a session to manage Resource and Agent mappings

• ResourceRelationshipLookupSession : a session to retrieve resource relationships
• ResourceRelationshipQuerySession : a session to query for resource relationships
• ResourceRelationshipSearchSession : a session to search for resource relationships
• ResourceRelationshipAdminSession : a session to create and delete resource relationships
• ResourceRelationshipNotificationSession : a session to receive notifications pertaining to resource relationshipchanges
• ResourceRelationshipBinSession : a session to look up resource relationship to bin mappings
• ResourceRelationshipBinAssignmentSession : a session to manage resource relationship to bin mappings
• ResourceRelationshipSmartBinSession : a session to manage smart resource relationship bins

• BinLookupSession: a session to retrieve bins
• BinQuerySession : a session to query bins
• BinSearchSession : a session to search for bins
• BinAdminSession : a session to create, update and delete bins
• BinNotificationSession : a session to receive notifications pertaining to changes in bins
• BinHierarchySession : a session to traverse bin hierarchies
• BinHierarchyDesignSession : a session to manage bin hierarchies

Method Summary

Modifier and Type	Method	Description
BinAdminSession	getBinAdminSession()	Gets the bin administrative session for creating, updating and deleteing bins.
BinHierarchyDesignSession	getBinHierarchyDesignSession()	Gets the bin hierarchy design session.
BinHierarchySession	getBinHierarchySession()	Gets the bin hierarchy traversal session.
BinLookupSession	getBinLookupSession()	Gets the bin lookup session.
BinNotificationSession	getBinNotificationSession(BinReceiver binReceiver)	Gets the notification session for subscribing to changes to a bin.
BinQuerySession	getBinQuerySession()	Gets the bin query session.
BinSearchSession	getBinSearchSession()	Gets the bin search session.
GroupAssignmentSession	getGroupAssignmentSession()	Gets the session for assigning resources to groups.
GroupAssignmentSession	getGroupAssignmentSessionForBin(Id binId)	Gets a group assignment session for the given bin.
GroupHierarchySession	getGroupHierarchySession()	Gets a session for retrieving gropup hierarchies.
GroupHierarchySession	getGroupHierarchySessionForBin(Id binId)	Gets a group hierarchy session for the given bin.
GroupNotificationSession	getGroupNotificationSession(GroupReceiver groupRceeiver)	Gets the notification session for notifications pertaining to resource changes.
GroupNotificationSession	getGroupNotificationSessionForBin(GroupReceiver groupRceeiver, Id binId)	Gets the group notification session for the given bin.
GroupSession	getGroupSession()	Gets the session for retrieving gropup memberships.
GroupSession	getGroupSessionForBin(Id binId)	Gets a group session for the given bin.
MembershipSession	getMembershipSession()	Gets the session for querying memberships.
MembershipSession	getMembershipSessionForBin(Id binId)	Gets a resource membership session for the given bin.
ResourceAdminSession	getResourceAdminSession()	Gets a resource administration session for creating, updating and deleting resources.
ResourceAdminSession	getResourceAdminSessionForBin(Id binId)	Gets a resource administration session for the given bin.
ResourceAgentAssignmentSession	getResourceAgentAssignmentSession()	Gets the session for assigning agents to resources.
ResourceAgentAssignmentSession	getResourceAgentAssignmentSessionForBin(Id binId)	Gets a resource agent session for the given bin.
ResourceAgentSession	getResourceAgentSession()	Gets the session for retrieving resource agent mappings.
ResourceAgentSession	getResourceAgentSessionForBin(Id binId)	Gets a resource agent session for the given bin.
ResourceBatchManager	getResourceBatchManager()	Gets the ResourceBatchManager .
ResourceBinAssignmentSession	getResourceBinAssignmentSession()	Gets the session for assigning resource to bin mappings.
ResourceBinSession	getResourceBinSession()	Gets the session for retrieving resource to bin mappings.
ResourceDemographicManager	getResourceDemographicManager()	Gets the ResourceDemographicManager .
ResourceLookupSession	getResourceLookupSession()	Gets the OsidSession associated with the resource lookup service.
ResourceLookupSession	getResourceLookupSessionForBin(Id binId)	Gets the OsidSession associated with the resource lookup service for the given bin.
ResourceNotificationSession	getResourceNotificationSession(ResourceReceiver resourceReceiver)	Gets the notification session for notifications pertaining to resource changes.
ResourceNotificationSession	getResourceNotificationSessionForBin(ResourceReceiver resourceReceiver, Id binId)	Gets the resource notification session for the given bin.
ResourceQuerySession	getResourceQuerySession()	Gets a resource query session.
ResourceQuerySession	getResourceQuerySessionForBin(Id binId)	Gets a resource query session for the given bin.
ResourceRelationshipAdminSession	getResourceRelationshipAdminSession()	Gets the OsidSession associated with the resource relationship administration service.
ResourceRelationshipAdminSession	getResourceRelationshipAdminSessionForBin(Id binId)	Gets the OsidSession associated with the resource relationship administration service for the given bin.
ResourceRelationshipBinAssignmentSession	getResourceRelationshipBinAssignmentSession()	Gets the session for assigning resource relationships to bin mappings.
ResourceRelationshipBinSession	getResourceRelationshipBinSession()	Gets the session for retrieving resource relationship to bin mappings.
ResourceRelationshipLookupSession	getResourceRelationshipLookupSession()	Gets the OsidSession associated with the resource relationship lookup service.
ResourceRelationshipLookupSession	getResourceRelationshipLookupSessionForBin(Id binId)	Gets the OsidSession associated with the resource relationship lookup service for the given bin.
ResourceRelationshipNotificationSession	getResourceRelationshipNotificationSession(ResourceRelationshipReceiver resourceRelationshipReceiver)	Gets the OsidSession associated with the resource relationship notification service.
ResourceRelationshipNotificationSession	getResourceRelationshipNotificationSessionForBin(ResourceRelationshipReceiver resourceRelationshipReceiver, Id binId)	Gets the OsidSession associated with the resource relationship notification service for the given bin.
ResourceRelationshipQuerySession	getResourceRelationshipQuerySession()	Gets the OsidSession associated with the resource relationship query service.
ResourceRelationshipQuerySession	getResourceRelationshipQuerySessionForBin(Id binId)	Gets the OsidSession associated with the resource relationship query service for the given bin.
ResourceRelationshipSearchSession	getResourceRelationshipSearchSession()	Gets the OsidSession associated with the resource relationship search service.
ResourceRelationshipSearchSession	getResourceRelationshipSearchSessionForBin(Id binId)	Gets the OsidSession associated with the resource relationship search service for the given bin.
ResourceRelationshipSmartBinSession	getResourceRelationshipSmartBinSession(Id binId)	Gets the session for managing dynamic resource relationship bins.
ResourceSearchSession	getResourceSearchSession()	Gets a resource search session.
ResourceSearchSession	getResourceSearchSessionForBin(Id binId)	Gets a resource search session for the given bin.
ResourceSmartBinSession	getResourceSmartBinSession(Id binId)	Gets the session for managing dynamic resource bins.

Methods inherited from interface Closeable

close

Methods inherited from interface OsidManager

close

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

Methods inherited from interface OsidManager

changeBranch, initialize, rollbackService

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

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 ResourceProfile

getBinRecordTypes, getBinSearchRecordTypes, getResourceRecordTypes, getResourceRelationshipRecordTypes, getResourceRelationshipSearchRecordTypes, getResourceSearchRecordTypes, supportsBinAdmin, supportsBinHierarchy, supportsBinHierarchyDesign, supportsBinLookup, supportsBinNotification, supportsBinQuery, supportsBinRecordType, supportsBinSearch, supportsBinSearchRecordType, supportsGroup, supportsGroupAssignment, supportsGroupHierarchy, supportsGroupNotification, supportsMembership, supportsResourceAdmin, supportsResourceAgent, supportsResourceAgentAssignment, supportsResourceBatch, supportsResourceBin, supportsResourceBinAssignment, supportsResourceDemographic, supportsResourceLookup, supportsResourceNotification, supportsResourceQuery, supportsResourceRecordType, supportsResourceRelationshipAdmin, supportsResourceRelationshipBin, supportsResourceRelationshipBinAssignment, supportsResourceRelationshipLookup, supportsResourceRelationshipNotification, supportsResourceRelationshipQuery, supportsResourceRelationshipRecordType, supportsResourceRelationshipSearch, supportsResourceRelationshipSearchRecordType, supportsResourceRelationshipSmartBin, supportsResourceSearch, supportsResourceSearchRecordType, supportsResourceSmartBin, supportsVisibleFederation

Modifier and Type	Method	Description
TypeList	getBinRecordTypes()	Gets all the bin record types supported.
TypeList	getBinSearchRecordTypes()	Gets all the bin search record types supported.
TypeList	getResourceRecordTypes()	Gets all the resource record types supported.
TypeList	getResourceRelationshipRecordTypes()	Gets the supported ResourceRelationship record types.
TypeList	getResourceRelationshipSearchRecordTypes()	Gets the supported ResourceRelationship search record types.
TypeList	getResourceSearchRecordTypes()	Gets all the resource search record types supported.
boolean	supportsBinAdmin()	Tests if bin administration is supported.
boolean	supportsBinHierarchy()	Tests if a bin hierarchy traversal is supported.
boolean	supportsBinHierarchyDesign()	Tests if a bin hierarchy design is supported.
boolean	supportsBinLookup()	Tests if bin lookup is supported.
boolean	supportsBinNotification()	Tests if bin notification is supported.
boolean	supportsBinQuery()	Tests if bin query is supported.
boolean	supportsBinRecordType(Type binRecordType)	Tests if a given bin record type is supported.
boolean	supportsBinSearch()	Tests if bin search is supported.
boolean	supportsBinSearchRecordType(Type binSearchRecordType)	Tests if a given bin search record type is supported.
boolean	supportsGroup()	Tests if group resources are supported.
boolean	supportsGroupAssignment()	Tests if group resource assignment is supported.
boolean	supportsGroupHierarchy()	Tests if a group resource hierarchy service is supported.
boolean	supportsGroupNotification()	Tests if group resource notification is supported.
boolean	supportsMembership()	Tests if membership queries are supported.
boolean	supportsResourceAdmin()	Tests if resource administration is supported.
boolean	supportsResourceAgent()	Tests if retrieving mappings of resource and agents is supported.
boolean	supportsResourceAgentAssignment()	Tests if managing mappings of resources and agents is supported.
boolean	supportsResourceBatch()	Tests if a resource batch service is available.
boolean	supportsResourceBin()	Tests if retrieving mappings of resource and bins is supported.
boolean	supportsResourceBinAssignment()	Tests if managing mappings of resource and bins is supported.
boolean	supportsResourceDemographic()	Tests if a resource demographic service is available.
boolean	supportsResourceLookup()	Tests if resource lookup is supported.
boolean	supportsResourceNotification()	Tests if resource notification is supported.
boolean	supportsResourceQuery()	Tests if resource query is supported.
boolean	supportsResourceRecordType(Type resourceRecordType)	Tests if a given resource record type is supported.
boolean	supportsResourceRelationshipAdmin()	Tests if a resource relationships administrative service is supported.
boolean	supportsResourceRelationshipBin()	Tests if retrieving mappings of resource relationships and bins is supported.
boolean	supportsResourceRelationshipBinAssignment()	Tests if managing mappings of resource relationships and bins is supported.
boolean	supportsResourceRelationshipLookup()	Tests if looking up resource relationships is supported.
boolean	supportsResourceRelationshipNotification()	Tests if a resource relationships notification service is supported.
boolean	supportsResourceRelationshipQuery()	Tests if querying resource relationships is supported.
boolean	supportsResourceRelationshipRecordType(Type resourceRelationshipRecordType)	Tests if the given ResourceRelationship record type is supported.
boolean	supportsResourceRelationshipSearch()	Tests if searching resource relationships is supported.
boolean	supportsResourceRelationshipSearchRecordType(Type resourceRelationshipSearchRecordType)	Tests if the given ResourceRelationship search record type is supported.
boolean	supportsResourceRelationshipSmartBin()	Tests if resource relationship smart bins are available.
boolean	supportsResourceSearch()	Tests if resource search is supported.
boolean	supportsResourceSearchRecordType(Type resourceSearchRecordType)	Tests if a given resource search type is supported.
boolean	supportsResourceSmartBin()	Tests if resource smart bins are available.
boolean	supportsVisibleFederation()	Tests if federation is visible.

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

getResourceLookupSession

ResourceLookupSession getResourceLookupSession()
                                        throws OperationFailedException

Gets the OsidSession associated with the resource lookup service.

Returns:

a ResourceLookupSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceLookup() is false

Compliance:

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

getResourceLookupSessionForBin

ResourceLookupSession getResourceLookupSessionForBin(Id binId)
                                              throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the resource lookup service for the given bin.

Parameters:

binId - the Id of the bin

Returns:

a ResourceLookupSession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceLookup() or supportsVisibleFederation() is false

Compliance:

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

getResourceQuerySession

ResourceQuerySession getResourceQuerySession()
                                      throws OperationFailedException

Gets a resource query session.

Returns:

a ResourceQuerySession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceQuery() is false

Compliance:

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

getResourceQuerySessionForBin

ResourceQuerySession getResourceQuerySessionForBin(Id binId)
                                            throws NotFoundException,
OperationFailedException

Gets a resource query session for the given bin.

Parameters:

binId - the Id of the bin

Returns:

a ResourceQuerySession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceQuery() or supportsVisibleFederation() is false

Compliance:

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

getResourceSearchSession

ResourceSearchSession getResourceSearchSession()
                                        throws OperationFailedException

Gets a resource search session.

Returns:

a ResourceSearchSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceSearch() is false

Compliance:

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

getResourceSearchSessionForBin

ResourceSearchSession getResourceSearchSessionForBin(Id binId)
                                              throws NotFoundException,
OperationFailedException

Gets a resource search session for the given bin.

Parameters:

binId - the Id of the bin

Returns:

a ResourceSearchSession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceSearch() or supportsVisibleFederation() is false

Compliance:

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

getResourceAdminSession

ResourceAdminSession getResourceAdminSession()
                                      throws OperationFailedException

Gets a resource administration session for creating, updating and deleting resources.

Returns:

a ResourceAdminSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceAdmin() is false

Compliance:

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

getResourceAdminSessionForBin

ResourceAdminSession getResourceAdminSessionForBin(Id binId)
                                            throws NotFoundException,
OperationFailedException

Gets a resource administration session for the given bin.

Parameters:

binId - the Id of the bin

Returns:

a ResourceAdminSession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceAdmin() or supportsVisibleFederation() is false

Compliance:

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

getResourceNotificationSession

ResourceNotificationSession getResourceNotificationSession(ResourceReceiver resourceReceiver)
                                                    throws OperationFailedException

Gets the notification session for notifications pertaining to resource changes.

Parameters:

resourceReceiver - the notification callback

Returns:

a ResourceNotificationSession

Throws:

NullArgumentException - resourceReceiver is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceNotification() is false

Compliance:

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

getResourceNotificationSessionForBin

ResourceNotificationSession getResourceNotificationSessionForBin(ResourceReceiver resourceReceiver,
 Id binId)
                                                          throws NotFoundException,
OperationFailedException

Gets the resource notification session for the given bin.

Parameters:

resourceReceiver - the notification callback

binId - the Id of the bin

Returns:

a ResourceNotificationSession

Throws:

NotFoundException - binId not found

NullArgumentException - resourceReceiver or binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceNotification() or supportsVisibleFederation() is false

Compliance:

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

getResourceBinSession

ResourceBinSession getResourceBinSession()
                                  throws OperationFailedException

Gets the session for retrieving resource to bin mappings.

Returns:

a ResourceBinSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceBin() is false

Compliance:

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

getResourceBinAssignmentSession

ResourceBinAssignmentSession getResourceBinAssignmentSession()
                                                      throws OperationFailedException

Gets the session for assigning resource to bin mappings.

Returns:

a ResourceBinAssignmentSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceBinAssignment() is false

Compliance:

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

getResourceSmartBinSession

ResourceSmartBinSession getResourceSmartBinSession(Id binId)
                                            throws NotFoundException,
OperationFailedException

Gets the session for managing dynamic resource bins.

Parameters:

binId - the Id of the bin

Returns:

a ResourceSmartBinSession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceSmartBin() is false

Compliance:

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

getMembershipSession

MembershipSession getMembershipSession()
                                throws OperationFailedException

Gets the session for querying memberships.

Returns:

a MembershipSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsMembership() is false

Compliance:

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

getMembershipSessionForBin

MembershipSession getMembershipSessionForBin(Id binId)
                                      throws NotFoundException,
OperationFailedException

Gets a resource membership session for the given bin.

Parameters:

binId - the Id of the bin

Returns:

a MembershipSession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsMembership() or supportsVisibleFederation() is false

Compliance:

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

getGroupSession

GroupSession getGroupSession()
                      throws OperationFailedException

Gets the session for retrieving gropup memberships.

Returns:

a GroupSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsGroup() is false

Compliance:

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

getGroupSessionForBin

GroupSession getGroupSessionForBin(Id binId)
                            throws NotFoundException,
OperationFailedException

Gets a group session for the given bin.

Parameters:

binId - the Id of the bin

Returns:

a GroupSession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsGroup() or supportsVisibleFederation() is false

Compliance:

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

getGroupAssignmentSession

GroupAssignmentSession getGroupAssignmentSession()
                                          throws OperationFailedException

Gets the session for assigning resources to groups.

Returns:

a GroupAssignmentSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsGroupAssignment() is false

Compliance:

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

getGroupAssignmentSessionForBin

GroupAssignmentSession getGroupAssignmentSessionForBin(Id binId)
                                                throws NotFoundException,
OperationFailedException

Gets a group assignment session for the given bin.

Parameters:

binId - the Id of the bin

Returns:

a GroupAssignmentSession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsGroupAssignment() or supportsVisibleFederation() is false

Compliance:

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

getGroupNotificationSession

GroupNotificationSession getGroupNotificationSession(GroupReceiver groupRceeiver)
                                              throws OperationFailedException

Gets the notification session for notifications pertaining to resource changes.

Parameters:

groupRceeiver - the notification callback

Returns:

a GroupNotificationSession

Throws:

NullArgumentException - groupReceiver is null

OperationFailedException - unable to complete request

UnimplementedException - supportsGroupNotification() is false

Compliance:

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

getGroupNotificationSessionForBin

GroupNotificationSession getGroupNotificationSessionForBin(GroupReceiver groupRceeiver,
 Id binId)
                                                    throws NotFoundException,
OperationFailedException

Gets the group notification session for the given bin.

Parameters:

groupRceeiver - the notification callback

binId - the Id of the bin

Returns:

a GroupNotificationSession

Throws:

NotFoundException - binId not found

NullArgumentException - groupReceiver or binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsGroupNotification() or supportsVisibleFederation() is false

Compliance:

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

getGroupHierarchySession

GroupHierarchySession getGroupHierarchySession()
                                        throws OperationFailedException

Gets a session for retrieving gropup hierarchies.

Returns:

a GroupHierarchySession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsGroupHierarchy() is false

Compliance:

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

getGroupHierarchySessionForBin

GroupHierarchySession getGroupHierarchySessionForBin(Id binId)
                                              throws NotFoundException,
OperationFailedException

Gets a group hierarchy session for the given bin.

Parameters:

binId - the Id of the bin

Returns:

a GroupHierarchySession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsGroupHierarchy() or supportsVisibleFederation() is false

Compliance:

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

getResourceAgentSession

ResourceAgentSession getResourceAgentSession()
                                      throws OperationFailedException

Gets the session for retrieving resource agent mappings.

Returns:

a ResourceAgentSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceAgent() is false

Compliance:

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

getResourceAgentSessionForBin

ResourceAgentSession getResourceAgentSessionForBin(Id binId)
                                            throws NotFoundException,
OperationFailedException

Gets a resource agent session for the given bin.

Parameters:

binId - the Id of the bin

Returns:

a ResourceAgentSession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceAgent() or supportsVisibleFederation() is false

Compliance:

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

getResourceAgentAssignmentSession

ResourceAgentAssignmentSession getResourceAgentAssignmentSession()
                                                          throws OperationFailedException

Gets the session for assigning agents to resources.

Returns:

a ResourceAgentAssignmentSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceAgentAssignment() is false

Compliance:

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

getResourceAgentAssignmentSessionForBin

ResourceAgentAssignmentSession getResourceAgentAssignmentSessionForBin(Id binId)
                                                                throws NotFoundException,
OperationFailedException

Gets a resource agent session for the given bin.

Parameters:

binId - the Id of the bin

Returns:

a ResourceAgentAssignmentSession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceAgentAssignment() or supportsVisibleFederation() is false

Compliance:

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

getResourceRelationshipLookupSession

ResourceRelationshipLookupSession getResourceRelationshipLookupSession()
                                                                throws OperationFailedException

Gets the OsidSession associated with the resource relationship lookup service.

Returns:

a ResourceRelationshipLookupSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipLookup() is false

Compliance:

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

getResourceRelationshipLookupSessionForBin

ResourceRelationshipLookupSession getResourceRelationshipLookupSessionForBin(Id binId)
                                                                      throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the resource relationship lookup service for the given bin.

Parameters:

binId - the Id of the Bin

Returns:

a ResourceRelationshipLookupSession

Throws:

NotFoundException - no Bin found by the given Id

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipLookup() or supportsVisibleFederation() is false

Compliance:

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

getResourceRelationshipQuerySession

ResourceRelationshipQuerySession getResourceRelationshipQuerySession()
                                                              throws OperationFailedException

Gets the OsidSession associated with the resource relationship query service.

Returns:

a ResourceRelationshipQuerySession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipQuery() is false

Compliance:

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

getResourceRelationshipQuerySessionForBin

ResourceRelationshipQuerySession getResourceRelationshipQuerySessionForBin(Id binId)
                                                                    throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the resource relationship query service for the given bin.

Parameters:

binId - the Id of the Bin

Returns:

a ResourceRelationshipQuerySession

Throws:

NotFoundException - no Bin found by the given Id

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipQuery() or supportsVisibleFederation() is false

Compliance:

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

getResourceRelationshipSearchSession

ResourceRelationshipSearchSession getResourceRelationshipSearchSession()
                                                                throws OperationFailedException

Gets the OsidSession associated with the resource relationship search service.

Returns:

a ResourceRelationshipSearchSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipSearch() is false

Compliance:

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

getResourceRelationshipSearchSessionForBin

ResourceRelationshipSearchSession getResourceRelationshipSearchSessionForBin(Id binId)
                                                                      throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the resource relationship search service for the given bin.

Parameters:

binId - the Id of the Bin

Returns:

a ResourceRelationshipSearchSession

Throws:

NotFoundException - no bin found by the given Id

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipSearch() or supportsVisibleFederation() is false

Compliance:

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

getResourceRelationshipAdminSession

ResourceRelationshipAdminSession getResourceRelationshipAdminSession()
                                                              throws OperationFailedException

Gets the OsidSession associated with the resource relationship administration service.

Returns:

a ResourceRelationshipAdminSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipAdmin() is false

Compliance:

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

getResourceRelationshipAdminSessionForBin

ResourceRelationshipAdminSession getResourceRelationshipAdminSessionForBin(Id binId)
                                                                    throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the resource relationship administration service for the given bin.

Parameters:

binId - the Id of the Bin

Returns:

a ResourceRelationshipAdminSession

Throws:

NotFoundException - no bin found by the given Id

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipAdmin() or supportsVisibleFederation() is false

Compliance:

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

getResourceRelationshipNotificationSession

ResourceRelationshipNotificationSession getResourceRelationshipNotificationSession(ResourceRelationshipReceiver resourceRelationshipReceiver)
                                                                            throws OperationFailedException

Gets the OsidSession associated with the resource relationship notification service.

Parameters:

resourceRelationshipReceiver - the notification callback

Returns:

a ResourceRelationshipNotificationSession

Throws:

NullArgumentException - resourceRelationshipReceiver is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipNotification() is false

Compliance:

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

getResourceRelationshipNotificationSessionForBin

ResourceRelationshipNotificationSession getResourceRelationshipNotificationSessionForBin(ResourceRelationshipReceiver resourceRelationshipReceiver,
 Id binId)
                                                                                  throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the resource relationship notification service for the given bin.

Parameters:

resourceRelationshipReceiver - the notification callback

binId - the Id of the Bin

Returns:

a ResourceRelationshipNotificationSession

Throws:

NotFoundException - no bin found by the given Id

NullArgumentException - resourceRelationshipReceiver or binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshiptNotification() or supportsVisibleFederation() is false

Compliance:

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

getResourceRelationshipBinSession

ResourceRelationshipBinSession getResourceRelationshipBinSession()
                                                          throws OperationFailedException

Gets the session for retrieving resource relationship to bin mappings.

Returns:

a ResourceRelationshipBinSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipBin() is false

Compliance:

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

getResourceRelationshipBinAssignmentSession

ResourceRelationshipBinAssignmentSession getResourceRelationshipBinAssignmentSession()
                                                                              throws OperationFailedException

Gets the session for assigning resource relationships to bin mappings.

Returns:

a ResourceRelationshipBinAssignmentSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipBinAssignment() is false

Compliance:

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

getResourceRelationshipSmartBinSession

ResourceRelationshipSmartBinSession getResourceRelationshipSmartBinSession(Id binId)
                                                                    throws NotFoundException,
OperationFailedException

Gets the session for managing dynamic resource relationship bins.

Parameters:

binId - the Id of the bin

Returns:

a ResourceRelationshipSmartBinSession

Throws:

NotFoundException - binId not found

NullArgumentException - binId is null

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceRelationshipSmartBin() is false

Compliance:

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

getBinLookupSession

BinLookupSession getBinLookupSession()
                              throws OperationFailedException

Gets the bin lookup session.

Returns:

a BinLookupSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsBinLookup() is false

Compliance:

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

getBinQuerySession

BinQuerySession getBinQuerySession()
                            throws OperationFailedException

Gets the bin query session.

Returns:

a BinQuerySession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsBinQuery() is false

Compliance:

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

getBinSearchSession

BinSearchSession getBinSearchSession()
                              throws OperationFailedException

Gets the bin search session.

Returns:

a BinSearchSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsBinSearch() is false

Compliance:

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

getBinAdminSession

BinAdminSession getBinAdminSession()
                            throws OperationFailedException

Gets the bin administrative session for creating, updating and deleteing bins.

Returns:

a BinAdminSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsBinAdmin() is false

Compliance:

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

getBinNotificationSession

BinNotificationSession getBinNotificationSession(BinReceiver binReceiver)
                                          throws OperationFailedException

Gets the notification session for subscribing to changes to a bin.

Parameters:

binReceiver - the notification callback

Returns:

a BinNotificationSession

Throws:

NullArgumentException - binReceiver is null

OperationFailedException - unable to complete request

UnimplementedException - supportsBinNotification() is false

Compliance:

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

getBinHierarchySession

BinHierarchySession getBinHierarchySession()
                                    throws OperationFailedException

Gets the bin hierarchy traversal session.

Returns:

a BinHierarchySession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsBinHierarchy() is false

Compliance:

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

getBinHierarchyDesignSession

BinHierarchyDesignSession getBinHierarchyDesignSession()
                                                throws OperationFailedException

Gets the bin hierarchy design session.

Returns:

a BinHierarchyDesignSession

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsBinHierarchyDesign() is false

Compliance:

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

getResourceBatchManager

ResourceBatchManager getResourceBatchManager()
                                      throws OperationFailedException

Gets the ResourceBatchManager .

Returns:

a ResourceBatchManager

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceBatch() is false

Compliance:

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

getResourceDemographicManager

ResourceDemographicManager getResourceDemographicManager()
                                                  throws OperationFailedException

Gets the ResourceDemographicManager .

Returns:

a ResourceDemographicManager

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsResourceDemographic() is false

Compliance:

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