org.hsqldb.auth
Class AuthBeanMultiplexer

java.lang.Object
  org.hsqldb.auth.AuthBeanMultiplexer

public class AuthBeanMultiplexer
extends Object

This class provides a method which can be used directly as a HyperSQL static Java function method. Manages a set of AuthFunctionBean implementations

Since:

2.0.1

Author:

Blaine Simpson (blaine dot simpson at admc dot com)

Method Summary

static Array	authenticate(String database, String user, String password) HyperSQL Java Function Method.
void	clear() Clear the set of AuthFunctionBeans
static AuthBeanMultiplexer	getSingleton()
void	setAuthFunctionBean(Connection c, AuthFunctionBean authFunctionBean) Exactly the same as setAuthFunctionBeans(String, List) other than taking an open Connection to identify the database.
void	setAuthFunctionBean(String dbName, AuthFunctionBean authFunctionBean) This is not an "adder" function, but a "setter" function for the specified dbName , so do not use this to add to a database's FunctionBeans, but to assign ths single given AuthFunctionBean as the specified database's authenticator.
void	setAuthFunctionBeans(Connection c, List<AuthFunctionBean> authFunctionBeans) Wrapper for setAuthFunctioNBeans(String, List)
void	setAuthFunctionBeans(Map<String,List<AuthFunctionBean>> authFunctionBeanMap) Primary purpose of this class is to manage this static map.
void	setAuthFunctionBeans(String dbName, List<AuthFunctionBean> authFunctionBeans) This is not an "adder" function, but a "setter" function for the specified dbName , so do not use this to add to a database's FunctionBeans, but to assign the entire list for that database.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getSingleton

public static AuthBeanMultiplexer getSingleton()

clear

public void clear()

Clear the set of AuthFunctionBeans

setAuthFunctionBeans

public void setAuthFunctionBeans(Map<String,List<AuthFunctionBean>> authFunctionBeanMap)

Primary purpose of this class is to manage this static map. From dbNames to ordered-lists-of-AuthFunctionBeans. This is not an "adder" function, but a "setter" function, so do not use this to add to a partial set, but to assign the entire set.

The given entries are copied, to limit side-effects and concurrency issues.

setAuthFunctionBeans

public void setAuthFunctionBeans(Connection c,
                                 List<AuthFunctionBean> authFunctionBeans)
                          throws SQLException

Wrapper for setAuthFunctioNBeans(String, List)

Parameters:

c - An open Connection to the desired database.

Throws:

SQLException - if failed to obtain unique name from given Connection.

setAuthFunctionBeans

public void setAuthFunctionBeans(String dbName,
                                 List<AuthFunctionBean> authFunctionBeans)

This is not an "adder" function, but a "setter" function for the specified dbName , so do not use this to add to a database's FunctionBeans, but to assign the entire list for that database.

The given entries are copied, to limit side-effects and concurrency issues.

Use this method instead of setAuthFunctionBean(String, AuthFunctionBean) in order to set up multiple authenticators for a single database for redundancy purposes.

See Also:

setAuthFunctionBeans(Map), setAuthFunctionBean(String, AuthFunctionBean)

setAuthFunctionBean

public void setAuthFunctionBean(Connection c,
                                AuthFunctionBean authFunctionBean)
                         throws SQLException

Exactly the same as setAuthFunctionBeans(String, List) other than taking an open Connection to identify the database.

Throws:

SQLException

setAuthFunctionBean

public void setAuthFunctionBean(String dbName,
                                AuthFunctionBean authFunctionBean)

This is not an "adder" function, but a "setter" function for the specified dbName , so do not use this to add to a database's FunctionBeans, but to assign ths single given AuthFunctionBean as the specified database's authenticator.

To set up multiple authenticators for a single database for redundancy purposes, use the method setAuthFunctionBeans(String, List) instead.

See Also:

setAuthFunctionBeans(String, List)

authenticate

public static Array authenticate(String database,
                                 String user,
                                 String password)
                          throws Exception

HyperSQL Java Function Method.

Registered AuthFunctionBeans matching the specified database and password will be tried in order.

1. If the AuthFunctionBean being tried throws a non-runtime Exception, then that RuntimeException is passed through (re-thrown), resulting in a SQLException for the authenticating application.
2. If the AuthFunctionBean being tried doesn't throw anything, then the return value is passed through (returned) and HyperSQL will allow access and set roles according to HyperSQL's authentication function contract.
3. If the AuthFunctionBean being tried throws a RuntimeException, then the next AuthFunctionBean in turn will be tried. If all matching AuthFunctionBeans throw RuntimeExceptions, then the first RuntimeException that was thrown will be passed through (re-thrown), resulting in a SQLException for the authenticating application.
4. If there are no AuthFunctionBeans registered for the specified dbName, then this method will throw an IllegalArgumentException, resulting in a SQLException for the authenticating application.

Returns:

Null or java.sql.Array to indicate successful authentication according to the contract for HyperSQL authentication functions.

Throws:

IllegalArgumentException - if no AuthFunctionBean has been set for specified dbName.

RuntimeException - if all matching AuthFunctionBeans threw RuntimeExceptions. (This indicates that no matching AuthFunctionBean functioned properly, not that authentication was purposefully denied by any AuthFunctionBean).

Exception - (non-runtime). A matching AuthFunctionBean threw this Exception.

See Also:

User Guide, System Management chapter, Authentication Settings subsection.