org.apache.sling.servlets.post
Interface SlingPostConstants

public interface SlingPostConstants

The SlingPostConstants interface provides constants for well known parameters of the core SlingPostServlet. Extensions of the servlet through implementations of the SlingPostOperation interface may extend this constants.

Field Summary

static java.lang.String	DEFAULT_CREATE_SUFFIX The suffix to the resource path used to indicate to automatically generate the name of the new item to create during a content creation request (value is "/").
static java.lang.String	DEFAULT_VALUE_SUFFIX Suffix indicating a default value for a property (value is "@DefaultValue").
static java.lang.String	ITEM_PREFIX_ABSOLUTE Prefix for properties addressing repository items with an absolute path (value is "/").
static java.lang.String	ITEM_PREFIX_RELATIVE_CURRENT Prefix for properties addressing repository items with a path relative to the current request item (value is "./").
static java.lang.String	ITEM_PREFIX_RELATIVE_PARENT Prefix for properties addressing repository items with a path relative to the parent of the request item (value is "../").
static int	NOPSTATUS_VALUE_DEFAULT The default response status sent back by a OPERATION_NOP if the RP_NOP_STATUS parameter is not provided or the parameter value cannot be converted into a valid response status code (value is 200).
static java.lang.String	OPERATION_COPY Name of the predefined copy operation (value is "copy").
static java.lang.String	OPERATION_DELETE Name of the predefined delete operation (value is "delete").
static java.lang.String	OPERATION_MOVE Name of the predefined move operation (value is "move") The move operation requires the RP_DEST request parameter denoting the path to move the content to.
static java.lang.String	OPERATION_NOP Name of the predefined null operation (value is "nop").
static java.lang.String	ORDER_AFTER Possible value of the RP_ORDER parameter indicating that the node by moved immediately after the sibbling whose name is contained in the RP_ORDER parameter (value is "after ").
static java.lang.String	ORDER_BEFORE Possible value of the RP_ORDER parameter indicating that the node by moved immediately before the sibbling whose name is contained in the RP_ORDER parameter (value is "before ").
static java.lang.String	ORDER_FIRST Possible value of the RP_ORDER parameter indicating that the node by moved to the first position amongst its sibblings (value is "first").
static java.lang.String	ORDER_LAST Possible value of the RP_ORDER parameter indicating that the node by moved to the last position amongst its sibblings (value is "last").
static java.lang.String	RP_APPLY_TO Name of the request parameter used to indicate the resource to apply the operation to (value is ":applyTo").
static java.lang.String	RP_DEST Name of the request parameter used to indicate the destination for the copy and move operations (value is ":dest").
static java.lang.String	RP_DISPLAY_EXTENSION Optional request parameter: if provided, added at the end of the computed (or supplied) redirect URL
static java.lang.String	RP_NODE_NAME Optional request paramter specifying a node name for a newly created node (value is ":name").
static java.lang.String	RP_NODE_NAME_HINT Optional request paramter specifying a node name hint for a newly created node (value is ":nameHint").
static java.lang.String	RP_NOP_STATUS Optional request parameter to indicate the actual response status to send back as a result of calling the #OPERATION_NOP (value is ":nopstatus").
static java.lang.String	RP_OPERATION The name of the parameter containing the operation to execute (value is ":operation").
static java.lang.String	RP_ORDER Optional request parameter indicating the order of newly created nodes in creation, copy and move operation requests (value is ":order").
static java.lang.String	RP_PREFIX Prefix for parameter names which control this POST (RP_ stands for "request param") (value is ":").
static java.lang.String	RP_REDIRECT_TO Optional request parameter: redirect to the specified URL after POST
static java.lang.String	RP_REPLACE Name of the request parameter indicating whether the destination for a copy or move operation is to be replaced if existing (value is ":replace").
static java.lang.String	RP_STATUS Optional request parameter: define how the response is sent back to the client.
static java.lang.String	STAR_CREATE_SUFFIX An alternative suffix to the resource path used to indicate to automatically generate the name of the new item to create during a content creation request (value is "/*").
static java.lang.String	STATUS_VALUE_BROWSER The supported value for the RP_STATUS request parameter requesting to not report success or failure of request processing using standard HTTP status codes but instead alwas set the status to 200/OK and only report the real success or failure status in the XHTML response.
static java.lang.String	STATUS_VALUE_STANDARD The supported value for the RP_STATUS request parameter requesting to report success or failure of request processing using standard HTTP status codes.
static java.lang.String	SUFFIX_COPY_FROM Suffix indicating that the named item is to be set from an item whose absolute or relative path is given in the parameter's value (value is "@CopyFrom").
static java.lang.String	SUFFIX_DELETE Suffix indicating that the named property is to be removed before applying any new content (value is "@Delete").
static java.lang.String	SUFFIX_MOVE_FROM Suffix indicating that the named item is to be set from an item whose absolute or relative path is given in the parameter's value (value is "@MoveFrom").
static java.lang.String	TYPE_HINT_SUFFIX Suffix indicating a type hint for the property (value is "@TypeHint").
static java.lang.String	VALUE_FROM_SUFFIX SLING-130, suffix that maps form field names to different JCR property names

Field Detail

RP_PREFIX

static final java.lang.String RP_PREFIX

Prefix for parameter names which control this POST (RP_ stands for "request param") (value is ":"). This prefix must be used on all request parameters which have significance to POST request processing. Such parameters will not be used to denote properties to be written to the repository.

See Also:

Constant Field Values

RP_OPERATION

static final java.lang.String RP_OPERATION

The name of the parameter containing the operation to execute (value is ":operation"). If this parameter is missing or empty, the request is assumed to be a request to create new content or to modify existing content.

See Also:

Constant Field Values

DEFAULT_CREATE_SUFFIX

static final java.lang.String DEFAULT_CREATE_SUFFIX

The suffix to the resource path used to indicate to automatically generate the name of the new item to create during a content creation request (value is "/").

See Also:

Constant Field Values

STAR_CREATE_SUFFIX

static final java.lang.String STAR_CREATE_SUFFIX

An alternative suffix to the resource path used to indicate to automatically generate the name of the new item to create during a content creation request (value is "/*").

See Also:

Constant Field Values

OPERATION_DELETE

static final java.lang.String OPERATION_DELETE

Name of the predefined delete operation (value is "delete").

The delete operation requires no further request parameters and just deletes the content addressed by the request.

If the RP_APPLY_TO parameter is set the resources listed in that parameter are deleted instead of the request resource.

See Also:

Constant Field Values

OPERATION_COPY

static final java.lang.String OPERATION_COPY

Name of the predefined copy operation (value is "copy").

The copy operation requires the RP_DEST request parameter denoting the path to copy the content to. In addition the RP_ORDER parameter may be defined to specificy to relative node order of the destination node. Finally the RP_REPLACE parameter may be set to indicate whether an existing item at the destination should be replaced or not.

If the RP_APPLY_TO parameter is set the resources listed in that parameter are copied instead of the request resource.

See Also:

Constant Field Values

OPERATION_MOVE

static final java.lang.String OPERATION_MOVE

Name of the predefined move operation (value is "move")

The move operation requires the RP_DEST request parameter denoting the path to move the content to. In addition the RP_ORDER parameter may be defined to specificy to relative node order of the destination node. Finally the RP_REPLACE parameter may be set to indicate whether an existing item at the destination should be replaced or not.

If the RP_APPLY_TO parameter is set the resources listed in that parameter are moved instead of the request resource.

See Also:

Constant Field Values

OPERATION_NOP

static final java.lang.String OPERATION_NOP

Name of the predefined null operation (value is "nop").

The null operation is a pseudo operation, which has no effects whatsoever except setting the response status. The null operation may be accompanied with the RP_NOP_STATUS parameter to indicate the actual response status to set and the RP_STATUS parameter to indicate how to send the actual response status.

See Also:

Constant Field Values

RP_APPLY_TO

static final java.lang.String RP_APPLY_TO

Name of the request parameter used to indicate the resource to apply the operation to (value is ":applyTo").

This property is used by certain opertaions - namely OPERATION_COPY, OPERATION_DELETE and OPERATION_MOVE - to apply the operation to multiple resources instead of the request resource.

See Also:

Constant Field Values

RP_DEST

static final java.lang.String RP_DEST

Name of the request parameter used to indicate the destination for the copy and move operations (value is ":dest"). This request parameter is required by the copy and move operations.

See Also:

Constant Field Values

RP_REPLACE

static final java.lang.String RP_REPLACE

Name of the request parameter indicating whether the destination for a copy or move operation is to be replaced if existing (value is ":replace"). Copy or move is only possible if the destination exists if the replace parameter is set to the case-insignificant value true.

See Also:

Constant Field Values

RP_ORDER

static final java.lang.String RP_ORDER

Optional request parameter indicating the order of newly created nodes in creation, copy and move operation requests (value is ":order").

The value of this parameter may be ORDER_FIRST, ORDER_BEFORE, ORDER_AFTER, ORDER_LAST or a numberic value indicating the absolute position in the child list of the parent node.

See Also:

Constant Field Values

ORDER_FIRST

static final java.lang.String ORDER_FIRST

Possible value of the RP_ORDER parameter indicating that the node by moved to the first position amongst its sibblings (value is "first").

See Also:

Constant Field Values

ORDER_BEFORE

static final java.lang.String ORDER_BEFORE

Possible value of the RP_ORDER parameter indicating that the node by moved immediately before the sibbling whose name is contained in the RP_ORDER parameter (value is "before ").

See Also:

Constant Field Values

ORDER_AFTER

static final java.lang.String ORDER_AFTER

Possible value of the RP_ORDER parameter indicating that the node by moved immediately after the sibbling whose name is contained in the RP_ORDER parameter (value is "after ").

See Also:

Constant Field Values

ORDER_LAST

static final java.lang.String ORDER_LAST

Possible value of the RP_ORDER parameter indicating that the node by moved to the last position amongst its sibblings (value is "last").

See Also:

Constant Field Values

RP_NODE_NAME

static final java.lang.String RP_NODE_NAME

Optional request paramter specifying a node name for a newly created node (value is ":name").

See Also:

Constant Field Values

RP_NODE_NAME_HINT

static final java.lang.String RP_NODE_NAME_HINT

Optional request paramter specifying a node name hint for a newly created node (value is ":nameHint").

See Also:

Constant Field Values

ITEM_PREFIX_ABSOLUTE

static final java.lang.String ITEM_PREFIX_ABSOLUTE

Prefix for properties addressing repository items with an absolute path (value is "/").

See Also:

ITEM_PREFIX_RELATIVE_CURRENT, Constant Field Values

ITEM_PREFIX_RELATIVE_CURRENT

static final java.lang.String ITEM_PREFIX_RELATIVE_CURRENT

Prefix for properties addressing repository items with a path relative to the current request item (value is "./").

When collecting parameters addressing repository items for modification, the parameters are first scanned to see whether there is a parameter with this relative path prefix. If such a parameter exists, the modification operations only assumes parameters whose name is prefixes with this prefix or the ITEM_PREFIX_ABSOLUTE or the ITEM_PREFIX_RELATIVE_PARENT to be parameters addressing properties to modify. Otherwise, that is if no parameter starts with this prefix, all parameters not starting with the command prefix are considered addressing properties to modify.

See Also:

Constant Field Values

ITEM_PREFIX_RELATIVE_PARENT

static final java.lang.String ITEM_PREFIX_RELATIVE_PARENT

Prefix for properties addressing repository items with a path relative to the parent of the request item (value is "../").

See Also:

ITEM_PREFIX_RELATIVE_CURRENT, Constant Field Values

RP_REDIRECT_TO

static final java.lang.String RP_REDIRECT_TO

Optional request parameter: redirect to the specified URL after POST

See Also:

Constant Field Values

RP_STATUS

static final java.lang.String RP_STATUS

Optional request parameter: define how the response is sent back to the client. Supported values for this property are STATUS_VALUE_BROWSER and STATUS_VALUE_STANDARD. The default is to assume STATUS_VALUE_STANDARD if the parameter is not set or set to any other value.

See Also:

Constant Field Values

STATUS_VALUE_STANDARD

static final java.lang.String STATUS_VALUE_STANDARD

The supported value for the RP_STATUS request parameter requesting to report success or failure of request processing using standard HTTP status codes. This value is assumed as the default value for the RP_STATUS parameter if the parameter is missing or not any of the two supported values.

See Also:

RP_STATUS, STATUS_VALUE_BROWSER, Constant Field Values

STATUS_VALUE_BROWSER

static final java.lang.String STATUS_VALUE_BROWSER

The supported value for the RP_STATUS request parameter requesting to not report success or failure of request processing using standard HTTP status codes but instead alwas set the status to 200/OK and only report the real success or failure status in the XHTML response.

See Also:

RP_STATUS, STATUS_VALUE_STANDARD, Constant Field Values

RP_NOP_STATUS

static final java.lang.String RP_NOP_STATUS

Optional request parameter to indicate the actual response status to send back as a result of calling the #OPERATION_NOP (value is ":nopstatus").

This parameter is expected to be single-valued and by an integer being a valid HTTP status code. If this parameter is missing or the parameter value cannot be converted to a HTTP status code (integer in the range [100..999]), the default status code 200/OK is returned.

See Also:

OPERATION_NOP, RP_STATUS, Constant Field Values

NOPSTATUS_VALUE_DEFAULT

static final int NOPSTATUS_VALUE_DEFAULT

The default response status sent back by a OPERATION_NOP if the RP_NOP_STATUS parameter is not provided or the parameter value cannot be converted into a valid response status code (value is 200).

See Also:

RP_NOP_STATUS, Constant Field Values

RP_DISPLAY_EXTENSION

static final java.lang.String RP_DISPLAY_EXTENSION

Optional request parameter: if provided, added at the end of the computed (or supplied) redirect URL

See Also:

Constant Field Values

VALUE_FROM_SUFFIX

static final java.lang.String VALUE_FROM_SUFFIX

SLING-130, suffix that maps form field names to different JCR property names

See Also:

Constant Field Values

TYPE_HINT_SUFFIX

static final java.lang.String TYPE_HINT_SUFFIX

Suffix indicating a type hint for the property (value is "@TypeHint").

See Also:

Constant Field Values

DEFAULT_VALUE_SUFFIX

static final java.lang.String DEFAULT_VALUE_SUFFIX

Suffix indicating a default value for a property (value is "@DefaultValue").

See Also:

Constant Field Values

SUFFIX_DELETE

static final java.lang.String SUFFIX_DELETE

Suffix indicating that the named property is to be removed before applying any new content (value is "@Delete").

See Also:

Constant Field Values

SUFFIX_MOVE_FROM

static final java.lang.String SUFFIX_MOVE_FROM

Suffix indicating that the named item is to be set from an item whose absolute or relative path is given in the parameter's value (value is "@MoveFrom").

This suffix is similar to the VALUE_FROM_SUFFIX in that the value for the item is not taken from the request parameter itself but from somewhere else. In this case the value is set by moving another repository item (in the same workspace) to the location addressed by the parameter.

See Also:

Constant Field Values

SUFFIX_COPY_FROM

static final java.lang.String SUFFIX_COPY_FROM

Suffix indicating that the named item is to be set from an item whose absolute or relative path is given in the parameter's value (value is "@CopyFrom").

This suffix is similar to the VALUE_FROM_SUFFIX in that the value for the item is not taken from the request parameter itself but from somewhere else. In this case the value is set by copying another repository item (in the same workspace) to the location addressed by the parameter.

See Also:

Constant Field Values