Package org.silverpeas.core.webapi.admin

Class ComponentResource

java.lang.Object

org.silverpeas.core.web.rs.RESTWebService

org.silverpeas.core.webapi.admin.AbstractAdminResource

org.silverpeas.core.webapi.admin.ComponentResource

All Implemented Interfaces:

ProtectedWebResource, WebAuthenticationValidation, WebAuthorizationValidation, SilverpeasWebResource

@WebService
@Path("components/{componentId}")
@Authorized
public class ComponentResource
extends AbstractAdminResource

A REST Web resource giving component data.

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
ComponentResource()

Method Summary

Modifier and Type	Method	Description
ComponentEntity	get()	Gets the JSON representation of the specified existing ComponentInstLight.
String	getComponentId()	Gets the identifier of the component instance to which the requested resource belongs to.
protected String	getResourceBasePath()	Gets the base path of the web resource relative to the root path of all of the web resources in Silverpeas as given by SilverpeasWebResource.getBasePath().
Map<SilverpeasRole,UsersAndGroupsRoleEntity>	getUsersAndGroupsRoles(String roles)	Gets users and groups roles indexed by role names.
protected WebResourceUri	initWebResourceUri()	Default initialization of WebResourceUri instance for all WEB services extending RESTWebService class.

Methods inherited from class org.silverpeas.core.webapi.admin.AbstractAdminResource

asWebEntities, asWebEntities, asWebEntity, asWebEntity, asWebEntity, asWebEntity, asWebPersonalEntities, asWebPersonalEntity, asWebPersonalEntity, asWebPersonalEntity, getAdminPersonalDelegate, getAdminServices, getLookDelegate, isUserAuthorizedToAccessLookContext, loadComponent, loadComponents, loadSpace, loadSpaces, verifyUserAuthorizedToAccessLookContext, verifyUserAuthorizedToAccessSpace

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

fromPage, getBundle, getBundleLocation, getHighestUserRole, getHttpRequest, getHttpServletRequest, getHttpServletResponse, getOrganisationController, getSilverpeasContext, getUri, getUser, getUserPreferences, getUserRoles, identifiedBy, identifiedBy, initContext, 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

ComponentResource

public ComponentResource()

Method Detail

getResourceBasePath

protected String getResourceBasePath()

Description copied from class: RESTWebService

Gets the base path of the web resource relative to the root path of all of 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.

initWebResourceUri

protected WebResourceUri initWebResourceUri()

Description copied from class: RESTWebService

Default initialization of WebResourceUri instance for all WEB services extending RESTWebService class.

This method can be overrated in case the default initialization is not satisfying a right behavior.

In any case, the WebResourceUri is computed one time (and only one) per request and the result of computation is provided by RESTWebService.getUri() method.

Overrides:

initWebResourceUri in class RESTWebService

Returns:

a WebResourceUri instance.

get

@GET
@Produces("application/json")
public ComponentEntity get()

Gets the JSON representation of the specified existing ComponentInstLight. If it doesn't exist, a 404 HTTP code is returned. If the user isn't authentified, a 401 HTTP code is returned. If the user isn't authorized to access the component, a 403 HTTP code is returned. If a problem occurs when processing the request, a 503 HTTP code is returned.

Returns:

the response to the HTTP GET request with the JSON representation of the asked ComponentInstLight.

getUsersAndGroupsRoles

@GET
@Path("usersAndGroupsRoles")
@Produces("application/json")
public Map<SilverpeasRole,UsersAndGroupsRoleEntity> getUsersAndGroupsRoles(@QueryParam("roles")
                                                                                 String roles)

Gets users and groups roles indexed by role names. If it doesn't exist, a 404 HTTP code is returned. If the user isn't authentified, a 401 HTTP code is returned. If the user isn't authorized to access the space, a 403 HTTP code is returned. If a problem occurs when processing the request, a 503 HTTP code is returned.

Parameters:

roles - aimed roles (each one separated by comma). If empty, all roles are returned.

Returns:

the JSON response to the HTTP GET request.

getComponentId

public String getComponentId()

Description copied from interface: SilverpeasWebResource

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

Returns:

the identifier of the Silverpeas component instance.