决定要以何种风格来撰写本书无疑是一件非常困难的事情,我当时在两种完全不同的写作风格之间摇摆不定,无法定夺。一种写作风格是:用非常科学化、公式化的方式来说明API设计时的动机、原因及步骤。使用这种方式来撰写的话,书中给出的建议和规则具有通用性,可以应用于任何项目。当然,通用性是本书的一个目的,书中所说的内容必须是普遍适用的,而不是简单地描述NetBeans项目的10年发展史。而另一方面,我坚信,如果只是在不停地说着一些建议,讲述着这些原则性的内容,而不给出合适的诠释,那么再好的建议也不能起到应有的作用。我不喜欢只说上一堆“是什么”,而不去详细地解释“为什么”。我一直想清楚地分析上下文,并以此来评估各种解决方案,然后再根据具体的环境来选择一个最合适的方案。这就是为什么我先把设计的背景和大家说明,只有这样,才有利于大家接受我们的设计原则。那么最佳的方式,就是把NetBeans项目中不同阶段面临的所有问题一五一十地摆出来。因此,可以将本书看作一本NetBeans项目的备忘录。 本书日志风格的写法也是一点点形成的。本书的写作,并不是一开始就列好题纲,打好草稿,书的议题是我在几年中陆陆续续地添加的。每当我们需要解决一个具有普遍性问题的时候,就会先在书中增加一个新的议题,找到相应解决方案后,就会记录下来。所以这种方式有效地记录了我们当时解决问题的思路,以及相应的规则。以这种写作方式来完成本书,使得本书读起来就像是记录实验日志一样。但我们的实验日志不是像写日记一样,每天一份,而是针对每个问题进行记录! 为了从这两种写作风格中获得最佳的解决方案,本书对每个专题的分析都详细说明了NetBeans项目中需要解决的问题的真实处境,然后从特有的问题抽象出一般性的建议或者解决方案,可以适用于任何框架或通用库项目。这类似我们采用的如下思路:首先是面对一个问题,然后进行分析,并提出解决方案。按照这样的思路来阅读本书,读者就可以一步步地验证我们给出的建议、方案,并判断我们推广的通用规则是否正确。在任何情况下,读者都可以灵活地调整书中所给出的方案、意见、建议等,从而更好地应用到自己的项目中。最后采用同样的思路、步骤,来看是否能得到与我们一致的意见。 API设计的技术天地非常美妙,但到目前为止,都还处于探索阶段,需要我们一步步地来积累这些知识。今天的软件系统正在变得越发庞大,我们需要运用最好的工程实践来正确地架构软件系统,并提高它们的可靠性。API设计就是其中的一种实践。在21世纪的软件开发中,希望这本书可以对你的开发进行指导!让我们的NetBeans API设计探索成为供你学习的案例,让我们总结的经验帮助你消除类似的错误。回顾1997年,我们踏上了崎岖不平的探索之路,走过了峥嵘岁月,今天,希望读者借助于这本书,一帆风顺地通过API设计的艰难险阻,而不必重复我们的曲折经历。
软件框架设计的艺术——这是一本备忘录吗
书名: 软件框架设计的艺术
作者: [捷克] Jaroslav Tulach
出版社: 人民邮电出版社
原作名: Practical API Design: Confessions of a Java Framework Architect
译者: 王磊 | 朱兴
出版年: 2011-3
页数: 388
定价: 75.00元
装帧: 平装
丛书: 图灵程序设计丛书
ISBN: 9787115248497