Package org.apache.sling.servlets.post
Class AbstractPostResponse
java.lang.Object
org.apache.sling.servlets.post.AbstractPostResponse
- All Implemented Interfaces:
PostResponse
- Direct Known Subclasses:
HtmlResponse
,JSONResponse
Deprecated.
The
AbstractPostResponse
class provides a basic implementation
of the PostResponse
interface maintaining properties to be
prepared for sending the response in an internal map.-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final String
Deprecated.Name of the error property set bysetError(Throwable)
static final String
Deprecated.Name of the create status property set bysetCreateRequest(boolean)
static final String
Deprecated.Name of the location property set bysetLocation(String)
static final String
Deprecated.Name of the parent location property set bysetParentLocation(String)
static final String
Deprecated.Name of the path property set bysetPath(String)
static final String
Deprecated.Name of the referer property set bysetReferer(String)
static final String
Deprecated.Name of the status code property set bysetStatus(int, String)
static final String
Deprecated.Name of the status message property set bysetStatus(int, String)
static final String
Deprecated.Name of the title property set bysetTitle(String)
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected abstract void
doSend
(javax.servlet.http.HttpServletResponse response) Deprecated.getError()
Deprecated.Returns any recorded error ornull
Deprecated.Returns the location of the modification.Deprecated.Returns the parent location of the modification.getPath()
Deprecated.Returns the absolute path of the item upon which the request operated.protected Object
getProperty
(String name) Deprecated.Returns the generic response property with the given name and type ornull
if no such property exists.protected <Type> Type
getProperty
(String name, Class<Type> type) Deprecated.Returns the generic response property with the given name and type ornull
if no such property exists or the property is not of the requested type.Deprecated.Returns the referer previously set byPostResponse.setReferer(String)
int
Deprecated.Returns the status code of this instance.Deprecated.Returns the status message ornull
if no has been set with thePostResponse.setStatus(int, String)
method.boolean
Deprecated.Returnstrue
if this was a create request.protected boolean
Deprecated.determines if the referer has a proper referer including protocolboolean
Deprecated.void
Deprecated.Records a 'copied' change.void
Deprecated.Records a 'created' changevoid
Deprecated.Records a 'deleted' changevoid
onModified
(String path) Deprecated.Records a 'modified' changevoid
Deprecated.Records a 'moved' change.final void
send
(javax.servlet.http.HttpServletResponse response, boolean setStatus) Deprecated.Writes the response to the given writer and replaces all ${var} patterns by the value of the respective property.void
setCreateRequest
(boolean isCreateRequest) Deprecated.Sets whether the request was a create request or not.void
Deprecated.Sets the recorded error causing the operation to fail.void
setLocation
(String location) Deprecated.Sets the location of this modification.void
setParentLocation
(String parentLocation) Deprecated.Sets the parent location of the modification.void
Deprecated.Sets the absolute path of the item upon which the request operated.protected void
setProperty
(String name, Object value) Deprecated.Sets a generic response property with the givenvoid
setReferer
(String referer) Deprecated.Sets the referer propertyvoid
Deprecated.sets the response status code propertiesvoid
Deprecated.Sets the title of the response messageMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.apache.sling.servlets.post.PostResponse
onChange
-
Field Details
-
PN_TITLE
Deprecated.Name of the title property set bysetTitle(String)
- See Also:
-
PN_STATUS_CODE
Deprecated.Name of the status code property set bysetStatus(int, String)
- See Also:
-
PN_STATUS_MESSAGE
Deprecated.Name of the status message property set bysetStatus(int, String)
- See Also:
-
PN_LOCATION
Deprecated.Name of the location property set bysetLocation(String)
- See Also:
-
PN_PARENT_LOCATION
Deprecated.Name of the parent location property set bysetParentLocation(String)
- See Also:
-
PN_PATH
Deprecated.Name of the path property set bysetPath(String)
- See Also:
-
PN_REFERER
Deprecated.Name of the referer property set bysetReferer(String)
- See Also:
-
PN_IS_CREATED
Deprecated.Name of the create status property set bysetCreateRequest(boolean)
- See Also:
-
PN_ERROR
Deprecated.Name of the error property set bysetError(Throwable)
- See Also:
-
-
Constructor Details
-
AbstractPostResponse
public AbstractPostResponse()Deprecated.
-
-
Method Details
-
getReferer
Deprecated.Returns the referer previously set byPostResponse.setReferer(String)
- Specified by:
getReferer
in interfacePostResponse
- Returns:
- the referer
-
setReferer
Deprecated.Sets the referer property- Specified by:
setReferer
in interfacePostResponse
- Parameters:
referer
- the referer
-
getPath
Deprecated.Returns the absolute path of the item upon which the request operated.If the
PostResponse.setPath(String)
method has not been called yet, this method returnsnull
.- Specified by:
getPath
in interfacePostResponse
- Returns:
- the path (might be null)
-
setPath
Deprecated.Sets the absolute path of the item upon which the request operated.- Specified by:
setPath
in interfacePostResponse
- Parameters:
path
- the path
-
isCreateRequest
public boolean isCreateRequest()Deprecated.Returnstrue
if this was a create request.Before calling the
PostResponse.setCreateRequest(boolean)
method, this method always returnsfalse
.- Specified by:
isCreateRequest
in interfacePostResponse
- Returns:
- if this was a create request
-
setCreateRequest
public void setCreateRequest(boolean isCreateRequest) Deprecated.Sets whether the request was a create request or not.- Specified by:
setCreateRequest
in interfacePostResponse
- Parameters:
isCreateRequest
- true if the request was a create request
-
getLocation
Deprecated.Returns the location of the modification.If the
PostResponse.setLocation(String)
method has not been called yet, this method returnsnull
.- Specified by:
getLocation
in interfacePostResponse
- Returns:
- the location
-
setLocation
Deprecated.Description copied from interface:PostResponse
Sets the location of this modification. This is the externalized form of thecurrent path
.- Specified by:
setLocation
in interfacePostResponse
- Parameters:
location
- the location
-
getParentLocation
Deprecated.Returns the parent location of the modification. this is the externalized form of the parent node of the current path.- Specified by:
getParentLocation
in interfacePostResponse
- Returns:
- the location of the modification.
-
setParentLocation
Deprecated.Description copied from interface:PostResponse
Sets the parent location of the modification. This is the externalized form of the parent node of thecurrent path
.- Specified by:
setParentLocation
in interfacePostResponse
- Parameters:
parentLocation
- the parent location of the modification
-
setTitle
Deprecated.Sets the title of the response message- Specified by:
setTitle
in interfacePostResponse
- Parameters:
title
- the title
-
setStatus
Deprecated.sets the response status code properties- Specified by:
setStatus
in interfacePostResponse
- Parameters:
code
- the codemessage
- the message
-
getStatusCode
public int getStatusCode()Deprecated.Returns the status code of this instance. If the status code has never been set by calling thesetStatus(int, String)
method, the status code is determined by checking if there was an error. If there was an error, the response is assumed to be unsuccessful and 500 is returned. If there is no error, the response is assumed to be successful and 200 is returned.- Specified by:
getStatusCode
in interfacePostResponse
- Returns:
- the status code
-
getStatusMessage
Deprecated.Description copied from interface:PostResponse
Returns the status message ornull
if no has been set with thePostResponse.setStatus(int, String)
method.- Specified by:
getStatusMessage
in interfacePostResponse
- Returns:
- the status message (might be null)
-
getError
Deprecated.Returns any recorded error ornull
- Specified by:
getError
in interfacePostResponse
- Returns:
- an error or
null
-
setError
Deprecated.Description copied from interface:PostResponse
Sets the recorded error causing the operation to fail.- Specified by:
setError
in interfacePostResponse
- Parameters:
error
- the throwable
-
isSuccessful
public boolean isSuccessful()Deprecated.- Specified by:
isSuccessful
in interfacePostResponse
- Returns:
- true if the status code is 2xx
-
onModified
Deprecated.Records a 'modified' change- Specified by:
onModified
in interfacePostResponse
- Parameters:
path
- path of the item that was modified
-
onCreated
Deprecated.Records a 'created' change- Specified by:
onCreated
in interfacePostResponse
- Parameters:
path
- path of the item that was created
-
onDeleted
Deprecated.Records a 'deleted' change- Specified by:
onDeleted
in interfacePostResponse
- Parameters:
path
- path of the item that was deleted
-
onMoved
Deprecated.Records a 'moved' change.Note: the moved change only records the basic move command. the implied changes on the moved properties and sub nodes are not recorded.
- Specified by:
onMoved
in interfacePostResponse
- Parameters:
srcPath
- source path of the node that was moveddstPath
- destination path of the node that was moved.
-
onCopied
Deprecated.Records a 'copied' change.Note: the copy change only records the basic copy command. the implied changes on the copied properties and sub nodes are not recorded.
- Specified by:
onCopied
in interfacePostResponse
- Parameters:
srcPath
- source path of the node that was copieddstPath
- destination path of the node that was copied.
-
setProperty
Deprecated.Sets a generic response property with the given- Parameters:
name
- name of the propertyvalue
- value of the property
-
getProperty
Deprecated.Returns the generic response property with the given name and type ornull
if no such property exists or the property is not of the requested type.- Type Parameters:
Type
- the return type- Parameters:
name
- the name of the requetested propertytype
- the type of the parameter which should be returned- Returns:
- the property as the requested type or null if not available at all or not in the requested type
-
getProperty
Deprecated.Returns the generic response property with the given name and type ornull
if no such property exists.- Parameters:
name
- the name of the response property- Returns:
- the requested property (might be null)
-
isSafeReferer
protected boolean isSafeReferer()Deprecated.determines if the referer has a proper referer including protocol- Returns:
- true if HTTP or HTTPS protocol information is available in the referer
-
doSend
Deprecated.- Throws:
IOException
-
send
public final void send(javax.servlet.http.HttpServletResponse response, boolean setStatus) throws IOException Deprecated.Writes the response to the given writer and replaces all ${var} patterns by the value of the respective property. if the property is not defined the pattern is not modified.- Specified by:
send
in interfacePostResponse
- Parameters:
response
- to send tosetStatus
- whether to set the status code on the response- Throws:
IOException
- if an i/o exception occurs
-
AbstractJakartaPostResponse
instead.