org.imixs.workflow.jaxrs

Class WorkflowRestService

java.lang.Object

org.imixs.workflow.jaxrs.WorkflowRestService

public class WorkflowRestService
extends Object

The WorkflowService Handler supports methods to process different kind of request URIs

Author:

rsoika

Constructor Summary

Constructors

Constructor and Description
WorkflowRestService()

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	getEvents(String uniqueid, String format) Returns a collection of events of a workitem, visible to the current user
javax.ws.rs.core.StreamingOutput	getHelpHTML()
javax.ws.rs.core.Response	getTaskListByAuthor(String user, String type, int pageIndex, int pageSize, String sortBy, Boolean sortReverse, String items, String format) Returns a collection of workitems representing the worklist by the current user
javax.ws.rs.core.Response	getTaskListByCreator(String creator, String type, int pageIndex, int pageSize, String sortBy, Boolean sortReverse, String items, String format)
javax.ws.rs.core.Response	getTaskListByGroup(String processgroup, String type, int pageIndex, int pageSize, String sortBy, Boolean sortReverse, String items, String format)
javax.ws.rs.core.Response	getTaskListByOwner(String owner, String type, int pageIndex, int pageSize, String sortBy, Boolean sortReverse, String items, String format)
javax.ws.rs.core.Response	getTaskListByProcessID(int processid, String type, int pageIndex, int pageSize, String sortBy, Boolean sortReverse, String items, String format)
javax.ws.rs.core.Response	getTaskListByRef(String uniqueid, String type, int pageIndex, int pageSize, String sortBy, Boolean sortReverse, String items, String format)
javax.ws.rs.core.Response	getWorkItem(String uniqueid, String items, String format) returns a single workitem defined by $uniqueid
javax.ws.rs.core.Response	getWorkItemFile(String uniqueid, String file, javax.ws.rs.core.UriInfo uriInfo) Returns a file attachment located in the property $file of the specified workitem The file name will be encoded.
javax.ws.rs.core.Response	getWorkList(String type, int pageIndex, int pageSize, String sortBy, Boolean sortReverse, String items, String format) Returns a collection of workitems representing the worklist by the current user
org.imixs.workflow.ItemCollection	parseWorkitem(InputStream requestBodyStream) This method expects a form post.
javax.ws.rs.core.Response	postFormWorkitem(InputStream requestBodyStream, String items) This method expects a form post and processes the WorkItem by the WorkflowService EJB.
javax.ws.rs.core.Response	postFormWorkitemByUnqiueID(String uid, InputStream requestBodyStream, String items) This method expects a form post and processes the WorkItem by the WorkflowService EJB.
javax.ws.rs.core.Response	postTypedWorkitemJSON(InputStream requestBodyStream, String error, String items) This method expects JSON in BADGARFISH notation to processed by the WorkflowService EJB.
javax.ws.rs.core.Response	postTypedWorkitemJSONByUniqueID(String uniqueid, InputStream requestBodyStream, String error, String items)
javax.ws.rs.core.Response	postWorkitem(org.imixs.workflow.xml.XMLDocument xmlworkitem, String items) This method post a ItemCollection object to be processed by the WorkflowManager.
javax.ws.rs.core.Response	postWorkitemByUniqueID(String uniqueid, org.imixs.workflow.xml.XMLDocument xmlworkitem, String items)
javax.ws.rs.core.Response	postWorkitems(org.imixs.workflow.xml.XMLDataCollection worklist) This method post a collection of ItemCollection objects to be processed by the WorkflowManager.
javax.ws.rs.core.Response	putFormWorkitem(InputStream requestBodyStream, String items) This method expects a form post.
javax.ws.rs.core.Response	putTypedWorkitemJSON(InputStream requestBodyStream, String error, String items) Delegater for PUT postJSONTypedWorkitem
javax.ws.rs.core.Response	putTypedWorkitemJSONByUniqueID(String uniqueid, InputStream requestBodyStream, String error, String items) Delegater for PUT postJSONWorkitemByUniqueID
javax.ws.rs.core.Response	putWorkitem(org.imixs.workflow.xml.XMLDocument workitem, String items) Delegater
javax.ws.rs.core.Response	putWorkitemByUniqueID(String uniqueid, org.imixs.workflow.xml.XMLDocument xmlworkitem, String items) Delegater for PUT postXMLWorkitemByUniqueID
javax.ws.rs.core.Response	putWorkitems(org.imixs.workflow.xml.XMLDataCollection worklist)

Methods inherited from class java.lang.Object

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

Constructor Detail

WorkflowRestService

public WorkflowRestService()

Method Detail

getHelpHTML

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

getWorkItem

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

returns a single workitem defined by $uniqueid

Parameters:

uniqueid -

Returns:

getWorkItemFile

public javax.ws.rs.core.Response getWorkItemFile(String uniqueid,
                                                 @Encoded
                                                 String file,
                                                 @Context
                                                 javax.ws.rs.core.UriInfo uriInfo)

Returns a file attachment located in the property $file of the specified workitem

The file name will be encoded. With a URLDecode the filename is decoded in different formats and searched in the file list. This is not a nice solution.

Parameters:

uniqueid -

Returns:

getEvents

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

Returns a collection of events of a workitem, visible to the current user

Parameters:

uniqueid - of workitem

Returns:

list of event entities

getWorkList

public javax.ws.rs.core.Response getWorkList(String type,
                                             int pageIndex,
                                             int pageSize,
                                             String sortBy,
                                             Boolean sortReverse,
                                             String items,
                                             String format)

Returns a collection of workitems representing the worklist by the current user

Parameters:

start -

count -

type -

sortorder -

getTaskListByOwner

public javax.ws.rs.core.Response getTaskListByOwner(String owner,
                                                    String type,
                                                    int pageIndex,
                                                    int pageSize,
                                                    String sortBy,
                                                    Boolean sortReverse,
                                                    String items,
                                                    String format)

getTaskListByAuthor

public javax.ws.rs.core.Response getTaskListByAuthor(String user,
                                                     String type,
                                                     int pageIndex,
                                                     int pageSize,
                                                     String sortBy,
                                                     Boolean sortReverse,
                                                     String items,
                                                     String format)

Returns a collection of workitems representing the worklist by the current user

Parameters:

start -

count -

type -

sortorder -

getTaskListByCreator

public javax.ws.rs.core.Response getTaskListByCreator(String creator,
                                                      String type,
                                                      int pageIndex,
                                                      int pageSize,
                                                      String sortBy,
                                                      Boolean sortReverse,
                                                      String items,
                                                      String format)

getTaskListByProcessID

public javax.ws.rs.core.Response getTaskListByProcessID(int processid,
                                                        String type,
                                                        int pageIndex,
                                                        int pageSize,
                                                        String sortBy,
                                                        Boolean sortReverse,
                                                        String items,
                                                        String format)

getTaskListByGroup

public javax.ws.rs.core.Response getTaskListByGroup(String processgroup,
                                                    String type,
                                                    int pageIndex,
                                                    int pageSize,
                                                    String sortBy,
                                                    Boolean sortReverse,
                                                    String items,
                                                    String format)

getTaskListByRef

public javax.ws.rs.core.Response getTaskListByRef(String uniqueid,
                                                  String type,
                                                  int pageIndex,
                                                  int pageSize,
                                                  String sortBy,
                                                  Boolean sortReverse,
                                                  String items,
                                                  String format)

postFormWorkitem

public javax.ws.rs.core.Response postFormWorkitem(InputStream requestBodyStream,
                                                  String items)

This method expects a form post and processes the WorkItem by the WorkflowService EJB. After the workItem was processed the method redirect the request to the provided action URI. The action URI can also be computed by the Imixs Workflow ResutlPlugin

Parameters:

requestBodyStream - - form content

action - - return URI

Returns:

postFormWorkitemByUnqiueID

public javax.ws.rs.core.Response postFormWorkitemByUnqiueID(String uid,
                                                            InputStream requestBodyStream,
                                                            String items)

This method expects a form post and processes the WorkItem by the WorkflowService EJB. After the workItem was processed the method redirect the request to the provided action URI. The action URI can also be computed by the Imixs Workflow ResutlPlugin

Parameters:

requestBodyStream - - form content

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

Returns:

putFormWorkitem

public javax.ws.rs.core.Response putFormWorkitem(InputStream requestBodyStream,
                                                 String items)

This method expects a form post.

Parameters:

requestBodyStream -

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

Returns:

See Also:

putWorkitemDefault

postWorkitem

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

This method post a ItemCollection object to be processed by the WorkflowManager. The method test for the properties $taskidid and $eventid NOTE!! - this method did not update an existing instance of a workItem. The behavior is different to the method putWorkitem(). It need to be discussed if the behavior is wrong or not.

Parameters:

workitem - - new workItem data

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

putWorkitem

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

Delegater

Parameters:

workitem -

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

Returns:

postWorkitemByUniqueID

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

putWorkitemByUniqueID

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

Delegater for PUT postXMLWorkitemByUniqueID

Parameters:

workitem -

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

Returns:

postWorkitems

public javax.ws.rs.core.Response postWorkitems(org.imixs.workflow.xml.XMLDataCollection worklist)

This method post a collection of ItemCollection objects to be processed by the WorkflowManager.

Parameters:

worklist - - workitem list data

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

putWorkitems

public javax.ws.rs.core.Response putWorkitems(org.imixs.workflow.xml.XMLDataCollection worklist)

postTypedWorkitemJSON

public javax.ws.rs.core.Response postTypedWorkitemJSON(InputStream requestBodyStream,
                                                       String error,
                                                       String items)

This method expects JSON in BADGARFISH notation to processed by the WorkflowService EJB.

The Method returns a workitem with the new data. If a processException Occurs the method returns an object with the error code

The JSON is parsed manually by teh imixs json parser. The expreced notation is:

... value":{"@type":"xs:int","$":"10"}

Parameters:

requestBodyStream -

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

Returns:

JSON object

Throws:

Exception

putTypedWorkitemJSON

public javax.ws.rs.core.Response putTypedWorkitemJSON(InputStream requestBodyStream,
                                                      String error,
                                                      String items)

Delegater for PUT postJSONTypedWorkitem

Parameters:

workitem -

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

Returns:

postTypedWorkitemJSONByUniqueID

public javax.ws.rs.core.Response postTypedWorkitemJSONByUniqueID(String uniqueid,
                                                                 InputStream requestBodyStream,
                                                                 String error,
                                                                 String items)

putTypedWorkitemJSONByUniqueID

public javax.ws.rs.core.Response putTypedWorkitemJSONByUniqueID(String uniqueid,
                                                                InputStream requestBodyStream,
                                                                String error,
                                                                String items)

Delegater for PUT postJSONWorkitemByUniqueID

Parameters:

workitem -

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

Returns:

parseWorkitem

public org.imixs.workflow.ItemCollection parseWorkitem(InputStream requestBodyStream)

This method expects a form post. The method parses the input stream to extract the provides field/value pairs. NOTE: The method did not(!) assume that the put/post request contains a complete workItem. For this reason the method loads the existing instance of the corresponding workItem (identified by the $uniqueid) and adds the values provided by the put/post request into the existing instance. The following kind of lines which can be included in the InputStream will be skipped ------------------------------1a26f3661ff7 Content-Disposition: form-data; name="query" Connection: keep-alive Content-Type: multipart/form-data; boundary=---------------------------195571638125373 Content-Length: 5680 -----------------------------195571638125373

Parameters:

requestBodyStream -

Returns:

a workitem