oracle.uddi.client
Class SimpleAuthenticationLiaison

java.lang.Object
oracle.uddi.client.SimpleAuthenticationLiaison

All Implemented Interfaces:

AuthenticationLiaison

public class SimpleAuthenticationLiaison

extends java.lang.Object

implements AuthenticationLiaison

Implements a simple authentication scheme provided by the UDDI messages get_authToken and discard_authToken, as defined in the UDDI specification. It is expected that the UDDI registry to be authenticated to understands the simple get/discard token scheme and allows simple username/password authentication.

Note: Clients of the API should do nothing more than instantiate this class. Its methods are called indirectly by the UddiClient object.

Constructor Summary

SimpleAuthenticationLiaison(java.lang.String szUserId, java.lang.String szCred)
Instantiate an instance.

Method Summary

void	authenticate() Perform the proper authentication.
void	close() Close the authenticated session.
java.lang.String	getAuthInfo() Return the token of the authenticated session.
java.lang.String	getPassword()
java.lang.String	getUserName()
void	init(UddiClient uddiClient) Initialize the authentication liaison.
void	setCredentials(java.lang.String szUserId, java.lang.String szCred) Change the credential information.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleAuthenticationLiaison

public SimpleAuthenticationLiaison(java.lang.String szUserId,
                                   java.lang.String szCred)

Instantiate an instance. This is all a UddiClient user needs to do.

Parameters:

szUserId - refers to the userid element of get_authToken message.

szCred - refers to the cred element of get_authToken message.

Method Detail

init

public void init(UddiClient uddiClient)

Description copied from interface: AuthenticationLiaison

Initialize the authentication liaison.

Specified by:

init in interface AuthenticationLiaison

authenticate

public void authenticate()
                  throws UddiClientException,
                         org.apache.soap.SOAPException

Description copied from interface: AuthenticationLiaison

Perform the proper authentication. If the authentication is successful, AuthenticationLiaison.getAuthInfo() must return the token for the authenticated session.

Specified by:

authenticate in interface AuthenticationLiaison

Throws:

UddiClientException

org.apache.soap.SOAPException

getAuthInfo

public java.lang.String getAuthInfo()

Description copied from interface: AuthenticationLiaison

Return the token of the authenticated session. This method is used by UddiClient to manage the session on behalf of the users.

Specified by:

getAuthInfo in interface AuthenticationLiaison

Returns:

the token of the authenticated session, null if not yet authenticated or token is not needed by the authentication scheme.

See Also:

UddiClient

setCredentials

public void setCredentials(java.lang.String szUserId,
                           java.lang.String szCred)
                    throws UddiClientException,
                           org.apache.soap.SOAPException

Change the credential information. NOTE: This will terminate previous authentication session.

Throws:

UddiClientException

org.apache.soap.SOAPException

getUserName

public java.lang.String getUserName()

getPassword

public java.lang.String getPassword()

close

public void close()
           throws UddiClientException,
                  org.apache.soap.SOAPException

Close the authenticated session. getAuthInfo() will return null from this point onwards.

Specified by:

close in interface AuthenticationLiaison

Throws:

UddiClientException

org.apache.soap.SOAPException