org.imixs.workflow.jaxrs

Class DocumentRestService

java.lang.Object

org.imixs.workflow.jaxrs.DocumentRestService

public class DocumentRestService
extends Object

The DocumentService provides methods to access the DocumentService EJB

Author:

rsoika

Constructor Summary

Constructors

Constructor and Description
DocumentRestService()

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	backup(String query, String filepath) This method creates a backup of the result set form a JQPL query.
javax.ws.rs.core.Response	convertResult(org.imixs.workflow.ItemCollection workitem, String items, String format) This method converts a single ItemCollection into a Jax-rs response object.
javax.ws.rs.core.Response	convertResultList(List<org.imixs.workflow.ItemCollection> result, String items, String format) This method converts a ItemCollection List into a Jax-rs response object.
javax.ws.rs.core.Response	countTotalHitsByQuery(String query, int maxResult, String format) Returns a total hits for a lucene Search Query
javax.ws.rs.core.Response	countTotalPagesByQuery(String query, int pageSize, String format) Returns the total pages for a lucene Search Query and a given page size.
javax.ws.rs.core.Response	deleteEntity(String uniqueid) This method deletes an entity
javax.ws.rs.core.Response	findDocumentsByJPQL(String query, int pageSize, int pageIndex, String items, String format) Returns a resultset for a JPQL statement
javax.ws.rs.core.Response	findDocumentsByQuery(String query, int pageSize, int pageIndex, String sortBy, boolean sortReverse, String items, String format) Returns a resultset for a lucene Search Query
javax.ws.rs.core.Response	getConfiguration(String format) Returns the IndexFieldListNoAnalyse from the lucensUpdateService
javax.ws.rs.core.Response	getDocument(String uniqueid, String items, String format) returns a single document defined by $uniqueid Regex for UID - e.g: bcc776f9-4e5a-4272-a613-9f5ebf35354d Snapshot: bcc776f9-4e5a-4272-a613-9f5ebf35354d-9b6655 deprecated format : 132d37bfd51-9a7868
javax.ws.rs.core.StreamingOutput	getHelpHTML()
protected static List<String>	getItemList(String items) This method returns a List object from a given comma separated string.
javax.ws.rs.core.StreamingOutput	getRoot()
javax.ws.rs.core.Response	postDocument(org.imixs.workflow.xml.XMLDocument xmlworkitem, String items) The method saves a document provided in xml format.
javax.ws.rs.core.Response	putDocument(org.imixs.workflow.xml.XMLDocument xmlworkitem, String items) Delegater putEntity @PUT
javax.ws.rs.core.Response	restore(String filepath) This method restores a backup from the fileSystem

Methods inherited from class java.lang.Object

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

Constructor Detail

DocumentRestService

public DocumentRestService()

Method Detail

getRoot

public javax.ws.rs.core.StreamingOutput getRoot()

getHelpHTML

public javax.ws.rs.core.StreamingOutput getHelpHTML()

getDocument

public javax.ws.rs.core.Response getDocument(String uniqueid,
                                             String items,
                                             String format)

returns a single document defined by $uniqueid Regex for UID - e.g: bcc776f9-4e5a-4272-a613-9f5ebf35354d Snapshot: bcc776f9-4e5a-4272-a613-9f5ebf35354d-9b6655 deprecated format : 132d37bfd51-9a7868

Parameters:

uniqueid -

Returns:

findDocumentsByQuery

public javax.ws.rs.core.Response findDocumentsByQuery(String query,
                                                      int pageSize,
                                                      int pageIndex,
                                                      String sortBy,
                                                      boolean sortReverse,
                                                      String items,
                                                      String format)

Returns a resultset for a lucene Search Query

Parameters:

query -

pageSize -

pageIndex -

items -

Returns:

findDocumentsByJPQL

public javax.ws.rs.core.Response findDocumentsByJPQL(String query,
                                                     int pageSize,
                                                     int pageIndex,
                                                     String items,
                                                     String format)

Returns a resultset for a JPQL statement

Parameters:

query - - JPQL statement

pageSize - - page size

pageIndex - - page index (default = 0)

items - - optional list of items

Returns:

result set.

countTotalHitsByQuery

public javax.ws.rs.core.Response countTotalHitsByQuery(String query,
                                                       int maxResult,
                                                       String format)

Returns a total hits for a lucene Search Query

Parameters:

query -

pageSize -

pageIndex -

items -

Returns:

countTotalPagesByQuery

public javax.ws.rs.core.Response countTotalPagesByQuery(String query,
                                                        int pageSize,
                                                        String format)

Returns the total pages for a lucene Search Query and a given page size.

Parameters:

query -

pageSize -

pageIndex -

items -

Returns:

postDocument

public javax.ws.rs.core.Response postDocument(org.imixs.workflow.xml.XMLDocument xmlworkitem,
                                              String items)

The method saves a document provided in xml format. The caller need to be assigned to the access role 'org.imixs.ACCESSLEVEL.MANAGERACCESS' Note: the method merges the content of the given document into an existing one because the DocumentService method save() did not merge an entity. But the rest service typically consumes only a subset of attributes. So this is the reason why we merge the entity here. In different to the behavior of the DocumentService the WorkflowService method process() did this merge automatically.

Parameters:

xmlworkitem - - document to be saved

items - - optional item list to be returned in the result

Returns:

putDocument

public javax.ws.rs.core.Response putDocument(org.imixs.workflow.xml.XMLDocument xmlworkitem,
                                             String items)

Delegater putEntity @PUT

Parameters:

xmlworkitem - - document to be saved

items - - optional item list to be returned in the result

Returns:

See Also:

putWorkitemDefault

deleteEntity

public javax.ws.rs.core.Response deleteEntity(String uniqueid)

This method deletes an entity

backup

public javax.ws.rs.core.Response backup(String query,
                                        String filepath)

This method creates a backup of the result set form a JQPL query. The entity list will be stored into the file system. The backup can be restored by calling the restore method

Parameters:

query -

start -

count -

filepath - - path in server filesystem

Returns:

restore

public javax.ws.rs.core.Response restore(String filepath)

This method restores a backup from the fileSystem

Parameters:

filepath - - path in server fileSystem

Returns:

getConfiguration

public javax.ws.rs.core.Response getConfiguration(String format)
                                           throws Exception

Returns the IndexFieldListNoAnalyse from the lucensUpdateService

Returns:

Throws:

Exception

getItemList

protected static List<String> getItemList(String items)

This method returns a List object from a given comma separated string. The method returns null if no elements are found. The provided parameter looks typical like this: txtWorkflowStatus,numProcessID,txtName

Parameters:

items -

Returns:

convertResult

public javax.ws.rs.core.Response convertResult(org.imixs.workflow.ItemCollection workitem,
                                               String items,
                                               String format)

This method converts a single ItemCollection into a Jax-rs response object.

The method expects optional items and format string (json|xml)

In case the result set is null, than the method returns an empty collection.

Parameters:

result - list of ItemCollection

items - - optional item list

format - - optional format string (json|xml)

Returns:

jax-rs Response object.

convertResultList

public javax.ws.rs.core.Response convertResultList(List<org.imixs.workflow.ItemCollection> result,
                                                   String items,
                                                   String format)

This method converts a ItemCollection List into a Jax-rs response object.

The method expects optional items and format string (json|xml)

In case the result set is null, than the method returns an empty collection.

Parameters:

result - list of ItemCollection

items - - optional item list

format - - optional format string (json|xml)

Returns:

jax-rs Response object.