update generic-io-api-in-java-and-api-design

generic-io-api-in-java-and-api-design/README.md

@@ -3,9 +3,13 @@
 
 ### :apple: 译序
 
-原文[A generic input/output API in Java](http://www.jroller.com/rickard/entry/a_generic_input_output_api)(by Rickard Öberg)中给出了一个通用`Java` `IO` `API`设计，并且有`API`的`Demo`代码。更重要的一点是，这篇文章给出实现这个`API`设计本身的步骤和过程，这让`API`设计实现过程有了条理。文中示范了从 普通简单实现 整理成 正确分解、可以复用、可扩展的`API`设计 的过程。这个很值得理解和学习！
+原文[A generic input/output API in Java](http://www.jroller.com/rickard/entry/a_generic_input_output_api)(by Rickard Öberg)中给出了一个通用`Java` `IO` `API`设计，并且有`API`的`Demo`代码。
 
-设计偏向是艺术，一个赏心悦目的设计，尤其是`API`设计，旁人看来多是妙手偶得的感觉，如果能有些章可循真是一件好事。给出 _**减少艺术的艺术工作量**_ 的方法的人是大师。 
+更重要的一点是，这篇文章给出实现这个`API`设计本身的步骤和过程，这让`API`设计实现过程有了条理。文中示范了从 普通简单实现 整理成 正确分解、可以复用、可扩展的`API`设计 的过程。
+这个很值得理解和学习！
+
+设计偏向是艺术，一个赏心悦目的设计，尤其是`API`设计，旁人看来多是妙手偶得的感觉，如果能有些章可循真是一件好事。
+给出 _**减少艺术的艺术工作量**_ 的方法的人是大师。
 
 `Java`的通用`I/O` `API`设计
 =========================
@@ -205,4 +209,17 @@ Usage in the `Qi4j` `SPI`
 
 多谢你的阅读，希望你能有所收获 :-)
 
-<EOF>
+**-EOF-**
+
+**译注：**
+
+原文中只给出设计的
+
+- 发展思路
+- 关键接口
+- 典型的使用方式。
+
+没有给出实现细节，看起来可能比较费力。（细致的分解后的设计往往比较抽象，不容易快速理解），
+我实现了[完整工程的Demo代码](https://github.com/oldratlee/io-api)，并写了一篇[简单分析](https://github.com/oldratlee/io-api/wiki/java-api-design-exercise)。
+
+更多资料参见[这里](https://github.com/oldratlee/io-api/wiki)。