在Resin3下配置SpringSide的HelloWorld示例程序碰到的问题和解决方法（说白了还是resin3.0解析xml问题）

因为想体验一把Spring2.0基于aop名称空间的AOP和Hibernate3.2比EJB3.0的JPA还要细致强大的annotation等等新特征，特地跑到SpringSide（一个基于Spring核心的强大而优雅的企业快速开发框架）去下载了完整的开发包。记得要先照它介绍的方式运行起来，只要双击个.bat文件程序，数据库（HSQLDB），服务器(Tomcat5.5)就全部署好了,范例就已经跑起来了，非常吸引人。但是我一般用的是Resin3 ,所以我打算停了Tomcat跑起我的Resin,这时候一向听话的Resin居然开始撒娇了。

配好路径启动Resin，调试信息如下：

1

Resin-3.0.19 (built Mon, 15 May 2006 04:50:47 PDT)
2

Copyright(c) 1998-2006 Caucho Technology. All rights reserved.
3


4

Using Resin(R) Open Source under the GNU Public License (GPL).
5


6

See http://www.caucho.com for information on Resin Professional,
7

including caching, clustering, JNI acceleration, and OpenSSL integration.
8


9

Starting Resin on Wed, 24 Jan 2007 21:25:59 +0800 (CST)
10


11

[21:26:02.375] Server[] starting
12

[21:26:02.375]
13

[21:26:02.375] Windows XP 5.1 x86
14

[21:26:02.375] Java 1.5.0_10-b03, 32, mixed mode, GBK, zh, Sun Microsystems Inc.
15

[21:26:02.375] resin.home = D:/resin-3.0.19
16

[21:26:02.375] server.root = null
17

[21:26:02.375]
18

[21:26:02.484] http listening to *:8080
19

[21:26:02.546] hmux listening to localhost:6802
20

[21:26:02.765] Host[] starting
21

[21:26:03.890] com.caucho.config.LineConfigException: WEB-INF/web.xml:4: bad character fffd
22

[21:26:04.781] WebApp[http://localhost:8080/resin-doc] starting
23

[21:26:04.953] Resin started in 3000ms

注意红色的信息，读取web.xml异常了，我四级都没过的英语也看出来了是字符错误，相信大家也看出来了吧。凭着经验判定是文件编码的问题，用eclipse打开web.xml果然中文部分有乱码。一向都觉得Resin在编码的处理上，特别是中文编码上比Tomcat5要好很多。今天怎么会出现这种奇怪的问题，带着疑问继续往下看吧。我当时想还是先跑起来再说，老老实实的把编码都转一下吧。

告诉大家一个转文件编码最简单的办法，就是把文件用windows自带的记事本程序打开，选择菜单“文件”－“另存为”，然后在另存为的界面把文件类型选择为“所有文件”，编码选择为“UTF-8”，选择目标文件覆盖保存。

转了编码后发现注释中有两个显示不了的字符，反正是注释索性就删掉了。修改后再次启动Resin，果然正常了。但是又出现了更郁闷的问题。部分调试信息如下：

1

2007-01-24 22:44:02,125 ERROR [org.springframework.web.context.ContextLoader] - <Context initialization failed>
2

org.springframework.beans.factory.BeanDefinitionStoreException: Unexpected exception parsing XML document from file [D:/projects/SSHelloWorld/webapp/WEB-INF/classes/spring/applicationContext.xml]; nested exception is java.lang.IllegalArgumentException: Bean name must not be empty
3

Caused by:
4

java.lang.IllegalArgumentException: Bean name must not be empty
5

at org.springframework.util.Assert.hasText(Assert.java:161)
6

at org.springframework.beans.factory.config.RuntimeBeanReference.<init>(RuntimeBeanReference.java:58)
7

at org.springframework.beans.factory.config.RuntimeBeanReference.<init>(RuntimeBeanReference.java:46)
8

at org.springframework.transaction.config.AnnotationDrivenBeanDefinitionParser.parseInternal(AnnotationDrivenBeanDefinitionParser.java:76)
9

at org.springframework.beans.factory.xml.AbstractBeanDefinitionParser.parse(AbstractBeanDefinitionParser.java:56)
10

at org.springframework.beans.factory.xml.NamespaceHandlerSupport.parse(NamespaceHandlerSupport.java:78)
11

at org.springframework.beans.factory.xml.BeanDefinitionParserDelegate.parseCustomElement(BeanDefinitionParserDelegate.java:1147)
12

at org.springframework.beans.factory.xml.BeanDefinitionParserDelegate.parseCustomElement(BeanDefinitionParserDelegate.java:1137)
13

at org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader.parseBeanDefinitions(DefaultBeanDefinitionDocumentReader.java:145)
14

at org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader.registerBeanDefinitions(DefaultBeanDefinitionDocumentReader.java:89)
15

at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.registerBeanDefinitions(XmlBeanDefinitionReader.java:499)
16

at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.doLoadBeanDefinitions(XmlBeanDefinitionReader.java:407)
17

at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.loadBeanDefinitions(XmlBeanDefinitionReader.java:357)
18

at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.loadBeanDefinitions(XmlBeanDefinitionReader.java:334)
19

at org.springframework.beans.factory.support.AbstractBeanDefinitionReader.loadBeanDefinitions(AbstractBeanDefinitionReader.java:126)
20

at org.springframework.beans.factory.support.AbstractBeanDefinitionReader.loadBeanDefinitions(AbstractBeanDefinitionReader.java:142)
21

at org.springframework.web.context.support.XmlWebApplicationContext.loadBeanDefinitions(XmlWebApplicationContext.java:123)
22

at org.springframework.web.context.support.XmlWebApplicationContext.loadBeanDefinitions(XmlWebApplicationContext.java:91)
23

at org.springframework.context.support.AbstractRefreshableApplicationContext.refreshBeanFactory(AbstractRefreshableApplicationContext.java:94)
24

at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:294)
25

at org.springframework.web.context.support.AbstractRefreshableWebApplicationContext.refresh(AbstractRefreshableWebApplicationContext.java:156)
26

at org.springframework.web.context.ContextLoader.createWebApplicationContext(ContextLoader.java:246)
27

at org.springframework.web.context.ContextLoader.initWebApplicationContext(ContextLoader.java:184)
28

at org.springframework.web.context.ContextLoaderListener.contextInitialized(ContextLoaderListener.java:49)
29

at com.caucho.server.webapp.Application.start(Application.java:1597)
30

at com.caucho.server.deploy.DeployController.startImpl(DeployController.java:621)
31

at com.caucho.server.deploy.StartAutoRedeployAutoStrategy.startOnInit(StartAutoRedeployAutoStrategy.java:72)
32

at com.caucho.server.deploy.DeployController.startOnInit(DeployController.java:509)
33

at com.caucho.server.deploy.DeployContainer.start(DeployContainer.java:158)
34

at com.caucho.server.webapp.ApplicationContainer.start(ApplicationContainer.java:652)
35

at com.caucho.server.host.Host.start(Host.java:385)
36

at com.caucho.server.deploy.DeployController.startImpl(DeployController.java:621)
37

at com.caucho.server.deploy.StartAutoRedeployAutoStrategy.startOnInit(StartAutoRedeployAutoStrategy.java:72)
38

at com.caucho.server.deploy.DeployController.startOnInit(DeployController.java:509)
39

at com.caucho.server.deploy.DeployContainer.start(DeployContainer.java:158)
40

at com.caucho.server.host.HostContainer.start(HostContainer.java:501)
41

at com.caucho.server.resin.ServletServer.start(ServletServer.java:977)
42

at com.caucho.server.deploy.DeployController.startImpl(DeployController.java:621)
43

at com.caucho.server.deploy.AbstractDeployControllerStrategy.start(AbstractDeployControllerStrategy.java:56)
44

at com.caucho.server.deploy.DeployController.start(DeployController.java:517)
45

at com.caucho.server.resin.ResinServer.start(ResinServer.java:485)
46

at com.caucho.server.resin.Resin.init(Resin.java)
47

at com.caucho.server.resin.Resin.main(Resin.java:624)

一看错误是Bean name must not be empty，bean的名字不能为空？为什么啊，没听说过啊，不管是Spring的官方文档，范例还是看的书上教授的都没有听说这么一回事情啊。没天理啊，运行个HelloWorld也这么费力。。。马上抱起错误就去找Google，居然搜不到。。。（正因为GOOGLE搜索不到相关的解决，所以我特地写了这篇文章与大家分享）不会吧，难道大家都没碰到过，我的人品问题？Google也没办法找到的问题，我只好翻找Spring的源代码。查看org.springframework.util.Assert.hasText类，原来抛出java.lang.IllegalArgumentException异常不是按字面意思理解的bean名字不能为空，先汗自己！不过在这个类里面也没找到具体的原因。难道还要继续往前翻找源代码？虽然看大师们的作品是种享受，但是注定我运行HelloWorld就搞成这样？并且查源代码也不是一时能找的出问题的。

停止服务，启动服务，停止服务，启动服务。。。反复的反复，问题依然。换回Tomcat去，一切正常。。。彻底崩溃，难道resin上跑不起Spring?Spring容器可是JAVA原生的动态代理方式实现，完全应该具备JAVA的“一次编写到处运行”。我看到的文档和书籍也无一不盛赞它的Web服务器，应用服务器无关。我想一定是哪里配置有问题，我又把每个xml配置文件都翻了个遍，依然找不出问题。

我突然想起曾经看过的一篇关于JAVA XML的文章，好像JAVA默认的XML解析用的是Crimson，不如另一个XML解析实现Xerces ,莫非是Resin用的解析不行？抱着死马当活马医的态度配上了xerces。

配置xerces方法如下：
1．在VM级
首先在CLASSPATH下放置xerces相关的包，然后在JRE/lib/目录下建一个jaxp.properties的文件，用来声名替换解析器，jaxp.properties内容如下：

1

javax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl
2

javax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl

注意：必须建立此文件显示声明，如果只是引入了xerces的相关包，由于JDK的Class Loader的优先级关系，还是会很顽固的使用Crimson。

2．在web服务器级（Resin3.0.19为例）
把xerces相关包放入容器的CLASSPATH中（Resin主目录下的lib目录），然后在配置文件resin.conf（Resin主目录下的conf目录中resin.conf文件）中的server节点中加入如下XML代码：

1

<system-property javax.xml.parsers.DocumentBuilderFactory="org.apache.xerces.jaxp.DocumentBuilderFactoryImpl"/>
2

<system-property javax.xml.parsers.SAXParserFactory="org.apache.xerces.jaxp.SAXParserFactoryImpl"/>

声明调用xerces实现XML解析。

JAVA XML相关内容推荐参阅：
http://www-900.ibm.com/developerWorks/cn/xml/x-injava/index.shtml

http://www-900.ibm.com/developerWorks/cn/xml/x-injava2/index.shtml

http://www-900.ibm.com/developerWorks/cn/xml/x-databdopt/part2/index.shtml

http://www-900.ibm.com/developerWorks/cn/xml/x-databdopt/part1/index.shtml

我在Resin中配置好xerces后，启动。WebApplicationContext初始化正常，Struts初始化正常，一切正常，终于看到了界面。

然后我又想刚才web.xml中的错误会不会也是因为没有用xerces的原因，把原来没修改的web.xml又拷了一个过来，启动依然报同样的错，仔细再看文件里面确实在最开始的注释中有两个错误的字符，不知道SpringSide的大侠们是故意的还是不小心弄错了。。。删除错误字符启动，成功！

总结如下：
1． web.xml中是以为确实存在错误的字符导致web容器无法初始化，修改文件后就正常了。
2． Resin读取Spring的配置文件必须显示采用xerces，否则无法初始化Spring容器。建议配置服务器级的xerces。
3． 平时开发和学习过程中应广泛涉猎，拓宽知识面。碰到问题大胆假设，联想，细心调试。最后再纠根问底，彻查明白。
4． 遇到问题不轻易放弃，多思考，多总结，多记录。