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

RelationshipProxyManager may be accessed by multiple processing threads.

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, getReleaseDate, getVersion, supportsJournalBranching, supportsJournalRollback, supportsOSIDVersion

Methods inherited from interface OsidProxyManager

close

Methods inherited from interface OsidProxyManager

changeBranch, getProxy, getProxyCondition, initialize, rollbackService

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

Methods inherited from interface Sourceable

getBranding, getBrandingIds, getLicense, getProvider, getProviderId

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}.