com.sun.jbi.util.jmx

Class AppSrvJMXConnectorSource

java.lang.Object

com.sun.jbi.util.jmx.AppSrvJMXConnectorSource

All Implemented Interfaces:

JMXConnectorSource

public class AppSrvJMXConnectorSource
extends Object
implements JMXConnectorSource

This class is to be used by jbi components / services to get a JMX Client Connector. This is a wrapper around the JMXConnectorFactory and allows one to connect to a Connector Server, which may have proprietary extensions for Security. The corresponding client Connector Source would be made available through this interface.

Author:

Sun Microsystems, Inc.

Constructor Summary

Constructors

Constructor and Description
AppSrvJMXConnectorSource() Ctor.

Method Summary

Methods

Modifier and Type	Method and Description
JMXConnector	getJMXConnector(boolean forceNew, Map environment) If the connection has already been created, return the existing JMXConnector unless 'forceNew' is true or the connection is currently null.
void	setCredentials(String username, String password)
void	setHostAndPort(String host, int port) If the JMX Connector Server's host and port cannot be identified from the JMX Service URL or if the JMXServiceURL is not set, then this is the process of indicating this information.
void	setIsSecure(boolean secureFlag) This operation is not supported by this implementation of the Connector source and is a no-op.
void	setJMXServiceURL(JMXServiceURL jmxServiceURL) If the JMXServiceURL is setup using this method, the host, protocol and port set independently are overridden.
void	setTrustStore(File truststore, String type, char[] passwd) This operation is not supported by this implementation of the Connector source and is a no-op.

Methods inherited from class java.lang.Object

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

Constructor Detail

AppSrvJMXConnectorSource

public AppSrvJMXConnectorSource()

Ctor.

Method Detail

setCredentials

public void setCredentials(String username,
                  String password)

Specified by:

setCredentials in interface JMXConnectorSource

Parameters:

username - is the username to be used for the Connection.

password - is the user password.

setIsSecure

public void setIsSecure(boolean secureFlag)

This operation is not supported by this implementation of the Connector source and is a no-op.

Specified by:

setIsSecure in interface JMXConnectorSource

Parameters:

secureFlag - indicates whether the connection is to be secured (ex. use SSL)

setTrustStore

public void setTrustStore(File truststore,
                 String type,
                 char[] passwd)

This operation is not supported by this implementation of the Connector source and is a no-op.

Specified by:

setTrustStore in interface JMXConnectorSource

Parameters:

truststore - path to the JKS truststore file.

type - is the type of the Keystore ( JKS, JCEKS etc)

passwd - - the truststore password

setJMXServiceURL

public void setJMXServiceURL(JMXServiceURL jmxServiceURL)

Description copied from interface: JMXConnectorSource

If the JMXServiceURL is setup using this method, the host, protocol and port set independently are overridden.

Specified by:

setJMXServiceURL in interface JMXConnectorSource

Parameters:

jmxServiceURL - - JMX Service URL

setHostAndPort

public void setHostAndPort(String host,
                  int port)

If the JMX Connector Server's host and port cannot be identified from the JMX Service URL or if the JMXServiceURL is not set, then this is the process of indicating this information. This is a no-op in this implementation.

Specified by:

setHostAndPort in interface JMXConnectorSource

Parameters:

host - - hostname

port - - port

getJMXConnector

public JMXConnector getJMXConnector(boolean forceNew,
                           Map environment)
                             throws IOException

If the connection has already been created, return the existing JMXConnector unless 'forceNew' is true or the connection is currently null.

Specified by:

getJMXConnector in interface JMXConnectorSource

Parameters:

forceNew - - create a new connection

environment - - a set of attributes to determine how the connection is made. This parameter can be null. Keys in this map must be Strings. The appropriate type of each associated value depends on the attribute. The contents of environment are not changed by this call

Returns:

the JMX Connector.

Throws:

IOException - if a connection cannot be established.