com.silverpeas.pdc.web
Class PdcResource

java.lang.Object
  com.silverpeas.web.RESTWebService
      com.silverpeas.pdc.web.PdcResource

@Service
@RequestScoped
@Authenticated
public class PdcResource
extends RESTWebService

A REST Web resource that represents the classification plan (named PdC). The PdC is defined by a set of semantic axis that vehicle the business concepts and the structures on which is based a given organization that uses the Silverpeas collaborative portal. The values of an axis is thus made either of single terms (of the inherent concept or structure) or of hierarchic semantic trees in which each branch carries an exactness about the value of a concept. It exists two kinds of PdC: the model (or the referent) in which all the axis to be used in the whole portal are defined, and the instances of the model that represent a PdC configured for a given Silverpeas component instance. The instances of the model can be just a clone of the model or a modified version by taking only some of the model's axis and by setting a different origin value (among the possible values of the axis) for each chosen axis. Such PdCs are identified by an unique URI in which the identifier of the Silverpeas component instance is referenced.

Nested Class Summary

Nested classes/interfaces inherited from class com.silverpeas.web.RESTWebService

RESTWebService.WebProcess<RETURN_VALUE>, RESTWebService.WebTreatment<RETURN_VALUE>

Field Summary

Fields inherited from class com.silverpeas.web.RESTWebService

RESPONSE_HEADER_ARRAYSIZE, REST_WEB_SERVICES_URI_BASE

Constructor Summary

PdcResource()

Method Summary

String	getComponentId() Gets the identifier of the component instance to which the requested resource belongs to.
PdcEntity	getPdc() Gets the PdC.
PdcEntity	getPdcForClassification(String component, String content) Gets the PdC configured for the Silverpeas component instance identified by the requested URI.

Methods inherited from class com.silverpeas.web.RESTWebService

getBundle, getBundleLocation, getGreaterUserRole, getHttpRequest, getHttpServletRequest, getHttpServletResponse, getOrganisationController, getUriInfo, getUserDetail, getUserPreferences, getUserRoles, process, validateUserAuthentication, validateUserAuthorization

Methods inherited from class java.lang.Object

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

Constructor Detail

PdcResource

public PdcResource()

Method Detail

getPdcForClassification

public PdcEntity getPdcForClassification(String component,
                                         String content)

Gets the PdC configured for the Silverpeas component instance identified by the requested URI. The PdC that is sent back is adapted for classifying or updating the classification of the resource content referred by the specified request query parameter. In that case, all the invariant axis of the PdC will have an invariant value set with the one coming from the classification of the resource. In effect, an invariant axis means that no other values are possible when one was already set in a position of the content on the axis. The PdC is sent back in JSON. If the user isn't authenticated, a 401 HTTP code is returned. If the user isn't authorized to access the requested component instance, a 403 is returned. If the resource content isn't indicated as query parameter, a 400 HTTP code is returned. If a problem occurs when processing the request, a 503 HTTP code is returned.

Parameters:

component - the unique identifier of the component instance for which the PdC is instanciated.

content - the unique identifier of the content to classify with the PdC.

Returns:

a web entity representing the PdC ready to be used to classify a content. The entity is serialized in JSON.

getPdc

public PdcEntity getPdc()

Gets the PdC. The PdC is sent back in JSON. If the user isn't authenticated, a 401 HTTP code is returned. If the user isn't authorized to access the requested component instance, a 403 is returned. If the resource content isn't indicated as query parameter, a 400 HTTP code is returned. If a problem occurs when processing the request, a 503 HTTP code is returned.

Returns:

a web entity representing the PdC. The entity is serialized in JSON.

getComponentId

public String getComponentId()

Description copied from class: RESTWebService

Gets the identifier of the component instance to which the requested resource belongs to.

Specified by:

getComponentId in class RESTWebService

Returns:

the identifier of the Silverpeas component instance.