FileFactory (The SAGA Interfaces 1.1.1-rm API)

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

public abstract class FileFactory
extends Object

Factory for objects from the namespace package.

Constructor Summary

Constructors
Constructor and Description

FileFactory()

Constructors
Constructor and Description
`FileFactory()`

Method Summary

Methods
Modifier and Type	Method and Description
`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.

Class FileFactory

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

FileFactory

Method Detail

doCreateIOVec

doCreateIOVec

doCreateFile

doCreateFileInputStream

doCreateFileOutputStream

doCreateDirectory

doCreateFile

doCreateFileInputStream

doCreateFileOutputStream

doCreateDirectory

createIOVec

createIOVec

createIOVec

createIOVec

createIOVec

createIOVec

createIOVec

createIOVec

createFile

createFile

createFile

createFile

createFile

createFile

createFile

createFile

createFileInputStream

createFileInputStream

createFileInputStream

createFileInputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createDirectory

createDirectory

createDirectory

createDirectory

createDirectory

createDirectory

createDirectory

createDirectory

createFile

createFile

createFile

createFile

createFile

createFile

createFile

createFile

createFileInputStream

createFileInputStream

createFileInputStream

createFileInputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createFileOutputStream

createDirectory

createDirectory

createDirectory

createDirectory

createDirectory

createDirectory

createDirectory