Interface FilingProxyManager

All Superinterfaces:

AutoCloseable, Closeable, FilingProfile, OsidProfile, OsidProxyManager, OsidProxyManager, Sourceable

public interface FilingProxyManager
extends OsidProxyManager, FilingProfile

The filing manager provides access sessions to retrieve and manage files and directories. A manager may support federation in that files and directories can be accessed by a specified path. Methods in this manager support the passing of a Proxy to pass information from server environments. The sessions included in this manager are:

• FileSystemSession: a session for traversing file systems
• FileSystemManagementSession: a session for performing operations across directories
• FileContentSession: a basic session for reading and writing a file
• FileLookupSession: a session for looking up files
• FileQuerySession: a session for searching for files
• FileSearchSession: a session for searching for files
• FileNotificationSession: a session for subscribing to changes in files
• FileSmartDirectorySession: a session for managing smart directories of files
• DirectoryLookupSession: a session for looking up a directories
• DirectorQuerySession: a session for searching for directories
• DirectorySearchSession: a session for searching for directories
• DirectoryNotificationSession: a session for subscribing to changes in directories

FilingProxyManager may be accessed by multiple processing threads.

Method Summary

Modifier and Type	Method	Description
DirectoryAdminSession	getDirectoryAdminSession(Proxy proxy)	Gets the session for creating and removing files.
DirectoryAdminSession	getDirectoryAdminSessionForDirectory(Id directoryId, Proxy proxy)	Gets the session for searching for creating and removing files in the given directory.
DirectoryLookupSession	getDirectoryLookupSession(Proxy proxy)	Gets the session for examining directories.
DirectoryLookupSession	getDirectoryLookupSessionForDirectory(Id directoryId, Proxy proxy)	Gets the session for examining a given directory.
DirectoryNotificationSession	getDirectoryNotificationSession(DirectoryReceiver directoryReceiver, Proxy proxy)	Gets the session for receiving messages about changes to directories.
DirectoryNotificationSession	getDirectoryNotificationSessionForDirectory(DirectoryReceiver directoryReceiver, Id directoryId, Proxy proxy)	Gets the session for receiving messages about changes to directories in the given directory.
DirectoryQuerySession	getDirectoryQuerySession(Proxy proxy)	Gets the session for querying directories.
DirectoryQuerySession	getDirectoryQuerySessionForDirectory(Id directoryId, Proxy proxy)	Gets the session for querying directories within a given directory.
DirectorySearchSession	getDirectorySearchSession(Proxy proxy)	Gets the session for searching for directories.
DirectorySearchSession	getDirectorySearchSessionForDirectory(Id directoryId, Proxy proxy)	Gets the session for searching for directories within a given directory.
FileContentSession	getFileContentSession(Proxy proxy)	Gets the session for reading and writing files.
FileContentSession	getFileContentSessionForDirectory(Id directoryId, Proxy proxy)	Gets the session for reading and writing files for the given path.
FileContentSession	getFileContentSessionForPath(String path, Proxy proxy)	Gets the session for reading and writing files for the given path.
FileLookupSession	getFileLookupSession(Proxy proxy)	Gets the session for looking up files.
FileLookupSession	getFileLookupSessionForDirectory(Id directoryId, Proxy proxy)	Gets a file lookup session for the specified directory.
FileNotificationSession	getFileNotificationSession(FileReceiver fileReceiver, Proxy proxy)	Gets the session for receiving messages about changes to files.
FileNotificationSession	getFileNotificationSessionForDirectory(FileReceiver fileReceiver, Id directoryId, Proxy proxy)	Gets a file notification session for the specified directory.
FileQuerySession	getFileQuerySession(Proxy proxy)	Gets the session for querying files.
FileQuerySession	getFileQuerySessionForDirectory(Id directoryId, Proxy proxy)	Gets a file query session for the specified directory.
FileSearchSession	getFileSearchSession(Proxy proxy)	Gets the session for searching for files.
FileSearchSession	getFileSearchSessionForDirectory(Id directoryId, Proxy proxy)	Gets a file search session for the specified directory.
FileSmartDirectorySession	getFileSmartDirectorySession(Id directoryId, Proxy proxy)	Gets the session for managing dynamic diectories.
FileSystemManagementSession	getFileSystemManagementSession(Proxy proxy)	Gets the session for manipulating file systems.
FileSystemManagementSession	getFileSystemManagementSessionForDirectory(Id directoryId, Proxy proxy)	Gets the session for manipulating files for the given path.
FileSystemManagementSession	getFileSystemManagementSessionForPath(String path, Proxy proxy)	Gets the session for manipulating files for the given path.
FileSystemSession	getFileSystemSession(Proxy proxy)	Gets the session for examining file systems.
FileSystemSession	getFileSystemSessionForDirectory(Id directoryId, Proxy proxy)	Gets the session for exmaning file systems for the given directory.
FileSystemSession	getFileSystemSessionForPath(String path, Proxy proxy)	Gets the session for exmaning file systems for the given path.
FilingAllocationProxyManager	getFilingAllocationProxyManager()	Gets the FilingAllocationProxyManager.

Methods inherited from interface Closeable

close

Methods inherited from interface FilingProfile

getDirectoryRecordTypes, getDirectorySearchRecordTypes, getFileRecordTypes, getFileSearchRecordTypes, supportsDirectoryAdmin, supportsDirectoryLookup, supportsDirectoryNotification, supportsDirectoryQuery, supportsDirectoryRecordType, supportsDirectorySearch, supportsDirectorySearchRecordType, supportsFileContent, supportsFileLookup, supportsFileNotification, supportsFileQuery, supportsFileRecordType, supportsFileSearch, supportsFileSearchRecordType, supportsFileSmartDirectory, supportsFileSystem, supportsFileSystemManagement, supportsFilingAllocation, supportsFilingManagement, supportsVisibleFederation

Methods inherited from interface OsidProfile

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

Methods inherited from interface OsidProxyManager

close

Methods inherited from interface OsidProxyManager

changeBranch, getProxy, getProxyCondition, initialize, rollbackService

Methods inherited from interface Sourceable

getBranding, getBrandingIds, getLicense, getProvider, getProviderId

Method Details

getFileSystemSession

FileSystemSession getFileSystemSession(Proxy proxy)
                                throws OperationFailedException

Gets the session for examining file systems.

Parameters:

proxy - a proxy

Returns:

a FileSystemSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileSystem() is false

Compliance:

optional - This method must be implemented if {@code supportsFileSystem()} is {@code true}.

getFileSystemSessionForPath

FileSystemSession getFileSystemSessionForPath(String path,
 Proxy proxy)
                                       throws NotFoundException,
OperationFailedException

Gets the session for exmaning file systems for the given path.

Parameters:

path - the path to a directory

proxy - a proxy

Returns:

a FileSystemSession

Throws:

NotFoundException - path is not found or is not a directory

NullArgumentException - path or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileSystem() is false

Compliance:

optional - This method must be implemented if {@code supportsFileSystem()} and {@code supportsVisibleFederation()} are {@code true}.

getFileSystemSessionForDirectory

FileSystemSession getFileSystemSessionForDirectory(Id directoryId,
 Proxy proxy)
                                            throws NotFoundException,
OperationFailedException

Gets the session for exmaning file systems for the given directory.

Parameters:

directoryId - the Id of a directory

proxy - a proxy

Returns:

a FileSystemSession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileSystem() is false

Compliance:

optional - This method must be implemented if {@code supportsFileSystem()} and {@code supportsVisibleFederation()} are {@code true}.

getFileSystemManagementSession

FileSystemManagementSession getFileSystemManagementSession(Proxy proxy)
                                                    throws OperationFailedException

Gets the session for manipulating file systems.

Parameters:

proxy - a proxy

Returns:

a FileSystemManagementSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileSystemManagement() is false

Compliance:

optional - This method must be implemented if {@code supportsFileSystemManagement()} is {@code true}.

getFileSystemManagementSessionForPath

FileSystemManagementSession getFileSystemManagementSessionForPath(String path,
 Proxy proxy)
                                                           throws NotFoundException,
OperationFailedException

Gets the session for manipulating files for the given path.

Parameters:

path - the path to a directory

proxy - a proxy

Returns:

a FileSystemManagementSession

Throws:

NotFoundException - path is not found or is not a directory

NullArgumentException - path or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileSystemManagement() is false

Compliance:

optional - This method must be implemented if {@code supportsFileSystemManagement()} and {@code supportsVisibleFederation()} are {@code true}.

getFileSystemManagementSessionForDirectory

FileSystemManagementSession getFileSystemManagementSessionForDirectory(Id directoryId,
 Proxy proxy)
                                                                throws NotFoundException,
OperationFailedException

Gets the session for manipulating files for the given path.

Parameters:

directoryId - the Id of a directory

proxy - a proxy

Returns:

a FileSystemManagementSession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileSystemManagement() is false

Compliance:

optional - This method must be implemented if {@code supportsFileSystemManagement()} and {@code supportsVisibleFederation()} are {@code true}.

getFileContentSession

FileContentSession getFileContentSession(Proxy proxy)
                                  throws OperationFailedException

Gets the session for reading and writing files.

Parameters:

proxy - a proxy

Returns:

a FileContentSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileContent() is false

Compliance:

optional - This method must be implemented if {@code supportsFileContent()} is {@code true}.

getFileContentSessionForPath

FileContentSession getFileContentSessionForPath(String path,
 Proxy proxy)
                                         throws NotFoundException,
OperationFailedException

Gets the session for reading and writing files for the given path.

Parameters:

path - the path to a directory

proxy - a proxy

Returns:

a FileContentSession

Throws:

NotFoundException - path is not found or is not a directory

NullArgumentException - path or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileContent() is false

Compliance:

optional - This method must be implemented if {@code supportsFileContent()} and {@code supportsVisibleFederation()} are {@code true}.

getFileContentSessionForDirectory

FileContentSession getFileContentSessionForDirectory(Id directoryId,
 Proxy proxy)
                                              throws NotFoundException,
OperationFailedException

Gets the session for reading and writing files for the given path.

Parameters:

directoryId - the Id of a directory

proxy - a proxy

Returns:

a FileContentSession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileContent() is false

Compliance:

optional - This method must be implemented if {@code supportsFileContent()} and {@code supportsVisibleFederation()} are {@code true}.

getFileLookupSession

FileLookupSession getFileLookupSession(Proxy proxy)
                                throws OperationFailedException

Gets the session for looking up files.

Parameters:

proxy - a proxy

Returns:

the FileLookupSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileLookup() is false

Compliance:

optional - This method must be implemented if {@code supportsFileLookup()} is {@code true}.

getFileLookupSessionForDirectory

FileLookupSession getFileLookupSessionForDirectory(Id directoryId,
 Proxy proxy)
                                            throws NotFoundException,
OperationFailedException

Gets a file lookup session for the specified directory.

Parameters:

directoryId - the Id to the directory

proxy - a proxy

Returns:

a FileLookupSession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileLookup() is false

Compliance:

optional - This method must be implemented if {@code supportsFileLookup()} and {@code supportsVisibleFederation()} are {@code true}.

getFileQuerySession

FileQuerySession getFileQuerySession(Proxy proxy)
                              throws OperationFailedException

Gets the session for querying files.

Parameters:

proxy - a proxy

Returns:

the FileQuerySession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileQuery() is false

Compliance:

optional - This method must be implemented if {@code supportsFileQuery()} is {@code true}.

getFileQuerySessionForDirectory

FileQuerySession getFileQuerySessionForDirectory(Id directoryId,
 Proxy proxy)
                                          throws NotFoundException,
OperationFailedException

Gets a file query session for the specified directory.

Parameters:

directoryId - the Id to the directory

proxy - a proxy

Returns:

a FileQuerySession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileQuery() is false

Compliance:

optional - This method must be implemented if {@code supportsFileQuery()} and {@code supportsVisibleFederation()} are {@code true}.

getFileSearchSession

FileSearchSession getFileSearchSession(Proxy proxy)
                                throws OperationFailedException

Gets the session for searching for files.

Parameters:

proxy - a proxy

Returns:

the FileSearchSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileSearch() is false

Compliance:

optional - This method must be implemented if {@code supportsFileSearch()} is {@code true}.

getFileSearchSessionForDirectory

FileSearchSession getFileSearchSessionForDirectory(Id directoryId,
 Proxy proxy)
                                            throws NotFoundException,
OperationFailedException

Gets a file search session for the specified directory.

Parameters:

directoryId - the Id to the directory

proxy - a proxy

Returns:

a FileSearchSession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileSearch() is false

Compliance:

optional - This method must be implemented if {@code supportsFileSearch()} and {@code supportsVisibleFederation()} are {@code true}.

getFileNotificationSession

FileNotificationSession getFileNotificationSession(FileReceiver fileReceiver,
 Proxy proxy)
                                            throws OperationFailedException

Gets the session for receiving messages about changes to files.

Parameters:

fileReceiver - the notification callback

proxy - a proxy

Returns:

a FileNotificationSession

Throws:

NullArgumentException - fileReceiver or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileNotification() is false

Compliance:

optional - This method must be implemented if {@code supportsFileNotification()} is {@code true}.

getFileNotificationSessionForDirectory

FileNotificationSession getFileNotificationSessionForDirectory(FileReceiver fileReceiver,
 Id directoryId,
 Proxy proxy)
                                                        throws NotFoundException,
OperationFailedException

Gets a file notification session for the specified directory.

Parameters:

fileReceiver - the notification callback

directoryId - the Id to the directory

proxy - a proxy

Returns:

a FileNotificationSession

Throws:

NotFoundException - directoryPath is not found

NullArgumentException - fileReceiver, directoryId, or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileNotification() is false

Compliance:

optional - This method must be implemented if {@code supportsFileNotification()} and {@code supportsVisibleFederation()} are {@code true}.

getFileSmartDirectorySession

FileSmartDirectorySession getFileSmartDirectorySession(Id directoryId,
 Proxy proxy)
                                                throws NotFoundException,
OperationFailedException

Gets the session for managing dynamic diectories.

Parameters:

directoryId - the Id to the directory

proxy - a proxy

Returns:

a FileSmartDirectorySession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsFileSmartDirectory() is false

Compliance:

optional - This method must be implemented if {@code supportsFileSmartDirectory()} and {@code supportsVisibleFederation()} are {@code true}.

getDirectoryLookupSession

DirectoryLookupSession getDirectoryLookupSession(Proxy proxy)
                                          throws OperationFailedException

Gets the session for examining directories.

Parameters:

proxy - a proxy

Returns:

a DirectoryLookupSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsDirectoryLookup() is false

Compliance:

optional - This method must be implemented if {@code supportsDirectoryLookup()} is {@code true}.

getDirectoryLookupSessionForDirectory

DirectoryLookupSession getDirectoryLookupSessionForDirectory(Id directoryId,
 Proxy proxy)
                                                      throws NotFoundException,
OperationFailedException

Gets the session for examining 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:

directoryId - the Id to the directory

proxy - a proxy

Returns:

a DirectoryLookupSession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsDirectoryLookup() is false

Compliance:

optional - This method must be implemented if {@code supportsDirectoryLookup()} and {@code supportsVisibleFederation()} are {@code true}.

getDirectoryQuerySession

DirectoryQuerySession getDirectoryQuerySession(Proxy proxy)
                                        throws OperationFailedException

Gets the session for querying directories.

Parameters:

proxy - a proxy

Returns:

a DirectoryQuerySession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsDirectoryQuery() is false

Compliance:

optional - This method must be implemented if {@code supportsDirectoryQuery()} is {@code true}.

getDirectoryQuerySessionForDirectory

DirectoryQuerySession getDirectoryQuerySessionForDirectory(Id directoryId,
 Proxy proxy)
                                                    throws NotFoundException,
OperationFailedException

Gets the session for querying directories within 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:

directoryId - the Id to the directory

proxy - a proxy

Returns:

a DirectoryQuerySession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsDirectoryQuery() is false

Compliance:

optional - This method must be implemented if {@code supportsDirectoryQuery()} and {@code supportsVisibleFederation()} are {@code true}.

getDirectorySearchSession

DirectorySearchSession getDirectorySearchSession(Proxy proxy)
                                          throws OperationFailedException

Gets the session for searching for directories.

Parameters:

proxy - a proxy

Returns:

a DirectorySearchSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsDirectorySearch() is false

Compliance:

optional - This method must be implemented if {@code supportsDirectorySearch()} is {@code true}.

getDirectorySearchSessionForDirectory

DirectorySearchSession getDirectorySearchSessionForDirectory(Id directoryId,
 Proxy proxy)
                                                      throws NotFoundException,
OperationFailedException

Gets the session for searching for directories within 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:

directoryId - the Id to the directory

proxy - a proxy

Returns:

a DirectorySearchSession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsDirectorySearch() is false

Compliance:

optional - This method must be implemented if {@code supportsDirectorySearch()} and {@code supportsVisibleFederation()} are {@code true}.

getDirectoryAdminSession

DirectoryAdminSession getDirectoryAdminSession(Proxy proxy)
                                        throws OperationFailedException

Gets the session for creating and removing files.

Parameters:

proxy - a proxy

Returns:

a DirectoryAdminSession

Throws:

NullArgumentException - proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsDirectoryAdmin() is false

Compliance:

optional - This method must be implemented if {@code supportsDirectoryAdmin()} is {@code true}.

getDirectoryAdminSessionForDirectory

DirectoryAdminSession getDirectoryAdminSessionForDirectory(Id directoryId,
 Proxy proxy)
                                                    throws NotFoundException,
OperationFailedException

Gets the session for searching for creating and removing files in 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:

directoryId - the Id to the directory

proxy - a proxy

Returns:

a DirectoryAdminSession

Throws:

NotFoundException - directoryId is not found

NullArgumentException - directoryId or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsDirectoryAdmin() is false

Compliance:

optional - This method must be implemented if {@code supportsDirectoryAdmin()} and {@code supportsVisibleFederation()} are {@code true}.

getDirectoryNotificationSession

DirectoryNotificationSession getDirectoryNotificationSession(DirectoryReceiver directoryReceiver,
 Proxy proxy)
                                                      throws OperationFailedException

Gets the session for receiving messages about changes to directories.

Parameters:

directoryReceiver - the notification callback

proxy - a proxy

Returns:

a DirectoryNotificationSession

Throws:

NullArgumentException - directoryReceiver or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsDirectoryNotification() is false

Compliance:

optional - This method must be implemented if {@code supportsDirectoryNotification()} is {@code true}.

getDirectoryNotificationSessionForDirectory

DirectoryNotificationSession getDirectoryNotificationSessionForDirectory(DirectoryReceiver directoryReceiver,
 Id directoryId,
 Proxy proxy)
                                                                  throws NotFoundException,
OperationFailedException

Gets the session for receiving messages about changes to directories in 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:

directoryReceiver - the notification callback

directoryId - the Id to the directory

proxy - a proxy

Returns:

a DirectoryNotificationSession

Throws:

NotFoundException - directoryPath is not found

NullArgumentException - directoryReceiver, directoryId, or proxy is null

OperationFailedException - unable to complete request

UnimplementedException - supportsDirectoryNotification() is false

Compliance:

optional - This method must be implemented if {@code supportsDirectoryNotification()} and {@code supportsVisibleFederation()} are {@code true}.

getFilingAllocationProxyManager

FilingAllocationProxyManager getFilingAllocationProxyManager()
                                                      throws OperationFailedException

Gets the FilingAllocationProxyManager.

Returns:

a FilingAllocationProxyManager

Throws:

OperationFailedException - unable to complete request

UnimplementedException - supportsFilingAllocation() is false

Compliance:

optional - This method must be implemented if {@code supportsFilingAllocation()} is {@code true}.