org.spincast.core.routing

Interface IRouteBuilder<R extends IRequestContext<?>>

All Known Implementing Classes:

RouteBuilder

public interface IRouteBuilder<R extends IRequestContext<?>>

Builder to create a route.

Method Summary

Modifier and Type	Method and Description
IRouteBuilder<R>	accept(ContentTypeDefaults... acceptedContentTypes) Sets the accepted Content-Types.
IRouteBuilder<R>	accept(Set<ContentTypeDefaults> acceptedContentTypes) Sets the accepted Content-Types.
IRouteBuilder<R>	acceptAsString(Set<String> acceptedContentTypes) Sets the accepted Content-Types.
IRouteBuilder<R>	acceptAsString(String... acceptedContentTypes) Sets the accepted Content-Types.
IRouteBuilder<R>	after(IHandler<R> afterFilter) Adds an "after" filter which will only be applied to this particular route.
IRouteBuilder<R>	ALL() Adds all HTTP methods as being supported.
IRouteBuilder<R>	allRoutingTypes() This route will be considered for all routing types.
IRouteBuilder<R>	before(IHandler<R> beforeFilter) Adds a "before" filter which will only be applied to this particular route.
IRouteBuilder<R>	cache() Adds cache headers.
IRouteBuilder<R>	cache(int seconds) Adds public cache headers.
IRouteBuilder<R>	cache(int seconds, boolean isPrivate) Adds cache headers.
IRouteBuilder<R>	cache(int seconds, boolean isPrivate, Integer secondsCdn) Adds cache headers.
IRoute<R>	create(IHandler<R> mainHandler) Creates and returns the route without adding it to the router.
IRouteBuilder<R>	DELETE() Adds DELETE as a supported HTTP method.
IRouteBuilder<R>	exception() This route will be considered during an Exception routing process.
IRouteBuilder<R>	found() This route will be considered during a Found routing process.
IRouteBuilder<R>	GET() Addss GET as a supported HTTP method.
IRouteBuilder<R>	HEAD() Adds HEAD as a supported HTTP method.
IRouteBuilder<R>	html() Adds application/html as an accepted Content-Type.
IRouteBuilder<R>	id(String id) An id that can be used to identify the route.
IRouteBuilder<R>	json() Adds application/json as an accepted Content-Type.
IRouteBuilder<R>	noCache() Automatically adds "no-cache" headers to the response.
IRouteBuilder<R>	notFound() This route will be considered during a Not Found routing process.
IRouteBuilder<R>	OPTIONS() Adds OPTIONS as a supported HTTP method.
IRouteBuilder<R>	PATCH() Adds PATCH as a supported HTTP method.
IRouteBuilder<R>	path(String path) The path of the route.
IRouteBuilder<R>	pos(int position) The position of the handler.
IRouteBuilder<R>	POST() Adds POST as a supported HTTP method.
IRouteBuilder<R>	PUT() Adds PUT as a supported HTTP method.
void	save(IHandler<R> mainHandler) Creates the route and saves it to the router.
IRouteBuilder<R>	SOME(HttpMethod... httpMethods) Adds the specified HTTP methods as being supported.
IRouteBuilder<R>	SOME(Set<HttpMethod> httpMethods) Adds the specified HTTP methods as being supported.
IRouteBuilder<R>	TRACE() Adds TRACE as a supported HTTP method.
IRouteBuilder<R>	xml() Adds application/xml as an accepted Content-Type.

Method Detail

id

IRouteBuilder<R> id(String id)

An id that can be used to identify the route. Must be unique.

path

IRouteBuilder<R> path(String path)

The path of the route.

pos

IRouteBuilder<R> pos(int position)

The position of the handler. If "0", the handler is considered as the *main* handler. Only one main handler per request is run (the first one found)! The main handler is usually where the body of the response is created. A route with a position less than "0" is considered as a "before" filter and will be run before the main handler. A route with a position greater than "0" is considered as an "after" filter and will be run after the main handler. All the matching before and after filters are run, from the lower position to the higher. If two filters have the same position, they will be run in order they have been added to the router. More than one position is allowed. If not specified, "0" is used.

found

IRouteBuilder<R> found()

This route will be considered during a Found routing process.

notFound

IRouteBuilder<R> notFound()

This route will be considered during a Not Found routing process.

exception

IRouteBuilder<R> exception()

This route will be considered during an Exception routing process.

allRoutingTypes

IRouteBuilder<R> allRoutingTypes()

This route will be considered for all routing types.

before

IRouteBuilder<R> before(IHandler<R> beforeFilter)

Adds a "before" filter which will only be applied to this particular route. If more than one filter is added, they will be run in order they have been added.

after

IRouteBuilder<R> after(IHandler<R> afterFilter)

Adds an "after" filter which will only be applied to this particular route. If more than one filter is added, they will be run in order they have been added.

acceptAsString

IRouteBuilder<R> acceptAsString(String... acceptedContentTypes)

Sets the accepted Content-Types. This route will only be considered for requests specifying those Content-Types as being accepted (using the Accept header).

acceptAsString

IRouteBuilder<R> acceptAsString(Set<String> acceptedContentTypes)

Sets the accepted Content-Types. This route will only be considered for requests specifying those Content-Types as being accepted (using the Accept header).

accept

IRouteBuilder<R> accept(ContentTypeDefaults... acceptedContentTypes)

Sets the accepted Content-Types. This route will only be considered for requests specifying those Content-Types as being accepted (using the Accept header).

accept

IRouteBuilder<R> accept(Set<ContentTypeDefaults> acceptedContentTypes)

Sets the accepted Content-Types. This route will only be considered for requests specifying those Content-Types as being accepted (using the Accept header).

html

IRouteBuilder<R> html()

Adds application/html as an accepted Content-Type.

json

IRouteBuilder<R> json()

Adds application/json as an accepted Content-Type.

xml

IRouteBuilder<R> xml()

Adds application/xml as an accepted Content-Type.

GET

IRouteBuilder<R> GET()

Addss GET as a supported HTTP method. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. This one will simply be added.

POST

IRouteBuilder<R> POST()

Adds POST as a supported HTTP method. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. This one will simply be added.

PUT

IRouteBuilder<R> PUT()

Adds PUT as a supported HTTP method. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. This one will simply be added.

DELETE

IRouteBuilder<R> DELETE()

Adds DELETE as a supported HTTP method. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. This one will simply be added.

OPTIONS

IRouteBuilder<R> OPTIONS()

Adds OPTIONS as a supported HTTP method. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. This one will simply be added.

TRACE

IRouteBuilder<R> TRACE()

Adds TRACE as a supported HTTP method. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. This one will simply be added.

HEAD

IRouteBuilder<R> HEAD()

Adds HEAD as a supported HTTP method. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. This one will simply be added.

PATCH

IRouteBuilder<R> PATCH()

Adds PATCH as a supported HTTP method. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. This one will simply be added.

ALL

IRouteBuilder<R> ALL()

Adds all HTTP methods as being supported. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. By calling this method, all methods will now be suported.

SOME

IRouteBuilder<R> SOME(Set<HttpMethod> httpMethods)

Adds the specified HTTP methods as being supported. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. Those new ones will simply be added.

SOME

IRouteBuilder<R> SOME(HttpMethod... httpMethods)

Adds the specified HTTP methods as being supported. If you started the creation of the route from an IRouter object, you already specified some supported HTTP methods. Those new ones will simply be added.

save

void save(IHandler<R> mainHandler)

Creates the route and saves it to the router. If the creation of the route was not started using an IRouter object, an exception will be thrown.

create

IRoute<R> create(IHandler<R> mainHandler)

Creates and returns the route without adding it to the router. NOTE : use save(...) instead to save the route to the router at the end of the build process!

noCache

IRouteBuilder<R> noCache()

Automatically adds "no-cache" headers to the response.

cache

IRouteBuilder<R> cache()

Adds cache headers.

Uses the default cache configurations, provided by ISpincastConfig

cache

IRouteBuilder<R> cache(int seconds)

Adds public cache headers.

Parameters:

seconds - The number of seconds the resource associated with this route should be cached.

cache

IRouteBuilder<R> cache(int seconds,
                       boolean isPrivate)

Adds cache headers.

Parameters:

seconds - The number of seconds the resource associated with this route should be cached.

isPrivate - should the cache be private? (help)

cache

IRouteBuilder<R> cache(int seconds,
                       boolean isPrivate,
                       Integer secondsCdn)

Adds cache headers.

Parameters:

seconds - The number of seconds the resource associated with this route should be cached.

isPrivate - should the cache be private? (help)

secondsCdn - The number of seconds the resource associated with this route should be cached by a CDN/proxy. If null, it won't be used.