org.exoplatform.social.rest.impl.user

Class UserRestResourcesV1

java.lang.Object

org.exoplatform.social.rest.impl.user.UserRestResourcesV1

All Implemented Interfaces:

org.exoplatform.services.rest.resource.ResourceContainer, SocialRest, UserRestResources, org.picocontainer.Startable

public class UserRestResourcesV1
extends Object
implements UserRestResources, org.picocontainer.Startable

Provides REST Services for manipulating jobs related to users.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UserRestResourcesV1.ACTIVITY_STREAM_TYPE

Field Summary

Fields

Modifier and Type	Field and Description
static org.exoplatform.portal.rest.UserFieldValidator	EMAIL_VALIDATOR
static org.exoplatform.portal.rest.UserFieldValidator	FIRSTNAME_VALIDATOR
static org.exoplatform.portal.rest.UserFieldValidator	LASTNAME_VALIDATOR
static org.exoplatform.portal.rest.UserFieldValidator	PASSWORD_VALIDATOR
static String	PROFILE_DEFAULT_AVATAR_URL
static String	PROFILE_DEFAULT_BANNER_URL
static List<org.exoplatform.portal.rest.UserFieldValidator>	USER_FIELD_VALIDATORS
static org.exoplatform.portal.rest.UserFieldValidator	USERNAME_VALIDATOR

Constructor Summary

Constructors

Constructor and Description

UserRestResourcesV1(org.exoplatform.portal.config.UserACL userACL, org.exoplatform.services.organization.OrganizationService organizationService, org.exoplatform.social.core.manager.IdentityManager identityManager, org.exoplatform.social.core.manager.RelationshipManager relationshipManager, org.exoplatform.services.user.UserStateService userStateService, org.exoplatform.social.core.space.spi.SpaceService spaceService, org.exoplatform.upload.UploadService uploadService)

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	addActivityByUser(javax.ws.rs.core.UriInfo uriInfo, String id, String expand, ActivityRestIn model)
javax.ws.rs.core.Response	addUser(javax.ws.rs.core.UriInfo uriInfo, String expand, UserEntity model) Creates an user
javax.ws.rs.core.Response	deleteUserById(javax.ws.rs.core.UriInfo uriInfo, String id, String expand)
javax.ws.rs.core.Response	getActivitiesOfUser(javax.ws.rs.core.UriInfo uriInfo, String id, String type, int offset, int limit, String before, String after, boolean returnSize, String expand)
javax.ws.rs.core.Response	getConnectionsOfUser(javax.ws.rs.core.UriInfo uriInfo, String id, String q, boolean returnSize, String expand)
javax.ws.rs.core.Response	getInvitationsOfUser(javax.ws.rs.core.UriInfo uriInfo, boolean returnSize, String expand)
javax.ws.rs.core.Response	getPendingOfUser(javax.ws.rs.core.UriInfo uriInfo, boolean returnSize, String expand)
javax.ws.rs.core.Response	getSpacesOfUser(javax.ws.rs.core.UriInfo uriInfo, String id, int offset, int limit, boolean returnSize, String expand)
javax.ws.rs.core.Response	getUserAvatarById(javax.ws.rs.core.UriInfo uriInfo, javax.ws.rs.core.Request request, String id, String lastModified, String defaultAvatar)
javax.ws.rs.core.Response	getUserBannerById(javax.ws.rs.core.UriInfo uriInfo, javax.ws.rs.core.Request request, String id, String lastModified, String defaultBanner)
javax.ws.rs.core.Response	getUserById(javax.ws.rs.core.UriInfo uriInfo, String id, String expand)
javax.ws.rs.core.Response	getUsers(javax.ws.rs.core.UriInfo uriInfo, String q, String status, String spaceId, int offset, int limit, boolean returnSize, String expand) Get all users, filter by name if exists.
javax.ws.rs.core.Response	importUsers(javax.servlet.http.HttpServletRequest request, String uploadId, boolean progress, boolean clean, boolean sync)
void	start()
void	stop()
javax.ws.rs.core.Response	updateUserById(javax.ws.rs.core.UriInfo uriInfo, String id, String expand, UserEntity model)
javax.ws.rs.core.Response	updateUserProfileAttribute(String username, String name, String value)
javax.ws.rs.core.Response	updateUserProfileAttributes(javax.servlet.http.HttpServletRequest request, String username, ProfileEntity profileEntity)

Methods inherited from class java.lang.Object

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

Field Detail

PROFILE_DEFAULT_BANNER_URL

public static final String PROFILE_DEFAULT_BANNER_URL

See Also:

Constant Field Values

PROFILE_DEFAULT_AVATAR_URL

public static final String PROFILE_DEFAULT_AVATAR_URL

See Also:

Constant Field Values

USERNAME_VALIDATOR

public static final org.exoplatform.portal.rest.UserFieldValidator USERNAME_VALIDATOR

EMAIL_VALIDATOR

public static final org.exoplatform.portal.rest.UserFieldValidator EMAIL_VALIDATOR

LASTNAME_VALIDATOR

public static final org.exoplatform.portal.rest.UserFieldValidator LASTNAME_VALIDATOR

FIRSTNAME_VALIDATOR

public static final org.exoplatform.portal.rest.UserFieldValidator FIRSTNAME_VALIDATOR

PASSWORD_VALIDATOR

public static final org.exoplatform.portal.rest.UserFieldValidator PASSWORD_VALIDATOR

USER_FIELD_VALIDATORS

public static final List<org.exoplatform.portal.rest.UserFieldValidator> USER_FIELD_VALIDATORS

Constructor Detail

UserRestResourcesV1

public UserRestResourcesV1(org.exoplatform.portal.config.UserACL userACL,
                           org.exoplatform.services.organization.OrganizationService organizationService,
                           org.exoplatform.social.core.manager.IdentityManager identityManager,
                           org.exoplatform.social.core.manager.RelationshipManager relationshipManager,
                           org.exoplatform.services.user.UserStateService userStateService,
                           org.exoplatform.social.core.space.spi.SpaceService spaceService,
                           org.exoplatform.upload.UploadService uploadService)

Method Detail

start

public void start()

Specified by:

start in interface org.picocontainer.Startable

stop

public void stop()

Specified by:

stop in interface org.picocontainer.Startable

getUsers

@RolesAllowed(value="users")
public javax.ws.rs.core.Response getUsers(@Context
                                                                       javax.ws.rs.core.UriInfo uriInfo,
                                                                       String q,
                                                                       String status,
                                                                       String spaceId,
                                                                       int offset,
                                                                       int limit,
                                                                       boolean returnSize,
                                                                       String expand)
                                                                throws Exception

Description copied from interface: UserRestResources

Get all users, filter by name if exists.

Specified by:

getUsers in interface UserRestResources

q - value that an user's name match

status - filter only online users

spaceId - filter only space members

Returns:

List of users in json format.

Throws:

Exception

addUser

@RolesAllowed(value="users")
public javax.ws.rs.core.Response addUser(@Context
                                                                      javax.ws.rs.core.UriInfo uriInfo,
                                                                      String expand,
                                                                      UserEntity model)
                                                               throws Exception

Description copied from interface: UserRestResources

Creates an user

Specified by:

addUser in interface UserRestResources

Returns:

user created in json format

Throws:

Exception

getUserById

@RolesAllowed(value="users")
public javax.ws.rs.core.Response getUserById(@Context
                                                                          javax.ws.rs.core.UriInfo uriInfo,
                                                                          String id,
                                                                          String expand)
                                                                   throws Exception

Specified by:

getUserById in interface UserRestResources

Throws:

Exception

getUserAvatarById

public javax.ws.rs.core.Response getUserAvatarById(@Context
                                                   javax.ws.rs.core.UriInfo uriInfo,
                                                   @Context
                                                   javax.ws.rs.core.Request request,
                                                   String id,
                                                   String lastModified,
                                                   String defaultAvatar)
                                            throws IOException

Throws:

IOException

getUserBannerById

public javax.ws.rs.core.Response getUserBannerById(@Context
                                                   javax.ws.rs.core.UriInfo uriInfo,
                                                   @Context
                                                   javax.ws.rs.core.Request request,
                                                   String id,
                                                   String lastModified,
                                                   String defaultBanner)
                                            throws IOException

Throws:

IOException

updateUserProfileAttribute

public javax.ws.rs.core.Response updateUserProfileAttribute(String username,
                                                            String name,
                                                            String value)
                                                     throws IOException

Throws:

IOException

updateUserProfileAttributes

public javax.ws.rs.core.Response updateUserProfileAttributes(@Context
                                                             javax.servlet.http.HttpServletRequest request,
                                                             String username,
                                                             ProfileEntity profileEntity)
                                                      throws Exception

Throws:

Exception

deleteUserById

@RolesAllowed(value="users")
public javax.ws.rs.core.Response deleteUserById(@Context
                                                                             javax.ws.rs.core.UriInfo uriInfo,
                                                                             String id,
                                                                             String expand)
                                                                      throws Exception

Specified by:

deleteUserById in interface UserRestResources

Throws:

Exception

updateUserById

@RolesAllowed(value="users")
public javax.ws.rs.core.Response updateUserById(@Context
                                                                             javax.ws.rs.core.UriInfo uriInfo,
                                                                             String id,
                                                                             String expand,
                                                                             UserEntity model)
                                                                      throws Exception

Specified by:

updateUserById in interface UserRestResources

Throws:

Exception

getConnectionsOfUser

@RolesAllowed(value="users")
public javax.ws.rs.core.Response getConnectionsOfUser(@Context
                                                                                   javax.ws.rs.core.UriInfo uriInfo,
                                                                                   String id,
                                                                                   String q,
                                                                                   boolean returnSize,
                                                                                   String expand)
                                                                            throws Exception

Specified by:

getConnectionsOfUser in interface UserRestResources

Throws:

Exception

getInvitationsOfUser

@RolesAllowed(value="users")
public javax.ws.rs.core.Response getInvitationsOfUser(@Context
                                                                                   javax.ws.rs.core.UriInfo uriInfo,
                                                                                   boolean returnSize,
                                                                                   String expand)
                                                                            throws Exception

Specified by:

getInvitationsOfUser in interface UserRestResources

Throws:

Exception

getPendingOfUser

public javax.ws.rs.core.Response getPendingOfUser(@Context
                                                  javax.ws.rs.core.UriInfo uriInfo,
                                                  boolean returnSize,
                                                  String expand)
                                           throws Exception

Specified by:

getPendingOfUser in interface UserRestResources

Throws:

Exception

getSpacesOfUser

@RolesAllowed(value="users")
public javax.ws.rs.core.Response getSpacesOfUser(@Context
                                                                              javax.ws.rs.core.UriInfo uriInfo,
                                                                              String id,
                                                                              int offset,
                                                                              int limit,
                                                                              boolean returnSize,
                                                                              String expand)
                                                                       throws Exception

Specified by:

getSpacesOfUser in interface UserRestResources

Throws:

Exception

getActivitiesOfUser

@RolesAllowed(value="users")
public javax.ws.rs.core.Response getActivitiesOfUser(@Context
                                                                                  javax.ws.rs.core.UriInfo uriInfo,
                                                                                  String id,
                                                                                  String type,
                                                                                  int offset,
                                                                                  int limit,
                                                                                  String before,
                                                                                  String after,
                                                                                  boolean returnSize,
                                                                                  String expand)
                                                                           throws Exception

Specified by:

getActivitiesOfUser in interface UserRestResources

Throws:

Exception

addActivityByUser

@RolesAllowed(value="users")
public javax.ws.rs.core.Response addActivityByUser(@Context
                                                                                javax.ws.rs.core.UriInfo uriInfo,
                                                                                String id,
                                                                                String expand,
                                                                                ActivityRestIn model)
                                                                         throws Exception

Specified by:

addActivityByUser in interface UserRestResources

Throws:

Exception

importUsers

@RolesAllowed(value="administrators")
public javax.ws.rs.core.Response importUsers(@Context
                                                                                   javax.servlet.http.HttpServletRequest request,
                                                                                   String uploadId,
                                                                                   boolean progress,
                                                                                   boolean clean,
                                                                                   boolean sync)