org.exist.xmldb
Interface UserManagementService

All Superinterfaces:

org.xmldb.api.base.Configurable, org.xmldb.api.base.Service

All Known Implementing Classes:

LocalUserManagementService, RemoteUserManagementService

public interface UserManagementService
extends org.xmldb.api.base.Service

An eXist-specific service which provides methods to manage users and permissions.

Method Summary

void	addAccount(Account account) Add a new account to the database
void	addGroup(Group group)
void	addUser(User user) Deprecated.
void	addUserGroup(Account user) Update the specified user without update user's password Method added by {Marco.Tampucci, Massimo.Martinelli} @isti.cnr.it
void	chmod(int mode)
void	chmod(org.xmldb.api.base.Resource resource, int mode) Change permissions for the specified resource.
void	chmod(org.xmldb.api.base.Resource resource, java.lang.String modeStr) Change permissions for the specified resource.
void	chmod(java.lang.String modeStr) Change permissions for the current collection
void	chown(Account u, java.lang.String group) Change owner and group of the current collection.
void	chown(org.xmldb.api.base.Resource res, Account u, java.lang.String group) Change owner and group of the specified resource.
Account	getAccount(java.lang.String name) Get a account record from the database
Account[]	getAccounts() Retrieve a list of all existing accounts.
Group	getGroup(java.lang.String name)
java.lang.String[]	getGroups() Retrieve a list of all existing groups.
java.lang.String	getName() Get the name of this service
Permission	getPermissions(org.xmldb.api.base.Collection coll) Get permissions for the specified collections
Permission	getPermissions(org.xmldb.api.base.Resource res) Get permissions for the specified resource
java.lang.String	getProperty(java.lang.String property) Get a property defined by this service.
User	getUser(java.lang.String name) Deprecated.
User[]	getUsers() Deprecated.
java.lang.String	getVersion() Get the version of this service
java.lang.String	hasUserLock(org.xmldb.api.base.Resource res) Check if the resource has a user lock.
Permission[]	listCollectionPermissions() Get permissions for all child collections contained in the current collection.
Permission[]	listResourcePermissions() Get permissions for all resources contained in the current collection.
void	lockResource(org.xmldb.api.base.Resource res, Account u) Lock the specified resource for the specified user.
void	lockResource(org.xmldb.api.base.Resource res, User u) Deprecated.
void	removeAccount(Account account) Delete a user from the database
void	removeGroup(Account user, java.lang.String rmgroup) Update the specified user removing a group from user's group Method added by {Marco.Tampucci, Massimo.Martinelli} @isti.cnr.it
void	removeGroup(Group group)
void	removeUser(User user) Deprecated.
void	setCollection(org.xmldb.api.base.Collection collection) Set the current collection for this service
void	setPermissions(org.xmldb.api.base.Collection child, Permission perm) Set permissions for the specified collection.
void	setPermissions(org.xmldb.api.base.Collection child, java.lang.String owner, java.lang.String group, int mode, java.util.List<ACEAider> aces)
void	setPermissions(org.xmldb.api.base.Resource resource, Permission perm) Set permissions for the specified resource.
void	setPermissions(org.xmldb.api.base.Resource resource, java.lang.String owner, java.lang.String group, int mode, java.util.List<ACEAider> aces)
void	setProperty(java.lang.String property, java.lang.String value) Set a property for this service.
void	unlockResource(org.xmldb.api.base.Resource res) Unlock the specified resource.
void	updateAccount(Account account) Update existing account information
void	updateUser(User user) Deprecated.

Method Detail

getName

java.lang.String getName()

Get the name of this service

Specified by:

getName in interface org.xmldb.api.base.Service

Returns:

The name

getVersion

java.lang.String getVersion()

Get the version of this service

Specified by:

getVersion in interface org.xmldb.api.base.Service

Returns:

The version value

setPermissions

void setPermissions(org.xmldb.api.base.Collection child,
                    Permission perm)
                    throws org.xmldb.api.base.XMLDBException

Set permissions for the specified collection.

Parameters:

child -

perm -

Throws:

org.xmldb.api.base.XMLDBException

setPermissions

void setPermissions(org.xmldb.api.base.Collection child,
                    java.lang.String owner,
                    java.lang.String group,
                    int mode,
                    java.util.List<ACEAider> aces)
                    throws org.xmldb.api.base.XMLDBException

Throws:

org.xmldb.api.base.XMLDBException

setPermissions

void setPermissions(org.xmldb.api.base.Resource resource,
                    Permission perm)
                    throws org.xmldb.api.base.XMLDBException

Set permissions for the specified resource.

Parameters:

resource -

perm -

Throws:

org.xmldb.api.base.XMLDBException

setPermissions

void setPermissions(org.xmldb.api.base.Resource resource,
                    java.lang.String owner,
                    java.lang.String group,
                    int mode,
                    java.util.List<ACEAider> aces)
                    throws org.xmldb.api.base.XMLDBException

Throws:

org.xmldb.api.base.XMLDBException

chown

void chown(Account u,
           java.lang.String group)
           throws org.xmldb.api.base.XMLDBException

Change owner and group of the current collection.

Parameters:

u - Description of the Parameter

group - Description of the Parameter

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

chown

void chown(org.xmldb.api.base.Resource res,
           Account u,
           java.lang.String group)
           throws org.xmldb.api.base.XMLDBException

Change owner and group of the specified resource.

Parameters:

res - Description of the Parameter

u - Description of the Parameter

group - Description of the Parameter

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

chmod

void chmod(org.xmldb.api.base.Resource resource,
           java.lang.String modeStr)
           throws org.xmldb.api.base.XMLDBException

Change permissions for the specified resource. Permissions are specified in a string according to the following format:

[user|group|other]=[+|-][read|write|update]

For example, to grant all permissions to the group and deny everything to others: group=+write,+read,+update,other=-read The changes are applied to the permissions currently active for this resource.

Parameters:

resource - Description of the Parameter

modeStr - Description of the Parameter

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

chmod

void chmod(java.lang.String modeStr)
           throws org.xmldb.api.base.XMLDBException

Change permissions for the current collection

Parameters:

modeStr - String describing the permissions to grant or deny.

Throws:

org.xmldb.api.base.XMLDBException

chmod

void chmod(int mode)
           throws org.xmldb.api.base.XMLDBException

Throws:

org.xmldb.api.base.XMLDBException

chmod

void chmod(org.xmldb.api.base.Resource resource,
           int mode)
           throws org.xmldb.api.base.XMLDBException

Change permissions for the specified resource.

Throws:

org.xmldb.api.base.XMLDBException

lockResource

void lockResource(org.xmldb.api.base.Resource res,
                  Account u)
                  throws org.xmldb.api.base.XMLDBException

Lock the specified resource for the specified user. A locked resource cannot be changed by other users (except users in group DBA) until the lock is released. Users with admin privileges can always change a resource.

Parameters:

res -

u -

Throws:

org.xmldb.api.base.XMLDBException

hasUserLock

java.lang.String hasUserLock(org.xmldb.api.base.Resource res)
                             throws org.xmldb.api.base.XMLDBException

Check if the resource has a user lock. Returns the name of the owner of the lock or null if no lock has been set on the resource.

Parameters:

res -

Returns:

Name of the owner of the lock

Throws:

org.xmldb.api.base.XMLDBException

unlockResource

void unlockResource(org.xmldb.api.base.Resource res)
                    throws org.xmldb.api.base.XMLDBException

Unlock the specified resource. The current user has to be same who locked the resource. Exception: admin users can always unlock a resource.

Parameters:

res -

Throws:

org.xmldb.api.base.XMLDBException

addAccount

void addAccount(Account account)
                throws org.xmldb.api.base.XMLDBException

Add a new account to the database

Parameters:

account - The feature to be added to the Account

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

updateAccount

void updateAccount(Account account)
                   throws org.xmldb.api.base.XMLDBException

Update existing account information

Parameters:

account - Description of the Parameter

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

getAccount

Account getAccount(java.lang.String name)
                   throws org.xmldb.api.base.XMLDBException

Get a account record from the database

Parameters:

name - Description of the Parameter

Returns:

The user value

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

getAccounts

Account[] getAccounts()
                      throws org.xmldb.api.base.XMLDBException

Retrieve a list of all existing accounts.

Returns:

The accounts value

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

getGroup

Group getGroup(java.lang.String name)
               throws org.xmldb.api.base.XMLDBException

Throws:

org.xmldb.api.base.XMLDBException

getGroups

java.lang.String[] getGroups()
                             throws org.xmldb.api.base.XMLDBException

Retrieve a list of all existing groups. Please note: new groups are created automatically if a new group is assigned to a user. You can't add or remove them.

Returns:

List of all existing groups.

Throws:

org.xmldb.api.base.XMLDBException

getProperty

java.lang.String getProperty(java.lang.String property)
                             throws org.xmldb.api.base.XMLDBException

Get a property defined by this service.

Specified by:

getProperty in interface org.xmldb.api.base.Configurable

Parameters:

property - Description of the Parameter

Returns:

The property value

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

setProperty

void setProperty(java.lang.String property,
                 java.lang.String value)
                 throws org.xmldb.api.base.XMLDBException

Set a property for this service.

Specified by:

setProperty in interface org.xmldb.api.base.Configurable

Parameters:

property - The new property value

value - The new property value

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

setCollection

void setCollection(org.xmldb.api.base.Collection collection)
                   throws org.xmldb.api.base.XMLDBException

Set the current collection for this service

Specified by:

setCollection in interface org.xmldb.api.base.Service

Parameters:

collection - The new collection value

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

getPermissions

Permission getPermissions(org.xmldb.api.base.Collection coll)
                          throws org.xmldb.api.base.XMLDBException

Get permissions for the specified collections

Parameters:

coll - Description of the Parameter

Returns:

The permissions value

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

getPermissions

Permission getPermissions(org.xmldb.api.base.Resource res)
                          throws org.xmldb.api.base.XMLDBException

Get permissions for the specified resource

Parameters:

res - Description of the Parameter

Returns:

The permissions value

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

listResourcePermissions

Permission[] listResourcePermissions()
                                     throws org.xmldb.api.base.XMLDBException

Get permissions for all resources contained in the current collection. Returns a list of permissions in the same order as Collection.listResources().

Returns:

Permission[]

Throws:

org.xmldb.api.base.XMLDBException

listCollectionPermissions

Permission[] listCollectionPermissions()
                                       throws org.xmldb.api.base.XMLDBException

Get permissions for all child collections contained in the current collection. Returns a list of permissions in the same order as Collection.listChildCollections().

Returns:

Permission[]

Throws:

org.xmldb.api.base.XMLDBException

removeAccount

void removeAccount(Account account)
                   throws org.xmldb.api.base.XMLDBException

Delete a user from the database

Parameters:

account - User

Throws:

org.xmldb.api.base.XMLDBException

removeGroup

void removeGroup(Group group)
                 throws org.xmldb.api.base.XMLDBException

Throws:

org.xmldb.api.base.XMLDBException

addUserGroup

void addUserGroup(Account user)
                  throws org.xmldb.api.base.XMLDBException

Update the specified user without update user's password Method added by {Marco.Tampucci, Massimo.Martinelli} @isti.cnr.it

Parameters:

user - Description of the Parameter

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

removeGroup

void removeGroup(Account user,
                 java.lang.String rmgroup)
                 throws org.xmldb.api.base.XMLDBException

Update the specified user removing a group from user's group Method added by {Marco.Tampucci, Massimo.Martinelli} @isti.cnr.it

Parameters:

user - Description of the Parameter

rmgroup - Description of group to remove

Throws:

org.xmldb.api.base.XMLDBException - Description of the Exception

addGroup

void addGroup(Group group)
              throws org.xmldb.api.base.XMLDBException

Throws:

org.xmldb.api.base.XMLDBException

addUser

@Deprecated
void addUser(User user)
             throws org.xmldb.api.base.XMLDBException

Deprecated.

Throws:

org.xmldb.api.base.XMLDBException

updateUser

@Deprecated
void updateUser(User user)
                throws org.xmldb.api.base.XMLDBException

Deprecated.

Throws:

org.xmldb.api.base.XMLDBException

getUser

@Deprecated
User getUser(java.lang.String name)
             throws org.xmldb.api.base.XMLDBException

Deprecated.

Throws:

org.xmldb.api.base.XMLDBException

getUsers

@Deprecated
User[] getUsers()
                throws org.xmldb.api.base.XMLDBException

Deprecated.

Throws:

org.xmldb.api.base.XMLDBException

removeUser

@Deprecated
void removeUser(User user)
                throws org.xmldb.api.base.XMLDBException

Deprecated.

Throws:

org.xmldb.api.base.XMLDBException

lockResource

@Deprecated
void lockResource(org.xmldb.api.base.Resource res,
                             User u)
                  throws org.xmldb.api.base.XMLDBException

Deprecated.

Throws:

org.xmldb.api.base.XMLDBException