org.ogf.saga.logicalfile
Class LogicalFileFactory

java.lang.Object
  extended by org.ogf.saga.logicalfile.LogicalFileFactory

public abstract class LogicalFileFactory
extends Object

Factory for objects from the logicalfile package.


Constructor Summary
LogicalFileFactory()
           
 
Method Summary
static LogicalDirectory createLogicalDirectory(Session session, URL name)
          Creates a LogicalDirectory using READ open mode.
static LogicalDirectory createLogicalDirectory(Session session, URL name, int flags)
          Creates a LogicalDirectory.
static LogicalDirectory createLogicalDirectory(String sagaFactoryClassname, Session session, URL name)
          Creates a LogicalDirectory using READ open mode.
static LogicalDirectory createLogicalDirectory(String sagaFactoryClassname, Session session, URL name, int flags)
          Creates a LogicalDirectory.
static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(String sagaFactoryClassname, TaskMode mode, Session session, URL name)
          Creates a task that creates a LogicalDirectory using READ open mode.
static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(String sagaFactoryClassname, TaskMode mode, Session session, URL name, int flags)
          Creates a task that creates a LogicalDirectory.
static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(String sagaFactoryClassname, TaskMode mode, URL name)
          Creates a task that creates a LogicalDirectory using READ open mode, using the default session.
static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(String sagaFactoryClassname, TaskMode mode, URL name, int flags)
          Creates a task that creates a LogicalDirectory using the default session.
static LogicalDirectory createLogicalDirectory(String sagaFactoryClassname, URL name)
          Creates a LogicalDirectory using READ open mode, using the default session.
static LogicalDirectory createLogicalDirectory(String sagaFactoryClassname, URL name, int flags)
          Creates a LogicalDirectory using the default session.
static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(TaskMode mode, Session session, URL name)
          Creates a task that creates a LogicalDirectory using READ open mode.
static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(TaskMode mode, Session session, URL name, int flags)
          Creates a task that creates a LogicalDirectory.
static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(TaskMode mode, URL name)
          Creates a task that creates a LogicalDirectory using READ open mode, using the default session.
static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(TaskMode mode, URL name, int flags)
          Creates a task that creates a LogicalDirectory using the default session.
static LogicalDirectory createLogicalDirectory(URL name)
          Creates a LogicalDirectory using READ open mode, using the default session.
static LogicalDirectory createLogicalDirectory(URL name, int flags)
          Creates a LogicalDirectory using the default session.
static LogicalFile createLogicalFile(Session session, URL name)
          Creates a LogicalFile using READ open mode.
static LogicalFile createLogicalFile(Session session, URL name, int flags)
          Creates a LogicalFile.
static LogicalFile createLogicalFile(String sagaFactoryClassname, Session session, URL name)
          Creates a LogicalFile using READ open mode.
static LogicalFile createLogicalFile(String sagaFactoryClassname, Session session, URL name, int flags)
          Creates a LogicalFile.
static Task<LogicalFileFactory,LogicalFile> createLogicalFile(String sagaFactoryClassname, TaskMode mode, Session session, URL name)
          Creates a task that creates a LogicalFile using READ open mode.
static Task<LogicalFileFactory,LogicalFile> createLogicalFile(String sagaFactoryClassname, TaskMode mode, Session session, URL name, int flags)
          Creates a task that creates a LogicalFile.
static Task<LogicalFileFactory,LogicalFile> createLogicalFile(String sagaFactoryClassname, TaskMode mode, URL name)
          Creates a task that creates a LogicalFile using READ open mode, using the default session.
static Task<LogicalFileFactory,LogicalFile> createLogicalFile(String sagaFactoryClassname, TaskMode mode, URL name, int flags)
          Creates a task that creates a LogicalFile using the default session.
static LogicalFile createLogicalFile(String sagaFactoryClassname, URL name)
          Creates a LogicalFile using READ open mode, using the default session.
static LogicalFile createLogicalFile(String sagaFactoryClassname, URL name, int flags)
          Creates a LogicalFile using the default session.
static Task<LogicalFileFactory,LogicalFile> createLogicalFile(TaskMode mode, Session session, URL name)
          Creates a task that creates a LogicalFile using READ open mode.
static Task<LogicalFileFactory,LogicalFile> createLogicalFile(TaskMode mode, Session session, URL name, int flags)
          Creates a task that creates a LogicalFile.
static Task<LogicalFileFactory,LogicalFile> createLogicalFile(TaskMode mode, URL name)
          Creates a task that creates a LogicalFile using READ open mode, using the default session.
static Task<LogicalFileFactory,LogicalFile> createLogicalFile(TaskMode mode, URL name, int flags)
          Creates a task that creates a LogicalFile using the default session.
static LogicalFile createLogicalFile(URL name)
          Creates a LogicalFile using READ open mode, using the default session.
static LogicalFile createLogicalFile(URL name, int flags)
          Creates a LogicalFile using the default session.
protected abstract  LogicalDirectory doCreateLogicalDirectory(Session session, URL name, int flags)
          Creates a Directory.
protected abstract  Task<LogicalFileFactory,LogicalDirectory> doCreateLogicalDirectory(TaskMode mode, Session session, URL name, int flags)
          Creates a task that creates a LogicalDirectory.
protected abstract  LogicalFile doCreateLogicalFile(Session session, URL name, int flags)
          Creates a LogicalFile.
protected abstract  Task<LogicalFileFactory,LogicalFile> doCreateLogicalFile(TaskMode mode, Session session, URL name, int flags)
          Creates a task that creates a LogicalFile.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

LogicalFileFactory

public LogicalFileFactory()
Method Detail

doCreateLogicalFile

protected abstract LogicalFile doCreateLogicalFile(Session session,
                                                   URL name,
                                                   int flags)
                                            throws NotImplementedException,
                                                   IncorrectURLException,
                                                   AuthenticationFailedException,
                                                   AuthorizationFailedException,
                                                   PermissionDeniedException,
                                                   BadParameterException,
                                                   AlreadyExistsException,
                                                   DoesNotExistException,
                                                   TimeoutException,
                                                   NoSuccessException
Creates a LogicalFile. 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

doCreateLogicalDirectory

protected abstract LogicalDirectory doCreateLogicalDirectory(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

doCreateLogicalFile

protected abstract Task<LogicalFileFactory,LogicalFile> doCreateLogicalFile(TaskMode mode,
                                                                            Session session,
                                                                            URL name,
                                                                            int flags)
                                                                     throws NotImplementedException
Creates a task that creates a LogicalFile. 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.

doCreateLogicalDirectory

protected abstract Task<LogicalFileFactory,LogicalDirectory> doCreateLogicalDirectory(TaskMode mode,
                                                                                      Session session,
                                                                                      URL name,
                                                                                      int flags)
                                                                               throws NotImplementedException
Creates a task that creates a LogicalDirectory. 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.

createLogicalFile

public static LogicalFile createLogicalFile(Session session,
                                            URL name,
                                            int flags)
                                     throws NotImplementedException,
                                            IncorrectURLException,
                                            AuthenticationFailedException,
                                            AuthorizationFailedException,
                                            PermissionDeniedException,
                                            BadParameterException,
                                            AlreadyExistsException,
                                            DoesNotExistException,
                                            TimeoutException,
                                            NoSuccessException
Creates a LogicalFile.

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 entry 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.

createLogicalFile

public static LogicalFile createLogicalFile(String sagaFactoryClassname,
                                            Session session,
                                            URL name,
                                            int flags)
                                     throws NotImplementedException,
                                            IncorrectURLException,
                                            AuthenticationFailedException,
                                            AuthorizationFailedException,
                                            PermissionDeniedException,
                                            BadParameterException,
                                            AlreadyExistsException,
                                            DoesNotExistException,
                                            TimeoutException,
                                            NoSuccessException
Creates a LogicalFile.

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 entry 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.

createLogicalFile

public static LogicalFile createLogicalFile(Session session,
                                            URL name)
                                     throws NotImplementedException,
                                            IncorrectURLException,
                                            AuthenticationFailedException,
                                            AuthorizationFailedException,
                                            PermissionDeniedException,
                                            BadParameterException,
                                            AlreadyExistsException,
                                            DoesNotExistException,
                                            TimeoutException,
                                            NoSuccessException
Creates a LogicalFile using READ open mode.

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 entry 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 actually not thrown, but specified in the SAGA specifications.
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.

createLogicalFile

public static LogicalFile createLogicalFile(String sagaFactoryClassname,
                                            Session session,
                                            URL name)
                                     throws NotImplementedException,
                                            IncorrectURLException,
                                            AuthenticationFailedException,
                                            AuthorizationFailedException,
                                            PermissionDeniedException,
                                            BadParameterException,
                                            AlreadyExistsException,
                                            DoesNotExistException,
                                            TimeoutException,
                                            NoSuccessException
Creates a LogicalFile using READ open mode.

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 entry 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 actually not thrown, but specified in the SAGA specifications.
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.

createLogicalFile

public static LogicalFile createLogicalFile(URL name,
                                            int flags)
                                     throws NotImplementedException,
                                            IncorrectURLException,
                                            AuthenticationFailedException,
                                            AuthorizationFailedException,
                                            PermissionDeniedException,
                                            BadParameterException,
                                            AlreadyExistsException,
                                            DoesNotExistException,
                                            TimeoutException,
                                            NoSuccessException
Creates a LogicalFile 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 entry 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.

createLogicalFile

public static LogicalFile createLogicalFile(String sagaFactoryClassname,
                                            URL name,
                                            int flags)
                                     throws NotImplementedException,
                                            IncorrectURLException,
                                            AuthenticationFailedException,
                                            AuthorizationFailedException,
                                            PermissionDeniedException,
                                            BadParameterException,
                                            AlreadyExistsException,
                                            DoesNotExistException,
                                            TimeoutException,
                                            NoSuccessException
Creates a LogicalFile 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 entry 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.

createLogicalFile

public static LogicalFile createLogicalFile(URL name)
                                     throws NotImplementedException,
                                            IncorrectURLException,
                                            AuthenticationFailedException,
                                            AuthorizationFailedException,
                                            PermissionDeniedException,
                                            BadParameterException,
                                            AlreadyExistsException,
                                            DoesNotExistException,
                                            TimeoutException,
                                            NoSuccessException
Creates a LogicalFile using READ open mode, 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 entry 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 actually not thrown, but specified in the SAGA specifications.
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.

createLogicalFile

public static LogicalFile createLogicalFile(String sagaFactoryClassname,
                                            URL name)
                                     throws NotImplementedException,
                                            IncorrectURLException,
                                            AuthenticationFailedException,
                                            AuthorizationFailedException,
                                            PermissionDeniedException,
                                            BadParameterException,
                                            AlreadyExistsException,
                                            DoesNotExistException,
                                            TimeoutException,
                                            NoSuccessException
Creates a LogicalFile using READ open mode, 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 entry 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 actually not thrown, but specified in the SAGA specifications.
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.

createLogicalDirectory

public static LogicalDirectory createLogicalDirectory(Session session,
                                                      URL name,
                                                      int flags)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException
Creates a LogicalDirectory.

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 entry 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.

createLogicalDirectory

public static LogicalDirectory createLogicalDirectory(String sagaFactoryClassname,
                                                      Session session,
                                                      URL name,
                                                      int flags)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException
Creates a LogicalDirectory.

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 entry 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.

createLogicalDirectory

public static LogicalDirectory createLogicalDirectory(Session session,
                                                      URL name)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException
Creates a LogicalDirectory using READ open mode.

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 entry 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 actually not thrown, but specified in the SAGA specifications.
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.

createLogicalDirectory

public static LogicalDirectory createLogicalDirectory(String sagaFactoryClassname,
                                                      Session session,
                                                      URL name)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException
Creates a LogicalDirectory using READ open mode.

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 entry 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 actually not thrown, but specified in the SAGA specifications.
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.

createLogicalDirectory

public static LogicalDirectory createLogicalDirectory(URL name,
                                                      int flags)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException
Creates a LogicalDirectory 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 entry 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.

createLogicalDirectory

public static LogicalDirectory createLogicalDirectory(String sagaFactoryClassname,
                                                      URL name,
                                                      int flags)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException
Creates a LogicalDirectory 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 entry 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.

createLogicalDirectory

public static LogicalDirectory createLogicalDirectory(URL name)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException
Creates a LogicalDirectory using READ open mode, 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 entry 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 actually not thrown, but specified in the SAGA specifications.
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.

createLogicalDirectory

public static LogicalDirectory createLogicalDirectory(String sagaFactoryClassname,
                                                      URL name)
                                               throws NotImplementedException,
                                                      IncorrectURLException,
                                                      AuthenticationFailedException,
                                                      AuthorizationFailedException,
                                                      PermissionDeniedException,
                                                      BadParameterException,
                                                      AlreadyExistsException,
                                                      DoesNotExistException,
                                                      TimeoutException,
                                                      NoSuccessException
Creates a LogicalDirectory using READ open mode, 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 entry 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 actually not thrown, but specified in the SAGA specifications.
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.

createLogicalFile

public static Task<LogicalFileFactory,LogicalFile> createLogicalFile(TaskMode mode,
                                                                     Session session,
                                                                     URL name,
                                                                     int flags)
                                                              throws NotImplementedException,
                                                                     NoSuccessException
Creates a task that creates a LogicalFile.

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.

createLogicalFile

public static Task<LogicalFileFactory,LogicalFile> createLogicalFile(String sagaFactoryClassname,
                                                                     TaskMode mode,
                                                                     Session session,
                                                                     URL name,
                                                                     int flags)
                                                              throws NotImplementedException,
                                                                     NoSuccessException
Creates a task that creates a LogicalFile.

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.

createLogicalFile

public static Task<LogicalFileFactory,LogicalFile> createLogicalFile(TaskMode mode,
                                                                     Session session,
                                                                     URL name)
                                                              throws NotImplementedException,
                                                                     NoSuccessException
Creates a task that creates a LogicalFile using READ open mode.

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.

createLogicalFile

public static Task<LogicalFileFactory,LogicalFile> createLogicalFile(String sagaFactoryClassname,
                                                                     TaskMode mode,
                                                                     Session session,
                                                                     URL name)
                                                              throws NotImplementedException,
                                                                     NoSuccessException
Creates a task that creates a LogicalFile using READ open mode.

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.

createLogicalFile

public static Task<LogicalFileFactory,LogicalFile> createLogicalFile(TaskMode mode,
                                                                     URL name,
                                                                     int flags)
                                                              throws NotImplementedException,
                                                                     NoSuccessException
Creates a task that creates a LogicalFile 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.

createLogicalFile

public static Task<LogicalFileFactory,LogicalFile> createLogicalFile(String sagaFactoryClassname,
                                                                     TaskMode mode,
                                                                     URL name,
                                                                     int flags)
                                                              throws NotImplementedException,
                                                                     NoSuccessException
Creates a task that creates a LogicalFile 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.

createLogicalFile

public static Task<LogicalFileFactory,LogicalFile> createLogicalFile(TaskMode mode,
                                                                     URL name)
                                                              throws NotImplementedException,
                                                                     NoSuccessException
Creates a task that creates a LogicalFile using READ open mode, 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.

createLogicalFile

public static Task<LogicalFileFactory,LogicalFile> createLogicalFile(String sagaFactoryClassname,
                                                                     TaskMode mode,
                                                                     URL name)
                                                              throws NotImplementedException,
                                                                     NoSuccessException
Creates a task that creates a LogicalFile using READ open mode, 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.

createLogicalDirectory

public static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(TaskMode mode,
                                                                               Session session,
                                                                               URL name,
                                                                               int flags)
                                                                        throws NotImplementedException,
                                                                               NoSuccessException
Creates a task that creates a LogicalDirectory.

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.

createLogicalDirectory

public static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(String sagaFactoryClassname,
                                                                               TaskMode mode,
                                                                               Session session,
                                                                               URL name,
                                                                               int flags)
                                                                        throws NotImplementedException,
                                                                               NoSuccessException
Creates a task that creates a LogicalDirectory.

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.

createLogicalDirectory

public static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(TaskMode mode,
                                                                               Session session,
                                                                               URL name)
                                                                        throws NotImplementedException,
                                                                               NoSuccessException
Creates a task that creates a LogicalDirectory using READ open mode.

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.

createLogicalDirectory

public static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(String sagaFactoryClassname,
                                                                               TaskMode mode,
                                                                               Session session,
                                                                               URL name)
                                                                        throws NotImplementedException,
                                                                               NoSuccessException
Creates a task that creates a LogicalDirectory using READ open mode.

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.

createLogicalDirectory

public static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(TaskMode mode,
                                                                               URL name,
                                                                               int flags)
                                                                        throws NotImplementedException,
                                                                               NoSuccessException
Creates a task that creates a LogicalDirectory 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.

createLogicalDirectory

public static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(String sagaFactoryClassname,
                                                                               TaskMode mode,
                                                                               URL name,
                                                                               int flags)
                                                                        throws NotImplementedException,
                                                                               NoSuccessException
Creates a task that creates a LogicalDirectory 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.

createLogicalDirectory

public static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(TaskMode mode,
                                                                               URL name)
                                                                        throws NotImplementedException,
                                                                               NoSuccessException
Creates a task that creates a LogicalDirectory using READ open mode, 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.

createLogicalDirectory

public static Task<LogicalFileFactory,LogicalDirectory> createLogicalDirectory(String sagaFactoryClassname,
                                                                               TaskMode mode,
                                                                               URL name)
                                                                        throws NotImplementedException,
                                                                               NoSuccessException
Creates a task that creates a LogicalDirectory using READ open mode, 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.


Copyright © 2014 Open Grid Forum. All rights reserved.