01: /*
02: * This file is part of the WfMOpen project.
03: * Copyright (C) 2001-2003 Danet GmbH (www.danet.de), GS-AN.
04: * All rights reserved.
05: *
06: * This program is free software; you can redistribute it and/or modify
07: * it under the terms of the GNU General Public License as published by
08: * the Free Software Foundation; either version 2 of the License, or
09: * (at your option) any later version.
10: *
11: * This program is distributed in the hope that it will be useful,
12: * but WITHOUT ANY WARRANTY; without even the implied warranty of
13: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14: * GNU General Public License for more details.
15: *
16: * You should have received a copy of the GNU General Public License
17: * along with this program; if not, write to the Free Software
18: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19: *
20: * $Id: ActivityFinder.java,v 1.2 2006/09/29 12:32:07 drmlipp Exp $
21: *
22: * $Log: ActivityFinder.java,v $
23: * Revision 1.2 2006/09/29 12:32:07 drmlipp
24: * Consistently using WfMOpen as projct name now.
25: *
26: * Revision 1.1.1.1 2003/06/30 20:05:16 drmlipp
27: * Initial import
28: *
29: * Revision 1.2 2003/06/27 08:51:44 lipp
30: * Fixed copyright/license information.
31: *
32: * Revision 1.1 2002/12/19 21:37:42 lipp
33: * Reorganized interfaces.
34: *
35: * Revision 1.6 2002/11/26 11:23:29 lipp
36: * Modified RemoteException comment.
37: *
38: * Revision 1.5 2001/12/16 10:36:01 lipp
39: * Javadoc fix.
40: *
41: * Revision 1.4 2001/12/14 16:05:45 lipp
42: * Partial implementation of ActivityFinder.
43: *
44: * Revision 1.3 2001/12/13 11:58:29 lipp
45: * Interface completed.
46: *
47: * Revision 1.2 2001/12/09 14:01:56 lipp
48: * Improved documentation.
49: *
50: * Revision 1.1 2001/11/30 15:39:37 lipp
51: * Evolving resource assignment.
52: *
53: */
54: package de.danet.an.workflow.spis.ras;
55:
56: import java.rmi.RemoteException;
57:
58: import de.danet.an.workflow.omgcore.WfActivity;
59:
60: /**
61: * This interface defines facilities that map activity ids to
62: * {@link de.danet.an.workflow.omgcore.WfActivity <code>WfActivity</code>}
63: * objects.
64: *
65: * <code>ActivityFinders</code> are used (in combination with an identifier)
66: * to identify activities in calls to a
67: * {@link ResourceAssignmentService <code>ResourceAssignmentService</code>}.
68: * They are guaranteed to be serializable objects with properly implemented
69: * {@link java.lang.Object#equals <code>equals</code>} and
70: * {@link java.lang.Object#hashCode <code>hashCode</code>} methods.
71: * It is expected that
72: * resource assignment facilities keep a peristent, indexed record of
73: * <code>ActivityFinder</code>s and store references to activities as
74: * tuples of a finder index and an activity identifier.
75: */
76: public interface ActivityFinder {
77:
78: /**
79: * Return the activity that is associated with the given id.
80: *
81: * @param actId the activity id (unique in the scope of this
82: * <code>ActivityFinder</code>.
83: * @return the <code>WfActivity</code> found.
84: * @throws NoSuchActivityException if no activity with the given
85: * <code>actId</code> can be found.
86: * @throws RemoteException if a system-level error occurs.
87: */
88: WfActivity find(String actId) throws NoSuchActivityException,
89: RemoteException;
90:
91: }
|