org.ogf.saga.namespace

Class NSFactory

java.lang.Object

org.ogf.saga.namespace.NSFactory

public abstract class NSFactory
extends Object

Factory for objects from the namespace package.

Constructor Summary

Constructors

Constructor and Description
NSFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static NSDirectory	createNSDirectory(Session session, URL name) Creates a namespace directory.
static NSDirectory	createNSDirectory(Session session, URL name, int flags) Creates a namespace directory.
static NSDirectory	createNSDirectory(String sagaFactoryClassname, Session session, URL name) Creates a namespace directory.
static NSDirectory	createNSDirectory(String sagaFactoryClassname, Session session, URL name, int flags) Creates a namespace directory.
static Task<NSFactory,NSDirectory>	createNSDirectory(String sagaFactoryClassname, TaskMode mode, Session session, URL name) Creates a task that creates a namespace directory.
static Task<NSFactory,NSDirectory>	createNSDirectory(String sagaFactoryClassname, TaskMode mode, Session session, URL name, int flags) Creates a task that creates a namespace directory.
static Task<NSFactory,NSDirectory>	createNSDirectory(String sagaFactoryClassname, TaskMode mode, URL name) Creates a task that creates a namespace directory using the default session.
static Task<NSFactory,NSDirectory>	createNSDirectory(String sagaFactoryClassname, TaskMode mode, URL name, int flags) Creates a task that creates a namespace directory using the default session.
static NSDirectory	createNSDirectory(String sagaFactoryClassname, URL name) Creates a namespace directory using the default session.
static NSDirectory	createNSDirectory(String sagaFactoryClassname, URL name, int flags) Creates a namespace directory using the default session.
static Task<NSFactory,NSDirectory>	createNSDirectory(TaskMode mode, Session session, URL name) Creates a task that creates a namespace directory.
static Task<NSFactory,NSDirectory>	createNSDirectory(TaskMode mode, Session session, URL name, int flags) Creates a task that creates a namespace directory.
static Task<NSFactory,NSDirectory>	createNSDirectory(TaskMode mode, URL name) Creates a task that creates a namespace directory using the default session.
static Task<NSFactory,NSDirectory>	createNSDirectory(TaskMode mode, URL name, int flags) Creates a task that creates a namespace directory using the default session.
static NSDirectory	createNSDirectory(URL name) Creates a namespace directory using the default session.
static NSDirectory	createNSDirectory(URL name, int flags) Creates a namespace directory using the default session.
static NSEntry	createNSEntry(Session session, URL name) Creates a namespace entry.
static NSEntry	createNSEntry(Session session, URL name, int flags) Creates a namespace entry.
static NSEntry	createNSEntry(String sagaFactoryClassname, Session session, URL name) Creates a namespace entry.
static NSEntry	createNSEntry(String sagaFactoryClassname, Session session, URL name, int flags) Creates a namespace entry.
static Task<NSFactory,NSEntry>	createNSEntry(String sagaFactoryClassname, TaskMode mode, Session session, URL name) Creates a task that creates a namespace entry.
static Task<NSFactory,NSEntry>	createNSEntry(String sagaFactoryClassname, TaskMode mode, Session session, URL name, int flags) Creates a task that creates a namespace entry.
static Task<NSFactory,NSEntry>	createNSEntry(String sagaFactoryClassname, TaskMode mode, URL name) Creates a task that creates a namespace entry using the default session.
static Task<NSFactory,NSEntry>	createNSEntry(String sagaFactoryClassname, TaskMode mode, URL name, int flags) Creates a task that creates a namespace entry using the default session.
static NSEntry	createNSEntry(String sagaFactoryClassname, URL name) Creates a namespace entry using the default session.
static NSEntry	createNSEntry(String sagaFactoryClassname, URL name, int flags) Creates a namespace entry using the default session.
static Task<NSFactory,NSEntry>	createNSEntry(TaskMode mode, Session session, URL name) Creates a task that creates a namespace entry.
static Task<NSFactory,NSEntry>	createNSEntry(TaskMode mode, Session session, URL name, int flags) Creates a task that creates a namespace entry.
static Task<NSFactory,NSEntry>	createNSEntry(TaskMode mode, URL name) Creates a task that creates a namespace entry using the default session.
static Task<NSFactory,NSEntry>	createNSEntry(TaskMode mode, URL name, int flags) Creates a task that creates a namespace entry using the default session.
static NSEntry	createNSEntry(URL name) Creates a namespace entry using the default session.
static NSEntry	createNSEntry(URL name, int flags) Creates a namespace entry using the default session.
protected abstract NSDirectory	doCreateNSDirectory(Session session, URL name, int flags) Creates a namespace directory.
protected abstract Task<NSFactory,NSDirectory>	doCreateNSDirectory(TaskMode mode, Session session, URL name, int flags) Creates a task that creates a namespace directory.
protected abstract NSEntry	doCreateNSEntry(Session session, URL name, int flags) Creates a namespace entry.
protected abstract Task<NSFactory,NSEntry>	doCreateNSEntry(TaskMode mode, Session session, URL name, int flags) Creates a task that creates a namespace entry.

Methods inherited from class java.lang.Object

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

Constructor Detail

NSFactory

public NSFactory()

Method Detail

doCreateNSEntry

protected abstract Task<NSFactory,NSEntry> doCreateNSEntry(TaskMode mode,
                                      Session session,
                                      URL name,
                                      int flags)
                                                    throws NotImplementedException

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

Parameters:

mode - the task mode.

session - the session handle.

name - the initial working directory.

flags - the open mode.

Returns:

the task.

Throws:

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

doCreateNSDirectory

protected abstract Task<NSFactory,NSDirectory> doCreateNSDirectory(TaskMode mode,
                                              Session session,
                                              URL name,
                                              int flags)
                                                            throws NotImplementedException

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

Parameters:

mode - the task mode.

session - the session handle.

name - the initial working directory.

flags - the open mode.

Returns:

the task.

Throws:

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

doCreateNSEntry

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

Creates a namespace entry. To be provided by the implementation.

Parameters:

session - the session handle.

name - the initial working directory.

flags - the open mode.

Returns:

the namespace entry.

Throws:

NotImplementedException

IncorrectURLException

AuthenticationFailedException

AuthorizationFailedException

PermissionDeniedException

BadParameterException

DoesNotExistException

AlreadyExistsException

TimeoutException

NoSuccessException

doCreateNSDirectory

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

Creates a namespace directory. To be provided by the implementation.

Parameters:

session - the session handle.

name - the initial working directory.

flags - the open mode.

Returns:

the namespace directory.

Throws:

NotImplementedException

IncorrectURLException

AuthenticationFailedException

AuthorizationFailedException

PermissionDeniedException

BadParameterException

DoesNotExistException

AlreadyExistsException

TimeoutException

NoSuccessException

createNSEntry

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

Creates a namespace entry.

Parameters:

session - the session handle.

name - the initial working directory.

flags - the open mode.

Returns:

the namespace entry.

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.

createNSEntry

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

Creates a namespace entry.

Parameters:

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

session - the session handle.

name - the initial working directory.

flags - the open mode.

Returns:

the namespace entry.

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.

createNSEntry

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

Creates a namespace entry.

Parameters:

session - the session handle.

name - the initial working directory.

Returns:

the namespace entry.

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.

createNSEntry

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

Creates a namespace entry.

Parameters:

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

session - the session handle.

name - the initial working directory.

Returns:

the namespace entry.

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.

createNSEntry

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

Creates a namespace entry using the default session.

Parameters:

name - the initial working directory.

flags - the open mode.

Returns:

the namespace entry.

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.

createNSEntry

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

Creates a namespace entry using the default session.

Parameters:

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

name - the initial working directory.

flags - the open mode.

Returns:

the namespace entry.

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.

createNSEntry

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

Creates a namespace entry using the default session.

Parameters:

name - the initial working directory.

Returns:

the namespace entry.

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.

createNSEntry

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

Creates a namespace entry using the default session.

Parameters:

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

name - the initial working directory.

Returns:

the namespace entry.

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.

createNSDirectory

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

Creates a namespace directory.

Parameters:

session - the session handle.

name - the initial working directory.

flags - the open mode.

Returns:

the namespace directory.

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.

createNSDirectory

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

Creates a namespace directory.

Parameters:

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

session - the session handle.

name - the initial working directory.

flags - the open mode.

Returns:

the namespace directory.

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.

createNSDirectory

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

Creates a namespace directory.

Parameters:

session - the session handle.

name - the initial working directory.

Returns:

the namespace directory.

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.

createNSDirectory

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

Creates a namespace directory.

Parameters:

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

session - the session handle.

name - the initial working directory.

Returns:

the namespace directory.

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.

createNSDirectory

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

Creates a namespace directory using the default session.

Parameters:

name - the initial working directory.

flags - the open mode.

Returns:

the namespace directory.

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.

createNSDirectory

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

Creates a namespace directory using the default session.

Parameters:

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

name - the initial working directory.

flags - the open mode.

Returns:

the namespace directory.

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.

createNSDirectory

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

Creates a namespace directory using the default session.

Parameters:

name - the initial working directory.

Returns:

the namespace directory.

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.

createNSDirectory

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

Creates a namespace directory using the default session.

Parameters:

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

name - the initial working directory.

Returns:

the namespace directory.

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.

createNSEntry

public static Task<NSFactory,NSEntry> createNSEntry(TaskMode mode,
                                    Session session,
                                    URL name,
                                    int flags)
                                             throws NotImplementedException,
                                                    NoSuccessException

Creates a task that creates a namespace entry.

Parameters:

mode - the task mode.

session - the session handle.

name - the initial working 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.

createNSEntry

public static Task<NSFactory,NSEntry> createNSEntry(String sagaFactoryClassname,
                                    TaskMode mode,
                                    Session session,
                                    URL name,
                                    int flags)
                                             throws NotImplementedException,
                                                    NoSuccessException

Creates a task that creates a namespace entry.

Parameters:

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

mode - the task mode.

session - the session handle.

name - the initial working 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.

createNSEntry

public static Task<NSFactory,NSEntry> createNSEntry(TaskMode mode,
                                    Session session,
                                    URL name)
                                             throws NotImplementedException,
                                                    NoSuccessException

Creates a task that creates a namespace entry.

Parameters:

mode - the task mode.

session - the session handle.

name - the initial working 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.

createNSEntry

public static Task<NSFactory,NSEntry> createNSEntry(String sagaFactoryClassname,
                                    TaskMode mode,
                                    Session session,
                                    URL name)
                                             throws NotImplementedException,
                                                    NoSuccessException

Creates a task that creates a namespace entry.

Parameters:

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

mode - the task mode.

session - the session handle.

name - the initial working 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.

createNSEntry

public static Task<NSFactory,NSEntry> createNSEntry(TaskMode mode,
                                    URL name,
                                    int flags)
                                             throws NotImplementedException,
                                                    NoSuccessException

Creates a task that creates a namespace entry using the default session.

Parameters:

mode - the task mode.

name - the initial working 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.

createNSEntry

public static Task<NSFactory,NSEntry> createNSEntry(String sagaFactoryClassname,
                                    TaskMode mode,
                                    URL name,
                                    int flags)
                                             throws NotImplementedException,
                                                    NoSuccessException

Creates a task that creates a namespace entry using the default session.

Parameters:

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

mode - the task mode.

name - the initial working 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.

createNSEntry

public static Task<NSFactory,NSEntry> createNSEntry(TaskMode mode,
                                    URL name)
                                             throws NotImplementedException,
                                                    NoSuccessException

Creates a task that creates a namespace entry using the default session.

Parameters:

mode - the task mode.

name - the initial working 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.

createNSEntry

public static Task<NSFactory,NSEntry> createNSEntry(String sagaFactoryClassname,
                                    TaskMode mode,
                                    URL name)
                                             throws NotImplementedException,
                                                    NoSuccessException

Creates a task that creates a namespace entry using the default session.

Parameters:

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

mode - the task mode.

name - the initial working 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.

createNSDirectory

public static Task<NSFactory,NSDirectory> createNSDirectory(TaskMode mode,
                                            Session session,
                                            URL name,
                                            int flags)
                                                     throws NotImplementedException,
                                                            NoSuccessException

Creates a task that creates a namespace directory.

Parameters:

mode - the task mode.

session - the session handle.

name - the initial working 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.

createNSDirectory

public static Task<NSFactory,NSDirectory> createNSDirectory(String sagaFactoryClassname,
                                            TaskMode mode,
                                            Session session,
                                            URL name,
                                            int flags)
                                                     throws NotImplementedException,
                                                            NoSuccessException

Creates a task that creates a namespace directory.

Parameters:

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

mode - the task mode.

session - the session handle.

name - the initial working 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.

createNSDirectory

public static Task<NSFactory,NSDirectory> createNSDirectory(TaskMode mode,
                                            Session session,
                                            URL name)
                                                     throws NotImplementedException,
                                                            NoSuccessException

Creates a task that creates a namespace directory.

Parameters:

mode - the task mode.

session - the session handle.

name - the initial working 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.

createNSDirectory

public static Task<NSFactory,NSDirectory> createNSDirectory(String sagaFactoryClassname,
                                            TaskMode mode,
                                            Session session,
                                            URL name)
                                                     throws NotImplementedException,
                                                            NoSuccessException

Creates a task that creates a namespace directory.

Parameters:

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

mode - the task mode.

session - the session handle.

name - the initial working 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.

createNSDirectory

public static Task<NSFactory,NSDirectory> createNSDirectory(TaskMode mode,
                                            URL name,
                                            int flags)
                                                     throws NotImplementedException,
                                                            NoSuccessException

Creates a task that creates a namespace directory using the default session.

Parameters:

mode - the task mode.

name - the initial working 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.

createNSDirectory

public static Task<NSFactory,NSDirectory> createNSDirectory(String sagaFactoryClassname,
                                            TaskMode mode,
                                            URL name,
                                            int flags)
                                                     throws NotImplementedException,
                                                            NoSuccessException

Creates a task that creates a namespace directory using the default session.

Parameters:

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

mode - the task mode.

name - the initial working 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.

createNSDirectory

public static Task<NSFactory,NSDirectory> createNSDirectory(TaskMode mode,
                                            URL name)
                                                     throws NotImplementedException,
                                                            NoSuccessException

Creates a task that creates a namespace directory using the default session.

Parameters:

mode - the task mode.

name - the initial working 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.

createNSDirectory

public static Task<NSFactory,NSDirectory> createNSDirectory(String sagaFactoryClassname,
                                            TaskMode mode,
                                            URL name)
                                                     throws NotImplementedException,
                                                            NoSuccessException

Creates a task that creates a namespace directory using the default session.

Parameters:

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

mode - the task mode.

name - the initial working 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.