restgroupsServer
Class ProfilesPilotResource

java.lang.Object
  org.restlet.resource.UniformResource
      org.restlet.resource.ServerResource
          restgroupsServer.BaseResource
              restgroupsServer.ProfilesPilotResource

public class ProfilesPilotResource
extends BaseResource

This class handles operations executed on the "/groups/{privateGroupName}/pilotConnection" resource. The POST handlePilotConnection(Representation) method is used for creating new clients pilot session. It is necessary to inform the client whether connecting to the group communication system was successful or not. {privateGroupName} is a profile name suggested by the client.

Author:

tkob

Field Summary

Fields inherited from class restgroupsServer.BaseResource

mySession

Constructor Summary

ProfilesPilotResource()

Method Summary

org.restlet.representation.Representation

handlePilotConnection(org.restlet.representation.Representation entity) The client who wants to connect to the RestGroups server sends two request: one permanent (see ProfileResource) and one temporary.

Methods inherited from class restgroupsServer.BaseResource

doInit, getFactory, getProfileEntities, getProfileEntitiesThreadIDs, getProfilesPilotEntities, getRequestSessionId, printProfileEntities, printProfilesPilotEntities, setResponseSessionId

Methods inherited from class org.restlet.resource.ServerResource

delete, delete, describeVariants, doConditionalHandle, doHandle, doHandle, doNegotiatedHandle, get, get, getConverterService, getInfo, getInfo, getMetadataService, getPreferredVariant, getVariants, handle, head, head, isAnnotated, isConditional, isExisting, isInRole, isNegotiated, options, options, post, post, put, put, redirectPermanent, redirectPermanent, redirectSeeOther, redirectSeeOther, redirectTemporary, redirectTemporary, setAllowedMethods, setAnnotated, setChallengeRequests, setConditional, setCookieSettings, setDimensions, setExisting, setLocationRef, setLocationRef, setNegotiated, setServerInfo, setStatus, setStatus, setStatus, setStatus, updateAllowedMethods, updateDimensions

Methods inherited from class org.restlet.resource.UniformResource

doCatch, doRelease, getAllowedMethods, getApplication, getChallengeRequests, getChallengeResponse, getClientInfo, getConditions, getContext, getCookies, getCookieSettings, getDimensions, getHostRef, getLocationRef, getLogger, getMatrix, getMethod, getOriginalRef, getProtocol, getQuery, getRanges, getReference, getReferrerRef, getRequest, getRequestAttributes, getRequestEntity, getResponse, getResponseAttributes, getResponseEntity, getRootRef, getServerInfo, getStatus, init, isConfidential, release

Methods inherited from class java.lang.Object

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

Constructor Detail

ProfilesPilotResource

public ProfilesPilotResource()

Method Detail

handlePilotConnection

@Post
public org.restlet.representation.Representation handlePilotConnection(org.restlet.representation.Representation entity)

The client who wants to connect to the RestGroups server sends two request: one permanent (see ProfileResource) and one temporary. This POST method handles the temporary request. It sets up the clients ProfilesPilotEntity and returns error after timeout or the result of establishing group communication system session through ProfileResource.

The body of the POST request contains a XML document with information about the pilot connection. The structure of the XML document is defined in the schemas/profilesPilotMessage.xsd schema file.

Parameters:

entity - a XML document with information necessary for beginning the process of establishing session with the RestGroups server

Returns:

status