org.ow2.proactive_grid_cloud_portal.common

Interface CommonRestInterface

@Path(value="/common")
 @Produces(value="application/json")
public interface CommonRestInterface

Method Summary

Modifier and Type	Method and Description
boolean	checkPcaAdmin(String sessionId) Check if a user has admin privilege in cloud automation service.
boolean	checkSubscriptionAdmin(String sessionId) Check if a user has admin privilege in notification service.
String	currentUser(String sessionId) Get the login string associated to a session.
UserData	currentUserData(String sessionId) Get a UserData object associated to a session.
boolean	isConnected(String sessionId) Tests whether the session is connected to the ProActive server.
String	login(String username, String password) login to the server with username and password form.
String	loginWithCredential(LoginForm multipart) Login to the server using a multipart form.
void	logout(String sessionId) Terminates a session.
boolean	portalAccess(String sessionId, String portal) Check single portal access.
List<String>	portalsAccesses(String sessionId, List<String> portals) Check multiple portals accesses.

Method Detail

login

@POST
 @Path(value="login")
String login(@FormParam(value="username")
                                         String username,
                                         @FormParam(value="password")
                                         String password)
                                  throws LoginException,
                                         SchedulerRestException

login to the server with username and password form.

Parameters:

username - username

password - password

Returns:

the session id associated to this new connection

Throws:

LoginException - if the authentication fails

SchedulerRestException - if any other error occurs

loginWithCredential

@POST
 @Consumes(value="multipart/form-data")
 @Path(value="login")
String loginWithCredential(LoginForm multipart)
                                                                                        throws KeyException,
                                                                                               LoginException,
                                                                                               SchedulerRestException

Login to the server using a multipart form. It can be used either by submitting:

• 2 fields: 'username' and 'password'
• a credential file with field name 'credential'

Parameters:

multipart - multipart form

Returns:

the session id associated to this new connection

Throws:

LoginException - if the authentication fails

KeyException - if the credentials file cannot be decrypted

SchedulerRestException - if any other error occurs

logout

@PUT
 @Path(value="logout")
void logout(@HeaderParam(value="sessionid")
                                        String sessionId)
                                 throws RestException

Terminates a session.

Parameters:

sessionId - id of the session to terminate

Throws:

RestException - if the server cannot be contacted

isConnected

@GET
 @Path(value="connected")
boolean isConnected(@HeaderParam(value="sessionid")
                                                   String sessionId)

Tests whether the session is connected to the ProActive server.

Parameters:

sessionId - the session to test

Returns:

true if the session is connected to the ProActive server, false otherwise.

currentUser

@GET
 @Path(value="currentuser")
String currentUser(@HeaderParam(value="sessionid")
                                                    String sessionId)

Get the login string associated to a session.
NOTE:
In case the given sessionId doesn't have an associated login (session id expired, or invalid), this endpoint will return null

Parameters:

sessionId - id of a session

Returns:

the associated login value or an empty string

currentUserData

@GET
 @Path(value="currentuserdata")
UserData currentUserData(@HeaderParam(value="sessionid")
                                                              String sessionId)

Get a UserData object associated to a session.
NOTE:
In case the given sessionId doesn't have an associated login (session id expired, or invalid), this endpoint will return null

Parameters:

sessionId - id of a session

Returns:

a UserData object or null

portalsAccesses

@GET
 @Path(value="permissions/portals")
List<String> portalsAccesses(@HeaderParam(value="sessionid")
                                                                      String sessionId,
                                                                      @QueryParam(value="portals")
                                                                      List<String> portals)
                                                               throws RestException

Check multiple portals accesses. Test if a user has access to the portals specified.

Parameters:

sessionId - id of a session

portals - a list of portals access to test

Returns:

a sublist of accessible portals

Throws:

RestException - if an error occurs or the session is invalid

portalAccess

@GET
 @Path(value="permissions/portals/{portal}")
boolean portalAccess(@HeaderParam(value="sessionid")
                                                                       String sessionId,
                                                                       @PathParam(value="portal")
                                                                       String portal)
                                                                throws RestException

Check single portal access. Test if a user has access to the specified portal.

Parameters:

sessionId - id of a session

portal - string value identifying the portal

Returns:

true if the user can access the portal, false otherwise

Throws:

RestException - if an error occurs or the session is invalid

checkSubscriptionAdmin

@GET
 @Path(value="permissions/notification-service/admin")
boolean checkSubscriptionAdmin(@HeaderParam(value="sessionid")
                                                                                           String sessionId)
                                                                                    throws RestException

Check if a user has admin privilege in notification service.

Parameters:

sessionId - id of a session

Returns:

true if the user has the correct rights

Throws:

RestException - if an error occurs or the session is invalid

checkPcaAdmin

@GET
 @Path(value="permissions/cloud-automation-service/admin")
boolean checkPcaAdmin(@HeaderParam(value="sessionid")
                                                                                      String sessionId)
                                                                               throws RestException

Check if a user has admin privilege in cloud automation service.

Parameters:

sessionId - id of a session

Returns:

true if the user has the correct rights

Throws:

RestException - if an error occurs or the session is invalid