com.adventnet.adaptors.http
Class HttpConnector

java.lang.Object
  |
  +--com.adventnet.adaptors.AbstractAdaptor
        |
        +--com.adventnet.adaptors.http.HttpConnector

public class HttpConnector

extends AbstractAdaptor

implements DynamicMBean, MBeanRegistration, java.lang.Runnable

This class acts as a Connector for HTTP access to mbeans in Multi-Protocol.

It itself acts as a mbean for exposing the http properties. This class extends the AbstractAdaptor which provides the implementation of ServiceInfo interface and acts as the http-server.

The port number of the service can be specified in the ObjectName with key-value pair as, port=8050(by default)

For example, to start the web-server at 8200, you can specify the following object name:

DefaultDomain

See Also:

Serialized Form

Inner classes inherited from class com.adventnet.adaptors.AbstractAdaptor

AbstractAdaptor.ProcessNotification

Field Summary

static HttpAuthTable	httpAuth
(package private) static java.lang.String	parentDir

Fields inherited from class com.adventnet.adaptors.AbstractAdaptor

handleNotificationinNewThread, notifications, port, processnotification, state

Constructor Summary

HttpConnector()
The NoArg constructor used to initialize the HttpAdaptor in forming the MBeanInfo and getting the reference of the MBeanServer using the MBeanServerFactory.findMBeanServer(null) method.

HttpConnector(int portNum)

HttpConnector(java.lang.Integer portNum)

HttpConnector(java.lang.Integer portNum, MBeanServer MBServer)
This constructor used to initialize the HttpAdaptor in forming the MBeanInfo and getting the reference of the MBeanServer using the input parameter portNum and MBServer.

Method Summary

void	addHttpServerInterface(HttpServerInterface httpServerInterface) Adds HttpServerInterface for controlling WebServer.
static boolean	authenticate(com.adventnet.agent.security.UserContext userContext) Deprecated
void	bind() Must be used to bind to a naming service or to bind to a ServerSocket
void	destroyAdaptor() Kills the adaptor and releases all its resources
void	enableAuthentication(boolean authFlag) enables the authentication feature of the adaptor.
void	enableAuthorisation(boolean authFlag) enables the authorisation feature of the adaptor.
ObjectName	getAdaptorObjectName() Returns the ObjectName of this adaptor with which it has been registered with the MBeanServer.
java.lang.String	getAdaptorVersion() Gets the version of the adaptor.
java.lang.Object	getAttribute(java.lang.String attribute) Gets the value of a specific attribute of this MBean.
AttributeList	getAttributes(java.lang.String[] attributes) Gets the value of a all attributes of this MBean.
MBeanInfo	getMBeanInfo() This method discovers the attributes and operations this MBean exposes for management.
static MBeanServer	getMBeanServer()
java.lang.String	getObjectName() Returns the ObjectName of this adaptor with which it has been registered with the MBeanServer.
static java.lang.String	getParentDirectory() Gets the parent directory for this adaptor
java.lang.String	getProtocol() Gets the protocol supported by this adaptor.
void	instantiateAdaptor() Must be implemented by the adaptor and should be used to instantiate itsefl
java.lang.Object	invoke(java.lang.String actionName, java.lang.Object[] params, java.lang.String[] signature) Invokes an action on this MBean.
static boolean	isAuthenticated() Deprecated
static boolean	isAuthorised() Deprecated
void	postDeregister() Allows this MBean to perform any operations needed after having been de-registered in the MBeanServer.
void	postRegister(java.lang.Boolean registrationDone) Allows this MBean to perform any operations needed after having been registered in the MBeanServer or after the registration has failed.
void	preDeregister() Allows this MBean to perform any operations it needs before being de-registered by the MBeanServer.
ObjectName	preRegister(MBeanServer server, ObjectName name) This method is an implementation of MBeanRegistration interface.
void	processClientRequests()
void	registerAuthentication()
void	restartHttpServer() Restarts the WebServer.
void	run() Getter for MBean server.
void	setAttribute(Attribute attribute) Sets the value of a specific attribute of this MBean.
AttributeList	setAttributes(AttributeList attributes) Sets the values of several attributes of this MBean.
static void	setParentDir(java.lang.String dirName)
void	startHttpServer() Invoke the HTTP server in a thread.
void	startService() Allows the web-server to get started.
void	stopHttpServer() Method to stop the http server.
void	stopService() Allows the web-server to get stopped.
void	unbind() Must be used to unbind from a naming service or to relese a ServerSocket

Methods inherited from class com.adventnet.adaptors.AbstractAdaptor

addNotificationListener, changeState, getHost, getNotificationInfo, getPort, getState, getStateInString, handleNotification, isActive, isSecure, processNotification, removeNotificationListener, setPort

Methods inherited from class java.lang.Object

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

Field Detail

httpAuth

public static HttpAuthTable httpAuth

parentDir

static java.lang.String parentDir

Constructor Detail

HttpConnector

public HttpConnector()

The NoArg constructor used to initialize the HttpAdaptor in forming the MBeanInfo and getting the reference of the MBeanServer using the MBeanServerFactory.findMBeanServer(null) method.

HttpConnector

public HttpConnector(int portNum)

HttpConnector

public HttpConnector(java.lang.Integer portNum)

HttpConnector

public HttpConnector(java.lang.Integer portNum,
                     MBeanServer MBServer)

This constructor used to initialize the HttpAdaptor in forming the MBeanInfo and getting the reference of the MBeanServer using the input parameter portNum and MBServer.

Method Detail

authenticate

public static boolean authenticate(com.adventnet.agent.security.UserContext userContext)

Deprecated

isAuthenticated

public static boolean isAuthenticated()

Deprecated

isAuthorised

public static boolean isAuthorised()

Deprecated

getMBeanInfo

public MBeanInfo getMBeanInfo()

This method discovers the attributes and operations this MBean exposes for management.

Specified by:

getMBeanInfo in interface DynamicMBean

Returns:

An instance of MBeanInfo allowing to retrieve all attributes and operations of this MBean.

getAttribute

public java.lang.Object getAttribute(java.lang.String attribute)
                              throws AttributeNotFoundException,
                                     MBeanException,
                                     ReflectionException

Gets the value of a specific attribute of this MBean.

Specified by:

getAttribute in interface DynamicMBean

Parameters:

attribute - A String specifying the name of the attribute to be retrieved.

Returns:

The value of the retrieved attribute.

getAttributes

public AttributeList getAttributes(java.lang.String[] attributes)

Gets the value of a all attributes of this MBean.

Specified by:

getAttributes in interface DynamicMBean

Parameters:

attributes - A list of attributes to be retrieved.

Returns:

The value of the retrieved attributes as attributeList.

invoke

public java.lang.Object invoke(java.lang.String actionName,
                               java.lang.Object[] params,
                               java.lang.String[] signature)
                        throws MBeanException,
                               ReflectionException

Invokes an action on this MBean.

Specified by:

invoke in interface DynamicMBean

Parameters:

actionName - The name of the action to be invoked.

params - An array containing the parameters to be set when the action is invoked

signature - An array containing the signature of the action. The class objects will be loaded using the same class loader as the one used for loading the MBean on which the action was invoked.

Returns:

The object returned by the action, which represents the result ofinvoking the action on the specified MBean.

setAttribute

public void setAttribute(Attribute attribute)
                  throws AttributeNotFoundException,
                         InvalidAttributeValueException,
                         MBeanException,
                         ReflectionException

Sets the value of a specific attribute of this MBean.

Specified by:

setAttribute in interface DynamicMBean

Parameters:

attribute - The identification of the attribute to be set and the value it is to be set to.

Returns:

The value of the attribute that has been set.

setAttributes

public AttributeList setAttributes(AttributeList attributes)

Sets the values of several attributes of this MBean.

Specified by:

setAttributes in interface DynamicMBean

Parameters:

attributes - A list of attributes: The identification of the attributes to be set and the values they are to be set to.

Returns:

The list of attributes that were set, with their new values.

preRegister

public ObjectName preRegister(MBeanServer server,
                              ObjectName name)
                       throws java.lang.Exception

This method is an implementation of MBeanRegistration interface. Allows this MBean to perform any operations it needs before being registered in the MBeanServer. If the name of the MBean is not specified, the MBean can provide a name for its registration. If any exception is raised, the MBean will not be registered with the MBeanServer.

This method is called by the MBeanServer before this mbean getting registered with the server. If the passed objectName is invalid, the returned objectName is taken as valid name to get registered with the server.

The service gets actually started only inside this method at the specified port mentioned in the key "port". If the key "port" is absent, then the service(http - server) gets started at the default port 8050.

Specified by:

preRegister in interface MBeanRegistration

Overrides:

preRegister in class AbstractAdaptor

Parameters:

server - The MBeanServer in which the MBean will be registered.

name - The object name of the MBean.

Returns:

The name of the MBean registered.

Throws:

java.lang.Exception - This exception should be caught by the MBeanServer and re-thrown as an MBeanRegistrationException.

postRegister

public void postRegister(java.lang.Boolean registrationDone)

Allows this MBean to perform any operations needed after having been registered in the MBeanServer or after the registration has failed.

Specified by:

postRegister in interface MBeanRegistration

Overrides:

postRegister in class AbstractAdaptor

Parameters:

registrationDone - Indicates whether or not the MBean has been successfully registered in the MBeanServer. The value false means that either the registration phase has failed.

preDeregister

public void preDeregister()
                   throws java.lang.Exception

Allows this MBean to perform any operations it needs before being de-registered by the MBeanServer.

Specified by:

preDeregister in interface MBeanRegistration

Overrides:

preDeregister in class AbstractAdaptor

Throws:

java.langException - This exception should be caught by the MBeanServer and re-thrown as an MBeanRegistrationException.

postDeregister

public void postDeregister()

Allows this MBean to perform any operations needed after having been de-registered in the MBeanServer.

Specified by:

postDeregister in interface MBeanRegistration

Overrides:

postDeregister in class AbstractAdaptor

startService

public void startService()
                  throws java.lang.IllegalStateException,
                         java.lang.Exception

Allows the web-server to get started.

Overrides:

startService in class AbstractAdaptor

Tags copied from class: AbstractAdaptor

Throws:

java.lang.IllegalStateException - when the adaptor is in STARTED or STARTING state

stopService

public void stopService()
                 throws java.lang.IllegalStateException

Allows the web-server to get stopped.

Overrides:

stopService in class AbstractAdaptor

Tags copied from class: AbstractAdaptor

Throws:

java.lang.IllegalStateException - when the adaptor is in STOPPED or STOPPING state

enableAuthentication

public void enableAuthentication(boolean authFlag)

enables the authentication feature of the adaptor.

Overrides:

enableAuthentication in class AbstractAdaptor

Returns:

void.

enableAuthorisation

public void enableAuthorisation(boolean authFlag)

enables the authorisation feature of the adaptor.

Overrides:

enableAuthorisation in class AbstractAdaptor

Returns:

void.

processClientRequests

public void processClientRequests()

instantiateAdaptor

public void instantiateAdaptor()
                        throws java.lang.InstantiationException

Description copied from class: AbstractAdaptor

Must be implemented by the adaptor and should be used to instantiate itsefl

Overrides:

instantiateAdaptor in class AbstractAdaptor

bind

public void bind()

Description copied from class: AbstractAdaptor

Must be used to bind to a naming service or to bind to a ServerSocket

Overrides:

bind in class AbstractAdaptor

unbind

public void unbind()

Description copied from class: AbstractAdaptor

Must be used to unbind from a naming service or to relese a ServerSocket

Overrides:

unbind in class AbstractAdaptor

registerAuthentication

public void registerAuthentication()

destroyAdaptor

public void destroyAdaptor()

Description copied from class: AbstractAdaptor

Kills the adaptor and releases all its resources

Overrides:

destroyAdaptor in class AbstractAdaptor

getAdaptorObjectName

public ObjectName getAdaptorObjectName()

Returns the ObjectName of this adaptor with which it has been registered with the MBeanServer.

Overrides:

getAdaptorObjectName in class AbstractAdaptor

Returns:

the ObjectName

getObjectName

public java.lang.String getObjectName()

Returns the ObjectName of this adaptor with which it has been registered with the MBeanServer.

Returns:

the ObjectName

run

public void run()

Getter for MBean server.

Specified by:

run in interface java.lang.Runnable

Returns:

the MBean server reference.

startHttpServer

public void startHttpServer()
                     throws java.lang.Exception

Invoke the HTTP server in a thread.

stopHttpServer

public void stopHttpServer()

Method to stop the http server.

restartHttpServer

public void restartHttpServer()

Restarts the WebServer.

Since:

AdventNet Agent Toolkit (Java Edition) 4.2 release.

getAdaptorVersion

public java.lang.String getAdaptorVersion()

Gets the version of the adaptor.

Overrides:

getAdaptorVersion in class AbstractAdaptor

getProtocol

public java.lang.String getProtocol()

Gets the protocol supported by this adaptor.

Overrides:

getProtocol in class AbstractAdaptor

addHttpServerInterface

public void addHttpServerInterface(HttpServerInterface httpServerInterface)

Adds HttpServerInterface for controlling WebServer. Users can add their implementation of HttpServerInterface to plug-in other webserver.

Parameters:

httpServerInterface - The HttpServerInterface of the user.

Since:

AdventNet Agent Toolkit (Java Edition) 4.2 release.

setParentDir

public static void setParentDir(java.lang.String dirName)

getParentDirectory

public static java.lang.String getParentDirectory()

Gets the parent directory for this adaptor

Returns:

The parent directory

getMBeanServer

public static MBeanServer getMBeanServer()