Package org.jdesktop.swingx.auth

Class JDBCLoginService

java.lang.Object

org.jdesktop.beans.AbstractBean

org.jdesktop.swingx.auth.LoginService

org.jdesktop.swingx.auth.JDBCLoginService

@JavaBean
public class JDBCLoginService
extends LoginService

A login service for connecting to SQL based databases via JDBC

Author:

rbair

Constructor Summary

Constructors

Constructor	Description
JDBCLoginService()	Default JavaBean constructor
JDBCLoginService(String jndiContext)	Create a new JDBCLoginService and initializes it to connect to a database using the given params.
JDBCLoginService(String driver, String url)	Create a new JDBCLoginService and initializes it to connect to a database using the given params.
JDBCLoginService(String driver, String url, Properties props)	Create a new JDBCLoginService and initializes it to connect to a database using the given params.

Method Summary

Modifier and Type	Method	Description
boolean	authenticate(String name, char[] password, String server)	This method is intended to be implemented by clients wishing to authenticate a user with a given password.
Connection	getConnection()
Properties	getProperties()
String	getUrl()
void	setConnection(Connection conn)
void	setProperties(Properties properties)
void	setUrl(String url)

Methods inherited from class org.jdesktop.swingx.auth.LoginService

addLoginListener, cancelAuthentication, getServer, getSynchronous, getUserRoles, removeLoginListener, setServer, setSynchronous, startAuthentication

Methods inherited from class org.jdesktop.beans.AbstractBean

addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, clone, fireIndexedPropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, fireVetoableChange, getPropertyChangeListeners, getPropertyChangeListeners, getVetoableChangeListeners, getVetoableChangeListeners, hasPropertyChangeListeners, hasVetoableChangeListeners, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener

Methods inherited from class java.lang.Object

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

Constructor Details

JDBCLoginService

public JDBCLoginService(String driver,
 String url)

Create a new JDBCLoginService and initializes it to connect to a database using the given params.

Parameters:

driver - DB driver class name

url - DB url

JDBCLoginService

public JDBCLoginService(String driver,
 String url,
 Properties props)

Create a new JDBCLoginService and initializes it to connect to a database using the given params.

Parameters:

driver - DB driver class name

url - DB url

props - Properties

JDBCLoginService

public JDBCLoginService(String jndiContext)

Create a new JDBCLoginService and initializes it to connect to a database using the given params.

Parameters:

jndiContext - String

JDBCLoginService

public JDBCLoginService()

Default JavaBean constructor

Method Details

getUrl

public String getUrl()

Returns:

the JDBC connection url

setUrl

public void setUrl(String url)

Parameters:

url - set the JDBC connection url

getProperties

public Properties getProperties()

Returns:

JDBC connection properties

setProperties

public void setProperties(Properties properties)

Parameters:

properties - miscellaneous JDBC properties to use when connecting to the database via the JDBC driver

getConnection

public Connection getConnection()

Returns:

Connection

setConnection

public void setConnection(Connection conn)

Parameters:

conn - Connection

authenticate

public boolean authenticate(String name,
 char[] password,
 String server)
                     throws Exception

Description copied from class: LoginService

This method is intended to be implemented by clients wishing to authenticate a user with a given password. Clients should implement the authentication in a manner that the authentication can be cancelled at any time.

Specified by:

authenticate in class LoginService

Parameters:

name - user name

password - user password

server - Must be either a valid JDBC URL for the type of JDBC driver you are using, or must be a valid JNDIContext from which to get the database connection

Returns:

true on authentication success

Throws:

Exception - TODO explain