摘要:
gwM-->14n 在这篇文章里,对于Spring XML的配置,我将向你展示12种比较好的实践。其中的一些实践不仅是好的实践,更是必要的实践。除此以外,还有其他因素,例如领域模型的设计,都能影响XML的配置,但是这篇文章重点研究XML配置的易读性和易管理性。
d&U~{ -jY=&~Ull Spring是一个强大的JAVA应用框架,广泛地应用于JAVA的应用程序。为Plain Old Java Objects(POJOs)提供企业级服务。Spring利用依赖注入机制来简化工作,同时提高易测性。Spring beans及依赖,以及beans类所需的服务都在配置文件中进行了详细的说明,这个配置文件是典型的XML格式。但是它既冗长又不实用。对于需要定义大量Spring beans的大工程来说,我们难以阅读和管理它。
n)x KF;IE gp+z\@ 版权声明:任何获得Matrix授权的网站,转载时请务必保留以下作者信息和链接
bYmk` V!N 作者:Jason;Li;evenbetter(作者的blog:
http://blog.matrix.org.cn/page/evenbetter)
jU\@e| 原文:
http://www.onjava.com/pub/a/onjava/2006/01/25/spring-xml-configuration-best-practices.html ;3GNsR{ 译文:
http://www.matrix.org.cn/resource/article/44/44236_Spring+XML+Configurations.html lg9743"0 关键字:Spring;XML;Configurations
aBly ?qT Nerj4W, 在这篇文章里,对于Spring XML的配置,我将向你展示12种比较好的实践。其中的一些实践不仅是好的实践,更是必要的实践。除此以外,还有其他因素,例如领域模型的设计,都能影响XML的配置,但是这篇文章重点研究XML配置的易读性和易管理性。
;;;3~ r ]D(Ho$\S 1。不要使用autowiring
DX-: %3-#pc`M6 Spring 可以通过类的自省来自动绑定其依赖部分,使得你不必明确指明bean的属性和构造器。Bean的属性可以通过属性名称或类型匹配来实现自动绑定。构造器通过类型匹配来实现自动绑定。你甚至可以指定自动检测自动绑定模式,它可以引导Spring选择一种适当的运行机制。先来看看下面的一个例子:
tC |jUW -sP##7l <bean id="orderService"
(kC?&D`6f class="com.lizjason.spring.OrderService"
SOJ/A|( autowire="byName"/>
=L!R!m4>K +0<w-[.Mln 8V@/q _0l]/ 0 G OrderService 类的属性名在容器中用于匹配bean实例。自动绑定可以潜在地节省一些打字和减少一些混乱。但是在现实世界的工程里你不应该使用这种方式,这是因为它牺牲了配置的清晰性和可维护性。许多指南和介绍中大量吹捧自动绑定是Spring的一种极好的特征而没有提到这一特性所带来的牺牲。依我的观点,这就像 Spring中的object-pooling,它更像是一种为了占据更多市场的商业特征。它对于XML配置文件的小巧化是一个好办法,但实际上也增加了复杂程度,尤其当你运行有大量类声明的工程时。虽然Spring允许你混合自动绑定和手动绑定,但是这个矛盾会使XML配置更加晦涩难懂。
) oOu[GB >cN9Zj 2.使用通俗的命名
`t(I.dx]2~ 833 'Y\'Za 这个方式对于Java编码也一样适用。在工程中使用清晰的、描述性的、协调的通俗名称对于开发者理解XML配置是十分有益的。例如对于bean ID,你可以根据通俗的Java类名来命名它。对于例子中OrderServiceDAO的bean ID命名为orderServiceDAO。对于大的工程,你可以在bean ID前面加上包名作为前缀。
E&!g#HOS 5>-uXLHM 3. 使用简洁的形式
KB H fz e` Q8x0 简洁形式避免了冗长,是因为它从子元素中将属性值和参考写到属性中。例如下面的例子:
"qd4]wH[s <+_kYgP <bean id="orderService"
emrL~!Q@ class="com.lizjason.spring.OrderService">
fl^u| <property name="companyName">
85d@ +}r< <value>lizjason</value>
<)7 Aqe </property>
H NGo^M <constructor-arg>
4E/4[\%A <ref bean="orderDAO">
-a`s^h2Z=R </constructor-arg>
s2 =H8d </bean>
&4Wi!D|b@ ~V9U0:u '`M=)SR& TZ-+U}g z 可以使用简洁形式将上述代码重写为:
Z-'Jq|g P?G# k> <bean id="orderService"
f}% 9RWu class="com.lizjason.spring.OrderService">
+q HR];N( <property name="companyName"
! |g#p0: value="lizjason"/>
'@{u[Cs <constructor-arg ref="orderDAO"/>
>K1|1W<&4y </bean>
&AM1hb?Qe +*p\o5 'u X\fYd H TeN#F>* 简洁形式功能在1.2版本中可以使用。对于<ref local="...">没有简洁形式。
}JMg=e< 简洁形式不但可以节约你的打字,而且可以使XML配置文件清晰。它最引人注目的是当在一个配置文件中有大量定义的类时可以提高易读性。
Q1y~Is0 Xeyo@J6l9 4. 对于构造器参数匹配,类型名比序号好。
JY|Dn\6K> w I6_7; 当一个构造器含有一个以上的同种类型的参数,或者属性值的标签已经被占用时,Spring允许你使用从0计数的序号来解决这些会带来混淆的问题。例如:
8EU1Eu w=|^hESF <bean id="billingService"
sqEPH[}X) class="com.lizjason.spring.BillingService">
Djf ,[ <constructor-arg index="0" value="lizjason"/>
Ua"%$K\ <constructor-arg index="1" value="100"/>
_CIv Q] </bean>
=i'Gb_8k. 1l&'{ncD|i 5Q+Q*e[_% nbX(%88jQ 像下面这样,利用类型属性来编写会更好一些:
+(x 2M `S&t%;n8+ <bean id="billingService"
;[ErcYbw class="com.lizjason.spring.BillingService">
'E>2&5 <constructor-arg type="java.lang.String"
2 2<z72%t5 value="lizjason"/>
GLnjbpCp. <constructor-arg type="int" value="100"/>
1&cR5+]V </bean>
?2QvD~ 4+^Gz$QG _nkss J 3Lu26{v 使用索引可以稍稍减少一些冗长,但是和使用类型属性相比,它还是有容易发生错误的倾向和难于阅读的缺点。你应该只在构造器参数不明确的时候,才使用索引这一方法。
$g9Cu&Ap pH|h)% Cw 5. 尽可能重用已定义过的bean
mmx8 4z5R 1:j6Ld$P Spring 提供一种类似继承一样的机制来减少配置信息的复制并简化XML配置。定义一个子类可以从它父类那里继承配置信息,而父类实质上作为子类的一个模板。这就是大工程中所谓的重用。你所需要做的就是在父类bean中设置abstract=true,然后在子bean注明它自己的父类bean。例如:
k%6pSa, @-H/eHsR= <bean id="abstractService" abstract="true"
tT|#[~Gj class="com.lizjason.spring.AbstractService">
NWIEg4v( <property name="companyName"
}, +8N value="lizjason"/>
sx@%3w3 </bean>
RL~Q#V7f *GAj#3 <bean id="shippingService"
bMD7>{L parent="abstractService"
2cNDX>mT@ class="com.lizjason.spring.ShippingService">
H> ;P <property name="shippedBy" value="lizjason"/>
MjZ[ ;G </bean>
XmZExdq^ ` /'+>>6 4g`_S. { /u`Hn jq_'kdFG ShippingService类从abstractService类那里继承companyName属性的值??lizjason。如果你没有为一个bean指明类或factory方法,那么这个bean便是抽象的。
x?Rn>lR\ !i25I<f 6. 尽量使用ApplicationContext来装配定义的bean
W*%'@ llm0t 像在Ant脚本中的引用一样,Spring的引用对于装配模块化的bean来说是很有用的。例如:
GeG(*!5 k^:Kk%]b <beans>
@#m{{T*8/ <import resource="billingServices.xml"/>
RNVtj1"=# <import resource="shippingServices.xml"/>
] *#^h\ <bean id="orderService"
k<# TS%N class="com.lizjason.spring.OrderService"/>
QSsE/ <beans>
2y(E #y 2U`yA&} `et5Hxhe mu/Z,;Yv$ 相对于使用import在XML配置中来预装配,通过ApplicationContext来配置这些beans,显得更加灵活。利用 ApplicationContext也使得XML配置易于管理。你可以像下面的例子那样在ApplictionContext构造器里布置bean:
H4G>h ! ?W:s]?P String[] serviceResources =
|O"E'/rE {"orderServices.xml",
6={"RxIkL "billingServices.xml",
Y>B&8b, "shippingServices.xml"};
[v Z>itk> ApplicationContext orderServiceContext = new
<YN4[*, - ClassPathXmlApplicationContext(serviceResources);
7iQMW R1h sST`S7(r (}dn <W JnpzX`C 7. 利用id作为bean的标识符
Ca]:!> U-3iT: 你可以指定一个id或名称来作为bean的标识符。虽然使用id不会提高易读性,但是它可以让XML parser对bean的引用有效方面进行更好的验证。如果由于XML IDREF的限制而不能使用某个id,你可以利用names来作为bean的标识符。XML IDREF的限制是id必须以字母开头(或者在XML规范中定义的标点符号),后面接着字母,数字,连字号,下划线,冒号等。实际上,遇到XML IDREF限制的问题是很少见的。
nQt2Y;)y |vv( x( 8. 在开发阶段使用依赖检验
qZ8ODWjcY S5 _R@O 你可以在bean中给依赖检验的属性设置值,而不采用原先默认的空值,属性设置例如simple,object或all,以便容器进行依赖检验。当bean的全部的属性(或某类属性)需要被明确设置或自动绑定时,依赖检验便显得很有用。
gn,.K8uw XcP{][ <bean id="orderService"
XD -}M"?m class="com.lizjason.spring.OrderService"
M4vbz [U dependency-check="objects">
"b>'BU~L <property name="companyName"
yqzC)C)LD[ value="lizjason"/>
-rq1]Rn <constructor-arg ref="orderDAO"/>
IxY?yt~Y </bean>
MFFJ@7W&E @\ecv$)<4t #>c_V = 4=Ogn% 在这个例子里,容器确保为orderService bean设置的属性不是primitives 或者 collections。为所有的bean设置默认依赖检测也是可以的,但是我们很少这样做,是因为有些bean的属性根本就不必设置。
: #Bvx8- }VRFum>a8$ 9. 为每个配置文件加上一个header comment
@n:VY3U?R ' CdaFr1 最好使用descriptive id和名称来代替在XML配置文件中的注释。此外,加上一个配置文件header也很有用处,它可以概述文件中所定义的bean。你可以选择将描述内容加入description标签中。例如:
{|7i-<D [kpfa\ 4 <beans>
<M u?lG <description>
; HM=Z4jd This file defines billing service
fH[Jf rm related beans and it depends on
=(xCi9mg baseServices.xml,which provides
83U}.5 service bean templates...
g /o[a </description>
4ujK|.>0dD ...
S\Cj4M+ </beans>
4U]up zr.5 l|(e}<E ]TdZe=a2~ 使用description标签的一个好处是可以容易地利用工具从标签中选取出description(的内容)。
3 +B4n Xz,+|@ [ 10. 对于任何变化,要与队友积极交流
aw6(n" 当你重构Java代码时,你需要随时更新配置文件并且通知队友。XML配置文件也是代码,它们是应用程序的至关重要的部分,但是它们难于阅读和维护。大部分时间你既要阅读XML配置文件又要阅读运行中的Java代码。
6{"xZRwm /G]7G.h] 11. Setter injection优于constructor injection
(Uz5Fo` ^9/o%@ ' Spring提供3种类型的依赖注入: constructor injection,setter injection, 和method injection。我们一般只用前两种类型。
BZ098i%w -k5r@b|p <bean id="orderService"
t +|Ffj class="com.lizjason.spring.OrderService">
tPg^Z)Gp* <constructor-arg ref="orderDAO"/>
0G}$1!Cz </bean>
Qv(_nR_Z T>>+jE?{ <bean id="billingService"
PP]YoV'g class="com.lizjason.spring.BillingService">
b~,eb)[ <property name="billingDAO"
'L<a<RhR! ref="billingDAO">
m'i*lq. </bean>
V$CrR#>@9 L]7*o s {yro Q 1 D^/ 这个例子中,orderService类使用的是constructor injection,而BillingService类使用的是setter injection。constructor injection可以确保bean不会在一个非法状态下被创建,但是setter injection更加灵活并且更易管理,尤其当类存在很多属性并且其中一些是可选的情况下。
]h nEx Td[V70># 12. 不要滥用依赖注入
""n3)X[C w&oB ;9;v 作为最后一点,Spring ApplicationContext可以替你创建Java对象,但是并不是所有的Java对象都通过依赖注入来创建的。例如,全局的对象不应该通过 ApplicationContext来创建。Spring是一个很棒的框架,但是,就易读性和易管理性而言,当定义大量bean的时候,基于XML的配置问题就会突出。过度的依赖注入会使XML配置变得复杂而且臃肿。记住!使用强大的IDE时,例如Eclipse和IntelliJ,与XML文件相比, Java代码更加易读,易维护,易管理。
BU$C4** [\S^V<2&%g 总结
kWH gF". 对于Spring的配置,XML是很优秀的方式。但当定义大量 bean时,基于XML配置会变得冗长,笨拙。Spring提供了丰富的配置选项。适当地利用其中的选项可以使XML配置清晰,但是,有些选项,例如 autowiring(自动绑定),往往会降低易读性和易维护性。文章中所列举的实例,可以帮助你创建出清晰易读的XML配置文件。