com.jalios.jcms.rest

Class JcmsRestResource

java.lang.Object

org.restlet.resource.Resource

com.jalios.jcms.rest.JcmsRestResource

All Implemented Interfaces:

MashupConstants, RestConstants

Direct Known Subclasses:

AdminResource, DataRestResource, DataTypeCollectionResource, DataTypeItemResource, WorkflowItemResource, WorkflowsResource, WorkspaceAdminResource

public abstract class JcmsRestResource
extends org.restlet.resource.Resource
implements RestConstants, MashupConstants

Generic Abstract Restlet Resource for all JCMS OpenAPI resource. It MUST be implemented by all such Resources. It : - provides facilities; - ensures stats are logged ... - formats list results.

Since:

JCMS-6.0

Author:

dissert

Field Summary

Fields

Modifier and Type	Field and Description
protected Channel	channel
protected org.restlet.Context	context
protected org.restlet.data.Form	formQueryString
protected javax.servlet.http.HttpServletRequest	j2eeRequest
protected JcmsContext	jcmsContext
protected PagerData	pagerData
protected java.lang.String	queryString
protected java.lang.String	xmlEncoding

Fields inherited from interface com.jalios.jcms.rest.RestConstants

CSRF_HEADER_NAME, HTTP_HEADERS, METHOD_OVERRIDE_HTTP_HEADER, SERVER_REQUEST_HTTP_HEADER_PREFIX, UTS_ADMIN, UTS_DATA_CHILDREN, UTS_DATA_PARAM, UTS_DATATYPE_ITEM, UTS_DATATYPE_LIST, UTS_DOC, UTS_JSYNC_REQUEST, UTS_LOCK, UTS_MEMBER_ITEM, UTS_SEARCH, UTS_UNLOCK, UTS_WHOAMI_ITEM, UTS_WORKFLOWS, UTS_WORKFLOWS_ITEM, UTS_WORKSPACE_ADMIN, UTS_WORKSPACE_ADMIN2

Fields inherited from interface com.jalios.jcms.mashup.MashupConstants

DATA_TAG, DATASET_TAG, FIELD_CLASS, FIELD_ENTRY, FIELD_ITEM, FIELD_KEY, FIELD_NAME, FIELD_TAG, FIELD_VALUE, FILE_FIELD, FILE_ID, FILE_MTIME, FILE_SIZE, FILE_TAG, FILE_TICKET, FILESET_TAG, RELATED_TAG, REVISION

Constructor Summary

Constructors

Constructor and Description
JcmsRestResource(org.restlet.Context context, org.restlet.data.Request request, org.restlet.data.Response response)

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	checkReadRight(Data theData) Check if the given Data may be read by the logged Member.
void	delete()
protected void	doDelete()
protected void	doPost(org.restlet.resource.Representation entity)
protected void	doPost(java.lang.String action, org.restlet.data.Form requestEntityForm)
protected void	doPut(org.restlet.resource.Representation entity)
protected void	doStat()
protected void	forward(java.lang.String path)
protected void	generateErrorRepresentation(java.lang.String errorMessage, java.lang.String applicationErrorCode, org.restlet.data.Status httpStatus, org.restlet.data.Response response) Generate an XML representation of an error response.
protected java.lang.String	getAtomRepresentation()
protected java.lang.String	getItemXmlRepresentation(java.lang.Object item)
protected java.lang.String	getJSONRepresentation()
protected Member	getLoggedMember()
PagerData	getPagerData() Retrieve the PagerData associated to this Resource, if any.
protected java.lang.String	getPlainTextRepresentation()
org.restlet.resource.Representation	getRepresentation(org.restlet.resource.Variant variant)
java.lang.String	getXmlProlog()
protected java.lang.String	getXmlRepresentation()
protected java.lang.String	insertAfterXml()
protected java.lang.String	insertBeforeXml()
void	post(org.restlet.resource.Representation entity)
void	put(org.restlet.resource.Representation entity)
void	setXmlUTF8Encoding()

Methods inherited from class org.restlet.resource.Resource

allowDelete, allowGet, allowPost, allowPut, generateRef, getContext, getLogger, getPreferredRepresentation, getPreferredVariant, getRequest, getResponse, getVariants, handleDelete, handleGet, handleHead, handleOptions, handlePost, handlePut, init, isNegotiateContent, setContext, setNegotiateContent, setRequest, setResponse

Methods inherited from class java.lang.Object

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

Field Detail

channel

protected Channel channel

j2eeRequest

protected javax.servlet.http.HttpServletRequest j2eeRequest

jcmsContext

protected JcmsContext jcmsContext

xmlEncoding

protected java.lang.String xmlEncoding

pagerData

protected PagerData pagerData

queryString

protected java.lang.String queryString

formQueryString

protected org.restlet.data.Form formQueryString

context

protected org.restlet.Context context

Constructor Detail

JcmsRestResource

public JcmsRestResource(org.restlet.Context context,
                org.restlet.data.Request request,
                org.restlet.data.Response response)

Method Detail

getLoggedMember

protected Member getLoggedMember()

forward

protected void forward(java.lang.String path)

getXmlProlog

public java.lang.String getXmlProlog()

setXmlUTF8Encoding

public void setXmlUTF8Encoding()

getRepresentation

public final org.restlet.resource.Representation getRepresentation(org.restlet.resource.Variant variant)

Overrides:

getRepresentation in class org.restlet.resource.Resource

getXmlRepresentation

protected java.lang.String getXmlRepresentation()

getItemXmlRepresentation

protected java.lang.String getItemXmlRepresentation(java.lang.Object item)

insertBeforeXml

protected java.lang.String insertBeforeXml()

insertAfterXml

protected java.lang.String insertAfterXml()

getPlainTextRepresentation

protected java.lang.String getPlainTextRepresentation()

getJSONRepresentation

protected java.lang.String getJSONRepresentation()

getAtomRepresentation

protected java.lang.String getAtomRepresentation()

generateErrorRepresentation

protected void generateErrorRepresentation(java.lang.String errorMessage,
                               java.lang.String applicationErrorCode,
                               org.restlet.data.Status httpStatus,
                               org.restlet.data.Response response)

Generate an XML representation of an error response.

Parameters:

errorMessage - the error message.

applicationErrorCode - the error code.

httpStatus - the HTTP status

response - the response

doStat

protected void doStat()

post

public final void post(org.restlet.resource.Representation entity)

Overrides:

post in class org.restlet.resource.Resource

doPost

protected void doPost(org.restlet.resource.Representation entity)

doPost

protected void doPost(java.lang.String action,
          org.restlet.data.Form requestEntityForm)

put

public final void put(org.restlet.resource.Representation entity)

Overrides:

put in class org.restlet.resource.Resource

doPut

protected void doPut(org.restlet.resource.Representation entity)

delete

public final void delete()

Overrides:

delete in class org.restlet.resource.Resource

doDelete

protected void doDelete()

checkReadRight

protected boolean checkReadRight(Data theData)

Check if the given Data may be read by the logged Member. For specific types (not Publication, Category, Workspace, Member), the data may be read only by their author or an admin member.

Parameters:

theData - the data

Returns:

true is the Data can be read by the logged member

getPagerData

public PagerData getPagerData()

Retrieve the PagerData associated to this Resource, if any.

The pager data instance returned may not contain any data if only one results was returned, in such case, see DataRestResource.getData().

Returns:

a PagerData instance or null if channel was not available.