sunlabs.brazil.sunlabs
Class ScriptHandler

java.lang.Object
  extended by sunlabs.brazil.sunlabs.ScriptHandler (view source)
All Implemented Interfaces:
Handler

public class ScriptHandler
extends Object
implements Handler

Interpret a file or resource as a script and run it through The proper interpreter, replacing the content with the output of the script. This requires JSR223 or Java1.6

prefix, suffix, glob, match
See MatchString().
eval
If true, do ${..} processing of script first.
result
Specify the result mime type (defaults to text/html).
mime.suffix
Specifies the mime types for files with the specified suffix (or suffixes). A setting of mime.x=application/foo will attempt to use the language interpreter named "foo" for all URL's that map to files that end in ".x".
The stdout of the script becomes the resultant document (the return value is ignored). If no output is generated, the request returns false, and processing continues.

The global variables "prefix" and "request" are made available to the script, and refect the arguments to respond().

Each session gets its own interpreter instance(s) based on its "SessionID" (or "common" if none is available). Currently no initialization script is supported. See also ScriptServerTemplate, which provides the template version.


Constructor Summary
ScriptHandler()
           
 
Method Summary
 boolean init(Server server, String prefix)
          Initializes the handler.
 boolean respond(Request request)
          Run the file or resource associated with the URL through the script interpreter implied by the mime type.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ScriptHandler

public ScriptHandler()
Method Detail

init

public boolean init(Server server,
                    String prefix)
Description copied from interface: Handler
Initializes the handler.

Specified by:
init in interface Handler
Parameters:
server - The HTTP server that created this Handler. Typical Handlers will use Server.props to obtain run-time configuration information.
prefix - The handlers name. The string this Handler may prepend to all of the keys that it uses to extract configuration information from Server.props. This is set (by the Server and ChainHandler) to help avoid configuration parameter namespace collisions.
Returns:
true if this Handler initialized successfully, false otherwise. If false is returned, this Handler should not be used.

respond

public boolean respond(Request request)
                throws IOException
Run the file or resource associated with the URL through the script interpreter implied by the mime type. Each session gets its own interpreter.

Specified by:
respond in interface Handler
Parameters:
request - The Request object that represents the HTTP request.
Returns:
true if the request was handled. A request was handled if a response was supplied to the client, typically by calling Request.sendResponse() or Request.sendError.
Throws:
IOException - if there was an I/O error while sending the response to the client. Typically, in that case, the Server will (try to) send an error message to the client and then close the client's connection.

The IOException should not be used to silently ignore problems such as being unable to access some server-side resource (for example getting a FileNotFoundException due to not being able to open a file). In that case, the Handler's duty is to turn that IOException into a HTTP response indicating, in this case, that a file could not be found.


Version Kenai-svn-r24, Generated 08/18/09
Copyright (c) 2001-2009, Sun Microsystems.