org.osid.relationship

Interface RelationshipProxyManager

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, OsidProfile, 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

Methods

Modifier and Type	Method and 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 org.osid.OsidProxyManager

changeBranch, initialize, rollbackService

Methods inherited from interface org.osid.binding.java.OsidProxyManager

close

Methods inherited from interface java.io.Closeable

close

Methods inherited from interface org.osid.relationship.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 org.osid.OsidProfile

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

Methods inherited from interface org.osid.Sourceable

getBranding, getBrandingIds, getLicense, getProvider, getProviderId

Method Detail

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 supportsRelationshipLookup() is 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 supportsRelationshipLookup() and supportsVisibleFederation() are 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 supportsRelationshipQuery() is 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 supportsRelationshipQuery() and supportsVisibleFederation() are 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 supportsRelationshipSearch() is 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 supportsRelationshipSearch() and supportsVisibleFederation() are 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 supportsRelationshipAdmin() is 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 supportsRelationshipAdmin() and supportsVisibleFederation() are 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 supportsRelationshipNotification() is 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 supportsRelationshipNotification() and supportsVisibleFederation() are 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 supportsRelationshipFamily() is 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 supportsRelationshipFamilyAssignment() is 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 supportsRelationshipSmartFamily() is 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 supportsFamilyLookup() is 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 supportsFamilQuery() is 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 supportsFamilySearch() is 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 supportsFamilyAdmin() is 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 supportsFamilyNotification() is 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 supportsFamilyHierarchy() is 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 supportsFamilyHierarchyDesign() is 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 supportsRelationshipRules() is 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 supportsRelationshipRules() is true.