📐 generic API design example by I/O, the demo implementation of https://dzone.com/articles/generic-inputoutput-api-java
Java
的通用IO API
设计:book: English Documentation | :book: 中文文档
Java的通用I/O API(by Rickard Öberg)中给出了一个通用Java
IO API
设计,并且有API
的Demo
代码。更重要的是给出了这个API
设计本身的步骤和过程,这让API
设计有些条理。文中示范了从 普通简单实现 整理成 正交分解、可复用、可扩展、高性能、无错误的API
设计 的过程,这个过程是很值得理解和学习!
设计偏向是艺术,一个赏心悦目的设计,尤其是API
设计,旁人看来多是妙手偶得的感觉,如果能有些章可循真是一件美事。
在艺术工作中,真的艺术性工作量也只是一部分,而给出 方法 以 减少艺术工作之中艺术性工作量 的人是 大师。 ❤️
原文中只给出设计的
没有给出可运行的实现及其连接的细节,看起来可能比较费力,因为设计细致分解后抽象度高而不容易理解。
为了大家和自己更深入有效地学习,需要:
IO API
的可运行的Demo
实现。Demo
实现。API
的设计。PS:
上面2件事其实是份自学的家庭作业哦~ :laughing:
在阿里中间件团队的时候(2011年),@ShawnQianx 大大看到这篇文章时,给组员布置的家庭作业~ :bowtie:@ShawnQianx 对这篇文章及作者的评论:
设计时,一要分解好系统,二是多个组件拼回来还是系统预期的样子,二步都做好是难度所在。这个人分析和把控的功力很好!
com.oldratlee.io.core
com.oldratlee.io.core.filter
Filter
功能的类com.oldratlee.io.utils
com.oldratlee.io.demo
Main
类