org.objectweb.fractal.jmx.comm
Class RI_HtmlAdaptor

java.lang.Object
  org.objectweb.fractal.jmx.comm.RI_HtmlAdaptor

All Implemented Interfaces:

AttributeController, BindingController, CommunicatorAttributes, LifeCycleController

public class RI_HtmlAdaptor

extends Object

implements BindingController, LifeCycleController, CommunicatorAttributes

A component based on the HTML protocol adaptor provided by the JMX^TM 1.2 Reference Implementation. This adaptor allows an HTML browser to manage all MBeans in the Fractal JMX agent side. To connect a browser to the agent, open this page in a web browser:

http://host:port

where:

• host is the host name of the machine on which the agent is running (or localhost if the agent is local).
• port is the port number used by the HTML server in the agent (default: 8082).

This HTML protocol adaptor provides the following main HTML pages for managing MBeans in the agent:

• Agent View: Provides a list of object names of all the MBeans registered in the agent.
• Agent Administration: Registers and unregisters MBeans in the agent.
• MBean View: Reads and writes MBean attributes and perform operations on MBeans in the agent.

The binding controller part of this component allows to set the (required) agent component. The attribute controller part allows to set the port number used to connect a browser to the agent. The life-cycle controller part registers this component in the agent when it starts, if it is not already registered or if its port attribute has changed. The underlying HTML protocol adaptor is implemented as a dynamic MBean, and can be managed:

• as described in the JMX^TM 1.2 Reference Implementation documentation.
  It is identified in the agent by the ObjectName: RI_HtmlAdaptor:type=html,port=port
• or indirectly by accessing the MBean representing the attribute controller of this component.
  In this case, it is required to stop and (re)start the component to take account a new port number, and to browse a page with the new port.

Version:

0.1

Field Summary

Fields inherited from interface org.objectweb.fractal.api.control.LifeCycleController

STARTED, STOPPED

Constructor Summary

RI_HtmlAdaptor()

Method Summary

void	bindFc(String itfName, Object itfValue)
String	getFcState()
int	getPort() Gets the port number used by this component.
String[]	listFc()
Object	lookupFc(String itfName)
void	setPort(int port) Sets the port number used by this Component.
void	startFc()
void	stopFc()
void	unbindFc(String itfName)

Methods inherited from class java.lang.Object

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

Constructor Detail

RI_HtmlAdaptor

public RI_HtmlAdaptor()

Method Detail

listFc

public String[] listFc()

Specified by:

listFc in interface BindingController

lookupFc

public Object lookupFc(String itfName)

Specified by:

lookupFc in interface BindingController

bindFc

public void bindFc(String itfName,
                   Object itfValue)

Specified by:

bindFc in interface BindingController

unbindFc

public void unbindFc(String itfName)

Specified by:

unbindFc in interface BindingController

getFcState

public String getFcState()

Specified by:

getFcState in interface LifeCycleController

startFc

public void startFc()

Specified by:

startFc in interface LifeCycleController

stopFc

public void stopFc()

Specified by:

stopFc in interface LifeCycleController

getPort

public int getPort()

Description copied from interface: CommunicatorAttributes

Gets the port number used by this component.

Specified by:

getPort in interface CommunicatorAttributes

Returns:

the port number used by this component.

setPort

public void setPort(int port)

Description copied from interface: CommunicatorAttributes

Sets the port number used by this Component.

Specified by:

setPort in interface CommunicatorAttributes

Parameters:

port - the port number used by this Component.