Package sunlabs.brazil.sunlabs
Class PutHandler
java.lang.Object
sunlabs.brazil.sunlabs.PutHandler
- All Implemented Interfaces:
Handler
Simple PUT and DELETE method handler.
Create, update, or delete files implied by the URL.
returns:
(for PUT)
This handler mostly overlaps the functionallity of the PublishHandler, and they should be combined.
- 201 Created
- 204 No Content - it worked
- 415 Invalid file suffix (no mime type found)
- 403 bad file permissions
- 409 conflict suffix does not match mime type
- 500 server error: can't complete file write
- 501 invalid content-range
- 204 No Content - delete succeeded
- 403 forbidden - no delete permissions
- 404 not found - no file to delete
- root
- The document root. Can be used to override the default document root.
- prefix, suffix, glob, match
- Specifies which URL's trigger this handler. (See MatchString).
TODO:
- allow the deletion of empty directories
- support byte-ranges for updating
This handler mostly overlaps the functionallity of the PublishHandler, and they should be combined.
-
Constructor Summary
Constructors -
Method Summary
-
Constructor Details
-
PutHandler
public PutHandler()
-
-
Method Details
-
init
Description copied from interface:Handler
Initializes the handler.- Specified by:
init
in interfaceHandler
- Parameters:
server
- The HTTP server that created thisHandler
. TypicalHandler
s will useServer.props
to obtain run-time configuration information.prefix
- The handlers name. The string thisHandler
may prepend to all of the keys that it uses to extract configuration information fromServer.props
. This is set (by theServer
andChainHandler
) to help avoid configuration parameter namespace collisions.- Returns:
true
if thisHandler
initialized successfully,false
otherwise. Iffalse
is returned, thisHandler
should not be used.
-
respond
Description copied from interface:Handler
Responds to an HTTP request.- Specified by:
respond
in interfaceHandler
- Parameters:
request
- TheRequest
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 callingRequest.sendResponse()
orRequest.sendError
.- Throws:
IOException
- if there was an I/O error while sending the response to the client. Typically, in that case, theServer
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 aFileNotFoundException
due to not being able to open a file). In that case, theHandler
's duty is to turn thatIOException
into a HTTP response indicating, in this case, that a file could not be found.
-