《Struts2技术内幕》 新书部分篇章连载（一）—— 如何学习开源框架

2.6 如何学习开源框架

正确的学习方法不仅能够事半功倍，也能够使我们更加接近真理。在大家了解了框架的本质和Web开发模式之后，我们来讨论一下学习开源框架和基本方法。

在这里，本书为大家小结了一些正确的学习方法和最佳实践，这些不仅是笔者多年开发中的心得体会，也汲取了网络上的大家之言，希望对初学者或者正在为学习开源框架犯愁的朋友带来一些启示。这些学习方法，不仅适用于 Struts2，同样适用于许多其他的开源框架。

downpour 写道

最佳实践  阅读、仔细阅读、反复阅读每个开源框架自带的reference。

这是学习一个框架最为重要，也是最最开始需要做的事情。不幸的是，事实上，绝大多数程序员对此并不在意，并且总是以种种理由作为借口不乐意仔细阅读 Reference。

程序员的常见借口之一：英语水平跟不上，英文文档阅读起来太吃力。针对这样的借口，我们需要指出，阅读英文文档是每个程序员必须具备的基本素质之一，这就和调试程序需要耐心一样，对一个程序员来说非常重要。当然，阅读英文文档这一基本素质是一点一滴积累培养起来的，对于那些阅读起来实在觉得吃力的朋友，笔者的建议是结合中文的翻译版本一起看。国内有许多开源组织，例如满江红的开源支持者们已经为大家精心做了许多很有价值的翻译，例如Spring、Hibernate等都有对应的中文翻译文档。但是大家必须注意，看中文文档，必须和英文文档对照，因为没有人可以确保翻译能够百分之百的正确，语义的不匹配会给你带来极大的误导，通过对照，才能够将误解降低到最低。

程序员的常见借口之二：Reference太长，抓不住重点。在这里，笔者给出的建议是：耐心，耐心，还是耐心！从Reference的质量而言，其实大多数的开源框架的Reference都是非常优秀的，基本包含了框架的方方面面。尤其是Struts2，由于历史原因，Struts2的Reference基本上都是一个一个的专题Wiki文章拼起来的文档，每篇文章都有一个固定的主题，不仅包含原理解析、注意事项、有的还包含源码解析和示例讲解。或许阅读Reference可能会非常枯燥，但是从价值的角度看，对Reference的阅读往往是对大家帮助最大的。因此，笔者对阅读Reference的建议是，多看几遍。第一遍，你可以采取浏览（scan）的方式，目的是了解框架的整体架构的大致功能。第二遍，挑重点的章节仔细阅读，并且辅以一定的代码实践，目的是彻底掌握某个分支领域的知识。第三遍，带着问题阅读，在文档中寻找答案。

笔者之所以强烈推荐大家仔细阅读开源框架自带的reference，主要基于以下的两个原因：

权威性

这些自带的reference多数出自这些开源框架的作者或者开发人员之手。还有谁能够比他们自己更了解他们自己编写的产品呢？自己写的程序，到底有哪些优点，如何使用，自己肯定是最最清楚的，所以要说到权威性，不可能有任何的文档比自带的Reference更加权威。

正确性

自带的Reference几乎很少犯错，所以不会给你带来什么的误导信息。不仅如此，许多的Reference已经为你总结了许多框架使用过程中的最佳实践。所以我们没有理由不直接通过这些Reference来获得第一手的资料。

downpour 写道

最佳实践  精读网络教程。

对于很多初学者来说，他们对看Reference这种学习方式的接受程度很低。相反，他们会去转而学习一些网络教程。一般而言，这些学习材料的实际价值要比Reference低很多倍。主要原因在于，作者在编写这些教程时，多数都会加入他们自己的学习思路，而忽略了框架本身所期望达到的程序开发中最佳实践，甚至会给很多读者以：“程序就是这么写的”的误导。 所以，对于网络上的绝大多数网络教程，需要读者有足够的甄别能力，否则很容易被带入歧途。

网络上还有很多原版的教程，例如《XXX in Action》系列。《XXX in Action》系列的书籍在市场上深受好评。然而，这些系列的书籍并不比框架自带的Reference好多少，因为有些内容也带有作者个人的感情色彩。当然，每个作者在编写书籍或撰写教程的过程中都会夹带自己的感情色彩，这本不是什么坏事，不过既然我们已经有了Reference作为阅读的主体了，为什么我们要舍近求远呢？当然，不得不说，对于这类书籍，我们需要采取的态度是“精读”。

同时，网友也提到了很多网络教程。网络教程，尤其是中文的网络教程，基本上都是网友的经验之谈，也有写成系列文章的。对于网络教程，笔者的建议是：带着问题去读，去搜索你的答案，而不是当作核心文档来阅读。在找到答案之后，也需要通过实践来反复验证，因为有许多的解决方案，可能只是临时的，并不是程序开发中的最佳实践。

downpour 写道

最佳实践  搭建环境运行每个开源框架自带的sample项目。

每个开源框架基本上都会自带有sample项目。以Struts2为例，在Struts2的分发包的apps目录下就有多个sample项目，如图2-9所示。



Struts2是一个典型的Web层框架，所以所有Struts2的sample项目都以war包的形式给出，大家可以将这些war包的任何一个复制到你的Web容器的运行目录下，启动Web容器就可以访问这些sample项目。

千万不要小看这些sample项目，我们可以从这些项目中获取许多重要的知识和信息。有些知识恐怕连Reference都不曾提及。这些原生态的东西，使得我们完全无需舍近求远地到网络上去到处寻找例子，只要学习这些例子，就足够掌握开源框架的种种特性了。

我们可以就其中的三个sample项目进行举例分析：

struts2-blank-2.2.1.war

一般而言，名为xx-blank-xxx.war的sample项目是一个开源框架最小的一个可运行的范例。所以，如果大家仔细学习这个war包中的内容，至少可以发现组成一个Struts2程序的最小元素到底有哪些。在其中的WEB-INF/lib目录下，我们能够找到Struts2程序运行所需要依赖的JAR包的最小集合（如图2-8所示），我们还能从中学习Struts2的各种基础配置的编写等。



struts2-portlet-2.2.1.war

这个sample项目告诉我们在Portal环境下的Struts2的应用应该如何编写。通过与struts2-blank-2.2.1.war这个项目的比较，大家可以发现，Struts2在应对不同的Server环境方面的不同。


struts2-showcase-2.2.1.war

这个sample项目是Struts2特性的一个大杂烩，包含了绝大多数的Struts2的特性示例。这个sample项目对于大家阅读Reference是非常有帮助的。比如说，大家在阅读文档时看到了“文件上传”的章节，那么大家就可以参考这个项目中的upload子目录中的相关的类和配置。这相当于一边看文档，一边已经有一个现成的可以运行的例子辅助你进行学习。所以，这个项目与Reference的搭配是相得益彰、互为补充的，可以作为大家学习Struts的最佳资源。

downpour 写道

最佳实践  自己写一个sample项目亲身体验。

这一点其实不用多说，大家也应该明白。不过笔者还是见过不少程序员，眼高手低，整天吹嘘说这个框架的优点，那个框架的优势，但如果让他自己动手用这些框架写一段程序，又变得手足无措。

实践是检验真理的唯一标准。只有自己亲自动手去实践，才能说明你真正掌握了某个技术，理解了某个框架的特性。在编写自己的sample项目时，大家可以针对不同的特性，人为设置好业务场景（例如，使用“登录”作为一个基本的业务场景），在实践中不断地重构你的代码，从而领悟框架开发中的最佳实践，提升自己的开发水平。

downpour 写道

最佳实践  带着问题调试（debug）开源框架的源码。

如果大家对某个开源框架的使用已经比较熟练，对其内部的原理也基本掌握，或许你就会对其中的某些设计原理和设计思想产生兴趣。这个时候，通过开源框架的源码来寻找问题的答案不失为一个很好的进一步学习的途径。
在学习开源框架的源码时，笔者的建议是在程序运行在Debug模式的状态下，对源码进行调试，在Debug的过程中，查看在开源框架的内部到底运行了哪些类，它们的执行次序是怎样的以及这些类中临时变量的执行状态。笔者坚决反对逐个package地去阅读源码，这毫无意义。因为程序本身是一个整体，程序之所以成为程序，其本质在于它是动态的、运行的。如果我们逐一去阅读源码，就相当于把一个完整的整体进行肢体分解，那么我们将永远无法看到一个完整的动态执行过程。学习源码，最重要的要点在于抓住一个程序在运行过程中某一时刻某个关键类的运行状态和最终状态，而这些都能通过调试源码来实现，这才是阅读源码的最佳实践。