org.jboss.web
Class WebService

java.lang.Object
  org.jboss.mx.util.JBossNotificationBroadcasterSupport
      org.jboss.system.ServiceMBeanSupport
          org.jboss.web.WebService

All Implemented Interfaces:

javax.management.MBeanRegistration, javax.management.NotificationBroadcaster, javax.management.NotificationEmitter, org.jboss.system.Service, org.jboss.system.ServiceMBean, WebServiceMBean

public class WebService
extends org.jboss.system.ServiceMBeanSupport
implements WebServiceMBean

The WebService implementation. It configures a WebServer instance to perform dynamic class and resource loading.

Version:

$Revision: 1.20.2.3 $

Author:

Rickard �berg., Scott Stark., Jason Dillon

Field Summary

Fields inherited from class org.jboss.system.ServiceMBeanSupport

log, SERVICE_CONTROLLER_SIG, serviceName

Fields inherited from interface org.jboss.web.WebServiceMBean

OBJECT_NAME

Fields inherited from interface org.jboss.system.ServiceMBean

CREATE_EVENT, CREATED, DESTROY_EVENT, DESTROYED, FAILED, REGISTERED, START_EVENT, STARTED, STARTING, states, STOP_EVENT, STOPPED, STOPPING, UNREGISTERED

Constructor Summary

WebService()

Method Summary

URL	addClassLoader(ClassLoader cl)
protected void	createService()
int	getBacklog() Get the WebService listen queue backlog limit.
String	getBindAddress() Get the specific address the WebService listens on.
boolean	getDownloadResources() A flag indicating if the server should attempt to download resources, i.e.
boolean	getDownloadServerClasses() A flag indicating if the server should attempt to download classes from thread context class loader when a request arrives that does not have a class loader key prefix.
String	getHost() Set the name of the interface to use for the host portion of the RMI codebase URL.
protected javax.management.ObjectName	getObjectName(javax.management.MBeanServer server, javax.management.ObjectName name)
int	getPort() Get the WebService listening port.
void	removeClassLoader(ClassLoader cl)
void	setBacklog(int backlog) Set the WebService listen queue backlog limit.
void	setBindAddress(String host) Set the specific address the WebService listens on.
void	setDownloadResources(boolean flag)
void	setDownloadServerClasses(boolean flag)
void	setHost(String hostname) Get the name of the interface to use for the host portion of the RMI codebase URL.
void	setPort(int port) Set the WebService listening port.
void	setThreadPool(org.jboss.util.threadpool.BasicThreadPoolMBean threadPool) Set the thread pool used for the WebServer class loading.
protected void	startService() Start the web server for dynamic downloading of classes and resources.
protected void	stopService()

Methods inherited from class org.jboss.system.ServiceMBeanSupport

create, destroy, destroyService, getDeploymentInfo, getLog, getName, getNextNotificationSequenceNumber, getServer, getServiceName, getState, getStateString, jbossInternalCreate, jbossInternalDescription, jbossInternalDestroy, jbossInternalLifecycle, jbossInternalStart, jbossInternalStop, postDeregister, postRegister, preDeregister, preRegister, start, stop

Methods inherited from class org.jboss.mx.util.JBossNotificationBroadcasterSupport

addNotificationListener, getNotificationInfo, handleNotification, nextNotificationSequenceNumber, removeNotificationListener, removeNotificationListener, sendNotification

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jboss.system.ServiceMBean

getName, getState, getStateString, jbossInternalLifecycle

Methods inherited from interface org.jboss.system.Service

create, destroy, start, stop

Constructor Detail

WebService

public WebService()

Method Detail

addClassLoader

public URL addClassLoader(ClassLoader cl)

Specified by:

addClassLoader in interface WebServiceMBean

removeClassLoader

public void removeClassLoader(ClassLoader cl)

Specified by:

removeClassLoader in interface WebServiceMBean

setPort

public void setPort(int port)

Set the WebService listening port.

Specified by:

setPort in interface WebServiceMBean

Parameters:

port - The listening port; 0 for anonymous

getPort

public int getPort()

Get the WebService listening port.

Specified by:

getPort in interface WebServiceMBean

setHost

public void setHost(String hostname)

Get the name of the interface to use for the host portion of the RMI codebase URL.

Specified by:

setHost in interface WebServiceMBean

getHost

public String getHost()

Set the name of the interface to use for the host portion of the RMI codebase URL.

Specified by:

getHost in interface WebServiceMBean

getBindAddress

public String getBindAddress()

Get the specific address the WebService listens on.

Specified by:

getBindAddress in interface WebServiceMBean

Returns:

the interface name or IP address the WebService binds to.

setBindAddress

public void setBindAddress(String host)
                    throws UnknownHostException

Set the specific address the WebService listens on. This can be used on a multi-homed host for a ServerSocket that will only accept connect requests to one of its addresses.

Specified by:

setBindAddress in interface WebServiceMBean

Parameters:

host - the interface name or IP address to bind. If host is null, connections on any/all local addresses will be allowed.

Throws:

UnknownHostException

getBacklog

public int getBacklog()

Get the WebService listen queue backlog limit. The maximum queue length for incoming connection indications (a request to connect) is set to the backlog parameter. If a connection indication arrives when the queue is full, the connection is refused.

Specified by:

getBacklog in interface WebServiceMBean

Returns:

the queue backlog limit.

setBacklog

public void setBacklog(int backlog)

Set the WebService listen queue backlog limit. The maximum queue length for incoming connection indications (a request to connect) is set to the backlog parameter. If a connection indication arrives when the queue is full, the connection is refused.

Specified by:

setBacklog in interface WebServiceMBean

Parameters:

backlog, - the queue backlog limit.

setThreadPool

public void setThreadPool(org.jboss.util.threadpool.BasicThreadPoolMBean threadPool)

Set the thread pool used for the WebServer class loading.

Specified by:

setThreadPool in interface WebServiceMBean

getDownloadServerClasses

public boolean getDownloadServerClasses()

A flag indicating if the server should attempt to download classes from thread context class loader when a request arrives that does not have a class loader key prefix.

Specified by:

getDownloadServerClasses in interface WebServiceMBean

setDownloadServerClasses

public void setDownloadServerClasses(boolean flag)

Specified by:

setDownloadServerClasses in interface WebServiceMBean

getDownloadResources

public boolean getDownloadResources()

A flag indicating if the server should attempt to download resources, i.e. resource paths that don't end in .class

Specified by:

getDownloadResources in interface WebServiceMBean

setDownloadResources

public void setDownloadResources(boolean flag)

Specified by:

setDownloadResources in interface WebServiceMBean

getObjectName

protected javax.management.ObjectName getObjectName(javax.management.MBeanServer server,
                                                    javax.management.ObjectName name)
                                             throws javax.management.MalformedObjectNameException

Overrides:

getObjectName in class org.jboss.system.ServiceMBeanSupport

Throws:

javax.management.MalformedObjectNameException

createService

protected void createService()
                      throws Exception

Overrides:

createService in class org.jboss.system.ServiceMBeanSupport

Throws:

Exception

startService

protected void startService()
                     throws Exception

Start the web server for dynamic downloading of classes and resources.

The system java.rmi.server.codebase is also set to http://:/ if the property has not been set.

Overrides:

startService in class org.jboss.system.ServiceMBeanSupport

Throws:

Exception

stopService

protected void stopService()
                    throws Exception

Overrides:

stopService in class org.jboss.system.ServiceMBeanSupport

Throws:

Exception