Resin的基本使用

使用Resin开发Java   Web项目时，需要建立自己的WebApp。这里不介绍Resin   Cmp/Ejb的开发和使用，只介绍用    
   
  Resin开发普通的jspjava   servlet项目。在这里还要谈到resin.conf的配置。Resin中的应用可以有2种方式    
   
  发布：一是在Resin的目录下发布；二是打包成War发布。    
   
  1、在Resin的目录下发布    
   
  在resin.conf中查找<web-app>标签，该标签表示一个web应用。    
   
  标签中，id属性表示该应用的Web路径。如<web-app   id='/test'>，表示该应用在Web上访问的时候应该用    
   
  http://hostname/test/来访问。app-dir属性表示该应用的实际路径。如    
   
  <app-dir>d:   esindoc   est</app-dir>表示该应用在d:   esindoc   est目录下面。默认值为根下面的和id    
   
  同名的目录。Resin可以配置3种error-page：404错误也就是文件找不到错误页；Exception违例页；不能连接    
   
  java引擎页。他们分别可以这样子设置。    
   
  404文件找不到页    
   

  <web-app   id='/app1'>     
  <error-page   error-code='404'   location='/file_not_found.jsp'/>     
  </web-app>     
    
  Exception   违例页     
    
  <web-app   id='/foo'>     
  <error-page   exception-type='java.lang.NullPointerException'     
  location='/nullpointer.jsp'/>     
  </web-app>  

  
   
  不能连接到srun   Servlet引擎错误页    
   
  该页设置和应用无关，属于服务器的设置。    
   

  <http-server>     
  <error-page   exception-type='connection'     
  location='/missing_file.html'/>     
  </http-server>     
    

  classpath的设置    
   
  参见下面的语句：    

    
  <classpath   id='WEB-INF/classes'   source='WEB-INF/src'   compile='true'/>   

 
   
  id参数的值表示classpath中编译后的class的存放路径；source参数的值表示classpath中java源代码的存放    
   
  路径；compile中的值可能是true或者false，表示是否由Resin的srun自动编译java源代码。Classpath的设置    
   
  一般和javaBean或者Servlet的使用有关。id的值表示javaBean的编译好的包存放的根，source的值表示    
   
  javaBean的java源代码存放的根。Servlet相同。    
   
  Servlet的设置    
   
  参见下面的语句：    
   

  <servlet-mapping   url-pattern='*.xtp'   servlet-name='xtp'/>     
  <servlet-mapping   url-pattern='*.jsp'   servlet-name='jsp'/>     
  <servlet-mapping   url-pattern='/servlet/*'   servlet-name='invoker'/>     

   
  一般就是指定那些需要通过srun的解析。比如在这里，把*.jsp改成*.jss，其他不变，那么只要在访问时遇到    
   
  *.jss的文件就和原来遇到*.jsp一样处理。通过这个可以指定解析的引擎，如以下的配置：    
   

  <servlet-mapping   url-pattern='*.xtp'   servlet-name='com.caucho.jsp.XtpServlet'/>     
    
  在Servlet中，也可以指定servlet。如     
    
  <servlet   servlet-name='hello'   servlet-class='test.HelloWorld'/>     
  <servlet-mapping   url-pattern='/hello.html'   servlet-name='hello'/>   

 
   
  在servlet-mapping中有个重要的参数case-sensitive   如果在windows上，最好配置成false，忽略大小写，从    
   
  而和windows的约定一致。    
   
  Session的配置    
   
  参见如下的配置语句：    
   

  <session-config>     
  <session-max>4096</session-max>     
  <session-timeout>30</session-timeout>     
  <enable-cookies>true</enable-cookies>     
  <enable-url-rewriting>true</enable-url-rewriting>     
  <file-store>WEB-INF/sessions</file-store>     
  </session-config>     

   
  session-max   ：最大   session数量    
  session-timeout   ：session过期时间，以分钟为单位。    
   
  是否允许cookie   ：指session是否采用cookies。如果采用cookies，浏览器必须支持session才能使用，发布    
   
  时建议改成false。enable-url-rewriting和enable-cookies一般配合使用。如果enable-cookies是false，    
   
  enable-url-rewriting应该设成true比较合适。    
   
  file-store   ：该配置指示服务器是否把session作为文件存放在服务器上。如果把该项注释掉，则在你的    
   
  web-app目录下的WEB-Inf/sessions目录不保存序列化后的session对象。Session还有jdbc-store配置，对应    
   
  着把session通过jdbc永久保存在数据库中。其实也就是会话变量的序列化后的保存和重新载入的物理实现。    
  在这里session还支持了多服务器的设置问题，    
   
  通过tcp-store参数设置。由于涉及到负载平衡的问题，在这里不详细叙述，只简单写一个例子：    
   

  <http-server>     
    
  <http   id='a'   port='80'/>     
  <srun   id='a'   host='host-a'   port='6802'/>     
    
  <http   id='b'   port='80'/>     
  <srun   id='b'   host='host-b'   port='6802'/>     
    
  <host   id=''>     
  <web-app   id=''>     
    
  <session-config>     
  <tcp-store/>     
  <always-load-session/>     
  </session-config>     
  </web-app>     
  </host>     
    
  </http-server>     
    

  这个例子表示session是按照tcp   ring的方式传递。    
   
  temp-dir   的设置    
   
  temp-dir指的是应用的临时目录。也就是在javax.servlet.context.tempdir中用到的目录。模认是应用目录    
   
  下的WEB-INF   mp目录。    
   
  以上的设置都可以在<web-app>标签对中设置，控制某个web应用的设置。    
2、打包成War发布    
   
  以下是介绍对如何在resin下使用已经打包成War的java   Web应用进行发布。    
   
  其实这个是最简单也是最清晰的良好方法。在j2ee中，所有的项目都打包成ear发布。其中，Web应用打包成    
   
  war，ejb应用打包成jar。在resin中，这些都可以直接部署。这里我只对打包成war的Web应用的部署做介绍。    
   
  在resin.conf中，查找这个：<war-dir   id='webapps'/>。他表示war文件应该被拷贝的路径。这里指的是相对    
   
  于resin的安装路径，如以上的设置表示d:   esinwebapps。只要重新启动Resin就可以了。Resin会把该war自    
   
  动解包到webapps目录下。你可以在command控制台或者stdout.log中看到类似于    
   
  [2002-04-27   09:56:21.680]   initializing   application   http://haitaiserver:8080/rwtest   的语句。这个    
   
  表示该Web应用是自动安装的。只要这个应用是符合j2ee标准的Web应用，应该不会有问题。通过如上显示的路    
   
  径就可以访问到这个应用。如果你到d:   esinwebapps   wtest中浏览，你会看到Resin已经为你生成了rwtest    
   
  目录，下面是META-INF和WEB-INF还有你自己的JSPservlet   文件和目录。是完全符合j2ee的结构的。你可以    
   
  在rwtest目录下建立新的jspservlet，一样可以被编译和解析并运行的。在实际操作中，可以使用Jbuilder      
   
  或者   WebSphere等Ide工具进行集成调试和打包，非常的方便。    
   
  四、使用Resin进行java   Web项目的开发和调试    
   
  这里篇幅有限，不可能讲太多，我只对实际中最有用的部分做介绍。    
   
  Resin中如果定义了错误页，则出错后最常见的一大串Exception不会被看到，直接跳转到错误页。所以建议开    
   
  发中先不设置错误页。jsp错误中最常见的就是Nullpoint   Exception，其次是名称的拼写错误。错误也可以在    
   
  Resin安装目录下的log目录下的stderr.log中找到。通过对该log文件的分析可以看到很多有用的错误信息。    
   
  在调试jsp的时候，如果定义了compile为true，jsp先被翻译成Servlet的java文件，再被编译成class文件。    
   
  可以在你自己的work目录中找到该文件。java的名称在Resin中是这样子定义的：原先的jsp文件名前加下划线    
   
  ，再加上_jsp这个字样。所以在java   应用中的命名不要以_jsp结尾，也不要出现中文名称等字符；其实名称    
   
  以_jsp为开头也是不合法的。    
   
  关于java对多国语言的支持问题，在Resin中得到了很好的解决。以jsp为例，参考Resin自动生成的java      
   
  Servlet文件。只要在任何的jsp文件的最开始处增加：    
   

  <%   @page   contentType="text/html;charset=gb2312"   %> 

   
   
  中文问题就解决了。察看生成的Servlet源文件片断：    
   

 response.setContentType("text/html;charset=gb2312");     
  request.setCharacterEncoding("GB2312");  

  
   
  以上为设置字符集    

   
  private   static   byte[]   _jsp_string26;     
  private   static   byte[]   _jsp_string27;     
    
  _jsp_string26   =   "     
  </table>     
  <table   class="type">     
  <tr>     
    <td>".getBytes("GB2312");     
  _jsp_string27   =   "     
  </td><td>     
  </tr>     
  <!--     
  <tr>     
  <td>   ".getBytes("GB2312");     

   
  以上是对页面的显示的编码。其中，getBytes("gb2312")是静态编码，这是Resin为了解决某些环境下还是不    
   
  能正常显示而设置的。在Resin的配置文件(/conf/resin.conf)中，可以通过设置<jsp   precompile='true'      
   
  static-encoding='false'   recompile-on-error='true'/>中的static-encoding属性为true或者false，来控    
   
  制是否静态编码。其实在Resin容器的内部，所有的字符都是按照iso-8859-1来处理的。iso-8859-1是一个大    
   
  字符集，虽然中文的gb2312和8859在字的定义上有不同，但是编码是包容了gb2312的。按照解决多国语言的方    
   
  法，在纯英文平台上用iso-8859-1处理内部编码，而把字符的显示推向客户端的机器。所以这样只要编码是正    
   
  确的，在页面上显示中文就不存在问题。Tomcat3.2不方便的地方是Tomcat对数据库的操作中文支持不好，需    
   
  要手动在java   Bean或者Servlet中硬编码。通过测试，在Resin中完全没有这个问题。Tomcat4.0解决了这个问    
   
  题。不过个人习惯来讲还是觉得resin在配置方面方便一些。    
   
  在Resin中可以自动解决引入的jar。这个在使用特殊的类或者第三方提供的开发包非常有用。方法非常简单：    
   
  只要把该jar或者是zip拷贝到Resin安装目录下的lib目录下面，重新启动Resin，就可以了。如db2用到的    
   
  db2java.zip文件，只要轻松拷贝到d:   esinlib中就可以了。    
   
  Resin提供了对Jbuilder的集成调试。可以到：    
   
  http://www.caucho.com/projects/jbuilder/resin-jbuilder.jar免费下载到resin的jbuilder的ide扩展包。    
   
  然后，把该包该名成：resin-jbuilder.jar，拷贝到jbuilder6libext目录下。然后，把Resin2.1解包安装    
   
  在jbuilder6   esin-2.1目录下，就可以了。打开任何的War项目，在project上点右键，选择properties，选    
   
  择Servers标签。在原来的选择框上，就可以看到多了一项Resin2.1。这样子就可以象原来用tomcat一样调试    
   
  jspservlet了，而且比Tomcat更方便。调试方法和用Tomcat调试一样。    
   
  五、其他问题    
   
  使用Resin可以和apache结合使用。也就是利用apache做http服务器，而Resin做srun服务器。可以参考    
   
  resinconfsamples目录下的apache.conf。主要就是把   app-dir   设成   /usr/local/apache/htdocs（也就是    
   
  apache的root）。同时在apache   中的http.conf也做了相应的设置。Resin还提供了对该过程的自动安装程式    
   
  ，运行resininsetup，你可以在弹处的对话框中选择apache，这样子就可以了。只要你曾经安装过apache    
   
  ，resin可以自己找到httpd.conf文件所在的路径。    
   
  使用命令行方式启动Resin，如果改动了Resin.conf，Resin会自己重新启动适应新的配置。这个很适合初期安    
   
  装时使用。    
   
  Resin对数据库缓冲池的支持很好。在这里，它提供了DBPool对缓冲池做了封装。实际使用时，只要在    
   
  resin.conf这样配置：    
   

  <dbpool.sql>     
    
  　　<id>ORCL</id>     
  　　<driver>oracle.jdbc.driver.OracleDriver</driver>     
  　　<url>jdbc:oracle:thin:@localhost:1521:SMTH</url>     
    
  　　<!--   <url>jdbc:oracle:oci8:@SMTH</url>   -->     
    
  　　<user>scott</user>     
  　　<password>tiger</password>     
    
  　　<max-connections>5</max-connections>     
    
  </dbpool.sql>    

   
  然后，在你的jsp或者servlet中就可以这样子使用了：    
   
  先导入   com.caucho.sql.*包，然后如下直接得到连接：    
   
  Connection   conn   =   DBPool.getPool("ORCL").getConnection();    
   
  个人建议不要如上使用连接池，还是按照ejb的方法用从Context中直接找到的DataSource对象中得到连接通用    
   
  性比较好。代码也很简单：    
   

 Context   ctx   =   new   InitialContext();     
  DataSource   ds   =   (DataSource)ctx.lookup(“jdbc/EmployeeDB”);     
  Connection   conn   =   ds.getConnection();     
    
  在Resin中如下配置jdbc就可以了：     
    
  <resource-ref>     
  <res-ref-name>jdbc/EmployeeDB</res-ref-name>     
  <res-type>javax.sql.DataSource</res-type>     
  <init-param   driver-name="com.caucho.jdbc.mysql.Driver"/>     
  <init-param   url="jdbc:mysql_caucho://localhost:3306/test"/>     
  <init-param   user="name"/>     
  <init-param   password="password"/>     
  <init-param   max-connections="20"/>     
  <init-param   max-idle-time="30"/>     
  </resource-ref>     

   
  用Resin   Web   Server开发还是比较愉快的。只是没有像Weblogic   或者WebSphere那样子提供现成的管理控制台而已。但是从稳定性和方便性来讲，Resin个人认为比Tomcat要好很多。况且Resin还有提供了resin-cmp   和   resin-ejb，功能更强大。