com.openexchange.admin.rmi

Interface OXUserInterface

All Superinterfaces:

java.rmi.Remote

public interface OXUserInterface
extends java.rmi.Remote

This class defines the Open-Xchange API Version 2 for creating and manipulating OX Users within an OX context.

Example:

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

 final Context ctx = new Context(1);

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

 final UserModuleAccess access = new UserModuleAccess();
 access.access.enableAll();  // give access to all modules.

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

 User created = 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, User usrdata, Credentials auth) Manipulate user data within the given context.
void	changeCapabilities(Context ctx, User user, 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 user's capabilities.
void	changeMailAddressPersonal(Context ctx, User user, java.lang.String personal, Credentials auth) Changes the personal part of specified user's E-Mail address.
void	changeModuleAccess(Context ctx, User user, java.lang.String access_combination_name, Credentials auth) Manipulate user module access within the given context.
void	changeModuleAccess(Context ctx, User user, UserModuleAccess moduleAccess, Credentials auth) Manipulate user module access within the given context.
void	changeModuleAccessGlobal(java.lang.String filter, UserModuleAccess addAccess, UserModuleAccess removeAccess, Credentials auth) This method changes module Permissions for all (!) users in all (!) contexts.
User	create(Context ctx, User usrdata, Credentials auth) Creates a new user within the given context. Default context access rights are used!
User	create(Context ctx, User usrdata, java.lang.String access_combination_name, Credentials auth) Creates a new user within the given context.
User	create(Context ctx, User usrdata, UserModuleAccess access, Credentials auth) Creates a new user within the given context.
void	delete(Context ctx, User[] users, Credentials auth) Delete user from given context.
void	delete(Context ctx, User user, Credentials auth) Delete user from given context.
boolean	exists(Context ctx, User user, Credentials auth) Check whether the given user exists.
java.lang.String	getAccessCombinationName(Context ctx, User user, Credentials auth) Get current access combination name of an user!
java.util.Set<java.lang.String>	getCapabilities(Context ctx, User user, Credentials auth) Gets specified user's capabilities.
User	getContextAdmin(Context ctx, Credentials auth) Returns the Context admin User object
UserModuleAccess	getContextAdminUserModuleAccess(Context ctx, Credentials auth) Returns the module access rights of the context-admin
User[]	getData(Context ctx, User[] users, Credentials auth) Retrieve user objects for a range of users by username or id.
User	getData(Context ctx, User user, Credentials auth) Retrieve user objects for a range of users by username or id.
UserModuleAccess	getModuleAccess(Context ctx, User user, Credentials auth) Retrieve the ModuleAccess for an user.
java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.util.Set<java.lang.String>>>	getUserCapabilitiesSource(Context ctx, User user, Credentials credentials) Gets the capabilities tree showing which capability comes from which source
java.util.List<UserProperty>	getUserConfigurationSource(Context ctx, User user, java.lang.String searchPattern, Credentials credentials) Retrieve user configuration (within UserProperty) and its source.
User[]	list(Context ctx, java.lang.String search_pattern, Credentials auth) Retrieve all users for a given context.
User[]	list(Context ctx, java.lang.String search_pattern, Credentials auth, boolean includeGuests, boolean excludeUsers) Retrieve all users for a given context.
User[]	listAll(Context ctx, Credentials auth) Retrieve all users for a given context.
User[]	listAll(Context ctx, Credentials auth, boolean includeGuests, boolean excludeUsers) Retrieve all users for a given context.
User[]	listCaseInsensitive(Context ctx, java.lang.String search_pattern, Credentials auth) Retrieve all users for a given context.
User[]	listCaseInsensitive(Context ctx, java.lang.String search_pattern, Credentials auth, boolean includeGuests, boolean excludeUsers) Retrieve all users for a given context.
UserModuleAccess	moduleAccessForName(java.lang.String accessCombinationName) Retrieve the ModuleAccess for an user.
int	moveFromContextToUserFilestore(Context ctx, User user, Filestore dstFilestore, long maxQuota, Credentials credentials) Moves a user's files from a context to his own storage.
int	moveFromMasterToUserFilestore(Context ctx, User user, User masterUser, Filestore dstFilestore, long maxQuota, Credentials credentials) Moves a user's files from a master account to his own storage.
int	moveFromUserFilestoreToMaster(Context ctx, User user, User masterUser, Credentials credentials) Moves a user's files from his own storage to the storage of specified master.
int	moveFromUserToContextFilestore(Context ctx, User user, Credentials credentials) Moves a user's files from his own to a context storage.
int	moveUserFilestore(Context ctx, User user, Filestore dstFilestore, Credentials credentials) Moves a user's files from one storage to another.

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

User create(Context ctx,
          User usrdata,
          UserModuleAccess access,
          Credentials auth)
            throws java.rmi.RemoteException,
                   StorageException,
                   InvalidCredentialsException,
                   NoSuchContextException,
                   InvalidDataException,
                   DatabaseUpdateException

Creates a new user within the given context.

Parameters:

context - Context in which the new user will exist.

usrdata - User containing user data.

auth - Credentials for authenticating against server.

access - UserModuleAccess containing module access for the user.

Returns:

int containing the id of the new user.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

create

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

Creates a new user within the given context.

Parameters:

context - Context in which the new user will exist.

usrdata - User containing user data.

auth - Credentials for authenticating against server.

access_combination_name - Access combination name identifying the module rights for the new user.

Returns:

int containing the id of the new user.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

create

User create(Context ctx,
          User usrdata,
          Credentials auth)
            throws java.rmi.RemoteException,
                   StorageException,
                   InvalidCredentialsException,
                   NoSuchContextException,
                   InvalidDataException,
                   DatabaseUpdateException

Creates a new user within the given context.
Default context access rights are used!

Parameters:

context - Context in which the new user will exist.

usrdata - User containing user data.

auth - Credentials for authenticating against server.

Returns:

int containing the id of the new user.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

getContextAdminUserModuleAccess

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

Returns the module access rights of the context-admin

Parameters:

context - The context

auth - Credentials for authenticating against server.

Returns:

int containing the id of the new user.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

getContextAdmin

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

Returns the Context admin User object

Parameters:

ctx - The context from which to obtain the administrator

auth - The credentials

Returns:

Throws:

java.rmi.RemoteException

InvalidCredentialsException

StorageException

InvalidDataException

getCapabilities

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

Gets specified user's capabilities.

Parameters:

ctx - The context

user - The user

auth - The credentials

Returns:

The capabilities

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

NoSuchUserException

changeCapabilities

void changeCapabilities(Context ctx,
                      User user,
                      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,
                               StorageException,
                               InvalidCredentialsException,
                               NoSuchContextException,
                               InvalidDataException,
                               DatabaseUpdateException,
                               NoSuchUserException

Changes specified user's capabilities.

Parameters:

ctx - The context

user - The user

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 - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

NoSuchUserException

changeMailAddressPersonal

void changeMailAddressPersonal(Context ctx,
                             User user,
                             java.lang.String personal,
                             Credentials auth)
                               throws java.rmi.RemoteException,
                                      StorageException,
                                      InvalidCredentialsException,
                                      NoSuchContextException,
                                      InvalidDataException,
                                      DatabaseUpdateException,
                                      NoSuchUserException

Changes the personal part of specified user's E-Mail address.

Parameters:

ctx - The context

user - The user

personal - The personal to set or null to drop the personal information (if any)

auth - The credentials

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

NoSuchUserException

moveUserFilestore

int moveUserFilestore(Context ctx,
                    User user,
                    Filestore dstFilestore,
                    Credentials credentials)
                      throws java.rmi.RemoteException,
                             StorageException,
                             InvalidCredentialsException,
                             NoSuchContextException,
                             NoSuchFilestoreException,
                             InvalidDataException,
                             DatabaseUpdateException,
                             NoSuchUserException

Moves a user's files from one storage to another.

This operation leaves quota usage unchanged and thus can be considered as the user-sensitive counterpart for OXContextInterface.moveContextFilestore().

Parameters:

ctx - The context in which the user resides

user - The user

dstFilestore - The destination file storage

credentials - The credentials

Returns:

The job identifier which can be used for retrieving progress information.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - If an error in the subsystems occurred.

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

NoSuchContextException - If no such context exists

NoSuchFilestoreException - If no file storage context exists

InvalidDataException - If passed data is invalid

DatabaseUpdateException - If update operation fails

NoSuchUserException - If no such user exists

moveFromUserFilestoreToMaster

int moveFromUserFilestoreToMaster(Context ctx,
                                User user,
                                User masterUser,
                                Credentials credentials)
                                  throws java.rmi.RemoteException,
                                         StorageException,
                                         InvalidCredentialsException,
                                         NoSuchContextException,
                                         NoSuchFilestoreException,
                                         InvalidDataException,
                                         DatabaseUpdateException,
                                         NoSuchUserException

Moves a user's files from his own storage to the storage of specified master.

This operation is quota-aware and thus transfers current quota usage to master account as well.

Parameters:

ctx - The context in which the user resides

user - The user

masterUser - The master user account

credentials - The credentials

Returns:

The job identifier which can be used for retrieving progress information.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - If an error in the subsystems occurred.

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

NoSuchContextException - If no such context exists

NoSuchFilestoreException - If no file storage context exists

InvalidDataException - If passed data is invalid

DatabaseUpdateException - If update operation fails

NoSuchUserException - If no such user exists

moveFromMasterToUserFilestore

int moveFromMasterToUserFilestore(Context ctx,
                                User user,
                                User masterUser,
                                Filestore dstFilestore,
                                long maxQuota,
                                Credentials credentials)
                                  throws java.rmi.RemoteException,
                                         StorageException,
                                         InvalidCredentialsException,
                                         NoSuchContextException,
                                         NoSuchFilestoreException,
                                         InvalidDataException,
                                         DatabaseUpdateException,
                                         NoSuchUserException

Moves a user's files from a master account to his own storage.

This operation is quota-aware and thus transfers current quota usage from master account to user.

Parameters:

ctx - The context in which the user resides

user - The user

masterUser - The master user account

dstFilestore - The destination file storage to move to

maxQuota - TODO

credentials - The credentials

Returns:

The job identifier which can be used for retrieving progress information.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - If an error in the subsystems occurred.

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

NoSuchContextException - If no such context exists

NoSuchFilestoreException - If no file storage context exists

InvalidDataException - If passed data is invalid

DatabaseUpdateException - If update operation fails

NoSuchUserException - If no such user exists

moveFromContextToUserFilestore

int moveFromContextToUserFilestore(Context ctx,
                                 User user,
                                 Filestore dstFilestore,
                                 long maxQuota,
                                 Credentials credentials)
                                   throws java.rmi.RemoteException,
                                          StorageException,
                                          InvalidCredentialsException,
                                          NoSuchContextException,
                                          NoSuchFilestoreException,
                                          InvalidDataException,
                                          DatabaseUpdateException,
                                          NoSuchUserException

Moves a user's files from a context to his own storage.

This operation is quota-aware and thus transfers current quota usage from context to user.

Parameters:

ctx - The context in which the user resides

user - The user

dstFilestore - The destination file storage to move to

maxQuota - TODO

credentials - The credentials

Returns:

The job identifier which can be used for retrieving progress information.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - If an error in the subsystems occurred.

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

NoSuchContextException - If no such context exists

NoSuchFilestoreException - If no file storage context exists

InvalidDataException - If passed data is invalid

DatabaseUpdateException - If update operation fails

NoSuchUserException - If no such user exists

moveFromUserToContextFilestore

int moveFromUserToContextFilestore(Context ctx,
                                 User user,
                                 Credentials credentials)
                                   throws java.rmi.RemoteException,
                                          StorageException,
                                          InvalidCredentialsException,
                                          NoSuchContextException,
                                          NoSuchFilestoreException,
                                          InvalidDataException,
                                          DatabaseUpdateException,
                                          NoSuchUserException

Moves a user's files from his own to a context storage.

This operation is quota-aware and thus transfers current quota usage from user to context.

Parameters:

ctx - The context in which the user resides

user - The user

credentials - The credentials

Returns:

The job identifier which can be used for retrieving progress information.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - If an error in the subsystems occurred.

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

NoSuchContextException - If no such context exists

NoSuchFilestoreException - If no file storage context exists

InvalidDataException - If passed data is invalid

DatabaseUpdateException - If update operation fails

NoSuchUserException - If no such user exists

change

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

Manipulate user data within the given context.

Parameters:

context - Context in which the new user will be modified.

usrdata - User containing user data.

auth - Credentials for authenticating against server.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

NoSuchUserException

delete

void delete(Context ctx,
          User[] users,
          Credentials auth)
            throws java.rmi.RemoteException,
                   StorageException,
                   InvalidCredentialsException,
                   NoSuchContextException,
                   InvalidDataException,
                   DatabaseUpdateException,
                   NoSuchUserException

Delete user from given context.

Parameters:

context - Context in which the new user will be deleted.

users - user array containing user object.

auth - Credentials for authenticating against server.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

NoSuchUserException

delete

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

Delete user from given context.

Parameters:

context - Context in which the new user will be deleted.

user - user object.

auth - Credentials for authenticating against server.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

NoSuchUserException

moduleAccessForName

UserModuleAccess moduleAccessForName(java.lang.String accessCombinationName)
                                     throws java.rmi.RemoteException

Retrieve the ModuleAccess for an user.

Parameters:

accessCombinationName - The access combination name

auth - Credentials for authenticating against server.

Returns:

UserModuleAccess containing the module access rights.

Throws:

java.rmi.RemoteException - General RMI Exception

getModuleAccess

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

Retrieve the ModuleAccess for an user.

Parameters:

context - Context

user_id - int containing the user id.

auth - Credentials for authenticating against server.

Returns:

UserModuleAccess containing the module access rights.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

NoSuchUserException

getAccessCombinationName

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

Get current access combination name of an user!

Parameters:

ctx -

user -

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

DatabaseUpdateException

NoSuchUserException

changeModuleAccess

void changeModuleAccess(Context ctx,
                      User user,
                      UserModuleAccess moduleAccess,
                      Credentials auth)
                        throws java.rmi.RemoteException,
                               StorageException,
                               InvalidCredentialsException,
                               NoSuchContextException,
                               InvalidDataException,
                               DatabaseUpdateException,
                               NoSuchUserException

Manipulate user module access within the given context.

Parameters:

ctx - Context object.

user_id - int containing the user id.

moduleAccess - UserModuleAccess containing module access.

auth - Credentials for authenticating against server.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

NoSuchUserException

changeModuleAccess

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

Manipulate user module access within the given context.

Parameters:

ctx - Context object.

user_id - int containing the user id.

access - String containing access combination name.

auth - Credentials for authenticating against server.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occurred.

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.

DatabaseUpdateException

NoSuchUserException

changeModuleAccessGlobal

void changeModuleAccessGlobal(java.lang.String filter,
                            UserModuleAccess addAccess,
                            UserModuleAccess removeAccess,
                            Credentials auth)
                              throws java.rmi.RemoteException,
                                     InvalidCredentialsException,
                                     StorageException,
                                     InvalidDataException

This method changes module Permissions for all (!) users in all (!) contexts. This can be filtered by already existing access combinations. If no filter is given, all users are changed.

Parameters:

filter - The call affects only users with exactly this access combination. This is either a String representing a defined module access combination or an Integer (masked as String) for direct definitions. null for no filter.

addAccess - Access rights to be added

removeAccess - Access rights to be removed

auth - Credentials for authenticating against server. Must be the master Admin.

Throws:

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

StorageException - When an error in the subsystems occured.

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

java.rmi.RemoteException - General RMI Exception

getData

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

Retrieve user objects for a range of users by username or id.

Parameters:

context - Context object.

users - User[] with users to get data for.

auth - Credentials for authenticating against server.

Returns:

User[] containing result objects.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occured.

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.

NoSuchUserException

DatabaseUpdateException

See Also:

User.getUsername().

getData

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

Retrieve user objects for a range of users by username or id.

Parameters:

context - Context object.

user - user object with user to get data for.

auth - Credentials for authenticating against server.

Returns:

User containing result object.

Throws:

java.rmi.RemoteException - General RMI Exception

StorageException - When an error in the subsystems occured.

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.

NoSuchUserException

DatabaseUpdateException

See Also:

User.getUsername().

list

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

Retrieve all users for a given context. 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:

ctx - Context object.

search_pattern - A pattern to search for

auth - Credentials for authenticating against server.

Returns:

User[] with currently ONLY id set in each User.

Throws:

java.rmi.RemoteException

StorageException

InvalidCredentialsException

NoSuchContextException

InvalidDataException

DatabaseUpdateException

list

User[] list(Context ctx,
          java.lang.String search_pattern,
          Credentials auth,
          boolean includeGuests,
          boolean excludeUsers)
            throws java.rmi.RemoteException,
                   StorageException,
                   InvalidCredentialsException,
                   NoSuchContextException,
                   InvalidDataException,
                   DatabaseUpdateException

Retrieve all users for a given context. 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:

ctx - Context object.

search_pattern - A pattern to search for

auth - Credentials for authenticating against server.

includeGuests - List guest users too

excludeUsers - List only guest users

Returns:

User[] with currently ONLY id set in each User.

Throws:

java.rmi.RemoteException

StorageException

InvalidCredentialsException

NoSuchContextException

InvalidDataException

DatabaseUpdateException

listCaseInsensitive

User[] listCaseInsensitive(Context ctx,
                         java.lang.String search_pattern,
                         Credentials auth)
                           throws java.rmi.RemoteException,
                                  StorageException,
                                  InvalidCredentialsException,
                                  NoSuchContextException,
                                  InvalidDataException,
                                  DatabaseUpdateException

Retrieve all users for a given context. 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:

ctx - Context object.

search_pattern - A pattern to search for

auth - Credentials for authenticating against server.

Returns:

User[] with currently ONLY id set in each User.

Throws:

java.rmi.RemoteException

StorageException

InvalidCredentialsException

NoSuchContextException

InvalidDataException

DatabaseUpdateException

listCaseInsensitive

User[] listCaseInsensitive(Context ctx,
                         java.lang.String search_pattern,
                         Credentials auth,
                         boolean includeGuests,
                         boolean excludeUsers)
                           throws java.rmi.RemoteException,
                                  StorageException,
                                  InvalidCredentialsException,
                                  NoSuchContextException,
                                  InvalidDataException,
                                  DatabaseUpdateException

Retrieve all users for a given context. 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:

ctx - Context object.

search_pattern - A pattern to search for

auth - Credentials for authenticating against server.

includeGuests - List guest users too

excludeUsers - List only guest users

Returns:

User[] with currently ONLY id set in each User.

Throws:

java.rmi.RemoteException

StorageException

InvalidCredentialsException

NoSuchContextException

InvalidDataException

DatabaseUpdateException

listAll

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

Retrieve all users for a given context. The same as calling list with a search_pattern of "*"

Parameters:

ctx - Context object.

auth - Credentials for authenticating against server.

Returns:

User[] with currently ONLY id set in each User.

Throws:

java.rmi.RemoteException

StorageException

InvalidCredentialsException

NoSuchContextException

InvalidDataException

DatabaseUpdateException

listAll

User[] listAll(Context ctx,
             Credentials auth,
             boolean includeGuests,
             boolean excludeUsers)
               throws java.rmi.RemoteException,
                      StorageException,
                      InvalidCredentialsException,
                      NoSuchContextException,
                      InvalidDataException,
                      DatabaseUpdateException

Retrieve all users for a given context. The same as calling list with a search_pattern of "*"

Parameters:

ctx - Context object.

auth - Credentials for authenticating against server.

includeGuests - List guest users too

excludeUsers - List only guest users

Returns:

User[] with currently ONLY id set in each User.

Throws:

java.rmi.RemoteException

StorageException

InvalidCredentialsException

NoSuchContextException

InvalidDataException

DatabaseUpdateException

exists

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

Check whether the given user exists. Either users id or name must be set.

Parameters:

ctx -

user -

Returns:

Throws:

java.rmi.RemoteException

InvalidDataException

InvalidCredentialsException

StorageException

DatabaseUpdateException

NoSuchContextException

getUserConfigurationSource

java.util.List<UserProperty> getUserConfigurationSource(Context ctx,
                                                      User user,
                                                      java.lang.String searchPattern,
                                                      Credentials credentials)
                                                        throws java.rmi.RemoteException,
                                                               InvalidDataException,
                                                               StorageException,
                                                               InvalidCredentialsException,
                                                               NoSuchUserException

Retrieve user configuration (within UserProperty) and its source.

Parameters:

ctx - Context object the user is associated to

user - User object to retrieve the configuration for

searchPattern - string with a pattern to search for a property

credentials - Credentials for authenticating against server

Returns:

The found properties in a List

Throws:

InvalidDataException

StorageException

NoSuchUserException

InvalidCredentialsException

java.rmi.RemoteException

getUserCapabilitiesSource

java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.util.Set<java.lang.String>>> getUserCapabilitiesSource(Context ctx,
                                                                                                                        User user,
                                                                                                                        Credentials credentials)
                                                                                                                          throws java.rmi.RemoteException,
                                                                                                                                 InvalidDataException,
                                                                                                                                 StorageException,
                                                                                                                                 InvalidCredentialsException,
                                                                                                                                 NoSuchUserException

Gets the capabilities tree showing which capability comes from which source

Parameters:

ctx - Context object the user is associated to

user - User object to retrieve the configuration for

credentials - Credentials for authenticating against server

Returns:

The capabilities tree

Throws:

InvalidDataException

StorageException

NoSuchUserException

InvalidCredentialsException

java.rmi.RemoteException