org.ogf.saga.logicalfile

Class LogicalFileFactory

java.lang.Object

org.ogf.saga.logicalfile.LogicalFileFactory

public abstract class LogicalFileFactory
extends Object

Factory for objects from the logicalfile package.

Constructor Summary

Constructors

Constructor and Description
LogicalFileFactory()

Method Summary

Methods

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