net.morimekta.providence.server

Class ProvidenceHttpServlet<RQ extends PMessage<RQ,RQF>,RQF extends PField,RS extends PMessage<RS,RSF>,RSF extends PField>

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

net.morimekta.providence.server.ProvidenceHttpServlet<RQ,RQF,RS,RSF>

All Implemented Interfaces:

Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig

public abstract class ProvidenceHttpServlet<RQ extends PMessage<RQ,RQF>,RQF extends PField,RS extends PMessage<RS,RSF>,RSF extends PField>
extends javax.servlet.http.HttpServlet

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ProvidenceHttpServlet(PMessageDescriptor<RQ,RQF> requestDescriptor)
ProvidenceHttpServlet(PMessageDescriptor<RQ,RQF> requestDescriptor, SerializerProvider serializerProvider)

Method Summary

Modifier and Type	Method and Description
protected void	doPost(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse resp)
protected Throwable	getResponseException(Throwable e) Get the exception to ge handled on failed requests.
protected abstract <T extends Throwable> RS	handle(javax.servlet.http.HttpServletRequest httpRequest, RQ request)
protected int	statusCodeForException(Throwable exception) With default exception handling, this can simply change the status code used for the response.

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doGet, doHead, doOptions, doPut, doTrace, getLastModified, service, service

Methods inherited from class javax.servlet.GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, init, log, log

Methods inherited from class java.lang.Object

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

Constructor Detail

ProvidenceHttpServlet

public ProvidenceHttpServlet(PMessageDescriptor<RQ,RQF> requestDescriptor)

ProvidenceHttpServlet

public ProvidenceHttpServlet(PMessageDescriptor<RQ,RQF> requestDescriptor,
                             SerializerProvider serializerProvider)

Method Detail

handle

@Nonnull
protected abstract <T extends Throwable> RS handle(javax.servlet.http.HttpServletRequest httpRequest,
                                                            RQ request)
                                                     throws T extends Throwable

Type Parameters:

T - Thrown exception type.

Parameters:

httpRequest - The HTTP request.

request - The parsed providence request.

Returns:

The response object.

Throws:

T - Any exception thrown.

T extends Throwable

getResponseException

@Nonnull
protected Throwable getResponseException(Throwable e)

Get the exception to ge handled on failed requests.

Parameters:

e - The exception seen.

Returns:

The exception to use as response base.

statusCodeForException

protected int statusCodeForException(@Nonnull
                                     Throwable exception)

With default exception handling, this can simply change the status code used for the response.

Parameters:

exception - The exception seen.

Returns:

The status code to be used.

doPost

protected void doPost(javax.servlet.http.HttpServletRequest req,
                      javax.servlet.http.HttpServletResponse resp)
               throws IOException

Overrides:

doPost in class javax.servlet.http.HttpServlet

Throws:

IOException