001: /*--
002:
003: Copyright (C) 2002-2005 Adrian Price.
004: All rights reserved.
005:
006: Redistribution and use in source and binary forms, with or without
007: modification, are permitted provided that the following conditions
008: are met:
009:
010: 1. Redistributions of source code must retain the above copyright
011: notice, this list of conditions, and the following disclaimer.
012:
013: 2. Redistributions in binary form must reproduce the above copyright
014: notice, this list of conditions, and the disclaimer that follows
015: these conditions in the documentation and/or other materials
016: provided with the distribution.
017:
018: 3. The names "OBE" and "Open Business Engine" must not be used to
019: endorse or promote products derived from this software without prior
020: written permission. For written permission, please contact
021: adrianprice@sourceforge.net.
022:
023: 4. Products derived from this software may not be called "OBE" or
024: "Open Business Engine", nor may "OBE" or "Open Business Engine"
025: appear in their name, without prior written permission from
026: Adrian Price (adrianprice@users.sourceforge.net).
027:
028: THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
029: WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
030: OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
031: DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
032: INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
033: (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
034: SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
035: HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
036: STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
037: IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
038: POSSIBILITY OF SUCH DAMAGE.
039:
040: For more information on OBE, please see
041: <http://obe.sourceforge.net/>.
042:
043: */
044:
045: package org.obe.spi.event;
046:
047: import org.obe.spi.model.ActivityInstance;
048: import org.obe.spi.service.WorkflowEventBroker;
049: import org.obe.xpdl.model.transition.Transition;
050: import org.wfmc.audit.WMAEventCode;
051:
052: /**
053: * Delivers transition event notifications.
054: *
055: * @author Adrian Price
056: */
057: public final class TransitionEvent extends WorkflowEvent {
058: private static final long serialVersionUID = -5960088342111172827L;
059: /**
060: * The transition fired.
061: */
062: public static final int FIRED = 0;
063: private static final String[] EVENT_TYPES = { "TransitionFired" };
064:
065: private transient Transition _definition;
066:
067: /**
068: * Constructs a new transition event.
069: *
070: * @param activityInstance
071: * @param id
072: * @param broker
073: * @param definition
074: */
075: public TransitionEvent(ActivityInstance activityInstance, int id,
076: WorkflowEventBroker broker, Transition definition) {
077:
078: super (activityInstance, id, String.class, EVENT_TYPES[id],
079: definition.getId(), broker);
080:
081: _definition = definition;
082: }
083:
084: /**
085: * Returns the transition ID.
086: *
087: * @return The ID of the transition that fired the event.
088: */
089: public String getTransitionId() {
090: return (String) getKeys()[0];
091: }
092:
093: /**
094: * Returns the target activity instance.
095: *
096: * @return Target activity instance.
097: */
098: public ActivityInstance getActivityInstance() {
099: return (ActivityInstance) source;
100: }
101:
102: /**
103: * Returns the definition of the transition.
104: *
105: * @return The transition definition from the workflow process definition.
106: */
107: public Transition getTransition() {
108: return _definition;
109: }
110:
111: public WMAEventCode getWMAEventCode() {
112: return WMAEventCode.UNKNOWN;
113: }
114:
115: public String toString() {
116: return EVENT_TYPES[_id] + "[source=" + source + ", definition="
117: + _definition + ']';
118: }
119: }
|