org.osid.offering.rules

Interface OfferingConstrainerLookupSession

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, OsidSession

public interface OfferingConstrainerLookupSession
extends OsidSession

This session provides methods for retrieving OfferingConstrainers.

This session defines views that offer differing behaviors when retrieving multiple objects.

• comparative view: elements may be silently omitted or re-ordered
• plenary view: provides a complete set or is an error condition
• isolated catalogue view: All offering constrainer methods in this session operate, retrieve and pertain to offering constrainer defined explicitly in the current catalogue. Using an isolated view is useful for managing OfferingConstrainers with the OfferingConstrainerAdminSession.
• federated catalogue view: All offering constrainer methods in this session operate, retrieve and pertain to all offering constrainer defined in this catalogue and any other offering constrainer implicitly available in this catalogue through catalogue inheritence.
• active offering constrainer view: All offering constrainer lookup methods return active offering constrainers.
• any status offering constrainer view: CanonicalUnit constrainers of any active or inactive status are returned from methods.

Generally, the comparative view should be used for most applications as it permits operation even if there is data that cannot be accessed. The methods useFederatedDistributorView() and useIsolatedDistributorView() behave as a radio group and one should be selected before invoking the methods in this session.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canLookupOfferingConstrainers() Tests if this user can perform OfferingConstrainers lookups.
Catalogue	getCatalogue() Gets the Catalogue associated with this session.
Id	getCatalogueId() Gets the Catalogue Id associated with this session.
OfferingConstrainer	getOfferingConstrainer(Id offeringConstrainerId) Gets the OfferingConstrainer specified by its Id.
OfferingConstrainerList	getOfferingConstrainers() Gets all OfferingConstrainers.
OfferingConstrainerList	getOfferingConstrainersByGenusType(Type offeringConstrainerGenusType) Gets an OfferingConstrainerList corresponding to the given offering constrainer genus Type which does not include offering constrainer of genus types derived from the specified Type.
OfferingConstrainerList	getOfferingConstrainersByIds(IdList offeringConstrainerIds) Gets an OfferingConstrainerList corresponding to the given IdList.
OfferingConstrainerList	getOfferingConstrainersByParentGenusType(Type offeringConstrainerGenusType) Gets an OfferingConstrainerList corresponding to the given offering constrainer genus Type and include any additional offering constrainer with genus types derived from the specified Type.
OfferingConstrainerList	getOfferingConstrainersByRecordType(Type offeringConstrainerRecordType) Gets an OfferingConstrainerList containing the given offering constrainer record Type.
void	useActiveOfferingConstrainerView() Only active offering constrainers are returned by methods in this session.
void	useAnyStatusOfferingConstrainerView() All active and inactive offering constrainers are returned by methods in this session.
void	useComparativeOfferingConstrainerView() The returns from the lookup methods may omit or translate elements based on this session, such as authorization, and not result in an error.
void	useFederatedCatalogueView() Federates the view for methods in this session.
void	useIsolatedCatalogueView() Isolates the view for methods in this session.
void	usePlenaryOfferingConstrainerView() A complete view of the OfferingConstrainer returns is desired.

Methods inherited from interface org.osid.OsidSession

getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions

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

close

Methods inherited from interface java.io.Closeable

close

Method Detail

getCatalogueId

Id getCatalogueId()

Gets the Catalogue Id associated with this session.

Returns:

the Catalogue Id associated with this session

Compliance:

mandatory - This method must be implemented.

getCatalogue

Catalogue getCatalogue()
                       throws OperationFailedException,
                              PermissionDeniedException

Gets the Catalogue associated with this session.

Returns:

the catalogue

Throws:

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

canLookupOfferingConstrainers

boolean canLookupOfferingConstrainers()

Tests if this user can perform OfferingConstrainers lookups. A return of true does not guarantee successful authorization. A return of false indicates that it is known all methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer lookup operations to unauthorized users.

Returns:

false if lookup methods are not authorized, true otherwise

Compliance:

mandatory - This method must be implemented.

useComparativeOfferingConstrainerView

void useComparativeOfferingConstrainerView()

The returns from the lookup methods may omit or translate elements based on this session, such as authorization, and not result in an error. This view is used when greater interoperability is desired at the expense of precision.

Compliance:

mandatory - This method is must be implemented.

usePlenaryOfferingConstrainerView

void usePlenaryOfferingConstrainerView()

A complete view of the OfferingConstrainer returns is desired. Methods will return what is requested or result in an error. This view is used when greater precision is desired at the expense of interoperability.

Compliance:

mandatory - This method is must be implemented.

useFederatedCatalogueView

void useFederatedCatalogueView()

Federates the view for methods in this session. A federated view will include offering constrainer in catalogues which are children of this catalogue in the catalogue hierarchy.

Compliance:

mandatory - This method is must be implemented.

useIsolatedCatalogueView

void useIsolatedCatalogueView()

Isolates the view for methods in this session. An isolated view restricts lookups to this catalogue only.

Compliance:

mandatory - This method is must be implemented.

useActiveOfferingConstrainerView

void useActiveOfferingConstrainerView()

Only active offering constrainers are returned by methods in this session.

Compliance:

mandatory - This method is must be implemented.

useAnyStatusOfferingConstrainerView

void useAnyStatusOfferingConstrainerView()

All active and inactive offering constrainers are returned by methods in this session.

Compliance:

mandatory - This method is must be implemented.

getOfferingConstrainer

OfferingConstrainer getOfferingConstrainer(Id offeringConstrainerId)
                                           throws NotFoundException,
                                                  OperationFailedException,
                                                  PermissionDeniedException

Gets the OfferingConstrainer specified by its Id. In plenary mode, the exact Id is found or a NOT_FOUND results. Otherwise, the returned OfferingConstrainer may have a different Id than requested, such as the case where a duplicate Id was assigned to an OfferingConstrainer and retained for compatibility. In active mode, offering constrainers are returned that are currently active. In any status mode, active and inactive offering constrainers are returned.

Parameters:

offeringConstrainerId - Id of the OfferingConstrainer

Returns:

the offering constrainer

Throws:

NotFoundException - offeringConstrainerId not found

NullArgumentException - offeringConstrainerId is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method is must be implemented.

getOfferingConstrainersByIds

OfferingConstrainerList getOfferingConstrainersByIds(IdList offeringConstrainerIds)
                                                     throws NotFoundException,
                                                            OperationFailedException,
                                                            PermissionDeniedException

Gets an OfferingConstrainerList corresponding to the given IdList. In plenary mode, the returned list contains all of the offering constrainer specified in the Id list, in the order of the list, including duplicates, or an error results if an Id in the supplied list is not found or inaccessible. Otherwise, inaccessible OfferingConstrainers may be omitted from the list and may present the elements in any order including returning a unique set. In active mode, offering constrainers are returned that are currently active. In any status mode, active and inactive offering constrainers are returned.

Parameters:

offeringConstrainerIds - the list of Ids to retrieve

Returns:

the returned OfferingConstrainer list

Throws:

NotFoundException - an Id was not found

NullArgumentException - offeringConstrainerIds is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getOfferingConstrainersByGenusType

OfferingConstrainerList getOfferingConstrainersByGenusType(Type offeringConstrainerGenusType)
                                                           throws OperationFailedException,
                                                                  PermissionDeniedException

Gets an OfferingConstrainerList corresponding to the given offering constrainer genus Type which does not include offering constrainer of genus types derived from the specified Type. In plenary mode, the returned list contains all known offering constrainer or an error results. Otherwise, the returned list may contain only those offering constrainer that are accessible through this session. In active mode, offering constrainers are returned that are currently active. In any status mode, active and inactive offering constrainers are returned.

Parameters:

offeringConstrainerGenusType - an offering constrainer genus type

Returns:

the returned OfferingConstrainer list

Throws:

NullArgumentException - offeringConstrainerGenusType is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getOfferingConstrainersByParentGenusType

OfferingConstrainerList getOfferingConstrainersByParentGenusType(Type offeringConstrainerGenusType)
                                                                 throws OperationFailedException,
                                                                        PermissionDeniedException

Gets an OfferingConstrainerList corresponding to the given offering constrainer genus Type and include any additional offering constrainer with genus types derived from the specified Type. In plenary mode, the returned list contains all known offering constrainer or an error results. Otherwise, the returned list may contain only those offering constrainer that are accessible through this session. In active mode, offering constrainers are returned that are currently active. In any status mode, active and inactive offering constrainers are returned.

Parameters:

offeringConstrainerGenusType - an offering constrainer genus type

Returns:

the returned OfferingConstrainer list

Throws:

NullArgumentException - offeringConstrainerGenusType is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getOfferingConstrainersByRecordType

OfferingConstrainerList getOfferingConstrainersByRecordType(Type offeringConstrainerRecordType)
                                                            throws OperationFailedException,
                                                                   PermissionDeniedException

Gets an OfferingConstrainerList containing the given offering constrainer record Type. In plenary mode, the returned list contains all known offering constrainer or an error results. Otherwise, the returned list may contain only those offering constrainer that are accessible through this session. In active mode, offering constrainers are returned that are currently active. In any status mode, active and inactive offering constrainers are returned.

Parameters:

offeringConstrainerRecordType - an offering constrainer record type

Returns:

the returned OfferingConstrainer list

Throws:

NullArgumentException - offeringConstrainerRecordType is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getOfferingConstrainers

OfferingConstrainerList getOfferingConstrainers()
                                                throws OperationFailedException,
                                                       PermissionDeniedException

Gets all OfferingConstrainers. In plenary mode, the returned list contains all known offering constrainer or an error results. Otherwise, the returned list may contain only those offering constrainer that are accessible through this session. In active mode, offering constrainers are returned that are currently active. In any status mode, active and inactive offering constrainers are returned.

Returns:

the returned OfferingConstrainer list

Throws:

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.