See also:

basicweb

The basicweb Java package provides a very simple server, client, and proxy. These agents serve as a testbed for prototyping and demonstrating protocols like PEP.

Design

• agents: modules that contain a useful main
• Server
• Client
• ProxyServer and it's ProxyClient
• Message - container for all the data that passes from client to server and visa versa
• Request
• ProxyRequest - passes entire URL in requestURI field
• Reply

Server

Server.main takes creates a basic web server.

arguments

• -port <portno> - port number to pass to accept
• -root <directory> - map all request URI's relative to directory, defaults to directory from which Server was executed.
• -noconfirm - allow the server to run without asking the console for confirmation before executing each request. Use at your own risk.

(minimal) security measures

Server has the following security measures:

• PUT can't overwrite an existing file
• Console confirmation - Server asks the console for permission to execute each request. basicweb.Server has no access control lists or password protection so don't leave it running in noconfimm mode.

ProxyServer

Proxy.main creates a web proxy that reads a proxy request from a client and passes the request to the server. The request is of the form:

method url HTTP/version

This differs from a standard request in the second field as it has a full URL where standard requests don't have the method://server:port portion.

chain of commands

I would like to take a moment to brag about the code re-use for the proxy. The ProxyServer is a standard Server that reads ProxyRequests instead of Requests. The ProxyRequest has a single purpose method dispatcher. The executed method is a ProxyClient that contacts the real server.

Client

The client is a very simple single document retriever. The data disappears into a NullOutputStream.

arguements

Client.main interates through the input creating a new Client for each request. Requests are of the form

[-method] URL

If the method is not -get or -put, the argument is assumed to be a URL and the method is assumed to be a get. You may also enter a default proxy:

-proxy URL

which will serve the remaining reuqests until another -proxy argument is encountered