org.jini.rio.tools.webster

Class Webster

java.lang.Object

org.jini.rio.tools.webster.Webster

All Implemented Interfaces:

Runnable

public class Webster
extends Object
implements Runnable

Webster is a HTTP server which can serve code from multiple codebases. Environment variables used to control Webster are as follows:

org.jini.rio.tools.webster.port	Sets the port for webster to use	0
org.jini.rio.tools.webster.restrictAccess	Restricts access only to files under root. Disallows any "../" notation.	true
org.jini.rio.tools.webster.root	Root directory to serve code from. Webster supports multiple root directories which are separated by a ;	System.getProperty(user.home)

Constructor Summary

Constructors

Constructor and Description
Webster() Create a new Webster.
Webster(int port) Create a new Webster
Webster(int port, String roots) Create a new Webster
Webster(int port, String roots, String bindAddress) Create a new Webster
Webster(int port, String roots, String bindAddress, int minThreads, int maxThreads) Create a new Webster
Webster(String roots) Create a new Webster
Webster(String[] options, LifeCycle lifeCycle) Create a new Webster, compatible with the ServiceStarter mechanism in Jini 2.0

Method Summary

Modifier and Type	Method and Description
static boolean	deleteFile(File dir)
protected String[]	expandRoots()
String	getAddress() Get address that Webster is bound to
int	getPort() Get the port Webster is bound to
String	getProtocol()
String	getRoots() Get the roots Webster is serving as a semicolon delimited String
String	getURL()
static void	main(String[] args)
protected File	parseFileName(String filename)
void	run()
void	terminate() Terminate a running Webster instance

Methods inherited from class java.lang.Object

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

Constructor Detail

Webster

public Webster()
        throws BindException

Create a new Webster. The port is determined by the org.jini.rio.tools.webster.port system property. If the org.jini.rio.tools.webster.port system property does not exist, an anonynous port will be allocated.

Throws:

BindException

Webster

public Webster(int port)
        throws BindException

Create a new Webster

Parameters:

port - The port to use

Throws:

BindException

Webster

public Webster(String roots)
        throws BindException

Create a new Webster

Parameters:

roots - The root(s) to serve code from. This is a semi-colin delimited list of directories

Throws:

BindException

Webster

public Webster(int port,
               String roots)
        throws BindException

Create a new Webster

Parameters:

port - The port to use

roots - The root(s) to serve code from. This is a semi-colin delimited list of directories

Throws:

BindException

Webster

public Webster(int port,
               String roots,
               String bindAddress)
        throws BindException

Create a new Webster

Parameters:

port - The port to use

roots - The root(s) to serve code from. This is a semi-colin delimited list of directories

bindAddress - TCP/IP address which Webster should bind to (null implies no specific address)

Throws:

BindException

Webster

public Webster(int port,
               String roots,
               String bindAddress,
               int minThreads,
               int maxThreads)
        throws BindException

Create a new Webster

Parameters:

port - The port to use

roots - The root(s) to serve code from. This is a semi-colin delimited list of directories

bindAddress - TCP/IP address which Webster should bind to (null implies no specific address)

minThreads - Minimum threads to use in the ThreadPool

maxThreads - Minimum threads to use in the ThreadPool

Throws:

BindException

Webster

public Webster(String[] options,
               LifeCycle lifeCycle)
        throws BindException

Create a new Webster, compatible with the ServiceStarter mechanism in Jini 2.0

Parameters:

options - String[] of options. Valid options are [-port port], [-roots list-of-roots], [-bindAddress address], [-minThreads minThreads], [-maxThreads maxThreads] [-soTimeout soTimeout]

lifeCycle - The LifeCycle object, may be null

Throws:

BindException

Method Detail

getRoots

public String getRoots()

Get the roots Webster is serving as a semicolon delimited String

getURL

public String getURL()

getAddress

public String getAddress()

Get address that Webster is bound to

Returns:

The host address the server socket Webster is using is bound to. If the socket is null, return null.

getProtocol

public String getProtocol()

terminate

public void terminate()

Terminate a running Webster instance

getPort

public int getPort()

Get the port Webster is bound to

run

public void run()

Specified by:

run in interface Runnable

parseFileName

protected File parseFileName(String filename)

expandRoots

protected String[] expandRoots()

main

public static void main(String[] args)
                 throws IOException

Throws:

IOException

deleteFile

public static boolean deleteFile(File dir)