org.jdesktop.swingx.auth
Class JDBCLoginService

java.lang.Object
  extended by org.jdesktop.beans.AbstractBean
      extended by org.jdesktop.swingx.auth.LoginService
          extended by org.jdesktop.swingx.auth.JDBCLoginService

public class JDBCLoginService
extends LoginService

A login service for connecting to SQL based databases via JDBC


Constructor Summary
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
 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 Detail

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 -
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 -
url -
props -

JDBCLoginService

public JDBCLoginService(String jndiContext)
Create a new JDBCLoginService and initializes it to connect to a database using the given params.

Parameters:
jndiContext -

JDBCLoginService

public JDBCLoginService()
Default JavaBean constructor

Method Detail

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()

setConnection

public void setConnection(Connection conn)

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