com.openexchange.admin.rmi

Interface OXContextInterface

All Superinterfaces:

java.rmi.Remote

public interface OXContextInterface
extends java.rmi.Remote

This class defines the Open-Xchange API Version 2 for creating and manipulating OX Contexts.

To create a new context, you must first register a database,server and filestore to the system!
For details about registering a filestore,server or databases have a look in the OXUtilInterface.

Example:

 final OXContextInterface iface = (OXContextInterface)Naming.lookup("rmi:///oxhost/"+OXContextInterface.RMI_NAME);

 final Context ctx = new Context(1337);

 User usr = new User();
 usr.setDisplay_name("admin display name");
 usr.setName("admin");
 usr.setPassword("secret");
 usr.setMailenabled(true);
 usr.setPrimaryEmail("admin@example.org");
 usr.setEmail1("admin@example.org");
 usr.setGiven_name("my");
 usr.setSur_name("admin");


 final Credentials auth = new Credentials();
 auth.setLogin("admin");
 auth.setPassword("secret");

 iface.create(ctx,usr,access,auth);

 

Author:

Manuel Kraft, Carsten Hoeger, Dennis Sieben

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	RMI_NAME RMI name to be used in the naming lookup.

Method Summary

Methods

Modifier and Type	Method and Description
void	change(Context ctx, Credentials auth) Change specified context! This method currently modifies following data: Login mappings - You can then login via usernam@loginmapping instead of username@contextID Context name in configdb - This is for better organization of contexts in your whole system.
void	changeCapabilities(Context ctx, java.util.Set<java.lang.String> capsToAdd, java.util.Set<java.lang.String> capsToRemove, java.util.Set<java.lang.String> capsToDrop, Credentials auth) Changes specified context's capabilities.
void	changeModuleAccess(Context ctx, java.lang.String access_combination_name, Credentials auth) Change module access rights by "access combination name" for ALL users in the specified context. IF you want to change data of a context like quota etc. use Method change(Context ctx, Credentials auth) This method modifies ONLY the access rights of the context!
void	changeModuleAccess(Context ctx, UserModuleAccess access, Credentials auth) Change module access rights for ALL users in the specified context. IF you want to change data of a context like quota etc. use Method change(final Context ctx, final Credentials auth) This method modifies ONLY the access rights of the context!
void	changeQuota(Context ctx, java.lang.String module, long quotaValue, Credentials auth) Changes specified context's quota for a certain module.
boolean	checkExists(Context ctx, Credentials auth) Deprecated.
Context	create(Context ctx, User admin_user, Credentials auth) Create a new context.
Context	create(Context ctx, User admin_user, Credentials auth, SchemaSelectStrategy schemaSelectStrategy) Create a new context.
Context	create(Context ctx, User admin_user, java.lang.String access_combination_name, Credentials auth) Create a new context! Given access combination name will be used for admin module access rights!
Context	create(Context ctx, User admin_user, java.lang.String access_combination_name, Credentials auth, SchemaSelectStrategy schemaSelectStrategy) Create a new context! Given access combination name will be used for admin module access rights!
Context	create(Context ctx, User admin_user, UserModuleAccess access, Credentials auth) Create a new context! Given access rights be used for admin!
Context	create(Context ctx, User admin_user, UserModuleAccess access, Credentials auth, SchemaSelectStrategy schemaSelectStrategy) Create a new context! Given access rights be used for admin!
void	delete(Context ctx, Credentials auth) Delete a context. Note: Deleting a context will delete all data which the context include (all users, groups, appointments, ...
void	disable(Context ctx, Credentials auth) Disable given context.
void	disableAll(Credentials auth) Disable all contexts.
void	downgrade(Context ctx, Credentials auth) If context was changed, call this method to flush data which is no longer needed due to access permission changes!
void	enable(Context ctx, Credentials auth) Enable given context.
void	enableAll(Credentials auth) Enable all contexts.
boolean	exists(Context ctx, Credentials auth) Determines whether a context already exists.
java.lang.String	getAccessCombinationName(Context ctx, Credentials auth) Get current access combination name of the context based on the rights of the admin user!
int	getAdminId(Context ctx, Credentials auth) Determines the user ID of the admin user for a given context
java.util.Set<java.lang.String>	getCapabilities(Context ctx, Credentials auth) Gets specified context's capabilities.
Context[]	getData(Context[] ctx, Credentials auth) Get specified context details
Context	getData(Context ctx, Credentials auth) Get specified context details
UserModuleAccess	getModuleAccess(Context ctx, Credentials auth) Get current module access rights of the context based on the rights of the admin user!
Context	getOwnData(Context ctx, Credentials auth) Get specified context details
Context[]	list(java.lang.String search_pattern, Credentials auth) Search for contexts Returns all contexts matching the provided search_pattern.
Context[]	listAll(Credentials auth) Convenience method for listing all contexts Use this for search a context or list all contexts.
Context[]	listByDatabase(Database db, Credentials auth) Search for context on specified db.
Context[]	listByFilestore(Filestore fs, Credentials auth) Search for context which store data on specified filestore
Quota[]	listQuotas(Context ctx, Credentials auth) Gets the configured quotas in given context.
int	moveContextDatabase(Context ctx, Database dst_database_id, Credentials auth) Move all data of a context contained in a database to another database
int	moveContextFilestore(Context ctx, Filestore dst_filestore_id, Credentials auth) Move all data of a context contained on the filestore to another filestore

Field Detail

RMI_NAME

static final java.lang.String RMI_NAME

RMI name to be used in the naming lookup.

See Also:

Constant Field Values

Method Detail

create

Context create(Context ctx,
             User admin_user,
             Credentials auth)
               throws java.rmi.RemoteException,
                      StorageException,
                      InvalidCredentialsException,
                      InvalidDataException,
                      ContextExistsException

Create a new context. If setFilestoreId() or setWriteDatabase() has been used in the given context object, the context will be created in the corresponding database or filestore. The assigned limits to the database/filestore are ignored, though.

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

admin_user - User data of administrative user account for this context

auth - Credentials for authenticating against server.

Returns:

Context object.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

ContextExistsException

create

Context create(Context ctx,
             User admin_user,
             java.lang.String access_combination_name,
             Credentials auth)
               throws java.rmi.RemoteException,
                      StorageException,
                      InvalidCredentialsException,
                      InvalidDataException,
                      ContextExistsException

Create a new context! Given access combination name will be used for admin module access rights!

Parameters:

ctx - Context object

admin_user - User data of administrative user account for this context

access_combination_name - String Access combination name!

auth - Credentials for authenticating against server.

Returns:

A new Context object, this should not have been used before or a one returned from a previous call to this API.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

ContextExistsException

create

Context create(Context ctx,
             User admin_user,
             UserModuleAccess access,
             Credentials auth)
               throws java.rmi.RemoteException,
                      StorageException,
                      InvalidCredentialsException,
                      InvalidDataException,
                      ContextExistsException

Create a new context! Given access rights be used for admin!

Parameters:

ctx - Context object

admin_user - User data of administrative user account for this context

access - UserModuleAccess Access rights!

auth - Credentials for authenticating against server.

Returns:

A new Context object, this should not have been used before or a one returned from a previous call to this API.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

ContextExistsException

create

Context create(Context ctx,
             User admin_user,
             Credentials auth,
             SchemaSelectStrategy schemaSelectStrategy)
               throws java.rmi.RemoteException,
                      StorageException,
                      InvalidCredentialsException,
                      InvalidDataException,
                      ContextExistsException

Create a new context. If setFilestoreId() or setWriteDatabase() has been used in the given context object, the context will be created in the corresponding database or filestore. The assigned limits to the database/filestore are ignored, though.

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

admin_user - User data of administrative user account for this context

auth - Credentials for authenticating against server.

schemaSelectStrategy - SchemaSelectStrategy to define how to select the schema where the context will be created.

Returns:

Context object.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

ContextExistsException

create

Context create(Context ctx,
             User admin_user,
             java.lang.String access_combination_name,
             Credentials auth,
             SchemaSelectStrategy schemaSelectStrategy)
               throws java.rmi.RemoteException,
                      StorageException,
                      InvalidCredentialsException,
                      InvalidDataException,
                      ContextExistsException

Create a new context! Given access combination name will be used for admin module access rights!

Parameters:

ctx - Context object

admin_user - User data of administrative user account for this context

access_combination_name - String Access combination name!

auth - Credentials for authenticating against server.

schemaSelectStrategy - SchemaSelectStrategy to define how to select the schema where the context will be created.

Returns:

A new Context object, this should not have been used before or a one returned from a previous call to this API.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

ContextExistsException

create

Context create(Context ctx,
             User admin_user,
             UserModuleAccess access,
             Credentials auth,
             SchemaSelectStrategy schemaSelectStrategy)
               throws java.rmi.RemoteException,
                      StorageException,
                      InvalidCredentialsException,
                      InvalidDataException,
                      ContextExistsException

Create a new context! Given access rights be used for admin!

Parameters:

ctx - Context object

admin_user - User data of administrative user account for this context

access - UserModuleAccess Access rights!

auth - Credentials for authenticating against server.

schemaSelectStrategy - SchemaSelectStrategy to define how to select the schema where the context will be created.

Returns:

A new Context object, this should not have been used before or a one returned from a previous call to this API.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

ContextExistsException

delete

void delete(Context ctx,
          Credentials auth)
            throws java.rmi.RemoteException,
                   InvalidCredentialsException,
                   NoSuchContextException,
                   StorageException,
                   DatabaseUpdateException,
                   InvalidDataException

Delete a context.
Note: Deleting a context will delete all data which the context include (all users, groups, appointments, ... )

Parameters:

auth - Credentials for authenticating against server.

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

NoSuchContextException - If the context does not exist in the system.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

DatabaseUpdateException

InvalidDataException

downgrade

void downgrade(Context ctx,
             Credentials auth)
               throws java.rmi.RemoteException,
                      InvalidCredentialsException,
                      NoSuchContextException,
                      StorageException,
                      DatabaseUpdateException,
                      InvalidDataException

If context was changed, call this method to flush data which is no longer needed due to access permission changes!

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

auth - Credentials for authenticating against server.

Throws:

java.rmi.RemoteException - General RMI Exception

InvalidCredentialsException

NoSuchContextException

StorageException - When an error in the subsystems occurred.

DatabaseUpdateException

InvalidDataException

moveContextFilestore

int moveContextFilestore(Context ctx,
                       Filestore dst_filestore_id,
                       Credentials auth)
                         throws java.rmi.RemoteException,
                                InvalidCredentialsException,
                                NoSuchContextException,
                                StorageException,
                                InvalidDataException,
                                NoSuchFilestoreException,
                                NoSuchReasonException,
                                OXContextException

Move all data of a context contained on the filestore to another filestore

This method returns immediately and the data is going to be copied in the background. To query the progress and the result of the actual task, the AdminJobExecutor interface must be used.

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

dst_filestore_id - Id of the Filestore to move the context in.

auth - Credentials for authenticating against server.

Returns:

Job id which can be used for retrieving progress information.

Throws:

InvalidCredentialsException - Credentials for authenticating against server.

NoSuchContextException - If the context does not exist in the system.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occured.

NoSuchFilestoreException

NoSuchReasonException

OXContextException

moveContextDatabase

int moveContextDatabase(Context ctx,
                      Database dst_database_id,
                      Credentials auth)
                        throws java.rmi.RemoteException,
                               InvalidCredentialsException,
                               NoSuchContextException,
                               StorageException,
                               InvalidDataException,
                               DatabaseUpdateException,
                               OXContextException

Move all data of a context contained in a database to another database

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

dst_database_id - ID of a registered Database to move all data of this context in.

auth - Credentials for authenticating against server.

Returns:

String containing return queue id to query status of job.

This method returns immediately and the data is going to be copied in the background. To query the progress and the result of the actual task, the AdminJobExecutor interface must be used.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

NoSuchContextException - If the context does not exist in the system.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occured.

DatabaseUpdateException

OXContextException

disable

void disable(Context ctx,
           Credentials auth)
             throws java.rmi.RemoteException,
                    InvalidCredentialsException,
                    NoSuchContextException,
                    StorageException,
                    InvalidDataException,
                    NoSuchReasonException,
                    OXContextException

Disable given context.

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

auth - Credentials for authenticating against server.

Throws:

InvalidCredentialsException - Credentials for authenticating against server.

NoSuchContextException - If the context does not exist in the system.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

NoSuchReasonException

OXContextException

enable

void enable(Context ctx,
          Credentials auth)
            throws java.rmi.RemoteException,
                   InvalidCredentialsException,
                   NoSuchContextException,
                   StorageException,
                   InvalidDataException

Enable given context.

Parameters:

auth - Credentials for authenticating against server.

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

NoSuchContextException - If the context does not exist in the system.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

InvalidDataException

list

Context[] list(java.lang.String search_pattern,
             Credentials auth)
               throws java.rmi.RemoteException,
                      StorageException,
                      InvalidCredentialsException,
                      InvalidDataException

Search for contexts
Returns all contexts matching the provided search_pattern. The search pattern is directly transformed into a SQL LIKE string comparison, where
a * is transformed into a %
a % and a _ must be escaped by a \ (e.g. if you want to search for _doe, use the pattern \_doe

Parameters:

auth - Credentials for authenticating against server.

search_pattern - Search pattern e.g "*mycontext*".

Returns:

Contexts.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

listAll

Context[] listAll(Credentials auth)
                  throws java.rmi.RemoteException,
                         StorageException,
                         InvalidCredentialsException,
                         InvalidDataException

Convenience method for listing all contexts Use this for search a context or list all contexts.

Parameters:

auth - Credentials for authenticating against server.

Returns:

Contexts.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

disableAll

void disableAll(Credentials auth)
                throws java.rmi.RemoteException,
                       StorageException,
                       InvalidCredentialsException,
                       InvalidDataException,
                       NoSuchReasonException

Disable all contexts.

Parameters:

auth - Credentials for authenticating against server.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

NoSuchReasonException

enableAll

void enableAll(Credentials auth)
               throws java.rmi.RemoteException,
                      StorageException,
                      InvalidCredentialsException

Enable all contexts.

Parameters:

auth - Credentials for authenticating against server.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

getOwnData

Context getOwnData(Context ctx,
                 Credentials auth)
                   throws java.rmi.RemoteException,
                          InvalidCredentialsException,
                          NoSuchContextException,
                          StorageException,
                          InvalidDataException

Get specified context details

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API. The context IDs of these objects should be set.

auth - The context-specific credentials

Returns:

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

getData

Context[] getData(Context[] ctx,
                Credentials auth)
                  throws java.rmi.RemoteException,
                         InvalidCredentialsException,
                         NoSuchContextException,
                         StorageException,
                         InvalidDataException

Get specified context details

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API. The context IDs of these objects should be set.

auth -

Returns:

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

getData

Context getData(Context ctx,
              Credentials auth)
                throws java.rmi.RemoteException,
                       InvalidCredentialsException,
                       NoSuchContextException,
                       StorageException,
                       InvalidDataException

Get specified context details

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API. The context ID of this object should be set.

auth - Credentials for authenticating against server.

Returns:

Data for the requested context.

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

change

void change(Context ctx,
          Credentials auth)
            throws java.rmi.RemoteException,
                   InvalidCredentialsException,
                   NoSuchContextException,
                   StorageException,
                   InvalidDataException

Change specified context! This method currently modifies following data: Login mappings - You can then login via usernam@loginmapping instead of username@contextID Context name in configdb - This is for better organization of contexts in your whole system. Change filestore quota size - Change how much quota the context is allowed to use! Change storage data informations - Change filestore infos for context. Normally NO need to change!

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API. Beside the context ID or name for identifying the context itself the object should only contain those field which need to be changed.

auth -

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

getCapabilities

java.util.Set<java.lang.String> getCapabilities(Context ctx,
                                              Credentials auth)
                                                throws java.rmi.RemoteException,
                                                       InvalidCredentialsException,
                                                       NoSuchContextException,
                                                       StorageException,
                                                       InvalidDataException

Gets specified context's capabilities.

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

auth - The credentials

Returns:

The capabilities

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

changeCapabilities

void changeCapabilities(Context ctx,
                      java.util.Set<java.lang.String> capsToAdd,
                      java.util.Set<java.lang.String> capsToRemove,
                      java.util.Set<java.lang.String> capsToDrop,
                      Credentials auth)
                        throws java.rmi.RemoteException,
                               InvalidCredentialsException,
                               NoSuchContextException,
                               StorageException,
                               InvalidDataException

Changes specified context's capabilities.

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

capsToAdd - The capabilities to add

capsToRemove - The capabilities to remove

capsToDrop - The capabilities to drop; e.g. clean from storage

auth - The credentials

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

listQuotas

Quota[] listQuotas(Context ctx,
                 Credentials auth)
                   throws java.rmi.RemoteException,
                          InvalidCredentialsException,
                          NoSuchContextException,
                          StorageException,
                          InvalidDataException

Gets the configured quotas in given context.

Parameters:

ctx - The context

auth - The credentials

Returns:

The configured quota

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

changeQuota

void changeQuota(Context ctx,
               java.lang.String module,
               long quotaValue,
               Credentials auth)
                 throws java.rmi.RemoteException,
                        InvalidCredentialsException,
                        NoSuchContextException,
                        StorageException,
                        InvalidDataException

Changes specified context's quota for a certain module.

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

module - The module to apply quota to

quotaValue - The quota value to set

auth - The credentials

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

changeModuleAccess

void changeModuleAccess(Context ctx,
                      UserModuleAccess access,
                      Credentials auth)
                        throws java.rmi.RemoteException,
                               InvalidCredentialsException,
                               NoSuchContextException,
                               StorageException,
                               InvalidDataException

Change module access rights for ALL users in the specified context.
IF you want to change data of a context like quota etc.
use Method change(final Context ctx, final Credentials auth) This method modifies ONLY the access rights of the context!

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

access -

auth -

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

changeModuleAccess

void changeModuleAccess(Context ctx,
                      java.lang.String access_combination_name,
                      Credentials auth)
                        throws java.rmi.RemoteException,
                               InvalidCredentialsException,
                               NoSuchContextException,
                               StorageException,
                               InvalidDataException

Change module access rights by "access combination name" for ALL users in the specified context.
IF you want to change data of a context like quota etc.
use Method change(Context ctx, Credentials auth) This method modifies ONLY the access rights of the context!

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

access -

auth -

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

getModuleAccess

UserModuleAccess getModuleAccess(Context ctx,
                               Credentials auth)
                                 throws java.rmi.RemoteException,
                                        InvalidCredentialsException,
                                        NoSuchContextException,
                                        StorageException,
                                        InvalidDataException

Get current module access rights of the context based on the rights of the admin user!

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

auth -

Returns:

Current module access rights!

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

getAccessCombinationName

java.lang.String getAccessCombinationName(Context ctx,
                                        Credentials auth)
                                          throws java.rmi.RemoteException,
                                                 InvalidCredentialsException,
                                                 NoSuchContextException,
                                                 StorageException,
                                                 InvalidDataException

Get current access combination name of the context based on the rights of the admin user!

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

auth -

Returns:

Access combination name or null if current access rights cannot be mapped to an access combination name.

Throws:

java.rmi.RemoteException

InvalidCredentialsException

NoSuchContextException

StorageException

InvalidDataException

listByDatabase

Context[] listByDatabase(Database db,
                       Credentials auth)
                         throws java.rmi.RemoteException,
                                StorageException,
                                InvalidCredentialsException,
                                InvalidDataException,
                                NoSuchDatabaseException

Search for context on specified db.

Parameters:

db - Database on which to search for contexts.

auth - Credentials for authenticating against server.

Returns:

Found contexts on the specified database.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

NoSuchDatabaseException

listByFilestore

Context[] listByFilestore(Filestore fs,
                        Credentials auth)
                          throws java.rmi.RemoteException,
                                 StorageException,
                                 InvalidCredentialsException,
                                 InvalidDataException,
                                 NoSuchFilestoreException

Search for context which store data on specified filestore

Parameters:

fs - Filestore

auth - Credentials for authenticating against server.

Returns:

Contexts found on this filestore.

Throws:

InvalidCredentialsException - When the supplied credentials were not correct or invalid.

InvalidDataException - If the data sent within the method contained invalid data.

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

NoSuchFilestoreException

getAdminId

int getAdminId(Context ctx,
             Credentials auth)
               throws java.rmi.RemoteException,
                      InvalidCredentialsException,
                      StorageException,
                      NoSuchContextException

Determines the user ID of the admin user for a given context

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API. This context will be used for determining the userId of the admin.

auth - Credentials for authenticating against the server.

Returns:

The userId of the admin user

Throws:

java.rmi.RemoteException - General RMI Exception

InvalidCredentialsException - Thrown when the login fails

StorageException - Thrown when an error in a subsystem occurred.

NoSuchContextException

exists

boolean exists(Context ctx,
             Credentials auth)
               throws java.rmi.RemoteException,
                      InvalidDataException,
                      StorageException,
                      InvalidCredentialsException

Determines whether a context already exists.

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

auth - Credentials for authenticating against the server.

Returns:

Whether the given context exists or not

Throws:

java.rmi.RemoteException

InvalidDataException

StorageException

InvalidCredentialsException

checkExists

@Deprecated
boolean checkExists(Context ctx,
                             Credentials auth)
                    throws java.rmi.RemoteException,
                           InvalidDataException,
                           StorageException,
                           InvalidCredentialsException

Deprecated.

Determines whether a context already exists.

Parameters:

ctx - A new Context object, this should not have been used before or a one returned from a previous call to this API.

auth - Credentials for authenticating against the server.

Returns:

Whether the given context exists or not

Throws:

java.rmi.RemoteException

InvalidDataException

StorageException

InvalidCredentialsException