ej.restserver

Class RestEndpoint

java.lang.Object

ej.restserver.RestEndpoint

Direct Known Subclasses:

AliasEndpoint, ResourceRestEndpoint

public class RestEndpoint
extends java.lang.Object

A REST endpoint exposes resources on a REST server.

Allow HTTP verbs are GET, POST, PUT and DELETE.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	uri The URI this endpoint answers.

Constructor Summary

Constructors

Constructor and Description
RestEndpoint(java.lang.String uri) Create a new endpoint at given URI.

Method Summary

Modifier and Type	Method and Description
ej.hoka.http.HTTPResponse	delete(ej.hoka.http.HTTPRequest request, java.util.Map<java.lang.String,java.lang.String> headers, java.util.Map<java.lang.String,java.lang.String> parameters) Handles DELETE request on this endpoint.
ej.hoka.http.HTTPResponse	get(ej.hoka.http.HTTPRequest request, java.util.Map<java.lang.String,java.lang.String> headers, java.util.Map<java.lang.String,java.lang.String> parameters) Handles GET request on this endpoint.
java.lang.String	getURI() Gets this endpoint URI.
ej.hoka.http.HTTPResponse	post(ej.hoka.http.HTTPRequest request, java.util.Map<java.lang.String,java.lang.String> headers, java.util.Map<java.lang.String,java.lang.String> parameters) Handles POST request on this endpoint.
ej.hoka.http.HTTPResponse	put(ej.hoka.http.HTTPRequest request, java.util.Map<java.lang.String,java.lang.String> headers, java.util.Map<java.lang.String,java.lang.String> parameters) Handles PUT request on this endpoint.

Methods inherited from class java.lang.Object

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

Field Detail

uri

protected java.lang.String uri

The URI this endpoint answers.

Constructor Detail

RestEndpoint

public RestEndpoint(java.lang.String uri)
             throws java.lang.IllegalArgumentException

Create a new endpoint at given URI.

For example, assuming a REST server running at 127.0.0.1:80, following code creates an endpoint at http://127.0.0.1:80/my/custom/endpoint

 server.add(new RestEndpoint("/my/custom/endpoint"));
 

If URI does not start with a / character, it is automatically added.

Parameters:

uri - the URI of this endpoint.

Throws:

java.lang.IllegalArgumentException - if URI is empty

Method Detail

getURI

public java.lang.String getURI()

Gets this endpoint URI.

Returns:

this endpoint URI.

get

public ej.hoka.http.HTTPResponse get(ej.hoka.http.HTTPRequest request,
                                     java.util.Map<java.lang.String,java.lang.String> headers,
                                     java.util.Map<java.lang.String,java.lang.String> parameters)

Handles GET request on this endpoint.

Default implementation return a a status code 501

Parameters:

request - the request to handle.

headers - request headers.

parameters - parsed query and body parameters.

Returns:

an HTTP response.

post

public ej.hoka.http.HTTPResponse post(ej.hoka.http.HTTPRequest request,
                                      java.util.Map<java.lang.String,java.lang.String> headers,
                                      java.util.Map<java.lang.String,java.lang.String> parameters)

Handles POST request on this endpoint.

Default implementation return a a status code 501

Parameters:

request - the request to handle.

headers - request headers.

parameters - parsed query and body parameters.

Returns:

an HTTP response.

put

public ej.hoka.http.HTTPResponse put(ej.hoka.http.HTTPRequest request,
                                     java.util.Map<java.lang.String,java.lang.String> headers,
                                     java.util.Map<java.lang.String,java.lang.String> parameters)

Handles PUT request on this endpoint.

Default implementation return a a status code 501

Parameters:

request - the request to handle.

headers - request headers.

parameters - parsed query and body parameters.

Returns:

an HTTP response.

delete

public ej.hoka.http.HTTPResponse delete(ej.hoka.http.HTTPRequest request,
                                        java.util.Map<java.lang.String,java.lang.String> headers,
                                        java.util.Map<java.lang.String,java.lang.String> parameters)

Handles DELETE request on this endpoint.

Default implementation return a a status code 501

Parameters:

request - the request to handle.

headers - request headers.

parameters - parsed query and body parameters.

Returns:

an HTTP response.