org.ogf.saga.file
Class FileFactory

java.lang.Object
  org.ogf.saga.file.FileFactory

public abstract class FileFactory
extends Object

Factory for objects from the namespace package.

Constructor Summary

FileFactory()

Method Summary

static Directory	createDirectory(Session session, URL name) Creates a Directory for reading.
static Directory	createDirectory(Session session, URL name, int flags) Creates a Directory.
static Directory	createDirectory(String sagaFactoryClassname, Session session, URL name) Creates a Directory for reading.
static Directory	createDirectory(String sagaFactoryClassname, Session session, URL name, int flags) Creates a Directory.
static Task<FileFactory,Directory>	createDirectory(String sagaFactoryClassname, TaskMode mode, Session session, URL name) Creates a task that creates a Directory for reading.
static Task<FileFactory,Directory>	createDirectory(String sagaFactoryClassname, TaskMode mode, Session session, URL name, int flags) Creates a task that creates a Directory.
static Task<FileFactory,Directory>	createDirectory(String sagaFactoryClassname, TaskMode mode, URL name) Creates a task that creates a Directory for reading, using the default session.
static Task<FileFactory,Directory>	createDirectory(String sagaFactoryClassname, TaskMode mode, URL name, int flags) Creates a task that creates a Directory, using the default session.
static Directory	createDirectory(String sagaFactoryClassname, URL name) Creates a Directory for reading, using the default session.
static Directory	createDirectory(String sagaFactoryClassname, URL name, int flags) Creates a Directory, using the default session.
static Task<FileFactory,Directory>	createDirectory(TaskMode mode, Session session, URL name) Creates a task that creates a Directory for reading.
static Task<FileFactory,Directory>	createDirectory(TaskMode mode, Session session, URL name, int flags) Creates a task that creates a Directory.
static Task<FileFactory,Directory>	createDirectory(TaskMode mode, URL name) Creates a task that creates a Directory for reading, using the default session.
static Task<FileFactory,Directory>	createDirectory(TaskMode mode, URL name, int flags) Creates a task that creates a Directory, using the default session.
static Directory	createDirectory(URL name) Creates a Directory for reading, using the default session.
static Directory	createDirectory(URL name, int flags) Creates a Directory, using the default session.
static File	createFile(Session session, URL name) Creates a File for reading.
static File	createFile(Session session, URL name, int flags) Creates a File.
static File	createFile(String sagaFactoryClassname, Session session, URL name) Creates a File for reading.
static File	createFile(String sagaFactoryClassname, Session session, URL name, int flags) Creates a File.
static Task<FileFactory,File>	createFile(String sagaFactoryClassname, TaskMode mode, Session session, URL name) Creates a task that creates a File for reading.
static Task<FileFactory,File>	createFile(String sagaFactoryClassname, TaskMode mode, Session session, URL name, int flags) Creates a task that creates a File.
static Task<FileFactory,File>	createFile(String sagaFactoryClassname, TaskMode mode, URL name) Creates a task that creates a File for reading, using the default session.
static Task<FileFactory,File>	createFile(String sagaFactoryClassname, TaskMode mode, URL name, int flags) Creates a task that creates a File, using the default session.
static File	createFile(String sagaFactoryClassname, URL name) Creates a File for reading, using the default session.
static File	createFile(String sagaFactoryClassname, URL name, int flags) Creates a File using the default session.
static Task<FileFactory,File>	createFile(TaskMode mode, Session session, URL name) Creates a task that creates a File for reading.
static Task<FileFactory,File>	createFile(TaskMode mode, Session session, URL name, int flags) Creates a task that creates a File.
static Task<FileFactory,File>	createFile(TaskMode mode, URL name) Creates a task that creates a File for reading, using the default session.
static Task<FileFactory,File>	createFile(TaskMode mode, URL name, int flags) Creates a task that creates a File, using the default session.
static File	createFile(URL name) Creates a File for reading, using the default session.
static File	createFile(URL name, int flags) Creates a File using the default session.
static FileInputStream	createFileInputStream(Session session, URL name) Creates a FileInputStream.
static FileInputStream	createFileInputStream(String sagaFactoryClassname, Session session, URL name) Creates a FileInputStream.
static Task<FileFactory,FileInputStream>	createFileInputStream(String sagaFactoryClassname, TaskMode mode, Session session, URL name) Creates a task that creates a FileInputStream.
static Task<FileFactory,FileInputStream>	createFileInputStream(String sagaFactoryClassname, TaskMode mode, URL name) Creates a task that creates a FileInputStream using the default session.
static FileInputStream	createFileInputStream(String sagaFactoryClassname, URL name) Creates a FileInputStream using the default session.
static Task<FileFactory,FileInputStream>	createFileInputStream(TaskMode mode, Session session, URL name) Creates a task that creates a FileInputStream.
static Task<FileFactory,FileInputStream>	createFileInputStream(TaskMode mode, URL name) Creates a task that creates a FileInputStream using the default session.
static FileInputStream	createFileInputStream(URL name) Creates a FileInputStream using the default session.
static FileOutputStream	createFileOutputStream(Session session, URL name) Creates a FileOutputStream.
static FileOutputStream	createFileOutputStream(Session session, URL name, boolean append) Creates a FileOutputStream.
static FileOutputStream	createFileOutputStream(String sagaFactoryClassname, Session session, URL name) Creates a FileOutputStream.
static FileOutputStream	createFileOutputStream(String sagaFactoryClassname, Session session, URL name, boolean append) Creates a FileOutputStream.
static Task<FileFactory,FileOutputStream>	createFileOutputStream(String sagaFactoryClassname, TaskMode mode, Session session, URL name) Creates a task that creates a FileOutputStream.
static Task<FileFactory,FileOutputStream>	createFileOutputStream(String sagaFactoryClassname, TaskMode mode, Session session, URL name, boolean append) Creates a task that creates a FileOutputStream.
static Task<FileFactory,FileOutputStream>	createFileOutputStream(String sagaFactoryClassname, TaskMode mode, URL name) Creates a task that creates a FileOutputStream using the default session.
static Task<FileFactory,FileOutputStream>	createFileOutputStream(String sagaFactoryClassname, TaskMode mode, URL name, boolean append) Creates a task that creates a FileOutputStream.
static FileOutputStream	createFileOutputStream(String sagaFactoryClassname, URL name) Creates a FileOutputStream using the default session.
static FileOutputStream	createFileOutputStream(String sagaFactoryClassname, URL name, boolean append) Creates a FileOutputStream using the default session.
static Task<FileFactory,FileOutputStream>	createFileOutputStream(TaskMode mode, Session session, URL name) Creates a task that creates a FileOutputStream.
static Task<FileFactory,FileOutputStream>	createFileOutputStream(TaskMode mode, Session session, URL name, boolean append) Creates a task that creates a FileOutputStream.
static Task<FileFactory,FileOutputStream>	createFileOutputStream(TaskMode mode, URL name) Creates a task that creates a FileOutputStream using the default session.
static Task<FileFactory,FileOutputStream>	createFileOutputStream(TaskMode mode, URL name, boolean append) Creates a task that creates a FileOutputStream.
static FileOutputStream	createFileOutputStream(URL name) Creates a FileOutputStream using the default session.
static FileOutputStream	createFileOutputStream(URL name, boolean append) Creates a FileOutputStream using the default session.
static IOVec	createIOVec(byte[] data) Creates an IOVec.
static IOVec	createIOVec(byte[] data, int lenIn) Creates an IOVec.
static IOVec	createIOVec(int size) Creates an IOVec.
static IOVec	createIOVec(int size, int lenIn) Creates an IOVec.
static IOVec	createIOVec(String sagaFactoryClassname, byte[] data) Creates an IOVec.
static IOVec	createIOVec(String sagaFactoryClassname, byte[] data, int lenIn) Creates an IOVec.
static IOVec	createIOVec(String sagaFactoryClassname, int size) Creates an IOVec.
static IOVec	createIOVec(String sagaFactoryClassname, int size, int lenIn) Creates an IOVec.
protected abstract Directory	doCreateDirectory(Session session, URL name, int flags) Creates a Directory.
protected abstract Task<FileFactory,Directory>	doCreateDirectory(TaskMode mode, Session session, URL name, int flags) Creates a task that creates a Directory.
protected abstract File	doCreateFile(Session session, URL name, int flags) Creates a File.
protected abstract Task<FileFactory,File>	doCreateFile(TaskMode mode, Session session, URL name, int flags) Creates a task that creates a File.
protected abstract FileInputStream	doCreateFileInputStream(Session session, URL name) Creates a FileInputStream.
protected abstract Task<FileFactory,FileInputStream>	doCreateFileInputStream(TaskMode mode, Session session, URL name) Creates a task that creates a FileInputStream.
protected abstract FileOutputStream	doCreateFileOutputStream(Session session, URL name, boolean append) Creates a FileOutputStream.
protected abstract Task<FileFactory,FileOutputStream>	doCreateFileOutputStream(TaskMode mode, Session session, URL name, boolean append) Creates a task that creates a FileOutputStream.
protected abstract IOVec	doCreateIOVec(byte[] data, int lenIn) Creates an IOVec.
protected abstract IOVec	doCreateIOVec(int size, int lenIn) Creates an IOVec.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FileFactory

public FileFactory()

Method Detail

doCreateIOVec

protected abstract IOVec doCreateIOVec(byte[] data,
                                       int lenIn)
                                throws BadParameterException,
                                       NoSuccessException

Creates an IOVec. To be provided by the implementation.

Parameters:

data - data to be used.

lenIn - number of bytes to read/write on readV/writeV.

Returns:

the IOVec.

Throws:

BadParameterException

NoSuccessException

doCreateIOVec

protected abstract IOVec doCreateIOVec(int size,
                                       int lenIn)
                                throws BadParameterException,
                                       NoSuccessException

Creates an IOVec. To be provided by the implementation.

Parameters:

size - size of data to be used.

lenIn - number of bytes to read/write on readV/writeV.

Returns:

the IOVec.

Throws:

BadParameterException

NoSuccessException

doCreateFile

protected abstract File doCreateFile(Session session,
                                     URL name,
                                     int flags)
                              throws NotImplementedException,
                                     IncorrectURLException,
                                     AuthenticationFailedException,
                                     AuthorizationFailedException,
                                     PermissionDeniedException,
                                     BadParameterException,
                                     AlreadyExistsException,
                                     DoesNotExistException,
                                     TimeoutException,
                                     NoSuccessException

Creates a File. To be provided by the implementation.

Parameters:

session - the session handle.

name - location of the file.

flags - the open mode.

Returns:

the file instance.

Throws:

NotImplementedException

IncorrectURLException

AuthenticationFailedException

AuthorizationFailedException

PermissionDeniedException

BadParameterException

AlreadyExistsException

DoesNotExistException

TimeoutException

NoSuccessException

doCreateFileInputStream

protected abstract FileInputStream doCreateFileInputStream(Session session,
                                                           URL name)
                                                    throws NotImplementedException,
                                                           IncorrectURLException,
                                                           AuthenticationFailedException,
                                                           AuthorizationFailedException,
                                                           PermissionDeniedException,
                                                           BadParameterException,
                                                           AlreadyExistsException,
                                                           DoesNotExistException,
                                                           TimeoutException,
                                                           NoSuccessException

Creates a FileInputStream. To be provided by the implementation.

Parameters:

session - the session handle.

name - location of the file.

Returns:

the FileInputStream instance.

Throws:

NotImplementedException

IncorrectURLException

AuthenticationFailedException

AuthorizationFailedException

PermissionDeniedException

BadParameterException

AlreadyExistsException

DoesNotExistException

TimeoutException

NoSuccessException

doCreateFileOutputStream

protected abstract FileOutputStream doCreateFileOutputStream(Session session,
                                                             URL name,
                                                             boolean append)
                                                      throws NotImplementedException,
                                                             IncorrectURLException,
                                                             AuthenticationFailedException,
                                                             AuthorizationFailedException,
                                                             PermissionDeniedException,
                                                             BadParameterException,
                                                             AlreadyExistsException,
                                                             DoesNotExistException,
                                                             TimeoutException,
                                                             NoSuccessException

Creates a FileOutputStream. To be provided by the implementation.

Parameters:

session - the session handle.

name - location of the file.

append - set when the file is opened for appending.

Returns:

the FileOutputStream instance.

Throws:

NotImplementedException

IncorrectURLException

AuthenticationFailedException

AuthorizationFailedException

PermissionDeniedException

BadParameterException

AlreadyExistsException

DoesNotExistException

TimeoutException

NoSuccessException

doCreateDirectory

protected abstract Directory doCreateDirectory(Session session,
                                               URL name,
                                               int flags)
                                        throws NotImplementedException,
                                               IncorrectURLException,
                                               AuthenticationFailedException,
                                               AuthorizationFailedException,
                                               PermissionDeniedException,
                                               BadParameterException,
                                               AlreadyExistsException,
                                               DoesNotExistException,
                                               TimeoutException,
                                               NoSuccessException

Creates a Directory. To be provided by the implementation.

Parameters:

session - the session handle.

name - location of directory.

flags - the open mode.

Returns:

the directory instance.

Throws:

NotImplementedException

IncorrectURLException

AuthenticationFailedException

AuthorizationFailedException

PermissionDeniedException

BadParameterException

AlreadyExistsException

DoesNotExistException

TimeoutException

NoSuccessException

doCreateFile

protected abstract Task<FileFactory,File> doCreateFile(TaskMode mode,
                                                       Session session,
                                                       URL name,
                                                       int flags)
                                                throws NotImplementedException

Creates a task that creates a File. To be provided by the implementation.

Parameters:

mode - the task mode.

session - the session handle.

name - location of the file.

flags - the open mode.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

doCreateFileInputStream

protected abstract Task<FileFactory,FileInputStream> doCreateFileInputStream(TaskMode mode,
                                                                             Session session,
                                                                             URL name)
                                                                      throws NotImplementedException

Creates a task that creates a FileInputStream. To be provided by the implementation.

Parameters:

mode - the task mode.

session - the session handle.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

doCreateFileOutputStream

protected abstract Task<FileFactory,FileOutputStream> doCreateFileOutputStream(TaskMode mode,
                                                                               Session session,
                                                                               URL name,
                                                                               boolean append)
                                                                        throws NotImplementedException

Creates a task that creates a FileOutputStream. To be provided by the implementation.

Parameters:

mode - the task mode.

session - the session handle.

name - location of the file.

append - when set, the file is opened for appending.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

doCreateDirectory

protected abstract Task<FileFactory,Directory> doCreateDirectory(TaskMode mode,
                                                                 Session session,
                                                                 URL name,
                                                                 int flags)
                                                          throws NotImplementedException

Creates a task that creates a Directory. To be provided by the implementation.

Parameters:

mode - the task mode.

session - the session handle.

name - location of directory.

flags - the open mode.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

createIOVec

public static IOVec createIOVec(byte[] data,
                                int lenIn)
                         throws BadParameterException,
                                NoSuccessException

Creates an IOVec.

Parameters:

data - data to be used.

lenIn - number of bytes to read/write on readV/writeV.

Returns:

the IOVec.

Throws:

BadParameterException - is thrown when lenIn is larger than the size of the specified buffer, or < 0, or when the implementation cannot handle the specified data buffer.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createIOVec

public static IOVec createIOVec(String sagaFactoryClassname,
                                byte[] data,
                                int lenIn)
                         throws BadParameterException,
                                NoSuccessException

Creates an IOVec.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

data - data to be used.

lenIn - number of bytes to read/write on readV/writeV.

Returns:

the IOVec.

Throws:

BadParameterException - is thrown when lenIn is larger than the size of the specified buffer, or < 0, or when the implementation cannot handle the specified data buffer.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createIOVec

public static IOVec createIOVec(byte[] data)
                         throws BadParameterException,
                                NoSuccessException

Creates an IOVec.

Parameters:

data - data to be used.

Returns:

the IOVec.

Throws:

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

BadParameterException - is thrown when the implementation cannot handle the specified data buffer.

createIOVec

public static IOVec createIOVec(String sagaFactoryClassname,
                                byte[] data)
                         throws BadParameterException,
                                NoSuccessException

Creates an IOVec.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

data - data to be used.

Returns:

the IOVec.

Throws:

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

BadParameterException - is thrown when the implementation cannot handle the specified data buffer.

createIOVec

public static IOVec createIOVec(int size,
                                int lenIn)
                         throws BadParameterException,
                                NoSuccessException

Creates an IOVec.

Parameters:

size - size of data to be used.

lenIn - number of bytes to read/write on readV/writeV.

Returns:

the IOVec.

Throws:

BadParameterException - is thrown when lenIn is larger than the size of the specified buffer, or < 0.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createIOVec

public static IOVec createIOVec(String sagaFactoryClassname,
                                int size,
                                int lenIn)
                         throws BadParameterException,
                                NoSuccessException

Creates an IOVec.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

size - size of data to be used.

lenIn - number of bytes to read/write on readV/writeV.

Returns:

the IOVec.

Throws:

BadParameterException - is thrown when lenIn is larger than the size of the specified buffer, or < 0.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createIOVec

public static IOVec createIOVec(int size)
                         throws BadParameterException,
                                NoSuccessException,
                                NotImplementedException

Creates an IOVec.

Parameters:

size - size of data to be used.

Returns:

the IOVec.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

BadParameterException - is thrown when the implementation cannot handle the specified size.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createIOVec

public static IOVec createIOVec(String sagaFactoryClassname,
                                int size)
                         throws BadParameterException,
                                NoSuccessException,
                                NotImplementedException

Creates an IOVec.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

size - size of data to be used.

Returns:

the IOVec.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

BadParameterException - is thrown when the implementation cannot handle the specified size.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFile

public static File createFile(Session session,
                              URL name,
                              int flags)
                       throws NotImplementedException,
                              IncorrectURLException,
                              AuthenticationFailedException,
                              AuthorizationFailedException,
                              PermissionDeniedException,
                              BadParameterException,
                              AlreadyExistsException,
                              DoesNotExistException,
                              TimeoutException,
                              NoSuccessException

Creates a File.

Parameters:

session - the session handle.

name - location of the file.

flags - the open mode.

Returns:

the file instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is thrown if the specified URL already exists, and the CREATE and EXCLUSIVE flags are given.

DoesNotExistException - is thrown if the specified URL does not exist, and the CREATE flag is not given.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFile

public static File createFile(String sagaFactoryClassname,
                              Session session,
                              URL name,
                              int flags)
                       throws NotImplementedException,
                              IncorrectURLException,
                              AuthenticationFailedException,
                              AuthorizationFailedException,
                              PermissionDeniedException,
                              BadParameterException,
                              AlreadyExistsException,
                              DoesNotExistException,
                              TimeoutException,
                              NoSuccessException

Creates a File.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

session - the session handle.

name - location of the file.

flags - the open mode.

Returns:

the file instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is thrown if the specified URL already exists, and the CREATE and EXCLUSIVE flags are given.

DoesNotExistException - is thrown if the specified URL does not exist, and the CREATE flag is not given.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFile

public static File createFile(Session session,
                              URL name)
                       throws NotImplementedException,
                              IncorrectURLException,
                              AuthenticationFailedException,
                              AuthorizationFailedException,
                              PermissionDeniedException,
                              BadParameterException,
                              AlreadyExistsException,
                              DoesNotExistException,
                              TimeoutException,
                              NoSuccessException

Creates a File for reading.

Parameters:

session - the session handle.

name - location of the file.

Returns:

the file instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFile

public static File createFile(String sagaFactoryClassname,
                              Session session,
                              URL name)
                       throws NotImplementedException,
                              IncorrectURLException,
                              AuthenticationFailedException,
                              AuthorizationFailedException,
                              PermissionDeniedException,
                              BadParameterException,
                              AlreadyExistsException,
                              DoesNotExistException,
                              TimeoutException,
                              NoSuccessException

Creates a File for reading.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

session - the session handle.

name - location of the file.

Returns:

the file instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFile

public static File createFile(URL name,
                              int flags)
                       throws NotImplementedException,
                              IncorrectURLException,
                              AuthenticationFailedException,
                              AuthorizationFailedException,
                              PermissionDeniedException,
                              BadParameterException,
                              AlreadyExistsException,
                              DoesNotExistException,
                              TimeoutException,
                              NoSuccessException

Creates a File using the default session.

Parameters:

name - location of the file.

flags - the open mode.

Returns:

the file instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is thrown if the specified URL already exists, and the CREATE and EXCLUSIVE flags are given.

DoesNotExistException - is thrown if the specified URL does not exist, and the CREATE flag is not given.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFile

public static File createFile(String sagaFactoryClassname,
                              URL name,
                              int flags)
                       throws NotImplementedException,
                              IncorrectURLException,
                              AuthenticationFailedException,
                              AuthorizationFailedException,
                              PermissionDeniedException,
                              BadParameterException,
                              AlreadyExistsException,
                              DoesNotExistException,
                              TimeoutException,
                              NoSuccessException

Creates a File using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

name - location of the file.

flags - the open mode.

Returns:

the file instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is thrown if the specified URL already exists, and the CREATE and EXCLUSIVE flags are given.

DoesNotExistException - is thrown if the specified URL does not exist, and the CREATE flag is not given.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFile

public static File createFile(URL name)
                       throws NotImplementedException,
                              IncorrectURLException,
                              AuthenticationFailedException,
                              AuthorizationFailedException,
                              PermissionDeniedException,
                              BadParameterException,
                              AlreadyExistsException,
                              DoesNotExistException,
                              TimeoutException,
                              NoSuccessException

Creates a File for reading, using the default session.

Parameters:

name - location of the file.

Returns:

the file instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFile

public static File createFile(String sagaFactoryClassname,
                              URL name)
                       throws NotImplementedException,
                              IncorrectURLException,
                              AuthenticationFailedException,
                              AuthorizationFailedException,
                              PermissionDeniedException,
                              BadParameterException,
                              AlreadyExistsException,
                              DoesNotExistException,
                              TimeoutException,
                              NoSuccessException

Creates a File for reading, using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

name - location of the file.

Returns:

the file instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileInputStream

public static FileInputStream createFileInputStream(Session session,
                                                    URL name)
                                             throws NotImplementedException,
                                                    IncorrectURLException,
                                                    AuthenticationFailedException,
                                                    AuthorizationFailedException,
                                                    PermissionDeniedException,
                                                    BadParameterException,
                                                    AlreadyExistsException,
                                                    DoesNotExistException,
                                                    TimeoutException,
                                                    NoSuccessException

Creates a FileInputStream.

Parameters:

session - the session handle.

name - location of the file.

Returns:

the FileInputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileInputStream

public static FileInputStream createFileInputStream(String sagaFactoryClassname,
                                                    Session session,
                                                    URL name)
                                             throws NotImplementedException,
                                                    IncorrectURLException,
                                                    AuthenticationFailedException,
                                                    AuthorizationFailedException,
                                                    PermissionDeniedException,
                                                    BadParameterException,
                                                    AlreadyExistsException,
                                                    DoesNotExistException,
                                                    TimeoutException,
                                                    NoSuccessException

Creates a FileInputStream.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

session - the session handle.

name - location of the file.

Returns:

the FileInputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileInputStream

public static FileInputStream createFileInputStream(URL name)
                                             throws NotImplementedException,
                                                    IncorrectURLException,
                                                    AuthenticationFailedException,
                                                    AuthorizationFailedException,
                                                    PermissionDeniedException,
                                                    BadParameterException,
                                                    AlreadyExistsException,
                                                    DoesNotExistException,
                                                    TimeoutException,
                                                    NoSuccessException

Creates a FileInputStream using the default session.

Parameters:

name - location of the file.

Returns:

the FileInputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileInputStream

public static FileInputStream createFileInputStream(String sagaFactoryClassname,
                                                    URL name)
                                             throws NotImplementedException,
                                                    IncorrectURLException,
                                                    AuthenticationFailedException,
                                                    AuthorizationFailedException,
                                                    PermissionDeniedException,
                                                    BadParameterException,
                                                    AlreadyExistsException,
                                                    DoesNotExistException,
                                                    TimeoutException,
                                                    NoSuccessException

Creates a FileInputStream using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

name - location of the file.

Returns:

the FileInputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileOutputStream

public static FileOutputStream createFileOutputStream(Session session,
                                                      URL name,
                                                      boolean append)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException

Creates a FileOutputStream.

Parameters:

session - the session handle.

name - location of the file.

append - when set, the file is opened for appending.

Returns:

the FileOutputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL points to a directory, or is an invalid entry name.

IncorrectURLException - is thrown if an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the parent directory does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileOutputStream

public static FileOutputStream createFileOutputStream(String sagaFactoryClassname,
                                                      Session session,
                                                      URL name,
                                                      boolean append)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException

Creates a FileOutputStream.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

session - the session handle.

name - location of the file.

append - when set, the file is opened for appending.

Returns:

the FileOutputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL points to a directory, or is an invalid entry name.

IncorrectURLException - is thrown if an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the parent directory does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileOutputStream

public static FileOutputStream createFileOutputStream(Session session,
                                                      URL name)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException

Creates a FileOutputStream.

Parameters:

session - the session handle.

name - location of the file.

Returns:

the FileOutputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL points to a directory, or is an invalid entry name.

IncorrectURLException - is thrown if an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the parent directory does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileOutputStream

public static FileOutputStream createFileOutputStream(String sagaFactoryClassname,
                                                      Session session,
                                                      URL name)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException

Creates a FileOutputStream.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

session - the session handle.

name - location of the file.

Returns:

the FileOutputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL points to a directory, or is an invalid entry name.

IncorrectURLException - is thrown if an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the parent directory does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileOutputStream

public static FileOutputStream createFileOutputStream(URL name,
                                                      boolean append)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException

Creates a FileOutputStream using the default session.

Parameters:

name - location of the file.

append - when set, the file is opened for appending.

Returns:

the FileOutputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL points to a directory, or is an invalid entry name.

IncorrectURLException - is thrown if an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the parent directory does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileOutputStream

public static FileOutputStream createFileOutputStream(String sagaFactoryClassname,
                                                      URL name,
                                                      boolean append)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException

Creates a FileOutputStream using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

name - location of the file.

append - when set, the file is opened for appending.

Returns:

the FileOutputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL points to a directory, or is an invalid entry name.

IncorrectURLException - is thrown if an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the parent directory does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileOutputStream

public static FileOutputStream createFileOutputStream(URL name)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException

Creates a FileOutputStream using the default session.

Parameters:

name - location of the file.

Returns:

the FileOutputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL points to a directory, or is an invalid entry name.

IncorrectURLException - is thrown if an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the parent directory does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFileOutputStream

public static FileOutputStream createFileOutputStream(String sagaFactoryClassname,
                                                      URL name)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException

Creates a FileOutputStream using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

name - location of the file.

Returns:

the FileOutputStream instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL points to a directory, or is an invalid entry name.

IncorrectURLException - is thrown if an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the parent directory does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createDirectory

public static Directory createDirectory(Session session,
                                        URL name,
                                        int flags)
                                 throws NotImplementedException,
                                        IncorrectURLException,
                                        AuthenticationFailedException,
                                        AuthorizationFailedException,
                                        PermissionDeniedException,
                                        BadParameterException,
                                        AlreadyExistsException,
                                        DoesNotExistException,
                                        TimeoutException,
                                        NoSuccessException

Creates a Directory.

Parameters:

session - the session handle.

name - location of the directory.

flags - the open mode.

Returns:

the directory instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is thrown if the specified URL already exists, and the CREATE and EXCLUSIVE flags are given.

DoesNotExistException - is thrown if the specified URL does not exist, and the CREATE flag is not given.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createDirectory

public static Directory createDirectory(String sagaFactoryClassname,
                                        Session session,
                                        URL name,
                                        int flags)
                                 throws NotImplementedException,
                                        IncorrectURLException,
                                        AuthenticationFailedException,
                                        AuthorizationFailedException,
                                        PermissionDeniedException,
                                        BadParameterException,
                                        AlreadyExistsException,
                                        DoesNotExistException,
                                        TimeoutException,
                                        NoSuccessException

Creates a Directory.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

session - the session handle.

name - location of the directory.

flags - the open mode.

Returns:

the directory instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is thrown if the specified URL already exists, and the CREATE and EXCLUSIVE flags are given.

DoesNotExistException - is thrown if the specified URL does not exist, and the CREATE flag is not given.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createDirectory

public static Directory createDirectory(Session session,
                                        URL name)
                                 throws NotImplementedException,
                                        IncorrectURLException,
                                        AuthenticationFailedException,
                                        AuthorizationFailedException,
                                        PermissionDeniedException,
                                        BadParameterException,
                                        AlreadyExistsException,
                                        DoesNotExistException,
                                        TimeoutException,
                                        NoSuccessException

Creates a Directory for reading.

Parameters:

session - the session handle.

name - location of the directory.

Returns:

the directory instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createDirectory

public static Directory createDirectory(String sagaFactoryClassname,
                                        Session session,
                                        URL name)
                                 throws NotImplementedException,
                                        IncorrectURLException,
                                        AuthenticationFailedException,
                                        AuthorizationFailedException,
                                        PermissionDeniedException,
                                        BadParameterException,
                                        AlreadyExistsException,
                                        DoesNotExistException,
                                        TimeoutException,
                                        NoSuccessException

Creates a Directory for reading.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

session - the session handle.

name - location of the directory.

Returns:

the directory instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createDirectory

public static Directory createDirectory(URL name,
                                        int flags)
                                 throws NotImplementedException,
                                        IncorrectURLException,
                                        AuthenticationFailedException,
                                        AuthorizationFailedException,
                                        PermissionDeniedException,
                                        BadParameterException,
                                        AlreadyExistsException,
                                        DoesNotExistException,
                                        TimeoutException,
                                        NoSuccessException

Creates a Directory, using the default session.

Parameters:

name - location of the directory.

flags - the open mode.

Returns:

the directory instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is thrown if the specified URL already exists, and the CREATE and EXCLUSIVE flags are given.

DoesNotExistException - is thrown if the specified URL does not exist, and the CREATE flag is not given.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createDirectory

public static Directory createDirectory(String sagaFactoryClassname,
                                        URL name,
                                        int flags)
                                 throws NotImplementedException,
                                        IncorrectURLException,
                                        AuthenticationFailedException,
                                        AuthorizationFailedException,
                                        PermissionDeniedException,
                                        BadParameterException,
                                        AlreadyExistsException,
                                        DoesNotExistException,
                                        TimeoutException,
                                        NoSuccessException

Creates a Directory, using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

name - location of the directory.

flags - the open mode.

Returns:

the directory instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is thrown if the specified URL already exists, and the CREATE and EXCLUSIVE flags are given.

DoesNotExistException - is thrown if the specified URL does not exist, and the CREATE flag is not given.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createDirectory

public static Directory createDirectory(URL name)
                                 throws NotImplementedException,
                                        IncorrectURLException,
                                        AuthenticationFailedException,
                                        AuthorizationFailedException,
                                        PermissionDeniedException,
                                        BadParameterException,
                                        AlreadyExistsException,
                                        DoesNotExistException,
                                        TimeoutException,
                                        NoSuccessException

Creates a Directory for reading, using the default session.

Parameters:

name - location of the directory.

Returns:

the directory instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createDirectory

public static Directory createDirectory(String sagaFactoryClassname,
                                        URL name)
                                 throws NotImplementedException,
                                        IncorrectURLException,
                                        AuthenticationFailedException,
                                        AuthorizationFailedException,
                                        PermissionDeniedException,
                                        BadParameterException,
                                        AlreadyExistsException,
                                        DoesNotExistException,
                                        TimeoutException,
                                        NoSuccessException

Creates a Directory for reading, using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

name - location of the directory.

Returns:

the directory instance.

Throws:

NotImplementedException - is thrown if the implementation does not provide an implementation of this method.

PermissionDeniedException - is thrown when the method failed because the identity used did not have sufficient permissions to perform the operation successfully.

AuthorizationFailedException - is thrown when none of the available contexts of the used session could be used for successful authorization. This error indicates that the resource could not be accessed at all, and not that an operation was not available due to restricted permissions.

AuthenticationFailedException - is thrown when operation failed because none of the available session contexts could successfully be used for authentication.

TimeoutException - is thrown when a remote operation did not complete successfully because the network communication or the remote service timed out.

BadParameterException - is thrown when the specified URL is an invalid file name.

IncorrectURLException - is thrown when an implementation cannot handle the specified protocol, or that access to the specified entity via the given protocol is impossible.

AlreadyExistsException - is not thrown, but a method may be invoked that may throw it (but not in this case).

DoesNotExistException - is thrown if the specified URL does not exist.

NoSuccessException - is thrown when the operation was not successfully performed, and none of the other exceptions apply.

createFile

public static Task<FileFactory,File> createFile(TaskMode mode,
                                                Session session,
                                                URL name,
                                                int flags)
                                         throws NotImplementedException,
                                                NoSuccessException

Creates a task that creates a File.

Parameters:

mode - the task mode.

session - the session handle.

name - location of the file.

flags - the open mode.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createFile

public static Task<FileFactory,File> createFile(String sagaFactoryClassname,
                                                TaskMode mode,
                                                Session session,
                                                URL name,
                                                int flags)
                                         throws NotImplementedException,
                                                NoSuccessException

Creates a task that creates a File.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

session - the session handle.

name - location of the file.

flags - the open mode.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createFile

public static Task<FileFactory,File> createFile(TaskMode mode,
                                                Session session,
                                                URL name)
                                         throws NotImplementedException,
                                                NoSuccessException

Creates a task that creates a File for reading.

Parameters:

mode - the task mode.

session - the session handle.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createFile

public static Task<FileFactory,File> createFile(String sagaFactoryClassname,
                                                TaskMode mode,
                                                Session session,
                                                URL name)
                                         throws NotImplementedException,
                                                NoSuccessException

Creates a task that creates a File for reading.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

session - the session handle.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createFile

public static Task<FileFactory,File> createFile(TaskMode mode,
                                                URL name,
                                                int flags)
                                         throws NotImplementedException,
                                                NoSuccessException

Creates a task that creates a File, using the default session.

Parameters:

mode - the task mode.

name - location of the file.

flags - the open mode.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createFile

public static Task<FileFactory,File> createFile(String sagaFactoryClassname,
                                                TaskMode mode,
                                                URL name,
                                                int flags)
                                         throws NotImplementedException,
                                                NoSuccessException

Creates a task that creates a File, using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

name - location of the file.

flags - the open mode.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createFile

public static Task<FileFactory,File> createFile(TaskMode mode,
                                                URL name)
                                         throws NotImplementedException,
                                                NoSuccessException

Creates a task that creates a File for reading, using the default session.

Parameters:

mode - the task mode.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createFile

public static Task<FileFactory,File> createFile(String sagaFactoryClassname,
                                                TaskMode mode,
                                                URL name)
                                         throws NotImplementedException,
                                                NoSuccessException

Creates a task that creates a File for reading, using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createFileInputStream

public static Task<FileFactory,FileInputStream> createFileInputStream(TaskMode mode,
                                                                      Session session,
                                                                      URL name)
                                                               throws NotImplementedException,
                                                                      NoSuccessException

Creates a task that creates a FileInputStream.

Parameters:

mode - the task mode.

session - the session handle.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createFileInputStream

public static Task<FileFactory,FileInputStream> createFileInputStream(String sagaFactoryClassname,
                                                                      TaskMode mode,
                                                                      Session session,
                                                                      URL name)
                                                               throws NotImplementedException,
                                                                      NoSuccessException

Creates a task that creates a FileInputStream.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

session - the session handle.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createFileInputStream

public static Task<FileFactory,FileInputStream> createFileInputStream(TaskMode mode,
                                                                      URL name)
                                                               throws NotImplementedException,
                                                                      NoSuccessException

Creates a task that creates a FileInputStream using the default session.

Parameters:

mode - the task mode.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createFileInputStream

public static Task<FileFactory,FileInputStream> createFileInputStream(String sagaFactoryClassname,
                                                                      TaskMode mode,
                                                                      URL name)
                                                               throws NotImplementedException,
                                                                      NoSuccessException

Creates a task that creates a FileInputStream using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createFileOutputStream

public static Task<FileFactory,FileOutputStream> createFileOutputStream(TaskMode mode,
                                                                        Session session,
                                                                        URL name)
                                                                 throws NotImplementedException,
                                                                        NoSuccessException

Creates a task that creates a FileOutputStream.

Parameters:

mode - the task mode.

session - the session handle.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException

createFileOutputStream

public static Task<FileFactory,FileOutputStream> createFileOutputStream(String sagaFactoryClassname,
                                                                        TaskMode mode,
                                                                        Session session,
                                                                        URL name)
                                                                 throws NotImplementedException,
                                                                        NoSuccessException

Creates a task that creates a FileOutputStream.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

session - the session handle.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException

createFileOutputStream

public static Task<FileFactory,FileOutputStream> createFileOutputStream(TaskMode mode,
                                                                        Session session,
                                                                        URL name,
                                                                        boolean append)
                                                                 throws NotImplementedException,
                                                                        NoSuccessException

Creates a task that creates a FileOutputStream.

Parameters:

mode - the task mode.

name - location of the file.

append - when set, the file is opened for appending.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createFileOutputStream

public static Task<FileFactory,FileOutputStream> createFileOutputStream(String sagaFactoryClassname,
                                                                        TaskMode mode,
                                                                        Session session,
                                                                        URL name,
                                                                        boolean append)
                                                                 throws NotImplementedException,
                                                                        NoSuccessException

Creates a task that creates a FileOutputStream.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

name - location of the file.

append - when set, the file is opened for appending.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createFileOutputStream

public static Task<FileFactory,FileOutputStream> createFileOutputStream(TaskMode mode,
                                                                        URL name)
                                                                 throws NotImplementedException,
                                                                        NoSuccessException

Creates a task that creates a FileOutputStream using the default session.

Parameters:

mode - the task mode.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createFileOutputStream

public static Task<FileFactory,FileOutputStream> createFileOutputStream(String sagaFactoryClassname,
                                                                        TaskMode mode,
                                                                        URL name)
                                                                 throws NotImplementedException,
                                                                        NoSuccessException

Creates a task that creates a FileOutputStream using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

name - location of the file.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createFileOutputStream

public static Task<FileFactory,FileOutputStream> createFileOutputStream(TaskMode mode,
                                                                        URL name,
                                                                        boolean append)
                                                                 throws NotImplementedException,
                                                                        NoSuccessException

Creates a task that creates a FileOutputStream.

Parameters:

mode - the task mode.

name - location of the file.

append - when set, the file is opened for appending.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createFileOutputStream

public static Task<FileFactory,FileOutputStream> createFileOutputStream(String sagaFactoryClassname,
                                                                        TaskMode mode,
                                                                        URL name,
                                                                        boolean append)
                                                                 throws NotImplementedException,
                                                                        NoSuccessException

Creates a task that creates a FileOutputStream.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

name - location of the file.

append - when set, the file is opened for appending.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createDirectory

public static Task<FileFactory,Directory> createDirectory(TaskMode mode,
                                                          Session session,
                                                          URL name,
                                                          int flags)
                                                   throws NotImplementedException,
                                                          NoSuccessException

Creates a task that creates a Directory.

Parameters:

mode - the task mode.

session - the session handle.

name - location of the directory.

flags - the open mode.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createDirectory

public static Task<FileFactory,Directory> createDirectory(String sagaFactoryClassname,
                                                          TaskMode mode,
                                                          Session session,
                                                          URL name,
                                                          int flags)
                                                   throws NotImplementedException,
                                                          NoSuccessException

Creates a task that creates a Directory.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

session - the session handle.

name - location of the directory.

flags - the open mode.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createDirectory

public static Task<FileFactory,Directory> createDirectory(TaskMode mode,
                                                          Session session,
                                                          URL name)
                                                   throws NotImplementedException,
                                                          NoSuccessException

Creates a task that creates a Directory for reading.

Parameters:

mode - the task mode.

session - the session handle.

name - location of the directory.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createDirectory

public static Task<FileFactory,Directory> createDirectory(String sagaFactoryClassname,
                                                          TaskMode mode,
                                                          Session session,
                                                          URL name)
                                                   throws NotImplementedException,
                                                          NoSuccessException

Creates a task that creates a Directory for reading.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

session - the session handle.

name - location of the directory.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

createDirectory

public static Task<FileFactory,Directory> createDirectory(TaskMode mode,
                                                          URL name,
                                                          int flags)
                                                   throws NotImplementedException,
                                                          NoSuccessException

Creates a task that creates a Directory, using the default session.

Parameters:

mode - the task mode.

name - location of the directory.

flags - the open mode.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createDirectory

public static Task<FileFactory,Directory> createDirectory(String sagaFactoryClassname,
                                                          TaskMode mode,
                                                          URL name,
                                                          int flags)
                                                   throws NotImplementedException,
                                                          NoSuccessException

Creates a task that creates a Directory, using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

name - location of the directory.

flags - the open mode.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented.

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createDirectory

public static Task<FileFactory,Directory> createDirectory(TaskMode mode,
                                                          URL name)
                                                   throws NotImplementedException,
                                                          NoSuccessException

Creates a task that creates a Directory for reading, using the default session.

Parameters:

mode - the task mode.

name - location of the directory.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.

createDirectory

public static Task<FileFactory,Directory> createDirectory(String sagaFactoryClassname,
                                                          TaskMode mode,
                                                          URL name)
                                                   throws NotImplementedException,
                                                          NoSuccessException

Creates a task that creates a Directory for reading, using the default session.

Parameters:

sagaFactoryClassname - the class name of the Saga factory to be used.

mode - the task mode.

name - location of the directory.

Returns:

the task.

Throws:

NotImplementedException - is thrown when the task version of this method is not implemented

NoSuccessException - is thrown when the default session could not be created or when the Saga factory could not be created.