spark

Class RouteImpl

java.lang.Object

spark.RouteImpl

Direct Known Subclasses:

ResponseTransformerRouteImpl, TemplateViewRouteImpl

public abstract class RouteImpl
extends Object

A Route is built up by a path (for url-matching) and the implementation of the 'handle' method. When a request is made, if present, the matching routes 'handle' method is invoked. The object that is returned from 'handle' will be set to the response body (toString()).

Author:

Per Wendel

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RouteImpl(String path) Constructor
protected	RouteImpl(String path, String acceptType) Constructor

Method Summary

Modifier and Type	Method and Description
String	getAcceptType()
abstract Object	handle(Request request, Response response) Invoked when a request is made on this route's corresponding path e.g.
String	render(Object element) This method should render the given element into something that can be send through Response element.

Methods inherited from class java.lang.Object

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

Constructor Detail

RouteImpl

protected RouteImpl(String path)

Constructor

Parameters:

path - The route path which is used for matching. (e.g. /hello, users/:name)

RouteImpl

protected RouteImpl(String path,
                    String acceptType)

Constructor

Parameters:

path - The route path which is used for matching. (e.g. /hello, users/:name)

acceptType - The accept type which is used for matching.

Method Detail

handle

public abstract Object handle(Request request,
                              Response response)
                       throws Exception

Invoked when a request is made on this route's corresponding path e.g. '/hello'

Parameters:

request - The request object providing information about the HTTP request

response - The response object providing functionality for modifying the response

Returns:

The content to be set in the response

Throws:

Exception - when handle fails

render

public String render(Object element)
              throws Exception

This method should render the given element into something that can be send through Response element. By default this method returns the result of calling toString method in given element, but can be overridden.

Parameters:

element - to be rendered.

Returns:

body content.

Throws:

Exception - when render fails

getAcceptType

public String getAcceptType()

Returns:

the accept type