Interface RelationshipProxyManager

All Superinterfaces:

AutoCloseable, Closeable, OsidProfile, OsidProxyManager, OsidProxyManager, RelationshipProfile, Sourceable

public interface RelationshipProxyManager
extends OsidProxyManager, RelationshipProfile

The relationship manager provides access to relationship sessions and provides interoperability tests for various aspects of this service. Methods in this manager support the passing of a Proxy. The sessions included in this manager are:

• RelationshipLookupSession : a session to retrieve and examine relationships
• RelationshipQuerySession : a session to query relationships
• RelationshipSearchSession : a session to search for relationships
• RelationshipAdminSession : a session to manage relationships
• RelationshipNotificationSession : a session to receive notifications pertaining to relationship changes
• RelationshipFamilySession : a session to look up relationship to family mappings
• RelationshipFamilyAssignmentSession : a session to manage relationship to family catalog mappings
• RelationshipSmartFamilySession : a session to manage dynamic relationship families

• FamilyLookupSession : a session to retrieve families
• FamilyQuerySession : a session to query families
• FamilySearchSession : a session to search for families
• FamilyAdminSession : a session to create and delete families
• FamilyNotificationSession : a session to receive notifications pertaining to family changes
• FamilyHierarchySession : a session to traverse a hierarchy of families
• FamilyHierarchyDesignSession : a session to manage a family hierarchy

Method Summary

Modifier and Type	Method	Description
FamilyAdminSession	getFamilyAdminSession(Proxy proxy)	Gets the OsidSession associated with the family administrative service.
FamilyHierarchyDesignSession	getFamilyHierarchyDesignSession(Proxy proxy)	Gets the OsidSession associated with the family hierarchy design service.
FamilyHierarchySession	getFamilyHierarchySession(Proxy proxy)	Gets the OsidSession associated with the family hierarchy service.
FamilyLookupSession	getFamilyLookupSession(Proxy proxy)	Gets the OsidSession associated with the family lookup service.
FamilyNotificationSession	getFamilyNotificationSession(FamilyReceiver familyReceiver, Proxy proxy)	Gets the OsidSession associated with the family notification service.
FamilyQuerySession	getFamilyQuerySession(Proxy proxy)	Gets the OsidSession associated with the family query service.
FamilySearchSession	getFamilySearchSession(Proxy proxy)	Gets the OsidSession associated with the family search service.
RelationshipAdminSession	getRelationshipAdminSession(Proxy proxy)	Gets the OsidSession associated with the relationship administration service.
RelationshipAdminSession	getRelationshipAdminSessionForFamily(Id familyId, Proxy proxy)	Gets the OsidSession associated with the relationship administration service for the given family.
RelationshipBatchProxyManager	getRelationshipBatchProxyManager()	Gets the relationship batch proxy manager.
RelationshipFamilyAssignmentSession	getRelationshipFamilyAssignmentSession(Proxy proxy)	Gets the OsidSession associated with assigning relationships to families.
RelationshipFamilySession	getRelationshipFamilySession(Proxy proxy)	Gets the OsidSession to lookup relationship/family mappings.
RelationshipLookupSession	getRelationshipLookupSession(Proxy proxy)	Gets the OsidSession associated with the relationship lookup service.
RelationshipLookupSession	getRelationshipLookupSessionForFamily(Id familyId, Proxy proxy)	Gets the OsidSession associated with the relationship lookup service for the given family.
RelationshipNotificationSession	getRelationshipNotificationSession(RelationshipReceiver relationshipReceiver, Proxy proxy)	Gets the OsidSession associated with the relationship notification service.
RelationshipNotificationSession	getRelationshipNotificationSessionForFamily(RelationshipReceiver relationshipReceiver, Id familyId, Proxy proxy)	Gets the OsidSession associated with the relationship notification service for the given family.
RelationshipQuerySession	getRelationshipQuerySession(Proxy proxy)	Gets the OsidSession associated with the relationship query service.
RelationshipQuerySession	getRelationshipQuerySessionForFamily(Id familyId, Proxy proxy)	Gets the OsidSession associated with the relationship query service for the given family.
RelationshipRulesProxyManager	getRelationshipRulesProxyManager()	Gets the relationship rules proxy manager.
RelationshipSearchSession	getRelationshipSearchSession(Proxy proxy)	Gets the OsidSession associated with the relationship search service.
RelationshipSearchSession	getRelationshipSearchSessionForFamily(Id familyId, Proxy proxy)	Gets the OsidSession associated with the relationship search service for the given family.
RelationshipSmartFamilySession	getRelationshipSmartFamilySession(Id familyId, Proxy proxy)	Gets the OsidSession to manage dynamic families of retlationships.

Methods inherited from interface Closeable

close

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 RelationshipProfile

getFamilyRecordTypes, getFamilySearchRecordTypes, getRelationshipRecordTypes, getRelationshipSearchRecordTypes, supportsFamilyAdmin, supportsFamilyHierarchy, supportsFamilyHierarchyDesign, supportsFamilyLookup, supportsFamilyNotification, supportsFamilyQuery, supportsFamilyRecordType, supportsFamilySearch, supportsFamilySearchRecordType, supportsRelationshipAdmin, supportsRelationshipBatch, supportsRelationshipFamily, supportsRelationshipFamilyAssignment, supportsRelationshipLookup, supportsRelationshipNotification, supportsRelationshipQuery, supportsRelationshipRecordType, supportsRelationshipRules, supportsRelationshipSearch, supportsRelationshipSearchRecordType, supportsRelationshipSmartFamily, supportsVisibleFederation

Modifier and Type	Method	Description
TypeList	getFamilyRecordTypes()	Gets the supported Family record types.
TypeList	getFamilySearchRecordTypes()	Gets the supported Family search record types.
TypeList	getRelationshipRecordTypes()	Gets the supported Relationship record types.
TypeList	getRelationshipSearchRecordTypes()	Gets the supported Relationship search record types.
boolean	supportsFamilyAdmin()	Tests if family administrative service is supported.
boolean	supportsFamilyHierarchy()	Tests for the availability of a family hierarchy traversal service.
boolean	supportsFamilyHierarchyDesign()	Tests for the availability of a family hierarchy design service.
boolean	supportsFamilyLookup()	Tests if looking up families is supported.
boolean	supportsFamilyNotification()	Tests if a family notification service is supported.
boolean	supportsFamilyQuery()	Tests if querying families is supported.
boolean	supportsFamilyRecordType(Type familyRecordType)	Tests if the given Family record type is supported.
boolean	supportsFamilySearch()	Tests if searching families is supported.
boolean	supportsFamilySearchRecordType(Type familySearchRecordType)	Tests if the given Family search record type is supported.
boolean	supportsRelationshipAdmin()	Tests if relationship administrative service is supported.
boolean	supportsRelationshipBatch()	Tests for the availability of a relationship batch service.
boolean	supportsRelationshipFamily()	Tests if a relationship family cataloging service is supported.
boolean	supportsRelationshipFamilyAssignment()	Tests if a relationship cataloging service is supported.
boolean	supportsRelationshipLookup()	Tests if looking up relationships is supported.
boolean	supportsRelationshipNotification()	Tests if a relationship notification service is supported.
boolean	supportsRelationshipQuery()	Tests if querying relationships is supported.
boolean	supportsRelationshipRecordType(Type relationshipRecordType)	Tests if the given Relationship record type is supported.
boolean	supportsRelationshipRules()	Tests if a relationship rules service is supported.
boolean	supportsRelationshipSearch()	Tests if searching relationships is supported.
boolean	supportsRelationshipSearchRecordType(Type relationshipSearchRecordType)	Tests if the given Relationship search record type is supported.
boolean	supportsRelationshipSmartFamily()	Tests if a relationship smart family cataloging service is supported.
boolean	supportsVisibleFederation()	Tests if any family federation is exposed.

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

getRelationshipLookupSession

RelationshipLookupSession getRelationshipLookupSession(Proxy proxy)
                                                throws OperationFailedException

Gets the OsidSession associated with the relationship lookup service.

Parameters:

proxy - a proxy

Returns:

a RelationshipLookupSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipLookup() is false

Compliance:

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

getRelationshipLookupSessionForFamily

RelationshipLookupSession getRelationshipLookupSessionForFamily(Id familyId,
 Proxy proxy)
                                                         throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the relationship lookup service for the given family.

Parameters:

familyId - the Id of the family

proxy - a proxy

Returns:

a RelationshipLookupSession

Throws:

NotFoundException - no Family found by the given Id

NullArgumentException - familyId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipLookup() or supportsVisibleFederation() is false

Compliance:

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

getRelationshipQuerySession

RelationshipQuerySession getRelationshipQuerySession(Proxy proxy)
                                              throws OperationFailedException

Gets the OsidSession associated with the relationship query service.

Parameters:

proxy - a proxy

Returns:

a RelationshipQuerySession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipQuery() is false

Compliance:

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

getRelationshipQuerySessionForFamily

RelationshipQuerySession getRelationshipQuerySessionForFamily(Id familyId,
 Proxy proxy)
                                                       throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the relationship query service for the given family.

Parameters:

familyId - the Id of the family

proxy - a proxy

Returns:

a RelationshipQuerySession

Throws:

NotFoundException - no Family found by the given Id

NullArgumentException - familyId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipQuery() or supportsVisibleFederation() is false

Compliance:

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

getRelationshipSearchSession

RelationshipSearchSession getRelationshipSearchSession(Proxy proxy)
                                                throws OperationFailedException

Gets the OsidSession associated with the relationship search service.

Parameters:

proxy - a proxy

Returns:

a RelationshipSearchSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipSearch() is false

Compliance:

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

getRelationshipSearchSessionForFamily

RelationshipSearchSession getRelationshipSearchSessionForFamily(Id familyId,
 Proxy proxy)
                                                         throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the relationship search service for the given family.

Parameters:

familyId - the Id of the family

proxy - a proxy

Returns:

a RelationshipSearchSession

Throws:

NotFoundException - no Family found by the given Id

NullArgumentException - familyId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipSearch() or supportsVisibleFederation() is false

Compliance:

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

getRelationshipAdminSession

RelationshipAdminSession getRelationshipAdminSession(Proxy proxy)
                                              throws OperationFailedException

Gets the OsidSession associated with the relationship administration service.

Parameters:

proxy - a proxy

Returns:

a RelationshipAdminSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipAdmin() is false

Compliance:

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

getRelationshipAdminSessionForFamily

RelationshipAdminSession getRelationshipAdminSessionForFamily(Id familyId,
 Proxy proxy)
                                                       throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the relationship administration service for the given family.

Parameters:

familyId - the Id of the family

proxy - a proxy

Returns:

a RelationshipAdminSession

Throws:

NotFoundException - no Family found by the given Id

NullArgumentException - familyId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipAdmin() or supportsVisibleFederation() is false

Compliance:

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

getRelationshipNotificationSession

RelationshipNotificationSession getRelationshipNotificationSession(RelationshipReceiver relationshipReceiver,
 Proxy proxy)
                                                            throws OperationFailedException

Gets the OsidSession associated with the relationship notification service.

Parameters:

relationshipReceiver - the receiver

proxy - a proxy

Returns:

a RelationshipNotificationSession

Throws:

NullArgumentException - relationshipReceiver or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipNotification() is false

Compliance:

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

getRelationshipNotificationSessionForFamily

RelationshipNotificationSession getRelationshipNotificationSessionForFamily(RelationshipReceiver relationshipReceiver,
 Id familyId,
 Proxy proxy)
                                                                     throws NotFoundException,
OperationFailedException

Gets the OsidSession associated with the relationship notification service for the given family.

Parameters:

relationshipReceiver - the receiver

familyId - the Id of the family

proxy - a proxy

Returns:

a RelationshipNotificationSession

Throws:

NotFoundException - no Family found by the given Id

NullArgumentException - relationshipReceiver, familyId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipNotification() or supportsVisibleFederation() is false

Compliance:

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

getRelationshipFamilySession

RelationshipFamilySession getRelationshipFamilySession(Proxy proxy)
                                                throws OperationFailedException

Gets the OsidSession to lookup relationship/family mappings.

Parameters:

proxy - a proxy

Returns:

a RelationshipFamilySession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipFamily() is false

Compliance:

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

getRelationshipFamilyAssignmentSession

RelationshipFamilyAssignmentSession getRelationshipFamilyAssignmentSession(Proxy proxy)
                                                                    throws OperationFailedException

Gets the OsidSession associated with assigning relationships to families.

Parameters:

proxy - a proxy

Returns:

a RelationshipFamilyAssignmentSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipFamilyAssignment() is false

Compliance:

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

getRelationshipSmartFamilySession

RelationshipSmartFamilySession getRelationshipSmartFamilySession(Id familyId,
 Proxy proxy)
                                                          throws NotFoundException,
OperationFailedException

Gets the OsidSession to manage dynamic families of retlationships.

Parameters:

familyId - the Id of the Family

proxy - a proxy

Returns:

a RelationshipSmartFamilySession

Throws:

NotFoundException - no family found by the given Id

NullArgumentException - familyId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipSmartFamily() is false

Compliance:

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

getFamilyLookupSession

FamilyLookupSession getFamilyLookupSession(Proxy proxy)
                                    throws OperationFailedException

Gets the OsidSession associated with the family lookup service.

Parameters:

proxy - a proxy

Returns:

a FamilyLookupSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFamilyLookup() is false

Compliance:

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

getFamilyQuerySession

FamilyQuerySession getFamilyQuerySession(Proxy proxy)
                                  throws OperationFailedException

Gets the OsidSession associated with the family query service.

Parameters:

proxy - a proxy

Returns:

a FamilyQuerySession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFamilyQuery() is false

Compliance:

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

getFamilySearchSession

FamilySearchSession getFamilySearchSession(Proxy proxy)
                                    throws OperationFailedException

Gets the OsidSession associated with the family search service.

Parameters:

proxy - a proxy

Returns:

a FamilySearchSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFamilySearch() is false

Compliance:

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

getFamilyAdminSession

FamilyAdminSession getFamilyAdminSession(Proxy proxy)
                                  throws OperationFailedException

Gets the OsidSession associated with the family administrative service.

Parameters:

proxy - a proxy

Returns:

a FamilyAdminSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFamilyAdmin() is false

Compliance:

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

getFamilyNotificationSession

FamilyNotificationSession getFamilyNotificationSession(FamilyReceiver familyReceiver,
 Proxy proxy)
                                                throws OperationFailedException

Gets the OsidSession associated with the family notification service.

Parameters:

familyReceiver - the receiver

proxy - a proxy

Returns:

a FamilyNotificationSession

Throws:

NullArgumentException - familyReceiver or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFamilyNotification() is false

Compliance:

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

getFamilyHierarchySession

FamilyHierarchySession getFamilyHierarchySession(Proxy proxy)
                                          throws OperationFailedException

Gets the OsidSession associated with the family hierarchy service.

Parameters:

proxy - a proxy

Returns:

a FamilyHierarchySession for families

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFamilyHierarchy() is false

Compliance:

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

getFamilyHierarchyDesignSession

FamilyHierarchyDesignSession getFamilyHierarchyDesignSession(Proxy proxy)
                                                      throws OperationFailedException

Gets the OsidSession associated with the family hierarchy design service.

Parameters:

proxy - a proxy

Returns:

a HierarchyDesignSession for families

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFamilyHierarchyDesign() is false

Compliance:

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

getRelationshipBatchProxyManager

RelationshipBatchProxyManager getRelationshipBatchProxyManager()
                                                        throws OperationFailedException

Gets the relationship batch proxy manager.

Returns:

a RelationshipBatchProxyManager

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipRules() is false

Compliance:

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

getRelationshipRulesProxyManager

RelationshipRulesProxyManager getRelationshipRulesProxyManager()
                                                        throws OperationFailedException

Gets the relationship rules proxy manager.

Returns:

a RelationshipRulesProxyManager

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsRelationshipRules() is false

Compliance:

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