多个编程语言Multiple languages-2
  。。。。。。
  创造一门语言              使用Jython,在你的程序内部创造一种解释(interpreted)语言是极其简单的。考虑 《Thinking in Java》第二版第八章greenhouse控制器的那个例子。那种情形下你会希望最终用户——也就是管理greenhouse的那个人——能够通过配置来控制整个系统,于是一个简单的脚本语言就成了理想的解决方案。     要创建这个语言,我们只需简单的写一组Python类,每个类的构造函数会把它自己添加到一个(静态的)master链表。公共的数据和行为会被factor到叫作Event的基类。每个Event对象都会包括一个action字符串(for simplicity——实际应用中,你应该安排一些functionality)和运行该事件(event)的设定时间。构造函数初始化这些成员变量,然后把新创建的Event对象添加到一个叫作events(在类的内部定义,但是位于所有方法的外部,所以它是静态的)的静态链表.
  
#:interpreter:GreenHouseLanguage.py   class Event:   events = [] # static   def __init__(self, action, time):     self.action = action     self.time = time     Event.events.append(self)   # Used by sort(). This will cause   # comparisons to be based only on time:   def __cmp__ (self, other):     if self.time < other.time: return -1     if self.time > other.time: return 1     return 0   def run(self):     print "%.2f: %s" % (self.time, self.action)   class LightOn(Event):   def __init__(self, time):     Event.__init__(self, "Light on", time)   class LightOff(Event):   def __init__(self, time):     Event.__init__(self, "Light off", time)   class WaterOn(Event):   def __init__(self, time):     Event.__init__(self, "Water on", time)   class WaterOff(Event):   def __init__(self, time):     Event.__init__(self, "Water off", time)   class ThermostatNight(Event):   def __init__(self, time):     Event.__init__(self,"Thermostat night", time)   class ThermostatDay(Event):   def __init__(self, time):     Event.__init__(self, "Thermostat day", time)   class Bell(Event):   def __init__(self, time):     Event.__init__(self, "Ring bell", time)    def run():   Event.events.sort();   for e in Event.events:     e.run()   # To test, this will be run when you say: # python GreenHouseLanguage.py if __name__ == "__main__":   ThermostatNight(5.00)   LightOff(2.00)   WaterOn(3.30)   WaterOff(4.45)   LightOn(1.00)   ThermostatDay(6.00)   Bell(7.00)   run() ##~
      每个派生类的构造函数都要调用基类的构造函数,基类的构造函数把新建的对象加入到链表。run()函数给整个链表排序,它自动的使用Event类所定义的__cmp__()方法只根据时间来进行比较。上面的例子,只是打印链表的内容,但是在实际系统中,它会等待每个事件设定的时间,然后运行那个事件。     __main__函数这部分对这些类做了一下简单的测试。     上面的文件现在已经是一个模块了,它可以被包括进(included)另外一个Python程序,用以定义那个程序所包含的所有类。但是,我们不用普通的Python程序,我们使用Java的Jython。这其实是非常简单的:你只需引入一些Jython类,创建一个PythonInterpreter对象,然后cause the Python files to be loaded:
  //- interpreter:GreenHouseController.java package interpreter; import org.python.util.PythonInterpreter;  import org.python.core.*;  import junit.framework.*;   public class  GreenHouseController extends TestCase  {    PythonInterpreter interp =      new PythonInterpreter();   public void test() throws PyException  {     System.out.println(       "Loading GreenHouse Language");     interp.execfile("GreenHouseLanguage.py");     System.out.println(       "Loading GreenHouse Script");     interp.execfile("Schedule.ghs");     System.out.println(       "Executing GreenHouse Script");     interp.exec("run()");   }   public static void    main(String[] args) throws PyException  {     junit.textui.TestRunner.run(GreenHouseController.class);   } } ///:~ 
     PythonInterpreter对象是一个完整的Python解释器,它可以从Java程序接受命令。其中一个命令是execfile(),这个命令告诉解释器去执行它所找到的特定文件所包含的所有语句。通过执行GreenHouseLanguage.py,那个文件里所有的类都会被加载到PythonInterpreter对象,于是解释器就“拥有了” greehouse控制器语言。Schedule.ghs是由最终用户创建的用来控制greenhouse的文件。下面是一个例子:
  //:! interpreter:Schedule.ghs Bell(7.00) ThermostatDay(6.00) WaterOn(3.30) LightOn(1.00) ThermostatNight(5.00) LightOff(2.00) WaterOff(4.45) ///:~       这就是interpreter设计模式所要达到的目的:使你的程序的配置对于最终用户来说尽可能的简单。使用Jython你几乎可以毫不费力的达到这个效果。     PythonInterpreter还有一个可供使用的方法是exec(),通过它你可以向解释器发送命令。上例中,run()函数就是通过exec().被调用的。  记住,要运行这个程序,你必须到http://jython.sourceforge.net下载并运行Jython(实际上,你只需要把jython.jar放到你的CLASSPATH就可以了)。上面这些做好以后,它就可以像其它Java程序那样运行了。 
  
控制解释器Controlling the interpreter          前面的例子只是创建解释器并且让它运行外部脚本。本章的剩余部分,我们会讲述更为复杂的与Python交互的方法。要在Java范围内对PythonInterpreter施加更多的控制,最简单的方法就是,发送数据给解释器,然后再从它取回数据(pull data back out)。 
 提交数据Putting data in     为了向你的Python程序插入数据,PythonInterpreter类有一个看似简单的方法:set( ).。实际上,set( )可以接受不同类型的数据并且对它们进行转换。下面的例子是一个关于set( )不同用法的相当全面的练习,一道给出的那些注释提供了相当完整的解释。
  //- interpreter:PythonInterpreterSetting.java // Passing data from Java to python when using // the PythonInterpreter object. package interpreter; import org.python.util.PythonInterpreter;  import org.python.core.*;  import java.util.*; import com.bruceeckel.python.*; import junit.framework.*;   public class  PythonInterpreterSetting extends TestCase  {   PythonInterpreter interp =      new PythonInterpreter();   public void test() throws PyException  {     // It automatically converts Strings      // into native Python strings:     interp.set("a", "This is a test");     interp.exec("print a");     interp.exec("print a[5:]"); // A slice     // It also knows what to do with arrays:     String[] s = { "How", "Do", "You", "Do?" };     interp.set("b", s);     interp.exec("for x in b: print x[0], x");     // set() only takes Objects, so it can't      // figure out primitives. Instead,     // you have to use wrappers:     interp.set("c", new PyInteger(1));     interp.set("d", new PyFloat(2.2));     interp.exec("print c + d");     // You can also use Java's object wrappers:     interp.set("c", new Integer(9));     interp.set("d", new Float(3.14));     interp.exec("print c + d");     // Define a Python function to print arrays:     interp.exec(       "def prt(x): \n" +       "  print x \n" +       "  for i in x: \n" +       "    print i, \n" +       "  print x.__class__\n");     // Arrays are Objects, so it has no trouble      // figuring out the types contained in arrays:     Object[] types = {       new boolean[]{ true, false, false, true },       new char[]{ 'a', 'b', 'c', 'd' },       new byte[]{ 1, 2, 3, 4 },       new int[]{ 10, 20, 30, 40 },       new long[]{ 100, 200, 300, 400 },       new float[]{ 1.1f, 2.2f, 3.3f, 4.4f },       new double[]{ 1.1, 2.2, 3.3, 4.4 },     };     for(int i = 0; i < types.length; i++) {       interp.set("e", types[i]);       interp.exec("prt(e)");     }     // It uses toString() to print Java objects:     interp.set("f", new Date());     interp.exec("print f");     // You can pass it a List      // and index into it...     List x = new ArrayList();     for(int i = 0; i < 10; i++)         x.add(new Integer(i * 10));     interp.set("g", x);     interp.exec("print g");     interp.exec("print g[1]");     // ... But it's not quite smart enough     // to treat it as a Python array:     interp.exec("print g.__class__");     // interp.exec("print g[5:]); // Fails     // If you want it to be a python array, you     // must extract the Java array:     System.out.println("ArrayList to array:");     interp.set("h", x.toArray());     interp.exec("print h.__class__");     interp.exec("print h[5:]");     // Passing in a Map:     Map m = new HashMap();     m.put(new Integer(1), new Character('a'));     m.put(new Integer(3), new Character('b'));     m.put(new Integer(5), new Character('c'));     m.put(new Integer(7), new Character('d'));     m.put(new Integer(11), new Character('e'));     System.out.println("m: " + m);     interp.set("m", m);     interp.exec("print m, m.__class__, " +        "m[1], m[1].__class__");     // Not a Python dictionary, so this fails:     //! interp.exec("for x in m.keys():" +     //!   "print x, m[x]");     // To convert a Map to a Python dictionary,     // use com.bruceeckel.python.PyUtil:     interp.set("m", PyUtil.toPyDictionary(m));     interp.exec("print m, m.__class__, " +        "m[1], m[1].__class__");     interp.exec("for x in m.keys():print x,m[x]");   }   public static void    main(String[] args) throws PyException  {     junit.textui.TestRunner.run(       PythonInterpreterSetting.class);   } } ///:~
      对于Java来说,大多数时候真正的对象(real objects)和基本类型(primitive types)之间的差别总会带来麻烦。一般而言,如果你传递给set( ),方法的是一个通常的对象(regular object),它是知道如何处理的,但是如果你想传入一个基本类型(primitive type)的对象,就必须得作转换。一种做法是创建一个“Py”类型,比如PyInteger和PyFloat,但实际上你也可以使用Java自带的对象外覆类比如Integer和Float,这些可能更容易记住。     上面程序的前一部分你会看到有一个exec( )含有以下的Python语句:     pint a[5:]     索引语句里的那个分号表明这是一个Python切片(slice),所谓切片就是从一个原始数组里产生出某一范围内的元素。在这里,它产生出一个包含从第5号元素开始直到原来数组最后一个元素的新数组。你也可以用“a[3:5]”产生第3号到第5号元素,或者用“a[:5]”产生第0号到第5号元素。在这个语句里使用切片的原因是为了保证Java的String确实被转换成了一个Python字符串,而Python字符串是可以被当作一个字符数组来对待的。     你会看到我们是能够用exec( ),来创建一个Python函数的(虽然有点别扭)。prt( )函数打印整个数组,然后(to make sure it’s a real Python array)遍历数组的每一个元素并且把它打印出来。最后,它打印数组的类名称,我们可以据此看看发生是什么转换(Python不仅有运行时刻信息,它还有与Java的反射相当的东西)。prt( )函数用以打印来自Java的基本类型的数组。     尽管可以使用set( )把一个Java的ArrayList传入解释器,而且你也能把它当作数组那样进行索引,但是试图从它产生一个切片是不会成功的。为了把它完全转换成一个数组,一种方法是简单的利用toArray( )从中取出一个Java数组,然后再把它传给解释器。set( )方法会把它转换成一个PyArray ——Jython提供的一个类——它可以被当作一个Python数组来处理(你也可以显式的创建一个PyArray,但是似乎没有这个必要)。     最后,我们创建了一个Map并且把它直接传给了解释器。虽然可以对While it is possible to do simple things like index into the resulting object,但它并不是一个真正的Python字典(dictionary),所以你不能调用像keys( )那样的方法。并没有直接了当的方法可以把一个Java的Map转换成一个Python字典,于是我就写了一个叫做toPyDictionary( )的小程序并且把它作为com.bruceeckel.python.PyUtil的一个静态方法。它还包括一些从Python数组提取数据到Java List和从Python字典提取数据到Java Map的一些小程序。
  //- com:bruceeckel:python:PyUtil.java // PythonInterpreter utilities package com.bruceeckel.python; import org.python.util.PythonInterpreter;  import org.python.core.*;  import java.util.*;   public class PyUtil {    /** Extract a Python tuple or array into a Java   List (which can be converted into other kinds    of lists and sets inside Java).    @param interp The Python interpreter object   @param pyName The id of the python list object   */   public static List    toList(PythonInterpreter interp, String pyName){     return new ArrayList(Arrays.asList(       (Object[])interp.get(         pyName, Object[].class)));   }   /** Extract a Python dictionary into a Java Map   @param interp The Python interpreter object   @param pyName The id of the python dictionary   */   public static Map    toMap(PythonInterpreter interp, String pyName){     PyList pa = ((PyDictionary)interp.get(       pyName)).items();     Map map = new HashMap();     while(pa.__len__() != 0) {       PyTuple po = (PyTuple)pa.pop();       Object first = po.__finditem__(0)         .__tojava__(Object.class);       Object second = po.__finditem__(1)         .__tojava__(Object.class);       map.put(first, second);     }     return map;   }   /** Turn a Java Map into a PyDictionary,    suitable for placing into a PythonInterpreter   @param map The Java Map object   */   public static PyDictionary    toPyDictionary(Map map) {     Map m = new HashMap();     Iterator it = map.entrySet().iterator();     while(it.hasNext()) {       Map.Entry e = (Map.Entry)it.next();       m.put(Py.java2py(e.getKey()),          Py.java2py(e.getValue()));     }     // PyDictionary constructor wants a Hashtable:     return new PyDictionary(new Hashtable(m));   } } ///:~ 
 下面是(黑盒)单元测试的代码:
  
 //- com:bruceeckel:python:Test.java package com.bruceeckel.python; import org.python.util.PythonInterpreter;  import java.util.*; import junit.framework.*;   public class Test extends TestCase  {   PythonInterpreter pi =     new PythonInterpreter();   public void test1() {     pi.exec("tup=('fee','fi','fo','fum','fi')");     List lst = PyUtil.toList(pi, "tup");     System.out.println(lst);     System.out.println(new HashSet(lst));   }   public void test2() {     pi.exec("ints=[1,3,5,7,9,11,13,17,19]");     List lst = PyUtil.toList(pi, "ints");     System.out.println(lst);   }   public void test3() {     pi.exec("dict = { 1 : 'a', 3 : 'b', " +        "5 : 'c', 9 : 'd', 11 : 'e'}");     Map mp = PyUtil.toMap(pi, "dict");     System.out.println(mp);   }   public void test4() {     Map m = new HashMap();     m.put("twas", new Integer(11));     m.put("brillig", new Integer(27));     m.put("and", new Integer(47));     m.put("the", new Integer(42));     m.put("slithy", new Integer(33));     m.put("toves", new Integer(55));     System.out.println(m);     pi.set("m", PyUtil.toPyDictionary(m));     pi.exec("print m");     pi.exec("print m['slithy']");   }   public static void main(String args[]) {     junit.textui.TestRunner.run(Test.class);   } } ///:~ 
 下一小节我们会讲述(数据)提取工具的用法。
  
 取出数据Getting data out     存在很多种不同的方法从PythonInterpreter提取数据。如果你只是调用get( )方法,把对象标识符作为一个字符串传给它,它会返回一个PyObject(由org.python.core所提供的支持类的一部分)。可以用__tojava__( )方法对它进行“cast”,但是还有比这更好的方法:
  1. Py类有一些很方便的方法,比如py2int( ),可以接受一个PyObjec并且把它转换成若干不同的类型。 2. get( )有一个重载过的版本可以接受预期的Java Class对象作为第二个参数,并且产生出一个具有其运行时刻类型(run-time type)的对象(所以说在你的Java代码里你仍然需要对得到的结果进行一次cast)。
        使用第二种方法,从PythonInterpreter取出一个数组是非常简单的。这一点显得尤为有用,因为Python对字符串和文件处理都异常的出色,所以通常你会希望把结果作为一个字符串数组提出出来。例如,你可以使用Python的glob( )函数对文件名进行通配符扩展(wildcard expansion),就像接下来的例子所展示的那样:
  //- interpreter:PythonInterpreterGetting.java // Getting data from the PythonInterpreter object. package interpreter; import org.python.util.PythonInterpreter;  import org.python.core.*;  import java.util.*; import com.bruceeckel.python.*; import junit.framework.*;   public class  PythonInterpreterGetting extends TestCase {    PythonInterpreter interp =      new PythonInterpreter();   public void test() throws PyException  {      interp.exec("a = 100");     // If you just use the ordinary get(),      // it returns a PyObject:     PyObject a = interp.get("a");     // There's not much you can do with a generic     // PyObject, but you can print it out:     System.out.println("a = " + a);     // If you know the type it's supposed to be,     // you can "cast" it using __tojava__() to     // that Java type and manipulate it in Java.     // To use 'a' as an int, you must use     // the Integer wrapper class:     int ai= ((Integer)a.__tojava__(Integer.class))       .intValue();     // There are also convenience functions:     ai = Py.py2int(a);     System.out.println("ai + 47 = " + (ai + 47));     // You can convert it to different types:     float af = Py.py2float(a);     System.out.println("af + 47 = " + (af + 47));     // If you try to cast it to an inappropriate     // type you'll get a runtime exception:     //! String as = (String)a.__tojava__(     //!   String.class);          // If you know the type, a more useful method     // is the overloaded get() that takes the      // desired class as the 2nd argument:     interp.exec("x = 1 + 2");     int x = ((Integer)interp       .get("x", Integer.class)).intValue();     System.out.println("x = " + x);          // Since Python is so good at manipulating     // strings and files, you will often need to     // extract an array of Strings. Here, a file      // is read as a Python array:     interp.exec("lines = " +        "open('PythonInterpreterGetting.java')" +       ".readlines()");     // Pull it in as a Java array of String:     String[] lines = (String[])       interp.get("lines", String[].class);     for(int i = 0; i < 10; i++)       System.out.print(lines[i]);          // As an example of useful string tools,     // global expansion of ambiguous file names     // using glob is very useful, but it's not     // part of the standard Jython package, so     // you'll have to make sure that your     // Python path is set to include these, or     // that you deliver the necessary Python     // files with your application.     interp.exec("from glob import glob");     interp.exec("files = glob('*.java')");     String[] files = (String[])       interp.get("files", String[].class);     for(int i = 0; i < files.length; i++)       System.out.println(files[i]);          // You can extract tuples and arrays into      // Java Lists with com.bruceeckel.PyUtil:     interp.exec(       "tup = ('fee', 'fi', 'fo', 'fum', 'fi')");     List tup = PyUtil.toList(interp, "tup");     System.out.println(tup);     // It really is a list of String objects:     System.out.println(tup.get(0).getClass());     // You can easily convert it to a Set:     Set tups = new HashSet(tup);     System.out.println(tups);     interp.exec("ints=[1,3,5,7,9,11,13,17,19]");     List ints = PyUtil.toList(interp, "ints");     System.out.println(ints);     // It really is a List of Integer objects:     System.out.println((ints.get(1)).getClass());          // If you have a Python dictionary, it can     // be extracted into a Java Map, again with     // com.bruceeckel.PyUtil:     interp.exec("dict = { 1 : 'a', 3 : 'b'," +       "5 : 'c', 9 : 'd', 11 : 'e' }");     Map map = PyUtil.toMap(interp, "dict");     System.out.println("map: " + map);     // It really is Java objects, not PyObjects:     Iterator it = map.entrySet().iterator();     Map.Entry e = (Map.Entry)it.next();     System.out.println(e.getKey().getClass());     System.out.println(e.getValue().getClass());   }   public static void    main(String[] args) throws PyException  {     junit.textui.TestRunner.run(       PythonInterpreterGetting.class);   } } ///:~ 
     最后两个例子展示了从Python的垫片(tuples)和链表(lists)中提取数据到Java Lists,以及从Python 字典中提取数据到Java Maps。上述两种情况都需要用到比标准Jython库所提供的更多的处理方法,所以我又写了一些小程序放在com.bruceeckel.pyton里。PyUtil: toList( )是用来从一个Python序列产生一个List,toMap( )用来从Python字典产生出一个Map。PyUtil所提供的方法使得在Java和Python之间来回传递重要的数据结构变得更为简单。
  
 多个解释器Multiple interpreters     很有必要再提一下,你可以在一个程序里声明多个PythonInterpreter对象,每个对象有它自己的名字空间:
  //- interpreter:MultipleJythons.java // You can run multiple interpreters, each // with its own name space. package interpreter; import org.python.util.PythonInterpreter;  import org.python.core.*;  import junit.framework.*;   public class MultipleJythons extends TestCase  {    PythonInterpreter      interp1 =  new PythonInterpreter(),     interp2 =  new PythonInterpreter();   public void test() throws PyException {      interp1.set("a", new PyInteger(42));     interp2.set("a", new PyInteger(47));     interp1.exec("print a");     interp2.exec("print a");     PyObject x1 = interp1.get("a");     PyObject x2 = interp2.get("a");     System.out.println("a from interp1: " + x1);     System.out.println("a from interp2: " + x2);   }   public static void    main(String[] args) throws PyException  {     junit.textui.TestRunner.run(MultipleJythons.class);   } } ///:~ 
     当运行程序的时候你会看到,每个PythonInterpreter所包含的a的值是不同的。
  。。。。。。
 
                          目录
  
 
  |