org.trellisldp.http

Class TrellisHttpResource

java.lang.Object

org.trellisldp.http.TrellisHttpResource

@Provider
 @ApplicationScoped
 @Path(value="{path: .*}")
public class TrellisHttpResource
extends Object

An HTTP request matcher for path-based HTTP resource operations.

Constructor Summary

Constructors

Constructor and Description
TrellisHttpResource(ServiceBundler trellis) Create a Trellis HTTP resource matcher.
TrellisHttpResource(ServiceBundler trellis, String baseUrl) Create a Trellis HTTP resource matcher.

Method Summary

Modifier and Type	Method and Description
void	createResource(AsyncResponse response, Request request, UriInfo uriInfo, HttpHeaders headers, SecurityContext secContext, InputStream body) Perform a POST operation on a LDP Resource.
void	deleteResource(AsyncResponse response, Request request, UriInfo uriInfo, HttpHeaders headers, SecurityContext secContext) Perform a DELETE operation on an LDP Resource.
void	getResource(AsyncResponse response, Request request, UriInfo uriInfo, HttpHeaders headers) Perform a GET operation on an LDP Resource.
void	getResourceHeaders(AsyncResponse response, Request request, UriInfo uriInfo, HttpHeaders headers) Perform a HEAD operation on an LDP Resource.
void	initialize() Initialize the Trellis backend with a root container and default ACL quads.
void	options(AsyncResponse response, Request request, UriInfo uriInfo, HttpHeaders headers) Perform an OPTIONS operation on an LDP Resource.
void	setResource(AsyncResponse response, Request request, UriInfo uriInfo, HttpHeaders headers, SecurityContext secContext, InputStream body) Perform a PUT operation on a LDP Resource.
void	updateResource(AsyncResponse response, Request request, UriInfo uriInfo, HttpHeaders headers, SecurityContext secContext, String body) Perform a PATCH operation on an LDP Resource.

Methods inherited from class java.lang.Object

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

Constructor Detail

TrellisHttpResource

@Inject
public TrellisHttpResource(ServiceBundler trellis)

Create a Trellis HTTP resource matcher.

Parameters:

trellis - the Trellis application bundle

TrellisHttpResource

public TrellisHttpResource(ServiceBundler trellis,
                           String baseUrl)

Create a Trellis HTTP resource matcher.

Parameters:

trellis - the Trellis application bundle

baseUrl - a base URL

Method Detail

initialize

@PostConstruct
public void initialize()

Initialize the Trellis backend with a root container and default ACL quads.

API Note:

In a CDI context, this initialization step will be called automatically. In a Java SE context, however, it may be necessary to invoke this method in code, though a ResourceService implementation may still choose to initialize itself independently of this method. In either case, if the persistence backend has already been initialized with a root resoure and root ACL, this method will make no changes to the storage layer.

getResource

@GET
 @Timed
public void getResource(@Suspended
                                     AsyncResponse response,
                                     @Context
                                     Request request,
                                     @Context
                                     UriInfo uriInfo,
                                     @Context
                                     HttpHeaders headers)

Perform a GET operation on an LDP Resource.

Parameters:

response - the async response

uriInfo - the URI info

headers - the HTTP headers

request - the request

Implementation Note:

The Memento implemenation pattern exactly follows section 4.2.1 of RFC 7089.

getResourceHeaders

@HEAD
 @Timed
public void getResourceHeaders(@Suspended
                                             AsyncResponse response,
                                             @Context
                                             Request request,
                                             @Context
                                             UriInfo uriInfo,
                                             @Context
                                             HttpHeaders headers)

Perform a HEAD operation on an LDP Resource.

Parameters:

response - the async response

uriInfo - the URI info

headers - the HTTP headers

request - the request

Implementation Note:

The Memento implemenation pattern exactly follows section 4.2.1 of RFC 7089.

options

@OPTIONS
 @Timed
public void options(@Suspended
                                     AsyncResponse response,
                                     @Context
                                     Request request,
                                     @Context
                                     UriInfo uriInfo,
                                     @Context
                                     HttpHeaders headers)

Perform an OPTIONS operation on an LDP Resource.

Parameters:

response - the async response

uriInfo - the URI info

headers - the HTTP headers

request - the request

updateResource

@PATCH
 @Timed
public void updateResource(@Suspended
                                          AsyncResponse response,
                                          @Context
                                          Request request,
                                          @Context
                                          UriInfo uriInfo,
                                          @Context
                                          HttpHeaders headers,
                                          @Context
                                          SecurityContext secContext,
                                          String body)

Perform a PATCH operation on an LDP Resource.

Parameters:

response - the async response

uriInfo - the URI info

secContext - the security context

headers - the HTTP headers

request - the request

body - the body

deleteResource

@DELETE
 @Timed
public void deleteResource(@Suspended
                                           AsyncResponse response,
                                           @Context
                                           Request request,
                                           @Context
                                           UriInfo uriInfo,
                                           @Context
                                           HttpHeaders headers,
                                           @Context
                                           SecurityContext secContext)

Perform a DELETE operation on an LDP Resource.

Parameters:

response - the async response

uriInfo - the URI info

secContext - the security context

headers - the HTTP headers

request - the request

createResource

@POST
 @Timed
public void createResource(@Suspended
                                         AsyncResponse response,
                                         @Context
                                         Request request,
                                         @Context
                                         UriInfo uriInfo,
                                         @Context
                                         HttpHeaders headers,
                                         @Context
                                         SecurityContext secContext,
                                         InputStream body)

Perform a POST operation on a LDP Resource.

Parameters:

response - the async response

uriInfo - the URI info

secContext - the security context

headers - the HTTP headers

request - the request

body - the body

setResource

@PUT
 @Timed
public void setResource(@Suspended
                                     AsyncResponse response,
                                     @Context
                                     Request request,
                                     @Context
                                     UriInfo uriInfo,
                                     @Context
                                     HttpHeaders headers,
                                     @Context
                                     SecurityContext secContext,
                                     InputStream body)

Perform a PUT operation on a LDP Resource.

Parameters:

response - the async response

uriInfo - the URI info

secContext - the security context

headers - the HTTP headers

request - the request

body - the body