一个java类要领提取器

很少需要直接利用反射东西；之所以在语言中提供它们，仅仅是为了支持其他Java特性，好比工具序列化（第10章先容）、Java Beans以及RMI（本章后头先容）。可是，我们很多时候仍然需要动态提取与一个类有关的资料。个中出格有用的东西即是一个类要领提取器。正如前面指出的那样，若检视类界说源码可能联机文档，只能看到在谁人类界说中被界说或包围的要领，基本类哪里尚有大量资料拿不到。幸运的是，“反射”做到了这一点，可用它写一个简朴的东西，令其自动展示整个接口。下面即是详细的措施：
 

//: ShowMethods.java
// Using Java 1.1 reflection to show all the 
// methods of a class, even if the methods are 
// defined in the base class.
import java.lang.reflect.*;

public class ShowMethods {
  static final String usage =
    "usage: \n" +
    "ShowMethods qualified.class.name\n" +
    "To show all methods in class or: \n" +
    "ShowMethods qualified.class.name word\n" +
    "To search for methods involving 'word'";
  public static void main(String[] args) {
    if(args.length < 1) {
      System.out.println(usage);
      System.exit(0);
    }
    try {
      Class c = Class.forName(args[0]);
      Method[] m = c.getMethods();
      Constructor[] ctor = c.getConstructors();
      if(args.length == 1) {
        for (int i = 0; i < m.length; i++)
          System.out.println(m[i].toString());
        for (int i = 0; i < ctor.length; i++)
          System.out.println(ctor[i].toString());
      } 
      else {
        for (int i = 0; i < m.length; i++)
          if(m[i].toString()
             .indexOf(args[1])!= -1)
            System.out.println(m[i].toString());
        for (int i = 0; i < ctor.length; i++)
          if(ctor[i].toString()
             .indexOf(args[1])!= -1)
          System.out.println(ctor[i].toString());
      }
    } catch (ClassNotFoundException e) {
      System.out.println("No such class: " + e);
    }
  }
} ///:~

Class要领getMethods()和getConstructors()可以别离返回Method和Constructor的一个数组。每个类都提供了进一步的要领，可理会出它们所代表的要领的名字、参数以及返回值。但也可以象这样一样只利用toString()，生成一个含有完整要领签名的字串。代码剩余的部门只是用于提取呼吁行信息，判定特定的签名是否与我们的方针字串相符（利用indexOf()），并打印出功效。
这里便用到了“反射”技能，因为由Class.forName()发生的功效不能在编译期间获知，所以所有要领签名信息城市在运行期间提取。若研究一下联机文档中关于“反射”（Reflection）的那部门文字，就会发明它已提供了足够多的支持，可对一个编译期完全未知的工具举办实际的配置以及发出要领挪用。同样地，这也属于险些完全不消我们劳神的一个步调——Java本身会操作这种支持，所以措施设计情况可以或许节制Java Beans——但它无论如何都长短常有趣的。
一个有趣的试验是运行java ShowMehods ShowMethods。这样做可获得一个列表，个中包罗一个public默认构建器，尽量我们在代码中瞥见并没有界说一个构建器。我们看到的是由编译器自动合成的那一个构建器。假如随之将ShowMethods设为一个非public类（即换成“友好”类），合成的默认构建器便不会在输出功效中呈现。合成的默认构建器会自动得到与类一样的会见权限。
ShowMethods的输出仍然有些“不爽”。譬喻，下面是通过挪用java ShowMethods java.lang.String获得的输出功效的一部门：
 

public boolean 
  java.lang.String.startsWith(java.lang.String,int)
public boolean 
  java.lang.String.startsWith(java.lang.String)
public boolean
  java.lang.String.endsWith(java.lang.String)

若能去掉象java.lang这样的限定词，功效显然会更令人满足。有鉴于此，可引入上一章先容的StreamTokenizer类，办理这个问题：
 

//: ShowMethodsClean.java
// ShowMethods with the qualifiers stripped
// to make the results easier to read
import java.lang.reflect.*;
import java.io.*;

public class ShowMethodsClean {
  static final String usage =
    "usage: \n" +
    "ShowMethodsClean qualified.class.name\n" +
    "To show all methods in class or: \n" +
    "ShowMethodsClean qualif.class.name word\n" +
    "To search for methods involving 'word'";
  public static void main(String[] args) {
    if(args.length < 1) {
      System.out.println(usage);
      System.exit(0);
    }
    try {
      Class c = Class.forName(args[0]);
      Method[] m = c.getMethods();
      Constructor[] ctor = c.getConstructors();
      // Convert to an array of cleaned Strings:
      String[] n = 
        new String[m.length + ctor.length];
      for(int i = 0; i < m.length; i++) {
        String s = m[i].toString();
        n[i] = StripQualifiers.strip(s);
      }
      for(int i = 0; i < ctor.length; i++) {
        String s = ctor[i].toString();
        n[i + m.length] = 
          StripQualifiers.strip(s);
      }
      if(args.length == 1)
        for (int i = 0; i < n.length; i++)
          System.out.println(n[i]);
      else
        for (int i = 0; i < n.length; i++)
          if(n[i].indexOf(args[1])!= -1)
            System.out.println(n[i]);
    } catch (ClassNotFoundException e) {
      System.out.println("No such class: " + e);
    }
  }
}

class StripQualifiers {
  private StreamTokenizer st;
  public StripQualifiers(String qualified) {
      st = new StreamTokenizer(
        new StringReader(qualified));
      st.ordinaryChar(' '); // Keep the spaces
  }
  public String getNext() {
    String s = null;
    try {
      if(st.nextToken() !=
            StreamTokenizer.TT_EOF) {
        switch(st.ttype) {
          case StreamTokenizer.TT_EOL:
            s = null;
            break;
          case StreamTokenizer.TT_NUMBER:
            s = Double.toString(st.nval);
            break;
          case StreamTokenizer.TT_WORD:
            s = new String(st.sval);
            break;
          default: // single character in ttype
            s = String.valueOf((char)st.ttype);
        }
      }
    } catch(IOException e) {
      System.out.println(e);
    }
    return s;
  }
  public static String strip(String qualified) {
    StripQualifiers sq = 
      new StripQualifiers(qualified);
    String s = "", si;
    while((si = sq.getNext()) != null) {
      int lastDot = si.lastIndexOf('.');
      if(lastDot != -1)
        si = si.substring(lastDot + 1);
      s += si;
    }
    return s;
  }
} ///:~

#p#分页标题#e#

ShowMethodsClean要领很是靠近前一个ShowMethods，只是它取得了Method和Constructor数组，并将它们转换成单个String数组。随后，每个这样的String工具都在StripQualifiers.Strip()里“过”一遍，删除所有要领限定词。正如各人看到的那样，此时用到了StreamTokenizer和String来完成这个事情。
如果记不得一个类是否有一个特定的要领，并且不想在联机文档里慢慢查抄类布局，可能不知道谁人类是否能对某个工具（如Color工具）做某件工作，该东西便可节减大量编程时间。
第17章提供了这个措施的一个GUI版本，可在本身写代码的时候运行它，以便快速查找需要的对象。