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.xpdl.model.ext;
046:
047: import org.obe.util.AbstractEnum;
048: import org.obe.xpdl.OBENames;
049:
050: import java.util.HashMap;
051: import java.util.List;
052: import java.util.Map;
053:
054: /**
055: * The ToolMode is used to indicate whether the tools in a tool set should be
056: * executed sequentially or in parallel. The default is SEQUENTIAL. This
057: * attribute is not described in the XPDL specification, but its predecessor
058: * <a href="http://www.wfmc.org/standards/docs/if19807m.pdf">WPDL</a> states
059: * that the workflow engine creates one work item per tool, and that execution
060: * flow between these work items (and thus the invocation order of the tools)
061: * can be controlled in a vendor-specific manner. The WPDL spec. does suggest
062: * SEQUENTIAL or PARALLEL modes, and states that the default is SEQUENTIAL
063: * (curious that the spec. defines the default for a vendor-specific attribute?).
064: *
065: * @author Adrian Price
066: */
067: public final class ToolMode extends AbstractEnum {
068: private static final long serialVersionUID = 2635003088809664289L;
069:
070: public static final int SEQUENTIAL_INT = 0;
071: public static final int PARALLEL_INT = 1;
072: /**
073: * ExecutionType representing sequential tool invocation.
074: */
075: public static final ToolMode SEQUENTIAL = new ToolMode(
076: OBENames.SEQUENTIAL_KIND, SEQUENTIAL_INT);
077: /**
078: * ExecutionType representing parallel tool invocation.
079: */
080: public static final ToolMode PARALLEL = new ToolMode(
081: OBENames.PARALLEL_KIND, PARALLEL_INT);
082: private static final ToolMode[] _values = { SEQUENTIAL, PARALLEL };
083: private static final Map _tagMap = new HashMap();
084: private static final List VALUES = clinit(_values, _tagMap);
085:
086: /**
087: * Converts the specified string to a ToolMode object.
088: *
089: * @param tag The string, one of: SEQUENTIAL or PARALLEL.
090: * @return The ToolMode object
091: * @throws IllegalArgumentException if the <code>tag<code> parameter is
092: * invalid.
093: */
094: public static ToolMode valueOf(String tag) {
095: ToolMode tm = (ToolMode) _tagMap.get(tag);
096: if (tm == null && tag != null)
097: throw new IllegalArgumentException(tag);
098: return tm;
099: }
100:
101: /**
102: * Construct a new ToolMode instance.
103: *
104: * @param name
105: * @param ordinal The value
106: */
107: private ToolMode(String name, int ordinal) {
108: super (name, ordinal);
109: }
110:
111: public List family() {
112: return VALUES;
113: }
114: }
|