至今，毫无疑问你已经看过不止一篇网上文章列举了java5.0的伟大的语言新特性:泛型，标注，枚举类型，自动装箱，可变参数， for/in循环，甚至静态引入。在此我将集中于你可能没有听说过的java5.0的新api特性。

　　至今，毫无疑问你已经看过不止一篇网上文章列举了java5.0的伟大的语言新特性:泛型，标注，枚举类型，自动装箱，可变参数， for/in循环，甚至静态引入。我也认为这些是伟大的特性，但是，你已经读过他们了。因此，在此我将集中于你可能没有听说过的java5.0的新api特性。

　　那么，在下面，是我喜欢的java5.0的五个新api特性。那些看完本文后的细心的读者会发现额外的奖励―第六个特性:很少有人知道的java5.0支持的新语言语法，当然使用者就更少了。我非常喜欢它，因为它很新异。

　　callable 和 future 接口

　　我喜欢的第一个特性发掘自新的java.util.concurrent包。如它的名字暗示的，这是个并行编程工具包。在此有很多要探索的，而我要提的第一喜欢的特性是timeunit枚举类型。timeunit让我感兴趣的是它包含有用的时间相关工具--你通过一个枚举常量来调用它们，该常量代表度量时间的单位。例如:

timeunit.milliseconds.sleep(200);

　　然而，timeunit并不是最值得夸奖的。java.util.concurrent最强大的特性之一是它的任务-执行/线程-池结构。executorservice接口提供了执行任务的能力。executors类定义了工厂方法用于获取使用线程池的executorservice的实现。这是强大的要素。

　　我所喜欢的任务-执行框架的部分是它如何表现任务以及执行它的结果:callable和future接口。我们都熟悉用于定义线程的runnable接口和它的run()方法。callable像runnable，但它的方法叫做call()，并且这个方法可以返回一个结果或者抛出一个异常，而这两点是runnable.run()做不到的。

　　callable是一个泛型，并且它的结果已经参数化。例如，一个计算biginteger的任务，是callable<biginteger>，并且它的方法call()被声明为返回biginteger。下面是仅有三行代码的callable接口:

public interface callable<v> {
      v call() throws exception;
  }

　　当我想要异步执行一个callable任务，我将它传递给executorservice的submit()方法。submit()的返回值―这也是我喜欢的部分―是一个future对象:本质上是一个对将来某时刻的结果的“借条”。如果我准备使用我的任务的结果，我简单的调用future对象的get()方法即可。如果任务的执行已完成，那么get()立刻返回结果。否则，它将阻塞直到结果可用。如果callable抛出异常，那么get()方法将该异常包装为executionexception并且抛出它。future还有方法用来对任务的执行进行取消和查询状态，但是你必须自己查找它们(这些方法)。future也用了泛型，并且结果的类型也参数化了。因此如果我submit()一个callable<biginteger>来执行，我将获得一个future< biginteger >。

　　下面是一个简短的例子:

/**
 * 这是一个用来计算大素数的callable。
 */
public class primesearch implements callable<biginteger>
{
    static random prng = new securerandom();
    int n;
    public primesearch(int bitsize) { n = bitsize; }
    public biginteger call() {
        return biginteger.probableprime(n, prng);
    }
}

// 尝试同时计算两个素数
executorservice pool = executors.newfixedthreadpool(2);
future<biginteger> p = pool.submit(new primesearch(512));
future<biginteger> q = pool.submit(new primesearch(512));

// 将两个素数相乘来得到一个合数
biginteger product = p.get().multiply(q.get());

　　可变参数和自动装箱

　　我说过我不想谈论java5.0的新语言特性，我不会，但是我确实关注由于可变参数和自动装箱才变为可能的(或者被增强的旧api)新的api。

　　首先，当然，是java5.0的printf风格的文本格式化能力，通过java.util.formatter类和类似string.format()的工具方法。这类文本格式化是最常被引用来支持语言的增加的可变参数和自动装箱的那种用例。考虑这个:

string s = string.format("%s:%d: %s%n", filename,
                           linenumber,
                   exception.getmessage());

　　关于这段代码没有什么特别值得注意的东西。我将它列在这是为了说明因为可变参数和自动装箱所以比下面的例子显得简单:

string s = string.format("%s:%d: %s%n", new object[] {
                           filename,
                           new integer(linenumber),
              exception.getmessage()});

　　可变参数和自动装箱还对java.lang.reflect api有一个实质性的影响。那就是当查找和调用方法时不再需要类和对象数组:

method m = c.getmethod("put", object.class,object.class);
  m.invoke(map, "key", "value");

　　如果我必须选择一个最喜欢的可变参数方法，那么，将是java.util.arrays.aslist()。这个方法真是个用于创建不变的对象列表的方便的工厂方法。它接受任何数量的类型t的参数并且将它们作为list返回:

list<integer> smallprimes =
     arrays.aslist(2, 3, 5, 7, 11, 13, 17, 19);

　　能力

　　我们在上面谈论了runnable和callable，并且你毫无疑问已经听说过重要的comparable， serializable,和cloneable接口。java5.0新增加了五个重要的能力接口。第一个，当然，是java.lang.iterable。你或许知道java5.0新的for/in循环可以迭代数组和集合。你可能不知道它能够对任何实现了可迭代(iterable)接口的对象工作。因此，如果你想让一个不是集合的数据结构可以简单地迭代，只需实现iterable接口。你要做的就是增加一个返回java.util.iterator 的iterator()方法。当然，写这个迭代器(iterator)可能不是那么简单的。

　　下面的代码是一个实现了iterable<string>（是的，iterable是泛型的）的文本文件类，因而允许文本文件可以用for/in循环逐行的迭代。你可以用类似下面的代码使用它：

textfile textfile = new textfile(new file(f), "utf-8");
  int linenumber = 0;
  for(string line : textfile)
      system.out.printf("%6d: %s%n", ++linenumber, line);

　　下面是textfile的代码。注意，迭代器不尝试检测对底层文件的并发的修改。如果你想自己做，看一看

java.nio.channels.filelock。
import java.io.*;
import java.util.iterator;

public class textfile implements iterable<string> {
    file f;
    string charsetname;

    public textfile(file f, string charsetname)
   throws ioexception
    {
   this.f = f;
   this.charsetname = charsetname;

   if (!f.exists())
       throw new filenotfoundexception(f.getpath());
   if (!f.canread())
       throw new ioexception("can't read: " +
              f.getpath());
    }

    public iterator<string> iterator() {
   try {
       return new textfileiterator(f, charsetname);
   }
   catch(ioexception e) {
       throw new illegalargumentexception(e);
   }
    }

   void getnextline() {
       if (!closed) {
      try { nextline = in.readline(); }
      catch(ioexception e) {
          throw new illegalargumentexception(e);
      }
      if (nextline == null) {
          try { in.close(); }
          catch(ioexception ignored) {}
          closed = true;
      }
       }
   }
    }
}

　　iterable是到目前为止最重要的新能力接口，但是其它的也是非常的漂亮。接下来，我们碰到java.lang.appendable。一个appendable对象可以追加字符或字符序列(或者一个字符序列的子序列)。实现者包括stringbuffer和stringbuilder(如果你还没有听说过它，一定要看一看)，writer(及其子类)，printstream,还有java.nio.charbuffer。将可追加性从这些类中分离出来成为appendable接口，使得新的java.util.formatter类更强大:它能将文本格式化为任何可追加的对象，包括你自己的实现。(练习留给读者:你能否将上面的textfile类变得既可迭代又可追加么?)。

　　java.lang.readable接口和appendable相反:一个可读对象可以将字符传输给给定的charbuffer。java.io.reader和它的全部子类都是可读的(当然了)，charbuffer本身也一样。就像appendable是为了java.util.formatter的利益而创造，readable是为了java.util.scanner的利益而创造。(java5.0增加了scanner，连同formatter。这是java对c的scanf()函数的适应，但是它(scanner)不像formatter之对应于printf()的关系那样密切。)

　　我想讨论的最后两个能力接口是java.io.closeable和java.io.flushable。如它们的名字暗示的，它们趋向于被任何类实现，通过一个close()或者flush()方法。closeable被所有的输入和输出流类，randomaccessfile和formatter实现。flushable被输出流类和formatter实现。这些接口也是为了formatter类的利益而定义。注意，appendable对象(像stringbuilder)不总是可关闭或者可冲刷(flushable)。通过将可关闭性和可冲刷性分解出来成为这些接口，formatter的close()和flush()方法能够决定它们操作的appendable对象是否需要被关闭或被冲刷。(java5.0还增加了第六个能力接口，并且它也是有关formatter类的。那些想要控制它们的实例怎样被格式化的类可以实现java.util.formattable接口。然而这个接口的api是难用的，我不想谈论它。)

　　@override

　　毫无疑问,你已经听说过能用元数据标注java5.0的类型和方法。但是你可能不熟悉增加到java.lang的标准标注类型。我喜欢的第四个特性就是java.lang.override标注。当你写一个方法准备覆盖另一个的方法时，用@override来标注它，这样编译器会进行检查来确保你确实，实际上，覆盖了你想覆盖的方法。

　　如果你拼写错了方法名字或者弄错了方法参数，那么你实际上并没有覆盖那个你认为你覆盖了的方法。这样就造成了一个如果不用@override很难捕捉的臭虫。我所以知道是因为我的关于java1.4的新api特性的文章就讲到了这个臭虫，并且这个错误至少有一年一直没被检测到(至少没有被报告)。在那篇文章中，你可以在第一页结尾看到我犯的错误。那篇文章现在包含一个链接到我的博客入口，在那里我改正了这个臭虫并且在代码中增加了@override声明。

　　matchresult

　　我喜欢的java5.0的最后一个特性是java.util.regex.matchresult。对于用于正则表达式的模式/匹配api我从来没有真正非常满意。java5.0增加的matchresult在让我大大地更加满意。当使用一个不太平凡的模式(pattern)，每次调用匹配者(matcher)的find()方法会生成许多状态:开始位置，结束位置，匹配的文本，同时还有模式的开始，结束，每个子表达式的文本。在java5.0以前，你只能从matcher获取它们，通过在调用find()后再调用start(),end(),还有group()，如果需要的话。

　　然而，到了java5.0，你可以只调用tomatchresult()来获取matchresult对象再获取全部的状态，matchresult对象可以保存并且可以以后再检查。matchresult像matcher一样有start(),end()，以及group()方法，并且，实际上，matcher现在实现了matchresult。

　　这里是一个有用的返回matchresult的方法:

public static list<matchresult> findall(pattern pattern,
               charsequence text)  {
    list<matchresult> results =
        new arraylist<matchresult>();
    matcher m = pattern.matcher(text);
    while(m.find()) results.add(m.tomatchresult());
    return results;
}

　　还有使用这个方法的代码:

list<matchresult> results = findall(pattern, text);
for(matchresult r : results) {
    system.out.printf("found '%s' at (%d,%d)%n",
            r.group(), r.start(), r.end());
}

　　十六进制浮点数字面值

　　我承诺谈论java5.0的最晦涩的新语言特性。这就是:十六进制格式的浮点常量!这里是奇异的详情:一个十六进制符号的浮点常量以0x或者0x开头。随后的十六进制数字形成了数的基数。关键是这些数字可以包含一个小数点(一个十六进制小数点?)。在基数后面是指数，是必需的。十六进制浮点常量使用p或者p而不是e或者e来引入指数。(想一下“幂”来帮助记忆)。p或者p后面是指数，必须是一个十进制数，而不是十六进制数。而且这是个以二为根的指数，而不是以十为根。那就是，表示基数要乘以的2的幂。最后，整个常量可以跟随一个f或者f来表示一个浮点常量，或者一个d或者d表示一个双精度常量，就像一个十进制浮点数一样。

　　下面是一些例子:

double x = 0xap0;    // 10 * 2^0 = 10.0
  double y = 0xfp2d;   // 15 * 2^2 = 60.0
  float z  = 0xf.ap1f; // (15 + 10/16ths) * 2^1 = 31.25f
  // 用十进制来打印
  system.out.printf("%f %f %f%n", x, y, z);
  // 用十六进制来打印
  system.out.printf("%a %a %a%n", x, y, z);

　　为什么sun要对语言做这些?5.0的发行说明说:

　　为了允许特定浮点值实现精确及可预见的规范，十六进制符号可用于float和double的浮点字面值和字符串到浮点数的转换方法中。

　　这点是合理的。十进制小数像0.1是不能精确地用浮点格式表示的，并且如果你真的需要确切知道在一个浮点或者双精度值中比特位是怎么设的，那么你真的想要一个十六进制字面值。例如，float.max_value的javadoc指出最大的浮点值是0x1.fffffep+127f。

　　如果你知道并且喜欢ieee-754浮点标准，那么十六进制浮点字段值或许是你喜欢的一个特性。我只是认为他们有趣。