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

Methods

Modifier and Type	Method and Description
javax.ws.rs.core.StreamingOutput	getHelpHTML()
org.imixs.workflow.xml.XMLItemCollection	getWorkItem(String uniqueid, String items) returns a singel 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.
org.imixs.workflow.xml.XMLItemCollection	getWorkItemJSON(String uniqueid, String items)
org.imixs.workflow.xml.XMLItemCollection	getWorkItemJSONPath(String uniqueid, String items)
org.imixs.workflow.xml.XMLItemCollection	getWorkItemXML(String uniqueid, String items)
org.imixs.workflow.xml.XMLItemCollection	getWorkItemXMLPath(String uniqueid, String items)
org.imixs.workflow.xml.EntityCollection	getWorkList(int start, int count, String type, int sortorder, String items) Returns a collection of workitems representing the worklist by the current user
org.imixs.workflow.xml.EntityCollection	getWorkListByAuthor(String user, int start, int count, String type, int sortorder, String items) Returns a collection of workitems representing the worklist by the current user
org.imixs.workflow.xml.EntityCollection	getWorkListByAuthorJSON(String user, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByAuthorXML(String user, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByCreator(String creator, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByCreatorJSON(String creator, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByCreatorXML(String creator, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByGroup(String processgroup, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByGroupJSON(String processgroup, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByGroupXML(String processgroup, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByOwner(String owner, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByOwnerJSON(String owner, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByOwnerXML(String owner, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByProcessID(int processid, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByProcessIDJSON(int processid, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByProcessIDXML(int processid, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByQuery(String query, int start, int count, String items) Returns a result set by JPQL Query
org.imixs.workflow.xml.EntityCollection	getWorkListByQueryJSON(String query, int start, int count, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByQueryXML(String query, int start, int count, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByRef(String uniqueid, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByRefJSON(String uniqueid, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByRefXML(String uniqueid, int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByWriteAccess(int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByWriteAccessJSON(int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListByWriteAccessXML(int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListJSON(int start, int count, String type, int sortorder, String items)
org.imixs.workflow.xml.EntityCollection	getWorkListXML(int start, int count, String type, int sortorder, String items)
static org.imixs.workflow.ItemCollection	parseWorkitem(InputStream requestBodyStream) This method expects a form post.
javax.ws.rs.core.Response	postWorkitem(InputStream requestBodyStream, String action, String error) This method expects a form post.
javax.ws.rs.core.Response	postWorkitemJSON(InputStream requestBodyStream, String action, String error, String encoding) This method expects a form post and processes the WorkItem by the WorkflowService EJB.
javax.ws.rs.core.Response	postWorkitemJSON(org.imixs.workflow.xml.XMLItemCollection workitem, String action) NOTE!
javax.ws.rs.core.Response	postWorkitemsXML(org.imixs.workflow.xml.EntityCollection worklist)
javax.ws.rs.core.Response	postWorkitemXML(org.imixs.workflow.xml.XMLItemCollection workitem, String action)
javax.ws.rs.core.Response	putWorkitem(InputStream requestBodyStream, String action, String error) This method expects a form post and processes the WorkItem by the WorkflowService EJB.
javax.ws.rs.core.Response	putWorkitemsXML(org.imixs.workflow.xml.EntityCollection worklist) This method post a collection of ItemCollection objects to be processed by the WorkflowManager.
javax.ws.rs.core.Response	putWorkitemXML(org.imixs.workflow.xml.XMLItemCollection workitem, String action) This method post a ItemCollection object to be processed by the WorkflowManager.

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()

getWorkList

public org.imixs.workflow.xml.EntityCollection getWorkList(int start,
                                                  int count,
                                                  String type,
                                                  int sortorder,
                                                  String items)

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

Parameters:

start -

count -

type -

sortorder -

getWorkListXML

public org.imixs.workflow.xml.EntityCollection getWorkListXML(int start,
                                                     int count,
                                                     String type,
                                                     int sortorder,
                                                     String items)

Parameters:

start -

count -

type -

sortorder -

Returns:

getWorkListJSON

public org.imixs.workflow.xml.EntityCollection getWorkListJSON(int start,
                                                      int count,
                                                      String type,
                                                      int sortorder,
                                                      String items)

getWorkListByAuthor

public org.imixs.workflow.xml.EntityCollection getWorkListByAuthor(String user,
                                                          int start,
                                                          int count,
                                                          String type,
                                                          int sortorder,
                                                          String items)

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

Parameters:

start -

count -

type -

sortorder -

getWorkListByAuthorXML

public org.imixs.workflow.xml.EntityCollection getWorkListByAuthorXML(String user,
                                                             int start,
                                                             int count,
                                                             String type,
                                                             int sortorder,
                                                             String items)

Parameters:

start -

count -

type -

sortorder -

Returns:

getWorkListByAuthorJSON

public org.imixs.workflow.xml.EntityCollection getWorkListByAuthorJSON(String user,
                                                              int start,
                                                              int count,
                                                              String type,
                                                              int sortorder,
                                                              String items)

getWorkListByCreator

public org.imixs.workflow.xml.EntityCollection getWorkListByCreator(String creator,
                                                           int start,
                                                           int count,
                                                           String type,
                                                           int sortorder,
                                                           String items)

getWorkListByCreatorXML

public org.imixs.workflow.xml.EntityCollection getWorkListByCreatorXML(String creator,
                                                              int start,
                                                              int count,
                                                              String type,
                                                              int sortorder,
                                                              String items)

getWorkListByCreatorJSON

public org.imixs.workflow.xml.EntityCollection getWorkListByCreatorJSON(String creator,
                                                               int start,
                                                               int count,
                                                               String type,
                                                               int sortorder,
                                                               String items)

getWorkListByProcessID

public org.imixs.workflow.xml.EntityCollection getWorkListByProcessID(int processid,
                                                             int start,
                                                             int count,
                                                             String type,
                                                             int sortorder,
                                                             String items)

getWorkListByProcessIDXML

public org.imixs.workflow.xml.EntityCollection getWorkListByProcessIDXML(int processid,
                                                                int start,
                                                                int count,
                                                                String type,
                                                                int sortorder,
                                                                String items)

getWorkListByProcessIDJSON

public org.imixs.workflow.xml.EntityCollection getWorkListByProcessIDJSON(int processid,
                                                                 int start,
                                                                 int count,
                                                                 String type,
                                                                 int sortorder,
                                                                 String items)

getWorkListByGroup

public org.imixs.workflow.xml.EntityCollection getWorkListByGroup(String processgroup,
                                                         int start,
                                                         int count,
                                                         String type,
                                                         int sortorder,
                                                         String items)

getWorkListByGroupXML

public org.imixs.workflow.xml.EntityCollection getWorkListByGroupXML(String processgroup,
                                                            int start,
                                                            int count,
                                                            String type,
                                                            int sortorder,
                                                            String items)

getWorkListByGroupJSON

public org.imixs.workflow.xml.EntityCollection getWorkListByGroupJSON(String processgroup,
                                                             int start,
                                                             int count,
                                                             String type,
                                                             int sortorder,
                                                             String items)

getWorkListByOwner

public org.imixs.workflow.xml.EntityCollection getWorkListByOwner(String owner,
                                                         int start,
                                                         int count,
                                                         String type,
                                                         int sortorder,
                                                         String items)

getWorkListByOwnerXML

public org.imixs.workflow.xml.EntityCollection getWorkListByOwnerXML(String owner,
                                                            int start,
                                                            int count,
                                                            String type,
                                                            int sortorder,
                                                            String items)

getWorkListByOwnerJSON

public org.imixs.workflow.xml.EntityCollection getWorkListByOwnerJSON(String owner,
                                                             int start,
                                                             int count,
                                                             String type,
                                                             int sortorder,
                                                             String items)

getWorkListByWriteAccess

public org.imixs.workflow.xml.EntityCollection getWorkListByWriteAccess(int start,
                                                               int count,
                                                               String type,
                                                               int sortorder,
                                                               String items)

getWorkListByWriteAccessXML

public org.imixs.workflow.xml.EntityCollection getWorkListByWriteAccessXML(int start,
                                                                  int count,
                                                                  String type,
                                                                  int sortorder,
                                                                  String items)

getWorkListByWriteAccessJSON

public org.imixs.workflow.xml.EntityCollection getWorkListByWriteAccessJSON(int start,
                                                                   int count,
                                                                   String type,
                                                                   int sortorder,
                                                                   String items)

getWorkListByRef

public org.imixs.workflow.xml.EntityCollection getWorkListByRef(String uniqueid,
                                                       int start,
                                                       int count,
                                                       String type,
                                                       int sortorder,
                                                       String items)

getWorkListByRefXML

public org.imixs.workflow.xml.EntityCollection getWorkListByRefXML(String uniqueid,
                                                          int start,
                                                          int count,
                                                          String type,
                                                          int sortorder,
                                                          String items)

getWorkListByRefJSON

public org.imixs.workflow.xml.EntityCollection getWorkListByRefJSON(String uniqueid,
                                                           int start,
                                                           int count,
                                                           String type,
                                                           int sortorder,
                                                           String items)

getWorkListByQuery

public org.imixs.workflow.xml.EntityCollection getWorkListByQuery(String query,
                                                         int start,
                                                         int count,
                                                         String items)

Returns a result set by JPQL Query

Parameters:

query -

start -

count -

type -

sortorder -

items -

Returns:

getWorkListByQueryXML

public org.imixs.workflow.xml.EntityCollection getWorkListByQueryXML(String query,
                                                            int start,
                                                            int count,
                                                            String items)

getWorkListByQueryJSON

public org.imixs.workflow.xml.EntityCollection getWorkListByQueryJSON(String query,
                                                             int start,
                                                             int count,
                                                             String items)

getWorkItem

public org.imixs.workflow.xml.XMLItemCollection getWorkItem(String uniqueid,
                                                   String items)

returns a singel workitem defined by $uniqueid

Parameters:

uniqueid -

Returns:

getWorkItemXML

public org.imixs.workflow.xml.XMLItemCollection getWorkItemXML(String uniqueid,
                                                      String items)

getWorkItemXMLPath

public org.imixs.workflow.xml.XMLItemCollection getWorkItemXMLPath(String uniqueid,
                                                          String items)

getWorkItemJSON

public org.imixs.workflow.xml.XMLItemCollection getWorkItemJSON(String uniqueid,
                                                       String items)

getWorkItemJSONPath

public org.imixs.workflow.xml.XMLItemCollection getWorkItemJSONPath(String uniqueid,
                                                           String items)

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:

putWorkitem

public javax.ws.rs.core.Response putWorkitem(InputStream requestBodyStream,
                                    String action,
                                    String error)

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:

postWorkitem

public javax.ws.rs.core.Response postWorkitem(InputStream requestBodyStream,
                                     String action,
                                     String error)

This method expects a form post.

Parameters:

requestBodyStream -

Returns:

See Also:

putWorkitemDefault

putWorkitemXML

public javax.ws.rs.core.Response putWorkitemXML(org.imixs.workflow.xml.XMLItemCollection workitem,
                                       String action)

This method post a ItemCollection object to be processed by the WorkflowManager. The method test for the propertys $processid and $activityid 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

postWorkitemXML

public javax.ws.rs.core.Response postWorkitemXML(org.imixs.workflow.xml.XMLItemCollection workitem,
                                        String action)

postWorkitemJSON

public javax.ws.rs.core.Response postWorkitemJSON(org.imixs.workflow.xml.XMLItemCollection workitem,
                                         String action)

NOTE! This method did not work because the json format produced by getWorkitemJSOON it non consumable. The reason is @type attribute: ... value":{"@type":"xs:int","$":"10"} Seems to be a problem of jaxb jax-rs. Mybe GlassFish 4 solves this problem. For now we can not use this method.

Parameters:

workitem -

action -

Returns:

See Also:

postWorkitemJSON(InputStream requestBodyStream)

postWorkitemJSON

public javax.ws.rs.core.Response postWorkitemJSON(InputStream requestBodyStream,
                                         String action,
                                         String error,
                                         String encoding)

This method expects a form post and processes the WorkItem by the WorkflowService EJB. The Method returns a JSON object with the new data. If a processException Occurs the method returns a JSON object with the error code

Parameters:

requestBodyStream - - form content

Returns:

JSON object

Throws:

Exception

putWorkitemsXML

public javax.ws.rs.core.Response putWorkitemsXML(org.imixs.workflow.xml.EntityCollection worklist)

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

Parameters:

worklist - - workitem list data

postWorkitemsXML

public javax.ws.rs.core.Response postWorkitemsXML(org.imixs.workflow.xml.EntityCollection worklist)

parseWorkitem

public static final 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 $unqiueid) 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