com.beasys.commerce.axiom.contact.security
Class RDBMSRealm

com.beasys.commerce.axiom.contact.security.RDBMSRealm

public class RDBMSRealm

RDBMS realm class. This is the default realm to handle user/group information for the user management section of the Commerce Server.

Field Summary

protected Pool

delegatePool We maintain a pool of delegates, each with its own connection to the database.

Constructor Summary

RDBMSRealm()
Create a new RDBMS realm object.

Method Summary

protected weblogic.security.acl.User	authUserPassword(java.lang.String name, java.lang.String passwd) Authenticate the given user.
weblogic.logging.LogOutputStream	getDebugLog() Obtain the debug log, if it is enabled.
protected com.beasys.commerce.axiom.contact.security.RDBMSDelegate	getDelegate() Obtain a delegate from the pool.
java.security.acl.Group	getGroup(java.lang.String name) Return the group with the given name, or null if the group does not exist in the database.
protected java.util.Hashtable	getGroupMembersInternal(java.lang.String name)
java.util.Enumeration	getGroups() Return an enumeration of all groups in the database.
weblogic.security.acl.User	getUser(java.lang.String name) Return the user with the given name, or null if the user does not exist in the database.
java.util.Enumeration	getUsers() Return an enumeration of all users in the database.
protected void	returnDelegate(com.beasys.commerce.axiom.contact.security.RDBMSDelegate delegate) Return a delegate to the pool.
void	setDebug(boolean enable) Enable or disable debug logging.

Field Detail

delegatePool

protected Pool delegatePool

We maintain a pool of delegates, each with its own connection to the database. Access to the pool itself is synchronized, but since only one thread will obtain a given delegate from the pool at any time, we don't need to synchronize any other method calls.

See Also:

getDelegate(), returnDelegate(com.beasys.commerce.axiom.contact.security.RDBMSDelegate)

Constructor Detail

RDBMSRealm

public RDBMSRealm()

Create a new RDBMS realm object.

Method Detail

getDelegate

protected com.beasys.commerce.axiom.contact.security.RDBMSDelegate getDelegate()

Obtain a delegate from the pool. If the pool is empty, this may cause a new delegate to be created and handed back to us. If a fatal error occurs when you are using a delegate, do not return it to the pool. You can do this by setting your reference to the delegate to null and calling returnDelegate() as usual; it will do the right thing.

Throws:

RDBMSException - an error occurred in communicating with the database

See Also:

returnDelegate(com.beasys.commerce.axiom.contact.security.RDBMSDelegate)

returnDelegate

protected void returnDelegate(com.beasys.commerce.axiom.contact.security.RDBMSDelegate delegate)

Return a delegate to the pool. If the delegate was set to null because of errors, nothing is done.

See Also:

getDelegate()

getUser

public weblogic.security.acl.User getUser(java.lang.String name)

Return the user with the given name, or null if the user does not exist in the database.

Parameters:

name - the name to obtain

Returns:

the user, or null if none

Throws:

RDBMSException - an error occurred in communicating with the database

getGroupMembersInternal

protected java.util.Hashtable getGroupMembersInternal(java.lang.String name)

getGroup

public java.security.acl.Group getGroup(java.lang.String name)

Return the group with the given name, or null if the group does not exist in the database.

Parameters:

name - the name to obtain

Returns:

the group, or null if none

Throws:

RDBMSException - an error occurred in communicating with the database

getUsers

public java.util.Enumeration getUsers()

Return an enumeration of all users in the database. Each element of the Enumeration is a User object.

Returns:

all users

Throws:

RDBMSException - an error occurred in communicating with the database

See Also:

User

getGroups

public java.util.Enumeration getGroups()

Return an enumeration of all groups in the database. Each element of the Enumeration is a Group object. Note that in this realm, empty groups cannot currently exist.

Returns:

all groups

Throws:

RDBMSException - an error occurred in communicating with the database

See Also:

Group

authUserPassword

protected weblogic.security.acl.User authUserPassword(java.lang.String name,
                                                      java.lang.String passwd)

Authenticate the given user. If the authentication step passes, a User object is returned for that user, otherwise null is returned. This will always fail for users that came from an external (non-RDBMS) realm.

Returns:

the authenticated user, or null

Throws:

RDBMSException - an error occurred in communicating with the database

setDebug

public void setDebug(boolean enable)

Enable or disable debug logging.

getDebugLog

public weblogic.logging.LogOutputStream getDebugLog()

Obtain the debug log, if it is enabled.