RBAC

  
@Path("/")
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
public interface RbacUsersManager {
	/**
	 * Method used to obtain all currently defined users.
	 *
	 * @return
	 */
	@Path("/")
	@GET
	public Users loadAllUsers();

	/**
	 * Method used to obtain a slice of users based on a given page size and a start record.
	 *
	 * @param pageSize This is the page size we want to use.
	 * @param startRecord This is the start record we want to use.
	 * @return
	 */
	@Path("/{startRecord}/{pageSize}/")
	@GET
	public Users loadAllUsers(
			@PathParam("pageSize") int pageSize,
			@PathParam("startRecord") int startRecord);

	/**
	 * Method used to get an user from RBAC system by id.
	 *
	 * @param userId
	 * @return
	 */
	@Path("/{userId}")
	@GET
	public User loadUserById(@PathParam("userId") Integer userId);

	/**
	 * Method used to load all user roles.
	 *
	 * @param userId User unique identifier.
	 * @return
	 */
	@Path("/{userId}/roles")
	@GET
	public Roles loadUserRoles(@PathParam("userId") Integer userId);

	/**
	 * Method used to load all user permissions. Do not confuse it
	 * with activated permissions.
	 *
	 * @param userId User unique identifier.
	 * @return
	 */
	@Path("/{userId}/permissions")
	@GET
	public Permissions loadUserPermissions(@PathParam("userId") Integer userId);

	/**
	 * Method used to load all operations a user is allowed to execute
	 * on a specified object.
	 *
	 * @param userId User unique identifier.
	 * @param objectId Object unique identifier.
	 * @return
	 */
	@Path("/{userId}/operations/{objectId}")
	@GET
	public Operations loadUserOperationsForObject(
			@PathParam("userId") Integer userId,
			@PathParam("objectId") Integer objectId);

	/**
	 * Method used to create a new user.
	 *
	 * @param userId User unique identifier.
	 * @param user User object.
	 */
	@Path("/{userId}")
	@POST
	@Consumes("application/json")
	public void createUser(@PathParam("userId") Integer userId, User user);

	/**
	 * Method used to update an existing user.
	 *
	 * @param userId User unique identifier.
	 * @param user User instance that contains all new values that should be updated.
	 */
	@Path("/{userId}")
	@PUT
	@Consumes("application/json")
	public void updateUser(@PathParam("userId") Integer userId, User user);

	/**
	 * Method used to delete an existing user.
	 *
	 * @param userId User unique identifier.
	 */
	@Path("/{userId}")
	@DELETE
	public void deleteUser(@PathParam("userId") Integer userId);

	/**
	 * Method used to remove user from all roles he is currently assigned to.
	 *
	 * @param userId User unique identifier.
	 */
	@Path("/{userId}/roles")
	@DELETE
	public void deleteUserFromAllRoles(@PathParam("userId") Integer userId);

	/**
	 * Method used to stop all active sessions of an user.
	 *
	 * @param userId User unique identifier.
	 */
	@Path("/{userId}/sessions")
	@DELETE
	public void deleteUserSessions(@PathParam("userId") Integer userId);
}