org.apache.sling.servlethelpers.internalrequests

Class InternalRequest

java.lang.Object

org.apache.sling.servlethelpers.internalrequests.InternalRequest

Direct Known Subclasses:

ServletInternalRequest, SlingInternalRequest

public abstract class InternalRequest
extends java.lang.Object

Fluent helper for Sling internal requests. The ServletInternalRequest and SlingInternalRequest subclasses provide two modes for executing the internal requests, one that's very similar to the way Sling executes an HTTP request and another one that's faster by calling Servlets or Scripts directly.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	contentType
static java.lang.String	DEFAULT_METHOD
protected java.lang.String	extension
protected org.slf4j.Logger	log
static java.lang.String	MDC_KEY An slf4j MDC value is set at this key with request information.
protected java.lang.String	path
protected java.lang.String	requestMethod
protected org.apache.sling.api.resource.ResourceResolver	resourceResolver
protected java.lang.String	selectorString

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InternalRequest(@NotNull org.apache.sling.api.resource.ResourceResolver resourceResolver, @NotNull java.lang.String path) Clients use subclasses of this one

Method Summary

Modifier and Type	Method and Description
protected void	assertRequestExecuted()
protected void	checkNotNull(java.lang.Class<?> clazz, java.lang.Object candidate)
protected void	checkNotNull(java.lang.String info, java.lang.Object candidate)
InternalRequest	checkResponseContentType(java.lang.String contentType) After executing the request, checks that the response content-type is as expected.
InternalRequest	checkStatus(int... acceptableValues) After executing the request, checks that the request status is one of the supplied values.
protected abstract void	delegateExecute(org.apache.sling.api.SlingHttpServletRequest request, org.apache.sling.api.SlingHttpServletResponse response, org.apache.sling.api.resource.ResourceResolver resourceResolver) Execute the supplied Request
InternalRequest	execute() Execute the internal request.
protected abstract org.apache.sling.api.resource.Resource	getExecutionResource() Provide the Resource to use to execute the request
org.apache.sling.api.SlingHttpServletResponse	getResponse() Return the response object.
java.lang.String	getResponseAsString() Return the response as a String.
int	getStatus() Return the response status.
InternalRequest	withBody(java.io.Reader bodyContent) Use the supplied Reader as the request's body content
InternalRequest	withContentType(java.lang.String contentType) Set the HTTP request's Content-Type
InternalRequest	withExtension(java.lang.String extension) Sets the optional extension of the internal request, which influence the Servlet/Script resolution.
InternalRequest	withParameter(java.lang.String key, java.lang.Object value) Set a request parameter
InternalRequest	withParameters(java.util.Map<java.lang.String,java.lang.Object> additionalParameters) Add the supplied request parameters to the current ones
InternalRequest	withRequestMethod(java.lang.String method) Set the HTTP request method to use - defaults to GET
InternalRequest	withSelectors(java.lang.String... selectors) Sets the optional selectors of the internal request, which influence the Servlet/Script resolution.

Methods inherited from class java.lang.Object

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

Field Detail

resourceResolver

protected final org.apache.sling.api.resource.ResourceResolver resourceResolver

path

protected final java.lang.String path

selectorString

protected java.lang.String selectorString

extension

protected java.lang.String extension

requestMethod

protected java.lang.String requestMethod

contentType

protected java.lang.String contentType

log

protected final org.slf4j.Logger log

DEFAULT_METHOD

public static final java.lang.String DEFAULT_METHOD

See Also:

Constant Field Values

MDC_KEY

public static final java.lang.String MDC_KEY

An slf4j MDC value is set at this key with request information. That's useful for troubleshooting when using multiple internal requests in the context of a single HTTP request.

Constructor Detail

InternalRequest

protected InternalRequest(@NotNull
                          @NotNull org.apache.sling.api.resource.ResourceResolver resourceResolver,
                          @NotNull
                          @NotNull java.lang.String path)

Clients use subclasses of this one

Method Detail

checkNotNull

protected void checkNotNull(java.lang.String info,
                            java.lang.Object candidate)

checkNotNull

protected void checkNotNull(java.lang.Class<?> clazz,
                            java.lang.Object candidate)

withRequestMethod

public InternalRequest withRequestMethod(java.lang.String method)

Set the HTTP request method to use - defaults to GET

withContentType

public InternalRequest withContentType(java.lang.String contentType)

Set the HTTP request's Content-Type

withBody

public InternalRequest withBody(java.io.Reader bodyContent)

Use the supplied Reader as the request's body content

withSelectors

public InternalRequest withSelectors(java.lang.String... selectors)

Sets the optional selectors of the internal request, which influence the Servlet/Script resolution.

withExtension

public InternalRequest withExtension(java.lang.String extension)

Sets the optional extension of the internal request, which influence the Servlet/Script resolution.

withParameter

public InternalRequest withParameter(java.lang.String key,
                                     java.lang.Object value)

Set a request parameter

withParameters

public InternalRequest withParameters(java.util.Map<java.lang.String,java.lang.Object> additionalParameters)

Add the supplied request parameters to the current ones

execute

public final InternalRequest execute()
                              throws java.io.IOException

Execute the internal request. Can be called right after creating it, if no options need to be set.

Throws:

java.io.IOException - if the request was already executed, or if an error occurs during execution.

getExecutionResource

protected abstract org.apache.sling.api.resource.Resource getExecutionResource()

Provide the Resource to use to execute the request

delegateExecute

protected abstract void delegateExecute(org.apache.sling.api.SlingHttpServletRequest request,
                                        org.apache.sling.api.SlingHttpServletResponse response,
                                        org.apache.sling.api.resource.ResourceResolver resourceResolver)
                                 throws javax.servlet.ServletException,
                                        java.io.IOException

Execute the supplied Request

Throws:

javax.servlet.ServletException

java.io.IOException

assertRequestExecuted

protected void assertRequestExecuted()
                              throws java.io.IOException

Throws:

java.io.IOException

checkStatus

public InternalRequest checkStatus(int... acceptableValues)
                            throws java.io.IOException

After executing the request, checks that the request status is one of the supplied values. If this is not called before methods that access the response, a check for a 200 OK status is done automatically unless this was called with no arguments before. This makes sure a status check is done or explicitly disabled.

Parameters:

acceptableValues - providing no values means "don't care"

Throws:

java.io.IOException - if status doesn't match any of these values

checkResponseContentType

public InternalRequest checkResponseContentType(java.lang.String contentType)
                                         throws java.io.IOException

After executing the request, checks that the response content-type is as expected.

Throws:

java.io.IOException - if the actual content-type doesn't match the expected one

getStatus

public int getStatus()
              throws java.io.IOException

Return the response status. The execute method must be called before this one.

Throws:

java.io.IOException - if the request hasn't been executed yet

getResponse

public org.apache.sling.api.SlingHttpServletResponse getResponse()
                                                          throws java.io.IOException

Return the response object. The execute method must be called before this one. A check for "200 OK" status is done automatically unless checkStatus(int...) has been called before.

Throws:

java.io.IOException - if the request hasn't been executed yet or if the status check fails.

getResponseAsString

public java.lang.String getResponseAsString()
                                     throws java.io.IOException

Return the response as a String. The execute method must be called before this one. A check for "200 OK" status is done automatically unless checkStatus(int...) has been called before.

Throws:

java.io.IOException - if the request hasn't been executed yet or if the status check fails.