去年用Jersey写了一个RESTful Web services,原来跑在Tomcat8上, 昨天把项目转到Glassfish4.1上, 总结一下工作的点
1.安装Glassfish4.1.1
从https://glassfish.java.net/下载, 完成后解压缩到/opt/下, unzip解完的目录为glassfish4
2.Glassfish中基础知识
bin/asadmin 打开管理终端, 以下命令都是在asadmin>下运行
2.1 start-domain 启动glassfish/domains/下的域, 也可以在命令的后面指定域, 默认启动domains下自代的域:domain1
2.2 delete-domain domain1 删除指定的域
2.3 stop-domain 关闭域,也可以指定域
2.4 list-domains 查看服务器上的所有domain
2.5 glassfish的管理后台地址:location:4848, 默认的用户名:admin, 密码为空,可以用change-admin-password 修改管理用户的密码
3.安装mysql
3.1 需要先把mysql.x.jar文件先移到(/opt/glassfish4)安装目录下的glassfish/domains/domain1(域)/lib/ext/目录下
3.2 glassfish v4.1.1到现在无法在管理后台中添加JDBC Resources 和 JDBC Connection Pools, 需要在Resources中添加资源描述(xml)文件,
先添加:JDBC Connection Pool, 因为JDBC Resources会引用(JDBC Connection Pool)中的name值
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE resources PUBLIC "-//GlassFish.org//DTD GlassFish Application Server 3.1 Resource Definitions//EN" "http://glassfish.org/dtds/glassfish-resources_1_5.dtd">
<resources>
<jdbc-connection-pool connection-validation-method="auto-commit" datasource-classname="com.mysql.jdbc.jdbc2.optional.MysqlDataSource" wrap-jdbc-objects="false" res-type="javax.sql.DataSource" name="连接池的名字,例:MysqlPool">
<property name="serverName" value="localhost"/>
<property name="portNumber" value="3306"/>
<property name="databaseName" value="数据库名称"/>
<property name="User" value="用户名"/>
<property name="Password" value="密码"/>
<property name="URL" value="jdbc:mysql://localhost:3306/数据库名称?zeroDateTimeBehavior=convertToNull"/>
<property name="driverClass" value="com.mysql.jdbc.Driver"/>
</jdbc-connection-pool>
</resources>
xml文件中的中文: mysql数据库和访问此数据库的用户名和密码, 接下来添加(JDBC Resources)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE resources PUBLIC "-//GlassFish.org//DTD GlassFish Application Server 3.1 Resource Definitions//EN" "http://glassfish.org/dtds/glassfish-resources_1_5.dtd">
<resources>
<jdbc-resource pool-name="连接池的名称,例:MysqlPool" jndi-name="JNDI名称,例:jdbc/iqido"></jdbc-resource>
</resources>
3.3 java 代码中的 jndi
Tomcat中的连接池定义在conf/context.xml中
<Context useHttpOnly="true">
<!-- Default set of monitored resources -->
<WatchedResource>WEB-INF/web.xml</WatchedResource>
<Resource name="jdbc/iqido" auth="Container" type="javax.sql.DataSource" maxActive="100" maxIdle="30" maxWait="10000" username="用户名" password="密码" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/数据库名称" />
</Context>
在java代码中用:java:/comp/env/jdbc/iqido访问此资源, 但在glassfish4.1.1中要使用(JDBC Resources)中定义的jndi-name属性值, 例:jdbc/iqido
一般此类配置参数都定义在一个外部资源文件中, 所有只需要注意即可
4.热布署应用
tomcat对热布署支持不够全面, 有些配置变更后需要重启, 而glassfish这类EE应用服务器作的都比较好
把原来的项目打为一个war包, 在管理后台中的(Applications) 页面中点(Deploy)进行热布署.
如果布署失败, 并且有用HK2可以试试把: Implicit CDI 取消, 默认是选中的
4.1 Context Root: 如果希望此项目为默认应用, 此处可以输入( / )
4.2 Virtual Servers: 可以绑定到指定的Server, 也可以在Virtual Servers中的server中设置某应用为默认应用
4.3 Tomcat中的默认应用
<Engine name="Catalina" defaultHost="localhost">
<Host name="localhost" appBase="webapps"
unpackWARs="true" autoDeploy="true">
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
<Context path="" docBase="client" reloadable="true" useHttpOnly="true"/>
</Host>
</Engine>
5.其它的设置
5.1 NIO传输模式,Tomcat也支持, 但不是默认模式, 要启用也容易, 在conf/server.xml中
<Connector
port="80" protocol="org.apache.coyote.http11.Http11NioProtocol"
connectionTimeout="20000"
redirectPort="443"
compression="on"
compressionMinSize="2048" URIEncoding="UTF-8"
noCompressionUserAgents="gozilla,traviata" compressableMimeType="text/html,text/xml,application/javascript,text/css,text/plain,text/json,application/json"/>
<Connector
port="8009" protocol="org.apache.coyote.ajp.AjpNioProtocol" redirectPort="443" />
Glassfish
Configurations > server-config > Network Config > Transports >tcp 默认为:
org.glassfish.grizzly.nio.transport.TCPNIOTransport
5.2 响应压缩
Tomcat
在5.1小节中Connector中可以看到是如何设置
Glassfish
Configurations > server-config > Network Config > Network Listeners >http-listener-1 页面中的 Http标签页
5.3 整理jar包
<安装目录>glassfish/modules/下已经有了jersey服务端项目需要的大多数jar包, 但v4.1.1不存在以下包, 需要把它们放到项目的类路径上
cglib-2.2.0-b21.jar
commons-codec-1.10.jar
eclipselink.jar
javax.annotation-api-1.2.jar
jaxb-api-2.2.7.jar
org.osgi.core-4.2.0.jar
persistence-api-1.0.jar
validation-api-1.1.0.Final.jar
为什么是这几个? 我用:jersey服务端 所有jar包跟glassfish/modules下的jar包作了对比
5.4 异常:
A: javax.servlet.ServletException: org.glassfish.jersey.server.ContainerException: java.lang.NoClassDefFoundError: org/xml/sax/helpers/DefaultHandler
如果用restclient访问资源可能会出现500错误, 查看domain1/logs/server.log会出现以下异常
org.glassfish.jersey.server.internal.process.MappableException: java.lang.NoClassDefFoundError: org/xml/sax/helpers/DefaultHandler
at org.glassfish.jersey.server.ServerRuntime$Responder.writeResponse(ServerRuntime.java:716)
at org.glassfish.jersey.server.ServerRuntime$Responder.processResponse(ServerRuntime.java:424)
at org.glassfish.jersey.server.ServerRuntime$Responder.process(ServerRuntime.java:414)
at org.glassfish.jersey.server.ServerRuntime$2.run(ServerRuntime.java:312)
at org.glassfish.jersey.internal.Errors$1.call(Errors.java:271)
at org.glassfish.jersey.internal.Errors$1.call(Errors.java:267)
at org.glassfish.jersey.internal.Errors.process(Errors.java:315)
at org.glassfish.jersey.internal.Errors.process(Errors.java:297)
at org.glassfish.jersey.internal.Errors.process(Errors.java:267)
at org.glassfish.jersey.process.internal.RequestScope.runInScope(RequestScope.java:317)
at org.glassfish.jersey.server.ServerRuntime.process(ServerRuntime.java:292)
at org.glassfish.jersey.server.ApplicationHandler.handle(ApplicationHandler.java:1139)
at org.glassfish.jersey.servlet.WebComponent.service(WebComponent.java:460)
at org.glassfish.jersey.servlet.ServletContainer.service(ServletContainer.java:386)
at org.glassfish.jersey.servlet.ServletContainer.service(ServletContainer.java:334)
at org.glassfish.jersey.servlet.ServletContainer.service(ServletContainer.java:221)
at org.apache.catalina.core.StandardWrapper.service(StandardWrapper.java:1682)
at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:318)
at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:160)
at org.apache.catalina.core.StandardPipeline.doInvoke(StandardPipeline.java:734)
at org.apache.catalina.core.StandardPipeline.invoke(StandardPipeline.java:673)
at com.sun.enterprise.web.WebPipeline.invoke(WebPipeline.java:99)
at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:174)
at org.apache.catalina.connector.CoyoteAdapter.doService(CoyoteAdapter.java:416)
at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:283)
at com.sun.enterprise.v3.services.impl.ContainerMapper$HttpHandlerCallable.call(ContainerMapper.java:459)
at com.sun.enterprise.v3.services.impl.ContainerMapper.service(ContainerMapper.java:167)
at org.glassfish.grizzly.http.server.HttpHandler.runService(HttpHandler.java:206)
at org.glassfish.grizzly.http.server.HttpHandler.doHandle(HttpHandler.java:180)
at org.glassfish.grizzly.http.server.HttpServerFilter.handleRead(HttpServerFilter.java:235)
at org.glassfish.grizzly.filterchain.ExecutorResolver$9.execute(ExecutorResolver.java:119)
at org.glassfish.grizzly.filterchain.DefaultFilterChain.executeFilter(DefaultFilterChain.java:283)
at org.glassfish.grizzly.filterchain.DefaultFilterChain.executeChainPart(DefaultFilterChain.java:200)
at org.glassfish.grizzly.filterchain.DefaultFilterChain.execute(DefaultFilterChain.java:132)
at org.glassfish.grizzly.filterchain.DefaultFilterChain.process(DefaultFilterChain.java:111)
at org.glassfish.grizzly.ProcessorExecutor.execute(ProcessorExecutor.java:77)
at org.glassfish.grizzly.nio.transport.TCPNIOTransport.fireIOEvent(TCPNIOTransport.java:536)
at org.glassfish.grizzly.strategies.AbstractIOStrategy.fireIOEvent(AbstractIOStrategy.java:112)
at org.glassfish.grizzly.strategies.WorkerThreadIOStrategy.run0(WorkerThreadIOStrategy.java:117)
at org.glassfish.grizzly.strategies.WorkerThreadIOStrategy.access$100(WorkerThreadIOStrategy.java:56)
at org.glassfish.grizzly.strategies.WorkerThreadIOStrategy$WorkerThreadRunnable.run(WorkerThreadIOStrategy.java:137)
at org.glassfish.grizzly.threadpool.AbstractThreadPool$Worker.doWork(AbstractThreadPool.java:591)
at org.glassfish.grizzly.threadpool.AbstractThreadPool$Worker.run(AbstractThreadPool.java:571)
at java.lang.Thread.run(Thread.java:745)
Caused by: java.lang.NoClassDefFoundError: org/xml/sax/helpers/DefaultHandler
at org.eclipse.persistence.jaxb.BeanValidationHelper.<clinit>(BeanValidationHelper.java:53)
at org.eclipse.persistence.jaxb.JAXBBeanValidator.isConstrainedObject(JAXBBeanValidator.java:257)
at org.eclipse.persistence.jaxb.JAXBBeanValidator.shouldValidate(JAXBBeanValidator.java:208)
at org.eclipse.persistence.jaxb.JAXBMarshaller.validateAndTransformIfNeeded(JAXBMarshaller.java:587)
at org.eclipse.persistence.jaxb.JAXBMarshaller.marshal(JAXBMarshaller.java:481)
at org.eclipse.persistence.jaxb.rs.MOXyJsonProvider.writeTo(MOXyJsonProvider.java:949)
at org.glassfish.jersey.message.internal.WriterInterceptorExecutor$TerminalWriterInterceptor.invokeWriteTo(WriterInterceptorExecutor.java:265)
at org.glassfish.jersey.message.internal.WriterInterceptorExecutor$TerminalWriterInterceptor.aroundWriteTo(WriterInterceptorExecutor.java:250)
at org.glassfish.jersey.message.internal.WriterInterceptorExecutor.proceed(WriterInterceptorExecutor.java:162)
at org.glassfish.jersey.server.internal.JsonWithPaddingInterceptor.aroundWriteTo(JsonWithPaddingInterceptor.java:106)
at org.glassfish.jersey.message.internal.WriterInterceptorExecutor.proceed(WriterInterceptorExecutor.java:162)
at org.glassfish.jersey.server.internal.MappableExceptionWrapperInterceptor.aroundWriteTo(MappableExceptionWrapperInterceptor.java:86)
at org.glassfish.jersey.message.internal.WriterInterceptorExecutor.proceed(WriterInterceptorExecutor.java:162)
at org.glassfish.jersey.message.internal.MessageBodyFactory.writeTo(MessageBodyFactory.java:1130)
at org.glassfish.jersey.server.ServerRuntime$Responder.writeResponse(ServerRuntime.java:683)
... 43 more
Caused by: java.lang.ClassNotFoundException: org.xml.sax.helpers.DefaultHandler not found by org.eclipse.persistence.moxy [221]
at org.apache.felix.framework.BundleWiringImpl.findClassOrResourceByDelegation(BundleWiringImpl.java:1532)
at org.apache.felix.framework.BundleWiringImpl.access$400(BundleWiringImpl.java:75)
at org.apache.felix.framework.BundleWiringImpl$BundleClassLoader.loadClass(BundleWiringImpl.java:1955)
at java.lang.ClassLoader.loadClass(ClassLoader.java:358)
... 58 more]]
这种情况下用rest客户端访问, 我试过是没问题的, 并且在浏览器中访问也是不会产生异常的. 但一定要保证applicationPath/application.wadl显示正常
B: GLASSFISH-21440:
java.lang.ClassNotFoundException: org.xml.sax.helpers.DefaultHandler not found by org.eclipse.persistence.moxy[72]