Interface FilingProxyManager
- All Superinterfaces:
AutoCloseable, Closeable, FilingProfile, OsidProfile, OsidProxyManager, OsidProxyManager, Sourceable
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
-
Method Summary
Modifier and TypeMethodDescriptiongetDirectoryAdminSession(Proxy proxy) Gets the session for creating and removing files.getDirectoryAdminSessionForDirectory(Id directoryId, Proxy proxy) Gets the session for searching for creating and removing files in the given directory.getDirectoryLookupSession(Proxy proxy) Gets the session for examining directories.getDirectoryLookupSessionForDirectory(Id directoryId, Proxy proxy) Gets the session for examining a given directory.getDirectoryNotificationSession(DirectoryReceiver directoryReceiver, Proxy proxy) Gets the session for receiving messages about changes to directories.getDirectoryNotificationSessionForDirectory(DirectoryReceiver directoryReceiver, Id directoryId, Proxy proxy) Gets the session for receiving messages about changes to directories in the given directory.getDirectoryQuerySession(Proxy proxy) Gets the session for querying directories.getDirectoryQuerySessionForDirectory(Id directoryId, Proxy proxy) Gets the session for querying directories within a given directory.getDirectorySearchSession(Proxy proxy) Gets the session for searching for directories.getDirectorySearchSessionForDirectory(Id directoryId, Proxy proxy) Gets the session for searching for directories within a given directory.getFileContentSession(Proxy proxy) Gets the session for reading and writing files.getFileContentSessionForDirectory(Id directoryId, Proxy proxy) Gets the session for reading and writing files for the given path.getFileContentSessionForPath(String path, Proxy proxy) Gets the session for reading and writing files for the given path.getFileLookupSession(Proxy proxy) Gets the session for looking up files.getFileLookupSessionForDirectory(Id directoryId, Proxy proxy) Gets a file lookup session for the specified directory.getFileNotificationSession(FileReceiver fileReceiver, Proxy proxy) Gets the session for receiving messages about changes to files.getFileNotificationSessionForDirectory(FileReceiver fileReceiver, Id directoryId, Proxy proxy) Gets a file notification session for the specified directory.getFileQuerySession(Proxy proxy) Gets the session for querying files.getFileQuerySessionForDirectory(Id directoryId, Proxy proxy) Gets a file query session for the specified directory.getFileSearchSession(Proxy proxy) Gets the session for searching for files.getFileSearchSessionForDirectory(Id directoryId, Proxy proxy) Gets a file search session for the specified directory.getFileSmartDirectorySession(Id directoryId, Proxy proxy) Gets the session for managing dynamic diectories.Gets the session for manipulating file systems.getFileSystemManagementSessionForDirectory(Id directoryId, Proxy proxy) Gets the session for manipulating files for the given path.getFileSystemManagementSessionForPath(String path, Proxy proxy) Gets the session for manipulating files for the given path.getFileSystemSession(Proxy proxy) Gets the session for examining file systems.getFileSystemSessionForDirectory(Id directoryId, Proxy proxy) Gets the session for exmaning file systems for the given directory.getFileSystemSessionForPath(String path, Proxy proxy) Gets the session for exmaning file systems for the given path.Gets theFilingAllocationProxyManager.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, supportsVisibleFederationModifier and TypeMethodDescriptionGets the supported directory record types.Gets the supported directory search record types.Gets the supported file record types.Gets the supported file search record types.booleanTests if directory administration is supported.booleanTests if aDirectoryLookupSessionis supported.booleanTests if a directory notification service is supported.booleanTests if directory querying is supported.booleansupportsDirectoryRecordType(Type directoryRecordType) Tests if the given directory record type is supported.booleanTests if directory searching is supported.booleansupportsDirectorySearchRecordType(Type directorySearchRecordType) Tests if the given directory search record type is supported.booleanTests if aFileContentSessionis supported.booleanTests if file lookup is supported.booleanTests if file notification is supported.booleanTests if file querying is supported.booleansupportsFileRecordType(Type fileRecordType) Tests if the given file record type is supported.booleanTests if file searching is supported.booleansupportsFileSearchRecordType(Type fileSearchRecordType) Tests if the given file search record type is supported.booleanTests if managing smart directories is supported.booleanTests if aFileSystemSessionis supported.booleanTests if aFileSystemManagementSessionis supported.booleanTests if a filing allocation service is supported.booleanTests if a file management service is supported.booleanTests if directory federation is exposed.Methods inherited from interface OsidProfile
getBranch, getBranchId, getDescription, getDisplayName, getId, getLocales, getProxyRecordTypes, getReleaseDate, getVersion, supportsJournalBranching, supportsJournalRollback, supportsOSIDVersion, supportsProxyRecordTypeModifier and TypeMethodDescriptionGets this service branch.Gets theBranch Idrepresenting this service branch.Gets a description of this service implementation.Gets a display name for this service implementation.getId()Gets an identifier for this service implementation.Gets the locales supported in this service.Gets the proxy recordTypessupported in this service.Gets the date this service implementation was released.Gets the version of this service implementation.booleanTest for support of a journal branching service.booleanTest for support of a journaling rollback service.booleansupportsOSIDVersion(Version version) Test for support of an OSID specification version.booleansupportsProxyRecordType(Type proxyRecordType) Test for support of a proxy type.Methods inherited from interface OsidProxyManager
closeMethods inherited from interface OsidProxyManager
changeBranch, initialize, rollbackServiceModifier and TypeMethodDescriptionvoidchangeBranch(Id branchId, Proxy proxy) Changes the service branch.voidinitialize(OsidRuntimeManager runtime) Initializes this manager.rollbackService(Date rollbackTime, Proxy proxy) Rolls back this service to a point in time.Methods inherited from interface Sourceable
getBranding, getBrandingIds, getLicense, getProvider, getProviderIdModifier and TypeMethodDescriptionGets a branding, such as an image or logo, expressed using theAssetinterface.Gets the branding assetIds.Gets the terms of usage.Gets theResourcerepresenting the provider.Gets theIdof the provider.
-
Method Details
-
getFileSystemSession
Gets the session for examining file systems.- Parameters:
proxy- a proxy- Returns:
- a
FileSystemSession - Throws:
NullArgumentException-proxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileSystem()isfalse- 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 directoryproxy- a proxy- Returns:
- a
FileSystemSession - Throws:
NotFoundException-pathis not found or is not a directoryNullArgumentException-pathorproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileSystem()isfalse- 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- theIdof a directoryproxy- a proxy- Returns:
- a
FileSystemSession - Throws:
NotFoundException-directoryIdis not foundNullArgumentException-directoryIdorproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileSystem()isfalse- 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-proxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileSystemManagement()isfalse- 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 directoryproxy- a proxy- Returns:
- a
FileSystemManagementSession - Throws:
NotFoundException-pathis not found or is not a directoryNullArgumentException-pathorproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileSystemManagement()isfalse- 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- theIdof a directoryproxy- a proxy- Returns:
- a
FileSystemManagementSession - Throws:
NotFoundException-directoryIdis not foundNullArgumentException-directoryIdorproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileSystemManagement()isfalse- Compliance:
optional- This method must be implemented if {@code supportsFileSystemManagement()} and {@code supportsVisibleFederation()} are {@code true} .
-
getFileContentSession
Gets the session for reading and writing files.- Parameters:
proxy- a proxy- Returns:
- a
FileContentSession - Throws:
NullArgumentException-proxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileContent()isfalse- 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 directoryproxy- a proxy- Returns:
- a
FileContentSession - Throws:
NotFoundException-pathis not found or is not a directoryNullArgumentException-pathorproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileContent()isfalse- 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- theIdof a directoryproxy- a proxy- Returns:
- a
FileContentSession - Throws:
NotFoundException-directoryIdis not foundNullArgumentException-directoryIdorproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileContent()isfalse- Compliance:
optional- This method must be implemented if {@code supportsFileContent()} and {@code supportsVisibleFederation()} are {@code true} .
-
getFileLookupSession
Gets the session for looking up files.- Parameters:
proxy- a proxy- Returns:
- the
FileLookupSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsFileLookup()isfalse- 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- theIdto the directoryproxy- a proxy- Returns:
- a
FileLookupSession - Throws:
NotFoundException-directoryIdis not foundNullArgumentException-directoryIdorproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileLookup()isfalse- Compliance:
optional- This method must be implemented if {@code supportsFileLookup()} and {@code supportsVisibleFederation()} are {@code true} .
-
getFileQuerySession
Gets the session for querying files.- Parameters:
proxy- a proxy- Returns:
- the
FileQuerySession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsFileQuery()isfalse- 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- theIdto the directoryproxy- a proxy- Returns:
- a
FileQuerySession - Throws:
NotFoundException-directoryIdis not foundNullArgumentException-directoryIdorproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileQuery()isfalse- Compliance:
optional- This method must be implemented if {@code supportsFileQuery()} and {@code supportsVisibleFederation()} are {@code true} .
-
getFileSearchSession
Gets the session for searching for files.- Parameters:
proxy- a proxy- Returns:
- the
FileSearchSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsFileSearch()isfalse- 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- theIdto the directoryproxy- a proxy- Returns:
- a
FileSearchSession - Throws:
NotFoundException-directoryIdis not foundNullArgumentException-directoryIdorproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileSearch()isfalse- 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 callbackproxy- a proxy- Returns:
a FileNotificationSession- Throws:
NullArgumentException-fileReceiverorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsFileNotification()isfalse- 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 callbackdirectoryId- theIdto the directoryproxy- a proxy- Returns:
- a
FileNotificationSession - Throws:
NotFoundException-directoryPathis not foundNullArgumentException-fileReceiver, directoryId, orproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileNotification()isfalse- 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- theIdto the directoryproxy- a proxy- Returns:
- a
FileSmartDirectorySession - Throws:
NotFoundException-directoryId is not foundNullArgumentException-directoryId or proxy is nullOperationFailedException- unable to complete requestUnimplementedException-supportsFileSmartDirectory()isfalse- Compliance:
optional- This method must be implemented if {@code supportsFileSmartDirectory()} and {@code supportsVisibleFederation()} are {@code true} .
-
getDirectoryLookupSession
Gets the session for examining directories.- Parameters:
proxy- a proxy- Returns:
- a
DirectoryLookupSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsDirectoryLookup()isfalse- 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- theIdto the directoryproxy- a proxy- Returns:
- a
DirectoryLookupSession - Throws:
NotFoundException-directoryId is not foundNullArgumentException-directoryId or proxy is nullOperationFailedException- unable to complete requestUnimplementedException-supportsDirectoryLookup()isfalse- Compliance:
optional- This method must be implemented if {@code supportsDirectoryLookup()} and {@code supportsVisibleFederation()} are {@code true} .
-
getDirectoryQuerySession
Gets the session for querying directories.- Parameters:
proxy- a proxy- Returns:
- a
DirectoryQuerySession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsDirectoryQuery()isfalse- 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- theIdto the directoryproxy- a proxy- Returns:
- a
DirectoryQuerySession - Throws:
NotFoundException-directoryId is not foundNullArgumentException-directoryId or proxy is nullOperationFailedException- unable to complete requestUnimplementedException-supportsDirectoryQuery()isfalse- Compliance:
optional- This method must be implemented if {@code supportsDirectoryQuery()} and {@code supportsVisibleFederation()} are {@code true} .
-
getDirectorySearchSession
Gets the session for searching for directories.- Parameters:
proxy- a proxy- Returns:
- a
DirectorySearchSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsDirectorySearch()isfalse- 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- theIdto the directoryproxy- a proxy- Returns:
- a
DirectorySearchSession - Throws:
NotFoundException-directoryId is not foundNullArgumentException-directoryId or proxy is nullOperationFailedException- unable to complete requestUnimplementedException-supportsDirectorySearch()isfalse- Compliance:
optional- This method must be implemented if {@code supportsDirectorySearch()} and {@code supportsVisibleFederation()} are {@code true} .
-
getDirectoryAdminSession
Gets the session for creating and removing files.- Parameters:
proxy- a proxy- Returns:
- a
DirectoryAdminSession - Throws:
NullArgumentException-proxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsDirectoryAdmin()isfalse- 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- theIdto the directoryproxy- a proxy- Returns:
- a
DirectoryAdminSession - Throws:
NotFoundException-directoryId is not foundNullArgumentException-directoryId or proxy is nullOperationFailedException- unable to complete requestUnimplementedException-supportsDirectoryAdmin()isfalse- 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 callbackproxy- a proxy- Returns:
- a
DirectoryNotificationSession - Throws:
NullArgumentException-directoryReceiverorproxyisnullOperationFailedException- unable to complete requestUnimplementedException-supportsDirectoryNotification()isfalse- 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 callbackdirectoryId- theIdto the directoryproxy- a proxy- Returns:
- a
DirectoryNotificationSession - Throws:
NotFoundException-directoryPathis not foundNullArgumentException-directoryReceiver, directoryId, orproxyis nullOperationFailedException- unable to complete requestUnimplementedException-supportsDirectoryNotification()isfalse- Compliance:
optional- This method must be implemented if {@code supportsDirectoryNotification()} and {@code supportsVisibleFederation()} are {@code true} .
-
getFilingAllocationProxyManager
Gets theFilingAllocationProxyManager.- Returns:
- a
FilingAllocationProxyManager - Throws:
OperationFailedException- unable to complete requestUnimplementedException-supportsFilingAllocation()isfalse- Compliance:
optional- This method must be implemented if {@code supportsFilingAllocation()} is {@code true} .
-