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

Classes in this File Line Coverage Branch Coverage Complexity
StandaloneUtils
0% 
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   
 

Reports generated by Cobertura.