com.beasys.commerce.axiom.contact
Interface RealmConfiguration

public interface RealmConfiguration

extends javax.ejb.EJBObject

This is the public interface for configuring the underlying Realm. This session bean controls not only configuration information for the current Realm, but also provides functionality to help keep data in the personalization database synchronized with data in the Realm datastore.

Method Summary

java.lang.String	cleanupMisconfiguredUsers() Removes misconfigured users (those found in the database but not in the realm) from the database.
java.util.ArrayList	getAllDBGroups() Returns all the groups that are in the database.
java.util.ArrayList	getAllRealmGroups() Returns all the groups that exist in LDAP.
int	getConfiguredGroupCount() Returns a count of the LDAP groups configured for personalization user.
int	getConfiguredUserCount() Returns a count of the realm users that also exist in the personalization database.
java.util.ArrayList	getDBUsers() Returns just the users found in the database.
java.lang.String[]	getMisconfiguredUsers() Returns the usernames that exist in the database, but not in the realm.
java.lang.String	getRealmClassName() Returns the name of the security realm class being used.
java.util.ArrayList	getRealmUsers() Returns just the users from the Realm.
void	registerGroup(java.lang.String groupName) Adds the necessary entries in the database for the group to start being used in the system.
void	unregisterGroup(java.lang.String groupName) Removes all relevant entries for a group from the database.

Methods inherited from interface javax.ejb.EJBObject

getEJBHome, getHandle, getPrimaryKey, isIdentical, remove

Method Detail

getConfiguredUserCount

public int getConfiguredUserCount()
                           throws java.rmi.RemoteException,
                                  UserManagementException

Returns a count of the realm users that also exist in the personalization database.

Returns:

a count of the realm users configured for personalization use

Throws:

UserManagementException - group count error

RemoteException - general error

getMisconfiguredUsers

public java.lang.String[] getMisconfiguredUsers()
                                         throws java.rmi.RemoteException,
                                                UserManagementException

Returns the usernames that exist in the database, but not in the realm.

Returns:

the usersnames for the users that are misconfigured

Throws:

UserManagementException - user find error

RemoteException - general error

cleanupMisconfiguredUsers

public java.lang.String cleanupMisconfiguredUsers()
                                           throws java.rmi.RemoteException,
                                                  UserManagementException

Removes misconfigured users (those found in the database but not in the realm) from the database.

Returns:

a status message for the operation

Throws:

UserManagementException - error cleaning up users

RemoteException - general error

getRealmUsers

public java.util.ArrayList getRealmUsers()
                                  throws java.rmi.RemoteException,
                                         UserManagementException

Returns just the users from the Realm.

Returns:

a list of usernames returned from the realm

Throws:

UserManagementException - error accessing realm

RemoteException - general error

getDBUsers

public java.util.ArrayList getDBUsers()
                               throws java.rmi.RemoteException,
                                      UserManagementException

Returns just the users found in the database.

Returns:

a list of usernames in the database

Throws:

UserManagementException - error accessing the database

RemoteException - general error

getConfiguredGroupCount

public int getConfiguredGroupCount()
                            throws java.rmi.RemoteException,
                                   UserManagementException

Returns a count of the LDAP groups configured for personalization user.

Throws:

UserManagementException - group count error

RemoteException - general error

getAllRealmGroups

public java.util.ArrayList getAllRealmGroups()
                                      throws java.rmi.RemoteException,
                                             UserManagementException

Returns all the groups that exist in LDAP.

Throws:

RemoteException - general error

UserManagementException - LDAP error

getAllDBGroups

public java.util.ArrayList getAllDBGroups()
                                   throws java.rmi.RemoteException,
                                          UserManagementException

Returns all the groups that are in the database.

Throws:

RemoteException - general error

UserManagementException - LDAP error

registerGroup

public void registerGroup(java.lang.String groupName)
                   throws java.rmi.RemoteException,
                          UserManagementException

Adds the necessary entries in the database for the group to start being used in the system.

Parameters:

groupName - the name of the group to register

Throws:

RemoteException - general error

UserManagementException - DB related error

unregisterGroup

public void unregisterGroup(java.lang.String groupName)
                     throws java.rmi.RemoteException,
                            UserManagementException

Removes all relevant entries for a group from the database.

Parameters:

groupName - the name of the group to unregister

Throws:

RemoteException - general error

UserManagementException - DB related error

getRealmClassName

public java.lang.String getRealmClassName()
                                   throws java.rmi.RemoteException

Returns the name of the security realm class being used.

Returns:

the name of the security realm class being used