org.osid.provisioning

Interface MySupplierSession

All Superinterfaces:

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

public interface MySupplierSession
extends OsidSession

This session defines methods for retrieving provisions supplied by the resource related to the authenticated agent.

This lookup session defines several views:

• effective provision view: All lookup methods return provisions and requests where the current date falls in between the effective dates inclusive.
• any effective provision view: Provisions and requests of any effective date are returned from methods.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canLookupMyProvisions() Tests if this user can perform Provisions lookups.
Distributor	getDistributor() Gets the Distributor associated with this session.
Id	getDistributorId() Gets the Distributor Id associated with this session.
PoolList	getMyPools() Gets all the pools in which the resource related to the authenticated agent is a part.
ProvisionableList	getMyProvisionables() Gets all the provisionables in which the resource related to the authenticated agent.
ProvisionList	getMyProvisions() Gets the provisions for the resource related to this agent.
void	useAnyEffectiveProvisionView() All provisionables requests and pools of any effective dates are returned by methods in this session.
void	useEffectiveProvisionView() Only provisionables requests and pools whose effective dates are current are returned by methods in this session.

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

getDistributorId

Id getDistributorId()

Gets the Distributor Id associated with this session.

Returns:

the Distributor Id associated with this session

Compliance:

mandatory - This method must be implemented.

getDistributor

Distributor getDistributor()
                           throws OperationFailedException,
                                  PermissionDeniedException

Gets the Distributor associated with this session.

Returns:

the distributor

Throws:

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

canLookupMyProvisions

boolean canLookupMyProvisions()

Tests if this user can perform Provisions 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 not offer lookup operations to unauthorized users.

Returns:

false if lookup methods are not authorized, true otherwise

Compliance:

mandatory - This method must be implemented.

useEffectiveProvisionView

void useEffectiveProvisionView()

Only provisionables requests and pools whose effective dates are current are returned by methods in this session.

Compliance:

mandatory - This method is must be implemented.

useAnyEffectiveProvisionView

void useAnyEffectiveProvisionView()

All provisionables requests and pools of any effective dates are returned by methods in this session.

Compliance:

mandatory - This method is must be implemented.

getMyProvisions

ProvisionList getMyProvisions()
                              throws OperationFailedException,
                                     PermissionDeniedException

Gets the provisions for the resource related to this agent.

Returns:

the returned ProvisionList

Throws:

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getMyPools

PoolList getMyPools()
                    throws OperationFailedException,
                           PermissionDeniedException

Gets all the pools in which the resource related to the authenticated agent is a part.

Returns:

the returned Pool list

Throws:

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.

getMyProvisionables

ProvisionableList getMyProvisionables()
                                      throws OperationFailedException,
                                             PermissionDeniedException

Gets all the provisionables in which the resource related to the authenticated agent.

Returns:

the returned Provisionable list

Throws:

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure

Compliance:

mandatory - This method must be implemented.