org.osid.filing.allocation

Interface FilingAllocationProxyManager

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, FilingAllocationProfile, OsidProfile, OsidProxyManager, Sourceable

public interface FilingAllocationProxyManager
extends OsidProxyManager, FilingAllocationProfile

The filing allocation manager provides access sessions to allocations. Methods in this manager support the passing of a Proxy to pass information from server environments. The sessions included in this manager are:

• AllocationSession: a session for accessing usage information and quotas for the current user
• AllocationLookupSession: a session for accessing usage information and quotas
• AllocationAdminSession a session for assigning quotas
• AllocationNotificationSession: a session for subscribing to usage warnings and quota changes

Method Summary

Methods

Modifier and Type	Method and Description
AllocationAdminSession	getAllocationAdminSession(Proxy proxy) Gets the session for assigning quotas.
AllocationAdminSession	getAllocationAdminSessionForDirectory(java.lang.String directoryPath, Proxy proxy) Gets the session for assigning quotas for the given directory.
AllocationLookupSession	getAllocationLookupSession(Proxy proxy) Gets the session for accessing usage and quotas.
AllocationLookupSession	getAllocationLookupSessionForDirectory(java.lang.String directoryPath, Proxy proxy) Gets the session for accessing usage and quotas for a given directory.
AllocationNotificationSession	getAllocationNotificationSession(AllocationReceiver allocationReceiver, Proxy proxy) Gets the session for receiving messages about changes to directories.
AllocationNotificationSession	getAllocationNotificationSessionForDirectory(AllocationReceiver allocationReceiver, java.lang.String directoryPath, Proxy proxy) Gets the session for receiving messages about usage warnings and quota changes for the given directory.
AllocationSession	getAllocationSession(Proxy proxy) Gets the session for accessing usage and quotas.
AllocationSession	getAllocationSessionForDirectory(java.lang.String directoryPath, Proxy proxy) Gets the session for accessing usage and quotas for a given directory.

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.filing.allocation.FilingAllocationProfile

getAllocationRecordTypes, supportsAllocation, supportsAllocationAdmin, supportsAllocationLookup, supportsAllocationNotification, supportsAllocationRecordType, 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

getAllocationSession

AllocationSession getAllocationSession(Proxy proxy)
                                       throws OperationFailedException

Gets the session for accessing usage and quotas.

Parameters:

proxy - a proxy

Returns:

an AllocationSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsAllocation() is false

Compliance:

optional - This method must be implemented if supportsAllocation() is true.

getAllocationSessionForDirectory

AllocationSession getAllocationSessionForDirectory(java.lang.String directoryPath,
                                                 Proxy proxy)
                                                   throws NotFoundException,
                                                          OperationFailedException

Gets the session for accessing usage and quotas for a given directory. If the path is an alias, the target directory is used. The path indicates the file alias and the real path indicates the target directory.

Parameters:

directoryPath - the pathname to the directory

proxy - a proxy

Returns:

an AllocationSession

Throws:

InvalidArgumentException - directoryPath is not a directory or an alias to a directory

NotFoundException - directoryPath is not found

NullArgumentException - directoryPath or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsAllocation() is false

Compliance:

optional - This method must be implemented if supportsAllocation() and supportsVisibleFederation() are true.

getAllocationLookupSession

AllocationLookupSession getAllocationLookupSession(Proxy proxy)
                                                   throws OperationFailedException

Gets the session for accessing usage and quotas.

Parameters:

proxy - a proxy

Returns:

an AllocationLookupSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsAllocationLookup() is false

Compliance:

optional - This method must be implemented if supportsAllocationLookup() is true.

getAllocationLookupSessionForDirectory

AllocationLookupSession getAllocationLookupSessionForDirectory(java.lang.String directoryPath,
                                                             Proxy proxy)
                                                               throws NotFoundException,
                                                                      OperationFailedException

Gets the session for accessing usage and quotas for a given directory. If the path is an alias, the target directory is used. The path indicates the file alias and the real path indicates the target directory.

Parameters:

directoryPath - the pathname to the directory

proxy - a proxy

Returns:

an AllocationLookupSession

Throws:

InvalidArgumentException - directoryPath is not a directory or an alias to a directory

NotFoundException - directoryPath is not found

NullArgumentException - directoryPath or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsAllocationLookup() is false

Compliance:

optional - This method must be implemented if supportsAllocationLookup() and supportsVisibleFederation() are true.

getAllocationAdminSession

AllocationAdminSession getAllocationAdminSession(Proxy proxy)
                                                 throws OperationFailedException

Gets the session for assigning quotas.

Parameters:

proxy - a proxy

Returns:

an AllocationAdminSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsAllocationAdmin() is false

Compliance:

optional - This method must be implemented if supportsAllocationAdmin() is true.

getAllocationAdminSessionForDirectory

AllocationAdminSession getAllocationAdminSessionForDirectory(java.lang.String directoryPath,
                                                           Proxy proxy)
                                                             throws NotFoundException,
                                                                    OperationFailedException

Gets the session for assigning quotas for the given directory. If the path is an alias, the target directory is used. The path indicates the file alias and the real path indicates the target directory.

Parameters:

directoryPath - the pathname to the directory

proxy - a proxy

Returns:

an AllocationAdminSession

Throws:

InvalidArgumentException - directoryPath is not a directory or an alias to a directory

NotFoundException - directoryPath is not found

NullArgumentException - directoryPath or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsAllocationAdmin() is false

Compliance:

optional - This method must be implemented if supportsAllocationAdmin() and supportsVisibleFederation() are true.

getAllocationNotificationSession

AllocationNotificationSession getAllocationNotificationSession(AllocationReceiver allocationReceiver,
                                                             Proxy proxy)
                                                               throws OperationFailedException

Gets the session for receiving messages about changes to directories.

Parameters:

allocationReceiver - the notification callback

proxy - a proxy

Returns:

an AllocationNotificationSession

Throws:

NullArgumentException - allocationReceiver or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsAllocationNotification() is false

Compliance:

optional - This method must be implemented if supportsDirectoryNotification() is true.

getAllocationNotificationSessionForDirectory

AllocationNotificationSession getAllocationNotificationSessionForDirectory(AllocationReceiver allocationReceiver,
                                                                         java.lang.String directoryPath,
                                                                         Proxy proxy)
                                                                           throws NotFoundException,
                                                                                  OperationFailedException

Gets the session for receiving messages about usage warnings and quota changes for the given directory. If the path is an alias, the target directory is used. The path indicates the file alias and the real path indicates the target directory.

Parameters:

allocationReceiver - the notification callback

directoryPath - the pathname to the directory

proxy - a proxy

Returns:

an AllocationNotificationSession

Throws:

InvalidArgumentException - directoryPath is not a directory or an alias to a directory

NotFoundException - directoryPath is not found

NullArgumentException - allocationReceiver, directoryPath or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsAllocationNotification() is false

Compliance:

optional - This method must be implemented if supportsAllocationNotification() and supportsVisibleFederation() are true.