|
有关构件操作接口标准的内容,我收到过几次梁小江的文档,也探讨过几次,但是我认为现在的文档的细致程度还是有很多欠缺,我想是需要好好理解一下specification这个概念,这个是个明确的规范标准,指导开发和操作的硬性规范,是需要相当细粒度的一个规则列表。附件是jsr 171的specification,你们可以参考一下,同时附链接地址,是jsr 171的页面,你们也可以参考一下,我想这个spec.拿出来就是能够应用于编程的东西,甚至,这要细到程序接口的定制,即便现在不能够足够细致,程序接口需要不断修改完善都没有关系,至少需要一个指导方向,我们对于构建要做1、2、3、4……这些操作,分别对应1、2、3、4……这些接口,它们分别具备 1、2、3、4……这些参数,主要用于1、2、3、4……这样的场景,这是一个更为详细的内容,之前我拿到的接口文档是涉及了这些内容,但我认为粒度不够,还是请再仔细考虑一下。暂时还不需要限定格式,但是我个人建议不要采用过于复杂的排版方式,如大量使用word提供的编目符号等内容,尽量用缩进表示层级关系。spec.应该是一个不依赖于特定编辑工具就能够明显表达意图的文档,jsr系列的spec.几乎都能够完全通过txt就直接表达,请参照这种表示方式。
谨祝:工作顺利!
ps:http://jcp.org/aboutJava/communityprocess/final/jsr171/index.html |
|