public interface OfferingCatalogueSession extends OsidSession
This session provides methods to retrieve Offering
to
Catalogue
mappings. An Offering
may appear
in multiple Catalogues.
Each Catalogue
may
have its own authorizations governing who is allowed to look at it.
This lookup session defines several views:
Modifier and Type | Method and Description |
---|---|
boolean |
canLookupOfferingCatalogueMappings()
Tests if this user can perform lookups of offering/catalogue mappings.
|
IdList |
getCatalogueIdsByOffering(Id offeringId)
Gets the list of
Catalogue Ids mapped to
an Offering. |
CatalogueList |
getCataloguesByOffering(Id offeringId)
Gets the list of
Catalogue objects mapped to an
Offering. |
IdList |
getOfferingIdsByCatalogue(Id catalogueId)
Gets the list of Offering Ids associated with a
Catalogue. |
IdList |
getOfferingIdsByCatalogues(IdList catalogueIds)
Gets the list of
Offering Ids corresponding to a list
of Catalogue objects. |
OfferingList |
getOfferingsByCatalogue(Id catalogueId)
Gets the list of
Offerings associated with a
Catalogue. |
OfferingList |
getOfferingsByCatalogues(IdList catalogueIds)
Gets the list of
Offerings corresponding to a list of
Catalogues. |
void |
useComparativeCatalogueView()
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 |
usePlenaryCatalogueView()
A complete view of the
Offering and Catalogue
returns is desired. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canLookupOfferingCatalogueMappings()
PERMISSION_DENIED.
This is intendedas
a hint to an application that may opt not to offer lookup operations
to unauthorized users. false
if looking up mappings is not authorized,
true
otherwisemandatory
- This method must be implemented. void useComparativeCatalogueView()
mandatory
- This method is must be implemented. void usePlenaryCatalogueView()
Offering
and Catalogue
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.mandatory
- This method is must be implemented. IdList getOfferingIdsByCatalogue(Id catalogueId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Catalogue.
catalogueId
- Id
of a Catalogues.
Ids
NotFoundException
- catalogueId
is not
foundNullArgumentException
- catalogueId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. OfferingList getOfferingsByCatalogue(Id catalogueId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Offerings
associated with a
Catalogue.
catalogueId
- Id
of a Catalogue
NotFoundException
- catalogueId
is not
foundNullArgumentException
- catalogueId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. IdList getOfferingIdsByCatalogues(IdList catalogueIds) throws OperationFailedException, PermissionDeniedException
Offering Ids
corresponding to a list
of Catalogue
objects.catalogueIds
- list of catalogue Ids
Ids
NullArgumentException
- catalogueIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. OfferingList getOfferingsByCatalogues(IdList catalogueIds) throws OperationFailedException, PermissionDeniedException
Offerings
corresponding to a list of
Catalogues.
catalogueIds
- list of catalogue Ids
NullArgumentException
- catalogueIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. IdList getCatalogueIdsByOffering(Id offeringId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Catalogue
Ids
mapped to
an Offering.
offeringId
- Id
of an Offering
Ids
NotFoundException
- offeringId
is not
foundNullArgumentException
- offeringId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CatalogueList getCataloguesByOffering(Id offeringId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Catalogue
objects mapped to an
Offering.
offeringId
- Id
of an Offering
NotFoundException
- offeringId
is not
foundNullArgumentException
- offeringId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.