1 /**
2 * Copyright 2005-2012 The Kuali Foundation
3 *
4 * Licensed under the Educational Community License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.opensource.org/licenses/ecl2.php
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16 package org.kuali.rice.kew.routemodule;
17
18 import java.util.List;
19
20 import org.kuali.rice.kew.actionrequest.ActionRequestValue;
21 import org.kuali.rice.kew.api.exception.WorkflowException;
22 import org.kuali.rice.kew.engine.RouteContext;
23 import org.kuali.rice.kew.util.ResponsibleParty;
24
25
26 /**
27 * A RouteModule is responsible for generating Action Requests for a given Route Header document.
28 * Implementations of this class are potentially remotable, so this interface uses value objects.
29 *
30 * @author Kuali Rice Team (rice.collab@kuali.org)
31 */
32 public interface RouteModule {
33
34 /**
35 * Generate action requests for the given RouteContext.
36 *
37 * @return A List of the generated ActionRequestValue objects.
38 */
39 List<ActionRequestValue> findActionRequests(RouteContext context) throws Exception;
40
41 /**
42 * The route module will re-resolve the given responsibilityId and return an object that contains the key to either
43 * a user, group, or role. The original responsibility associated with the given id will then be swapped with the
44 * new ResponsibleParty when routing is resolved.
45 *
46 * <p>This method is intended to allow for the calling code to be able to "switch-out" one responsibility for
47 * another (in the case of a change to an assigned reponsibility).</p>
48 *
49 * <p>Returning null from this method will indicate that the original responsibile party should remain unchanged.
50 * This is typically the recommended default for implementation of this method and covers most use cases.</p>
51 *
52 * @param responsibilityId the id of the responsibility to be resolved
53 * @return the responsibility party with which to replace the original responsibility, or null if the responsibility
54 * should remain unchanged.
55 */
56 ResponsibleParty resolveResponsibilityId(String responsibilityId) throws WorkflowException;
57
58 /**
59 * Returns true if this RouteModule has more requests available which it can generate. This method will only be
60 * called after the first set of action requests returned by the first invocation of findActionRequests have been
61 * fully activated. If this method returns true, findActionRequests will be invoked again and those requests will
62 * all be activated before the cycle continues until this method returns false;
63 *
64 * @param context the route context
65 * @return true if this route module has more requests it can generate, false otherwise
66 */
67 boolean isMoreRequestsAvailable(RouteContext context);
68
69 }