Package org.silverpeas.core.webapi.viewer

Class PreviewResource

java.lang.Object

org.silverpeas.core.web.rs.RESTWebService

org.silverpeas.core.webapi.viewer.AbstractViewResource

org.silverpeas.core.webapi.viewer.PreviewResource

All Implemented Interfaces:

ProtectedWebResource, WebAuthenticationValidation, WebAuthorizationValidation, SilverpeasWebResource

@WebService
@Path("preview")
@Authenticated
public class PreviewResource
extends AbstractViewResource

Author:

Yohann Chastagnier

Nested Class Summary

Nested classes/interfaces inherited from class org.silverpeas.core.web.rs.RESTWebService

RESTWebService.WebProcess<R>, RESTWebService.WebTreatment<R>

Field Summary

Fields inherited from class org.silverpeas.core.web.rs.RESTWebService

RESPONSE_HEADER_ARRAYSIZE

Fields inherited from interface org.silverpeas.core.web.SilverpeasWebResource

BASE_PATH

Constructor Summary

Constructors

Constructor	Description
PreviewResource()

Method Summary

Modifier and Type	Method	Description
protected PreviewEntity	asWebEntity(Preview preview)	Converts the preview into its corresponding web entity.
PreviewEntity	getPreview(String id, String type, String language)	Gets the JSON representation of preview information.
protected String	getResourceBasePath()	Gets the base path of the web resource relative to the root path of all the web resources in Silverpeas as given by SilverpeasWebResource.getBasePath().

Methods inherited from class org.silverpeas.core.webapi.viewer.AbstractViewResource

getAuthorizedResourceView, getComponentId

Methods inherited from class org.silverpeas.core.web.rs.RESTWebService

createWebResourceUri, fromPage, getBundle, getBundleLocation, getHighestUserRole, getHttpRequest, getHttpServletRequest, getHttpServletResponse, getOrganisationController, getSilverpeasContext, getUri, getUser, getUserPreferences, getUserRoles, identifiedBy, identifiedBy, initContext, initWebResourceUri, isUserDefined, process

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.silverpeas.core.web.rs.ProtectedWebResource

validateUserAuthorization

Methods inherited from interface org.silverpeas.core.web.rs.WebAuthenticationValidation

validateUserAuthentication

Constructor Detail

PreviewResource

public PreviewResource()

Method Detail

getPreview

@GET
@Path("{type}/{id}")
@Produces("application/json")
public PreviewEntity getPreview(@PathParam("id")
                                String id,
                                @PathParam("type")
                                String type,
                                @QueryParam("lang")
                                String language)

Gets the JSON representation of preview information. If it doesn't exist, a 404 HTTP code is returned. If the user isn't authenticated, a 401 HTTP code is returned. If a problem occurs when processing the request, a 503 HTTP code is returned.

Parameters:

id - the identifier of a resource handled into Silverpeas's context.

type - the type of the resource.

language - the language used to select the content to preview.

Returns:

the response to the HTTP GET request with the JSON representation of preview information.

asWebEntity

protected PreviewEntity asWebEntity(Preview preview)

Converts the preview into its corresponding web entity.

Parameters:

preview - the view to convert.

Returns:

the corresponding view entity.

getResourceBasePath

protected String getResourceBasePath()

Description copied from class: RESTWebService

Gets the base path of the web resource relative to the root path of all the web resources in Silverpeas as given by SilverpeasWebResource.getBasePath().

Specified by:

getResourceBasePath in class RESTWebService

Returns:

the relative path that identifies this REST web service among all other REST web services.