com.sun.xml.registry.ebxml
Class ConnectionImpl

java.lang.Object
  extended bycom.sun.xml.registry.ebxml.ConnectionImpl
All Implemented Interfaces:
javax.xml.registry.Connection

public class ConnectionImpl
extends java.lang.Object
implements javax.xml.registry.Connection

ConnectionImpl


Method Summary
 void authenticate()
          Forces authentication to occur.
 void close()
          Since a provider typically allocates significant resources outside the JVM on behalf of a Connection, clients should close them when they are not needed.
 javax.security.auth.callback.CallbackHandler getCallbackHandler()
          DOCUMENT ME!
 ConnectionFactoryImpl getConnectionFactory()
          DOCUMENT ME!
 java.util.Set getCredentials()
          Gets the credentials associated with this client.
 LoginModuleManager getLoginModuleManager()
          This method is used to get the reference to the LoginModuleManager With this reference, references to a parent Frame and Log can be passed to the LoginModuleManager.
 javax.xml.registry.RegistryService getRegistryService()
          Gets the RegistryService interface associated with the Connection.
 boolean isAuthenticated()
          Determine whether the user has already authenticated and setCredentials on the Connection or not.
 boolean isClosed()
          Return true if this Connection has been closed.
 boolean isSynchronous()
          Return true if client uses synchronous communication with JAXR provider.
 void logoff()
          Logout current user if any.
 void setCallbackHandler(javax.security.auth.callback.CallbackHandler handler)
          DOCUMENT ME!
 void setCredentials(java.util.Set credentials)
          Sets the Credentials associated with this client.
 void setSynchronous(boolean sync)
          Sets whether the client uses synchronous communication or not.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getRegistryService

public javax.xml.registry.RegistryService getRegistryService()
                                                      throws javax.xml.registry.JAXRException
Gets the RegistryService interface associated with the Connection. If a Connection property (e.g. credentials) is set after the client calls getRegistryService then the newly set Connection property is visible to the RegistryService previously returned by this call.

Capability Level: 0

Specified by:
getRegistryService in interface javax.xml.registry.Connection
Throws:
javax.xml.registry.JAXRException
See Also:
RegistryService

close

public void close()
           throws javax.xml.registry.JAXRException
Since a provider typically allocates significant resources outside the JVM on behalf of a Connection, clients should close them when they are not needed.

Capability Level: 0

Specified by:
close in interface javax.xml.registry.Connection
Throws:
javax.xml.registry.JAXRException - if a JARR error occurs.

isClosed

public boolean isClosed()
                 throws javax.xml.registry.JAXRException
Return true if this Connection has been closed.

Capability Level: 0

Specified by:
isClosed in interface javax.xml.registry.Connection
Returns:
DOCUMENT ME!
Throws:
javax.xml.registry.JAXRException - DOCUMENT ME!

isSynchronous

public boolean isSynchronous()
                      throws javax.xml.registry.JAXRException
Return true if client uses synchronous communication with JAXR provider. Note that a JAXR provider must support both modes of communication, while the client can choose which mode it wants to use. Default is a return value of true (synchronous communication).

Capability Level: 0

Specified by:
isSynchronous in interface javax.xml.registry.Connection
Returns:
DOCUMENT ME!
Throws:
javax.xml.registry.JAXRException - DOCUMENT ME!

setSynchronous

public void setSynchronous(boolean sync)
                    throws javax.xml.registry.JAXRException
Sets whether the client uses synchronous communication or not. A JAXR client may dynamically change its communication style preference.

Capability Level: 0

Specified by:
setSynchronous in interface javax.xml.registry.Connection
Parameters:
sync - DOCUMENT ME!
Throws:
javax.xml.registry.JAXRException - DOCUMENT ME!

setCredentials

public void setCredentials(java.util.Set credentials)
                    throws javax.xml.registry.JAXRException
Sets the Credentials associated with this client. The credentials is used to authenticate the client with the JAXR provider. A JAXR client may dynamically change its identity by changing the credentials associated with it.

Capability Level: 0

Specified by:
setCredentials in interface javax.xml.registry.Connection
Parameters:
credentials - a Collection oj java.lang.Objects which provide identity related information for the caller.
Throws:
javax.xml.registry.JAXRException - If the JAXR provider encounters an internal error

getCredentials

public java.util.Set getCredentials()
                             throws javax.xml.registry.JAXRException
Gets the credentials associated with this client.

Capability Level: 0

Specified by:
getCredentials in interface javax.xml.registry.Connection
Returns:
Set of java.lang.Object instances. The Collection may be empty but not null.
Throws:
javax.xml.registry.JAXRException - If the JAXR provider encounters an internal error

getConnectionFactory

public ConnectionFactoryImpl getConnectionFactory()
DOCUMENT ME!

Returns:
DOCUMENT ME!

getLoginModuleManager

public LoginModuleManager getLoginModuleManager()
This method is used to get the reference to the LoginModuleManager With this reference, references to a parent Frame and Log can be passed to the LoginModuleManager.

Returns:
A reference to the LoginModuleManager

getCallbackHandler

public javax.security.auth.callback.CallbackHandler getCallbackHandler()
                                                                throws javax.xml.registry.JAXRException
DOCUMENT ME!

Returns:
DOCUMENT ME!
Throws:
javax.xml.registry.JAXRException

setCallbackHandler

public void setCallbackHandler(javax.security.auth.callback.CallbackHandler handler)
DOCUMENT ME!

Parameters:
handler - DOCUMENT ME!

isAuthenticated

public boolean isAuthenticated()
                        throws javax.xml.registry.JAXRException
Determine whether the user has already authenticated and setCredentials on the Connection or not. Add to JAXR 2.0??

Throws:
javax.xml.registry.JAXRException

authenticate

public void authenticate()
                  throws javax.xml.registry.JAXRException
Forces authentication to occur. Add to JAXR 2.0??

Throws:
javax.xml.registry.JAXRException - DOCUMENT ME!

logoff

public void logoff()
            throws javax.xml.registry.JAXRException
Logout current user if any.

Throws:
javax.xml.registry.JAXRException


Copyright © 2001-2004 OASIS. All Rights Reserved.