17.2 方法查找工具

第11章介绍了Java 1.1新的“反射”概念，并利用这个概念查询一个特定类的方法——要么是由所有方法构成的一个完整列表，要么是这个列表的一个子集（名字与我们指定的关键字相符）。那个例子最大的好处就是能自动显示出所有方法，不强迫我们在继承结构中遍历，检查每一级的基类。所以，它实际是我们节省编程时间的一个有效工具：因为大多数Java方法的名字都规定得非常全面和详尽，所以能有效地找出那些包含了一个特殊关键字的方法名。若找到符合标准的一个名字，便可根据它直接查阅联机帮助文档。

但第11的那个例子也有缺陷，它没有使用AWT，仅是一个纯命令行的应用。在这儿，我们准备制作一个改进的GUI版本，能在我们键入字符的时候自动刷新输出，也允许我们在输出结果中进行剪切和粘贴操作：

  1. //: DisplayMethods.java
  2. // Display the methods of any class inside
  3. // a window. Dynamically narrows your search.
  4. import java.awt.*;
  5. import java.awt.event.*;
  6. import java.applet.*;
  7. import java.lang.reflect.*;
  8. import java.io.*;
  10. public class DisplayMethods extends Applet {
  11.   Class cl;
  12.   Method[] m;
  13.   Constructor[] ctor;
  14.   String[] n = new String[0];
  15.   TextField
  16.     name = new TextField(40),
  17.     searchFor = new TextField(30);
  18.   Checkbox strip =
  19.     new Checkbox("Strip Qualifiers");
  20.   TextArea results = new TextArea(40, 65);
  21.   public void init() {
  22.     strip.setState(true);
  23.     name.addTextListener(new NameL());
  24.     searchFor.addTextListener(new SearchForL());
  25.     strip.addItemListener(new StripL());
  26.     Panel
  27.       top = new Panel(),
  28.       lower = new Panel(),
  29.       p = new Panel();
  30.     top.add(new Label("Qualified class name:"));
  31.     top.add(name);
  32.     lower.add(
  33.       new Label("String to search for:"));
  34.     lower.add(searchFor);
  35.     lower.add(strip);
  36.     p.setLayout(new BorderLayout());
  37.     p.add(top, BorderLayout.NORTH);
  38.     p.add(lower, BorderLayout.SOUTH);
  39.     setLayout(new BorderLayout());
  40.     add(p, BorderLayout.NORTH);
  41.     add(results, BorderLayout.CENTER);
  42.   }
  43.   class NameL implements TextListener {
  44.     public void textValueChanged(TextEvent e) {
  45.       String nm = name.getText().trim();
  46.       if(nm.length() == 0) {
  47.         results.setText("No match");
  48.         n = new String[0];
  49.         return;
  50.       }
  51.       try {
  52.         cl = Class.forName(nm);
  53.       } catch (ClassNotFoundException ex) {
  54.         results.setText("No match");
  55.         return;
  56.       }
  57.       m = cl.getMethods();
  58.       ctor = cl.getConstructors();
  59.       // Convert to an array of Strings:
  60.       n = new String[m.length + ctor.length];
  61.       for(int i = 0; i < m.length; i++)
  62.         n[i] = m[i].toString();
  63.       for(int i = 0; i < ctor.length; i++)
  64.         n[i + m.length] = ctor[i].toString();
  65.       reDisplay();
  66.     }
  67.   }
  68.   void reDisplay() {
  69.     // Create the result set:
  70.     String[] rs = new String[n.length];
  71.     String find = searchFor.getText();
  72.     int j = 0;
  73.     // Select from the list if find exists:
  74.     for (int i = 0; i < n.length; i++) {
  75.       if(find == null)
  76.         rs[j++] = n[i];
  77.       else if(n[i].indexOf(find) != -1)
  78.           rs[j++] = n[i];
  79.     }
  80.     results.setText("");
  81.     if(strip.getState() == true)
  82.       for (int i = 0; i < j; i++)
  83.         results.append(
  84.           StripQualifiers.strip(rs[i]) + "\n");
  85.     else // Leave qualifiers on
  86.       for (int i = 0; i < j; i++)
  87.         results.append(rs[i] + "\n");
  88.   }
  89.   class StripL implements ItemListener {
  90.     public void itemStateChanged(ItemEvent e) {
  91.       reDisplay();
  92.     }
  93.   }
  94.   class SearchForL implements TextListener {
  95.     public void textValueChanged(TextEvent e) {
  96.       reDisplay();
  97.     }
  98.   }
  99.   public static void main(String[] args) {
  100.     DisplayMethods applet = new DisplayMethods();
  101.     Frame aFrame = new Frame("Display Methods");
  102.     aFrame.addWindowListener(
  103.       new WindowAdapter() {
  104.         public void windowClosing(WindowEvent e) {
  105.           System.exit(0);
  106.         }
  107.       });
  108.     aFrame.add(applet, BorderLayout.CENTER);
  109.     aFrame.setSize(500,750);
  110.     applet.init();
  111.     applet.start();
  112.     aFrame.setVisible(true);
  113.   }
  114. }
  116. class StripQualifiers {
  117.   private StreamTokenizer st;
  118.   public StripQualifiers(String qualified) {
  119.       st = new StreamTokenizer(
  120.         new StringReader(qualified));
  121.       st.ordinaryChar(' ');
  122.   }
  123.   public String getNext() {
  124.     String s = null;
  125.     try {
  126.       if(st.nextToken() !=
  127.             StreamTokenizer.TT_EOF) {
  128.         switch(st.ttype) {
  129.           case StreamTokenizer.TT_EOL:
  130.             s = null;
  131.             break;
  132.           case StreamTokenizer.TT_NUMBER:
  133.             s = Double.toString(st.nval);
  134.             break;
  135.           case StreamTokenizer.TT_WORD:
  136.             s = new String(st.sval);
  137.             break;
  138.           default: // single character in ttype
  139.             s = String.valueOf((char)st.ttype);
  140.         }
  141.       }
  142.     } catch(IOException e) {
  143.       System.out.println(e);
  144.     }
  145.     return s;
  146.   }
  147.   public static String strip(String qualified) {
  148.     StripQualifiers sq =
  149.       new StripQualifiers(qualified);
  150.     String s = "", si;
  151.     while((si = sq.getNext()) != null) {
  152.       int lastDot = si.lastIndexOf('.');
  153.       if(lastDot != -1)
  154.         si = si.substring(lastDot + 1);
  155.       s += si;
  156.     }
  157.     return s;
  158.   }
  159. } ///:~

程序中的有些东西已在以前见识过了。和本书的许多GUI程序一样，这既可作为一个独立的应用程序使用，亦可作为一个程序片（Applet）使用。此外，StripQualifiers类与它在第11章的表现是完全一样的。

GUI包含了一个名为name的“文本字段”（TextField），或在其中输入想查找的类名；还包含了另一个文本字段，名为searchFor，可选择性地在其中输入一定的文字，希望在方法列表中查找那些文字。Checkbox（复选框）允许我们指出最终希望在输出中使用完整的名字，还是将前面的各种限定信息删去。最后，结果显示于一个“文本区域”（TextArea）中。

大家会注意到这个程序未使用任何按钮或其他组件，不能用它们开始一次搜索。这是由于无论文本字段还是复选框都会受到它们的“监听者（Listener）对象的监视。只要作出一项改变，结果列表便会立即更新。若改变了name字段中的文字，新的文字就会在NameL类中捕获。若文字不为空，则在Class.forName()中用于尝试查找类。当然，在文字键入期间，名字可能会变得不完整，而Class.forName()会失败，这意味着它会“抛”出一个异常。该异常会被捕获，TextArea会随之设为Nomatch（不相符）。但只要键入了一个正确的名字（大小写也算在内），Class.forName()就会成功，而getMethods()和getConstructors()会分别返回由Method和Constructor对象构成的一个数组。这些数组中的每个对象都会通过toString()转变成一个字符串（这样便产生了完整的方法或构造器签名），而且两个列表都会合并到n中——一个独立的字符串数组。数组n属于DisplayMethods类的一名成员，并在调用reDisplay()时用于显示的更新。

若改变了Checkbox或searchFor组件，它们的“监听者”会简单地调用reDisplay()。reDisplay()会创建一个临时数组，其中包含了名为rs的字符串（rs代表“结果集”——Result Set）。结果集要么直接从n复制（没有find关键字），要么选择性地从包含了find关键字的n中的字符串复制。最后会检查strip Checkbox，看看用户是不是希望将名字中多余的部分删除（默认为“是”）。若答案是肯定的，则用StripQualifiers.strip()做这件事情；反之，就将列表简单地显示出来。

在init()中，大家也许认为在设置布局时需要进行大量繁重的工作。事实上，组件的布置完全可能只需要极少的工作。但象这样使用BorderLayout的好处是它允许用户改变窗口的大小，并特别能使TextArea（文本区域）更大一些，这意味着我们可以改变大小，以便毋需滚动即可看到更长的名字。

编程时，大家会发现特别有必要让这个工具处于运行状态，因为在试图判断要调用什么方法的时候，它提供了最好的方法之一。