org.cristalise.restapi

Class RestHandler

java.lang.Object

org.cristalise.restapi.RestHandler

Direct Known Subclasses:

CookieLogin, CookieLogout, ItemUtils, PathUtils, RootAccess, TokenLogin

public abstract class RestHandler
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	RestHandler.AuthData Handles encoding/decoding of agent and timestamp data

Field Summary

Fields

Modifier and Type	Field and Description
static String	COOKIENAME
static String	PASSWORD
static String	USERNAME

Constructor Summary

Constructors

Constructor and Description
RestHandler()

Method Summary

Modifier and Type	Method and Description
AgentPath	checkAuthCookie(javax.ws.rs.core.Cookie authCookie) Authorisation data is decrypted from the cookie
protected RestHandler.AuthData	decryptAuthData(String authData)
protected String	encryptAuthData(RestHandler.AuthData auth)
AgentProxy	getAgent(String agentName, javax.ws.rs.core.Cookie authCookie) AgentProxy is resolved either from cookie or from the name.
AgentProxy	getAgent(String agentName, String authData) AgentProxy is resolved either from authorisation data or from the name.
Map<String,Object>	getPagedResult(javax.ws.rs.core.UriInfo uri, int start, int batchSize, int totalRows, List<?> rows) Constructs the Map containing all data describing a PagedResult.
List<Property>	getPropertiesFromQParams(String search) Converts QueryParams to Item Properties
protected Map<String,Object>	makeItemDomainPathsData(ItemPath ip)
javax.ws.rs.core.Response	toJSON(Object data)

Methods inherited from class java.lang.Object

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

Field Detail

COOKIENAME

public static final String COOKIENAME

See Also:

Constant Field Values

USERNAME

public static final String USERNAME

See Also:

Constant Field Values

PASSWORD

public static final String PASSWORD

See Also:

Constant Field Values

Constructor Detail

RestHandler

public RestHandler()

Method Detail

decryptAuthData

protected RestHandler.AuthData decryptAuthData(String authData)
                                        throws InvalidAgentPathException,
                                               IllegalBlockSizeException,
                                               BadPaddingException,
                                               InvalidDataException

Parameters:

authData -

Returns:

Throws:

InvalidAgentPathException

IllegalBlockSizeException

BadPaddingException

InvalidDataException

encryptAuthData

protected String encryptAuthData(RestHandler.AuthData auth)
                          throws IllegalBlockSizeException,
                                 BadPaddingException

Parameters:

auth -

Returns:

Throws:

IllegalBlockSizeException

BadPaddingException

toJSON

public javax.ws.rs.core.Response toJSON(Object data)

checkAuthCookie

public AgentPath checkAuthCookie(javax.ws.rs.core.Cookie authCookie)

Authorisation data is decrypted from the cookie

Parameters:

authCookie - the cookie sent by the client

Returns:

AgentPath decrypted from the cookie

getAgent

public AgentProxy getAgent(String agentName,
                           javax.ws.rs.core.Cookie authCookie)

AgentProxy is resolved either from cookie or from the name. If property REST.requireLoginCookie=true the AgentProxy must be resolved from the authorisation data or an error is thrown.

Parameters:

agentName - the name of the Agent

authCookie - the cookie sent by the client

getAgent

public AgentProxy getAgent(String agentName,
                           String authData)

AgentProxy is resolved either from authorisation data or from the name. If property REST.requireLoginCookie=true the AgentProxy must be resolved from the authorisation data or an error is thrown.

Parameters:

agentName - the name of the Agent

authData - authorisation data (from cookie or token)

Returns:

AgentProxy

getPagedResult

public Map<String,Object> getPagedResult(javax.ws.rs.core.UriInfo uri,
                                         int start,
                                         int batchSize,
                                         int totalRows,
                                         List<?> rows)

Constructs the Map containing all data describing a PagedResult. Normally this result is converted to JSON

Parameters:

uri - The resource URI which is used to create pervPage and nextPage URL

start - the start index of the result set to be retrieved

batchSize - the size of the result set to be retrieved

totalRows - the total number of rows in the result set

rows - the actual rows

Returns:

the Map containing all data describing a PagedResult

getPropertiesFromQParams

public List<Property> getPropertiesFromQParams(String search)

Converts QueryParams to Item Properties

Parameters:

search - the string to decompose in the format: name,prop:val,prop:val

Returns:

the decoded list of Item Properties

makeItemDomainPathsData

protected Map<String,Object> makeItemDomainPathsData(ItemPath ip)

Parameters:

ip -