##### Coverage Report - org.apache.commons.scxml.test.StandaloneUtils

Classes in this File | Line Coverage | Branch Coverage | Complexity
StandaloneUtils |
0% |
0% |
| 6.0;6

1 |  |
     /*
2 |  |
      *
3 |  |
      *   Copyright 2006 The Apache Software Foundation.
4 |  |
      *
5 |  |
      *  Licensed under the Apache License, Version 2.0 (the "License");
6 |  |
      *  you may not use this file except in compliance with the License.
7 |  |
      *  You may obtain a copy of the License at
8 |  |
      *
9 |  |
      *      http://www.apache.org/licenses/LICENSE-2.0
10 |  |
      *
11 |  |
      *  Unless required by applicable law or agreed to in writing, software
12 |  |
      *  distributed under the License is distributed on an "AS IS" BASIS,
13 |  |
      *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 |  |
      *  See the License for the specific language governing permissions and
15 |  |
      *  limitations under the License.
16 |  |
      *
17 |  |
      */
18 |  |
     package org.apache.commons.scxml.test;
19 |  |
20 |  |
     import java.io.BufferedReader;
21 |  |
     import java.io.File;
22 |  |
     import java.io.IOException;
23 |  |
     import java.io.InputStreamReader;
24 |  |
     import java.net.URL;
25 |  |
     import java.util.StringTokenizer;
26 |  |
27 |  |
     import org.apache.commons.scxml.Context;
28 |  |
     import org.apache.commons.scxml.Evaluator;
29 |  |
     import org.apache.commons.scxml.EventDispatcher;
30 |  |
     import org.apache.commons.scxml.SCXMLExecutor;
31 |  |
     import org.apache.commons.scxml.SCXMLHelper;
32 |  |
     import org.apache.commons.scxml.TriggerEvent;
33 |  |
     import org.apache.commons.scxml.env.SimpleDispatcher;
34 |  |
     import org.apache.commons.scxml.env.Tracer;
35 |  |
     import org.apache.commons.scxml.invoke.SimpleSCXMLInvoker;
36 |  |
     import org.apache.commons.scxml.io.SCXMLDigester;
37 |  |
     import org.apache.commons.scxml.io.SCXMLSerializer;
38 |  |
     import org.apache.commons.scxml.model.ModelException;
39 |  |
     import org.apache.commons.scxml.model.SCXML;
40 |  |
     import org.xml.sax.SAXException;
41 |  |
42 |  |
     /**
43 |  |
      * Utility methods used by command line SCXML execution, useful for
44 |  |
      * debugging.
45 |  |
      *
46 |  |
      * The following expression languages are supported in SCXML documents:
47 |  |
      * <ol>
48 |  |
      *  <li>JEXL - Using Commons JEXL</li>
49 |  |
      *  <li>EL - Using Commons EL</li>
50 |  |
      * </ol>
51 |  |
      *
52 |  |
      * @see org.apache.commons.scxml.env.jexl
53 |  |
      * @see org.apache.commons.scxml.env.jsp
54 |  |
      */
55 |  |
     public final class StandaloneUtils {
56 |  |
57 |  |
         /**
58 |  |
          * Command line utility method for executing the state machine defined
59 |  |
          * using the SCXML document described by the specified URI and using
60 |  |
          * the specified expression evaluator.
61 |  |
          *
62 |  |
          * @param uri The URI or filename of the SCXML document
63 |  |
          * @param evaluator The expression evaluator for the expression language
64 |  |
          *                  used in the specified SCXML document
65 |  |
          *
66 |  |
          * <p>RUNNING:</p>
67 |  |
          * <ul>
68 |  |
          *  <li>Enter a space-separated list of "events"</li>
69 |  |
          *  <li>To quit, enter "quit"</li>
70 |  |
          *  <li>To populate a variable in the current context,
71 |  |
          *      type "name=value"</li>
72 |  |
          *  <li>To reset state machine, enter "reset"</li>
73 |  |
          * </ul>
74 |  |
          */
75 |  |
         public static void execute(final String uri, final Evaluator evaluator) {
76 |  |
             try {
77 | 0 |
                 String documentURI = getCanonicalURI(uri);
78 | 0 |
                 Context rootCtx = evaluator.newContext(null);
79 | 0 |
                 EventDispatcher ed = new SimpleDispatcher();
80 | 0 |
                 Tracer trc = new Tracer();
81 | 0 |
                 SCXML doc = SCXMLDigester.digest(new URL(documentURI), trc);
82 | 0 |
                 if (doc == null) {
83 | 0 |
                     System.err.println("The SCXML document " + uri
84 |  |
                             + " can not be parsed!");
85 | 0 |
                     System.exit(-1);
86 |  |
                 }
87 | 0 |
                 System.out.println(SCXMLSerializer.serialize(doc));
88 | 0 |
                 SCXMLExecutor exec = new SCXMLExecutor(evaluator, ed, trc);
89 | 0 |
                 exec.addListener(doc, trc);
90 | 0 |
                 exec.registerInvokerClass("scxml", SimpleSCXMLInvoker.class);
91 | 0 |
                 exec.setRootContext(rootCtx);
92 | 0 |
                 exec.setStateMachine(doc);
93 | 0 |
                 exec.go();
94 | 0 |
                 BufferedReader br = new BufferedReader(new
95 |  |
                     InputStreamReader(System.in));
96 | 0 |
                 String event = null;
97 | 0 |
                 while ((event = br.readLine()) != null) {
98 | 0 |
                     event = event.trim();
99 | 0 |
                     if (event.equalsIgnoreCase("help") || event.equals("?")) {
100 | 0 |
                         System.out.println("Enter a space-separated list of "
101 |  |
                             + "events");
102 | 0 |
                         System.out.println("To populate a variable in the "
103 |  |
                             + "current context, type \"name=value\"");
104 | 0 |
                         System.out.println("To quit, enter \"quit\"");
105 | 0 |
                         System.out.println("To reset state machine, enter "
106 |  |
                             + "\"reset\"");
107 | 0 |
                     } else if (event.equalsIgnoreCase("quit")) {
108 | 0 |
                         break;
109 | 0 |
                     } else if (event.equalsIgnoreCase("reset")) {
110 | 0 |
                         exec.reset();
111 | 0 |
                     } else if (event.indexOf('=') != -1) {
112 | 0 |
                         int marker = event.indexOf('=');
113 | 0 |
                         String name = event.substring(0, marker);
114 | 0 |
                         String value = event.substring(marker + 1);
115 | 0 |
                         rootCtx.setLocal(name, value);
116 | 0 |
                         System.out.println("Set variable " + name + " to "
117 |  |
                             + value);
118 | 0 |
                     } else if (SCXMLHelper.isStringEmpty(event)
119 |  |
                                || event.equalsIgnoreCase("null")) {
120 | 0 |
                         TriggerEvent[] evts = {new TriggerEvent(null,
121 |  |
                             TriggerEvent.SIGNAL_EVENT, null)};
122 | 0 |
                         exec.triggerEvents(evts);
123 | 0 |
                         if (exec.getCurrentStatus().isFinal()) {
124 | 0 |
                             System.out.println("A final configuration reached.");
125 |  |
                         }
126 |  |
                     } else {
127 | 0 |
                         StringTokenizer st = new StringTokenizer(event);
128 | 0 |
                         int tkns = st.countTokens();
129 | 0 |
                         TriggerEvent[] evts = new TriggerEvent[tkns];
130 | 0 |
                         for (int i = 0; i < tkns; i++) {
131 | 0 |
                             evts[i] = new TriggerEvent(st.nextToken(),
132 |  |
                                     TriggerEvent.SIGNAL_EVENT, null);
133 |  |
                         }
134 | 0 |
                         exec.triggerEvents(evts);
135 | 0 |
                         if (exec.getCurrentStatus().isFinal()) {
136 | 0 |
                             System.out.println("A final configuration reached.");
137 |  |
                         }
138 |  |
                     }
139 |  |
                 }
140 | 0 |
             } catch (IOException e) {
141 | 0 |
                 e.printStackTrace();
142 | 0 |
             } catch (ModelException e) {
143 | 0 |
                 e.printStackTrace();
144 | 0 |
             } catch (SAXException e) {
145 | 0 |
                 e.printStackTrace();
146 | 0 |
             }
147 | 0 |
         }
148 |  |
149 |  |
         /**
150 |  |
          * @param uri an absolute or relative URL
151 |  |
          * @return java.lang.String canonical URL (absolute)
152 |  |
          * @throws java.io.IOException if a relative URL can not be resolved
153 |  |
          *         to a local file
154 |  |
          */
155 |  |
         private static String getCanonicalURI(final String uri)
156 |  |
         throws IOException {
157 | 0 |
             if (uri.toLowerCase().startsWith("http://")
158 |  |
                 || uri.toLowerCase().startsWith("file://")) {
159 | 0 |
                     return uri;
160 |  |
             }
161 | 0 |
             File in = new File(uri);
162 | 0 |
             return "file:///" + in.getCanonicalPath();
163 |  |
         }
164 |  |
165 |  |
         /**
166 |  |
          * Discourage instantiation since this is a utility class.
167 |  |
          */
168 |  |
         private StandaloneUtils() {
169 | 0 |
             super();
170 | 0 |
         }
171 |  |
172 |  |
     }
173 |  |