使用Java实现内部领域特定语言(6)

 

 

在组织代码一章节中提到，对方法返回this的连贯接口建档比对返回中间对象的连贯接口建档来的简单的多，尤其是在使用Javadoc来建档的情况下。

 

Javadoc每次显示一个类的文档，这对于使用中间对象的DSL来说可能不是最好的方式：因为这样的DSL包含一组类，而不是单个的类。由于我们不能改变Javadoc显示我们的API文档的方式，我们发现在package.html文件中，加入一个使用连贯接口（包含所有相关类）、且对链中每个方法提供链接的例子，可以将Javadoc的限制的影响降到最低。

 

我们需要注意不要创建重复文档，因为那样会增加API创建者的维护代价。最好的方法是尽可能依赖于像可执行文档那样的测试。

 

Java适用于创建开发人员易读易写的、并且对于商业用户用样易读的内部领域特定语言。用Java创建的DSL可能比那些由动态语言创建的DSL来的冗长。但好的一面是，通过使用Java，我们可以利用编译器来增强DSL的语义。另外，我们依赖于成熟且强大的Java集成开发环境，从而使DSL的创建、使用和维护更加简单。

 

使用Java创建DSL需要API设计者做更多的工作，有更多的代码和文档需要创建和维护。但是，付出总有回报。使用我们API的用户在他们的代码库中会看到更多的优化。他们的代码将会更加简洁，更易于维护，这些将使得他们的生活更加轻松。

 

使用Java创建DSL有很多种不同的方式，这取决于我们试图达到的目的是什么。尽管没有什么通用的方法，我们还是发现结合方法链接和静态工厂方法与imports的方式可以得到干净、简洁、易读易写的API。

总而言之，在使用Java来创建DSL的时候有利有弊。这都由我们——开发人员根据项目需求去决定它是否是正确的选择。

 

另外一点题外话，Java 7可能会包含帮助我们创建不那么冗长的DSL的新语言特性（比如闭包）。如果想得到更多关于建议中所提特性的全面的列表，请访问Alex Miller的blog。

 

关于作者Alex Ruiz是Oracle开发工具组织中的一名软件工程师。Alex喜欢阅读任何关于Java、测试、OOP 和AOP的信息，他最大的爱好就是编程。在加入Oracle之前，Alex曾是ThoughtWorks的咨询顾问。Alex的blog为 http://www.jroller.com/page/alexRuiz。

 

Jeff Bay是纽约一家对冲基金的高级软件工程师。他曾多次建立高质量、迅速的XP团队工作于例如Onstar的计划注册系统、租赁软件、web服务器、建筑项目管理等各种系统。他对于消除重复和防止bug方面怀有极大的热情，以提高开发者的工作效率和减少在各种任务上所花费的时间。

 

 

◆ Domain Specific Language by Martin Fowler
◆ DSL Boundary by Martin Fowler
◆ Language Workbenches: The Killer-App for Domain Specific Languages? by Martin Fowler
◆ Fluent Interface by Martin Fowler
◆ Design Patterns: Elements of Reusable Object-Oriented Software by Erich Gamma, Richard Helm, Ralph Johnson, and John Vlissides
◆ Effective Java by Joshua Bloch
◆ Static Import at Java.sun.com
◆ Generics by Gilad Bracha
◆ Proposed features in Java 7 by Alex Miller
◆ Test-Driven Development definition from Wikipedia
◆ Simulating Named Parameters in Java by Alex Ruiz
◆ TableCellIndex by Mark Alexandre (first comment at Simulating Named Parameters in Java)
◆ Swing GUI test examples taken from Swing module of FEST (Fixtures for Easy Software Testing)
◆Reflection examples also taken from Reflection module of FEST (included with Swing module)
◆SQL example coming up in a open source project near you :)

 

 

【责任编辑：碧海蓝天 TEL：（010）68476606】