play框架手册-08.Play 提供的工具包.doc

08.Play.libs库包 play.libs包包含了很多有用的库，以帮助实现通用的编程任务。 大多数据库都是简单的帮助类，而且非常易懂易用： Codec:数据编码和解码工具箱 Crypto:密码图形工具（验证码？） Expression:动态评价表达式？ F: java实用编程工具 Files:文件系统控制帮助类 I18N:国际化帮助类 IO:流控制帮助类 Images:图片控制工具箱 Mail: E-mail功能 MimeTypes: MIME类型交换 OAuth: OAuth客户端协议（安全认证） OAuth2: OAuth2客户端协议（安全认证） OpenID: OpenID客户端协议（安全认证） Time: 时间和持续期间工具箱 WS: 强大的Web services客户端 XML: 加载XML结构 XPath: 用XPath解析XML 下面的内容着重介绍一些非常重要的库。 用XPath解析XML XPath 或许是最容易解析XML文档的工具了，而且不需要使用代码生成工具。play.libs.XPath库为高效完成解析任务提供了所有需求。 XPath可以操作所有的org.w3.dom.Node类型: org.w3.dom.Document xmlDoc = … // 找到 a Document somewhere for(Node event: XPath.selectNodes(events//event, xmlDoc)) { String name = XPath.selectText(name, event); String data = XPath.selectText(@date, event); for(Node place: XPath.selectNodes(//place, event)) { String place = XPath.selectText(@city, place); … } … } Web Service client play.libs.WS提供了一个强大的http客户端，Under the hood it uses Async HTTP client. 创建一个请求非常容易： HttpResponse res = WS.url().get(); 一旦获得HttpResponse对象后，就可以访问所有的response属性了： int status = res.getStatus(); String type = res.getContentType(); 也可获得不同类型的内容体： String content = res.getString(); Document xml = res.getXml(); JsonElement json = res.getJson(); InputStream is = res.getStream(); 也可以非阻塞方式使用async API来创建一个http请求。然后就可以得到一个PromiseHttpResponse，一旦兑现成功，就可以和平常一样使用HttpResponse： PromiseHttpResponse futureResponse = WS.url( ).getAsync(); Functional programming with Java功能扩展？ play.libs.F库从功能编程（functional programming） OptionT (T值可设置也可不用设置) EitherA,B (不是A就是B) TupleA,B (同是包含了A和B) OptionT, SomeT and NoneT 在某些情况下，函数可能不会返回结果（比如find方法），通常做法（非常糟糕）是返回null，这样做实际上非常危险，因为函数的返回类型不清晰。OptionT就是一个优雅的解决方案。如果函数成功执行，就返回明确的类型SomeT（封装了真实的结果），否则返回对象NoneT（OptionT的子类型）。示例： /* 安全除法(绝不抛出ArithmeticException运行时错误) */ public OptionDouble div(double a, double b) { if (b == 0) return None(); else return Some(a / b); } 用法： OptionDouble q = div(42, 5); if (q.isDefined()) { L(q = %s, q.get()); // q = 8.