resin指定java版本_resin的几个常用配置

2022-04-12 00:00:00 文件 配置 默认 重启 虚拟主机

本文着重介绍resin的几个常用配置

注:

1. 本文并非resin.conf的使用说明,只是从实用角度出发,按需分析常用的配置。更多的内容到官网学习吧;

2. 基于resin3.x的探讨。

(友情提示:刚下载的resin中,resin.conf里的配置都是包含有注释的——废话!)

Dependency checking

在说这个参数之前,不得不先了解一下resin的“Dependency checking”机制。resin会定时检测和下配置的资源是否改动,如果改动,会根据相应的策略重新启动web-apps和虚拟主机。那么,具体会检测那些资源呢?下面是一个清单:

WEB-INF/classes下的class文件

WEB-INF/lib下的jar文件

中指定的class或jar

WEB-INF/resin-web.xml

WEB-INF/web.xml

resin.conf

引入的配置文件

通过或或配置的.war文件;

通过加入的文件

是否很眼熟?没错!想当年在本地调试web的时候,改一个java文件,总会骂骂咧咧的停掉resin然后重启,甚是麻烦,会抱怨为啥class这么矫情,不能像改个jsp那样立竿见影的看到效果。resin说哥你想法是好的,但就算我有那个热加载的意愿,它jvm也不干那,你去找sun(oracle就不提了)理论去吧。

那只好忍了吧,但是要等多久才会自动加载一次呢?终于出场了。该标签定义了resin多久检测一次上面的那些资源是否变更。这个值是需要加单位的,具体的值定义可以参考Period定义。默认值为2s。

对于取值,resin.conf有这样的一段注释:

For production sites, change dependency-check-interval to something – like 600s, so it only checks for updates every 10 minutes.

就是说这种检测会非常耗时,如果搞resin优化的话,那么就把它设置的长一些吧(比如在生产环境里就设置的长一些)或者干脆设置为-1禁止自动检测变更,即禁止所谓的热部署。

Dependency checking与RHS

这个参数明了了,实践一下吧!于是搞一个测试项目出来,简单配置一下,跑起来之后,象征性的改一下resin.conf,我们将2s改为1s,看终端的滚动日志,咦,为什么没有输出日志?正在纳闷之时,日志来了,说检测到了resin.conf的dependency-check-interval改变了,重启了所有的host。等等,我们之前的检测时间是2s,为什么改动文件后感觉过了很久才重启了resin?

经过多番测试,结论是:“Dependency checking”与resin重启的机制完全是两回事。dependency-check-interval只是告诉resin多久检测一次上下文环境的变化,如果发生变化,先记录下来,负责监控resin的进程会定期检测这个记录,如果发现有新的变更记录,则重启resin。至于重启的机制,属于Resin Health System的范畴,本文暂不讨论。但可以通过这句话简单的验证一下我们的推论:

Because your site’s reliability is important, Resin monitors its internal sensor net every 60 seconds, recording your server’s memory, cpu, network, database and cluster status.

重启机制

如果是全局的配置(例如resin.conf)变更,则会重启整个resin(包括所有的虚拟主机),如果只是某个webapp做了变更(如class、jsp、web.xml等),则只对webapp重启。

需要说明一点的是,在中亦可配置该标签(属性),默认情况下,该属性会继承全局的dependency-check-interval值,但如果设置该值为-1,会发生什么事呢?我想你不会那么做的……

想要class的变更像jsp那样迅捷该怎么办到呢?myeclipse可以办到。eclipse for javaEE的话,还需要一些插件的支持,本文暂不做讨论,参考本文下边关于热部署的推荐文章。

一个server对应于一个jvm实例,为配置在其中的各个虚拟主机提供服务,接收请求并处理。在中可以配置HTTP,集群端口,存活时间,超时时间,线程池以及负载均衡。一个集群(cluster)可以包含多个server,但是id必须不同。server的属性包含有address(ip)和port,如果resin中只有配置这一个单独的server,则可以省略address和port,不过这么搞的话该server就无法作为集群的一部分工作,并且无法用命令行来管理。

常用属性有address和port。即在定义server的时候同时配置address和port。address的默认值是127.0.0.1。

假如由于同一个集群中的多个server配置大同小异,就可以先搞一个通用的server,其他的server会继承通用的server配置,各自的配置又会覆盖继承的配置。就是充当了这个通用的配置,正如其名,就将其中的配置看作是所有server的默认配置即可。像HTTP端口,超时,存活时间,JVM以及线程这些配置可以通过配置实现共享。

下面的一个配置中,定义了JVM的一些参数以及HTTP的通用配置:

list 1-1

也许你会异想天开的问,既然是默认的配置,那不显示配置可以吗?不可以!自己试一下就行了,去掉里面所有显示定义,重启resin你就会看到它的抗议:server-id ” has no matching definition. 并且此时resin会陷入脑残式的无限次重启之中,它也许认为这是个偶然性事件,重启resin以尝试恢复。

从外部的文件读取配置,这个外部文件必须符合一定的规范,否则resin解析不了的。标准就直接参考${RESIN_HOME}/conf/app-default.xml即可。配置全局的默认访问页面,可以修改app-default.xml中的。

http的典型用法是配置在server-default中。因为经常会有这样一个场景:同一个cluster中的所有server监听同一个端口。比如在lsit1-2中,两个server都默认监听80端口。亦可配置在每个单独的server中。

一个server可以服务于多个虚拟主机,每个虚拟主机都可以有自己的servlets以及文档。虚拟主机必须被明确的定义出来,就是说你不能只用(类比)。对于resin来说,创建一个虚拟主机就像创建一个目录,然后再为其设置一个DNS一样容易。一个虚拟主机可以包含一个或者多个web-app。简单的web-app可放置在一个名为“webapps”的目录下,就像Apache服务器上的/htdocs。复杂一点的站点,可以先部署多个webapps,然后将这些web-app放置在这些webapps中。

举例来说,假设有个server同时管理者两个域名:www.gryffindor.com和www.slytherin.com,这两个域名所对应的web-app部署在不同的目录下/var/resin/gryffindor和/var/resin/slytherin,他们共享同一个IP。当用户访问http://www.gryffindor.com/的时候,首先浏览器会发送HTTP请求到共享ip,resin接到请求后,从HTTP请求头中取出Host,根据Host值再将请求转发给相应的虚拟主机。

host重要的属性:

id: resin使用此id来区分不同的请求。若留空则表示该host为默认host,当其他的host无法被匹配的时候便会将请求转发到此host。

root-directory: 指定一个虚拟主机的文件系统的路径,默认的“.”就代表${RESIN_HOME}。参考下面list1-2的例子,可以更深入的理解root-directory的含义。

regexp:用正则表达式匹配域名。

list 1-2

主要的属性是id和root-directory,同host的id类似,web-app的id也是用于匹配url的。root-directory指定项目存放路径,可以使用路径,相对路径则是相对host的root-diirectory而言的。

注意:若使用myeclipse/eclipse创建项目,会有一个项目名(projectName),而此处的root-directory并非项目路径,而是一个特殊的目录,该目录的子目录以及文件必须符合Servlet规范,通常就是eclipse默认创建的WebContent,这个名字可以随便改。btw,这个规范的层级结构主要有三个元素:

/WEB-INF/web.xml

/WEB-INF/classes/

/WEB-INF/lib/

必须包含有上面三个东西。配置文件(*.properties, *.xml等等)需要放在classes下。

举例说明Eclipse中新增一个项目,然后部署resin的方法,假设现在有份配置如下:


list 1-3

下面就简单讲一个本地部署的例子(Eclipse for javaEE,resin3.x)

在Eclipse中新增一个项目,projectName为testResinCfg,根据Servlet规范,自行创建目录,结构如下:

01.testResinCfg

02.testResinCfg/src/

03.testResinCfg/web/

04.testResinCfg/web/META-INF/

05.testResinCfg/web/index.jsp

06.testResinCfg/web/WEB-INF/

07.testResinCfg/web/WEB-INF/classes/

08.testResinCfg/web/WEB-INF/lib/

09.testResinCfg/web/WEB-INF/work/

10.testResinCfg/web/WEB-INF/web.xml

list 1-4

本地调试:

在list1-3所示的默认host中,增加一个:

list 1-5

这样访问:http://localhost:8080/tt,如果是id=abc,那就是http://localhost:8080/abc。

在有dns的情况下:

在默认host之下在配置一个host:

1.

2.

3.

4.root-directory="D:\Program_Files\workplace\cache_study\web" />

5.

list 1-6

之后便可以通过http://mytest.org/abcd来访问项目了。

附:Resin与Eclipse for javaEE的整合方法

resin官方文档提供了安装Resin Plugin for Eclipse的方法,Galileo版本以上的eclipse for javaEE就可以装这个软件了,就像装tomcat一样。具体参考:resin

eclipse support

这里主要介绍手工整合Resin与Eclipse的方法。步骤如下:

1. 将web application配置到resin.conf中,具体方法参考上面;

2. 在待部署的项目上右击——Build Path,将${RESIN_HOME}/lib添加到项目的classpath中;

3. Run – Run Configurations(在本地调试的话,选择Debug Configurations),弹出的会话中,双击“Java Application”创建一个Configuration,在右边的Name中随意填写一个名字,标签页Main中,Project选择待运行web application,Main class填写resin的主类,查找该类有两种方法:

该类可以在${RESIN_HOME}/lib/resin.jar中的META-INF/MANIFEST.MF文件中找到,即Main-Class的值;

将${RESIN_HOME}/lib添加到项目的classpath后,即在Main标签页点击“搜索”,在弹出的对话框中搜索“resin”,如果是3.0.x,选择com.caucho.server.resin.Resin,如果是3.1.x,选择com.caucho.boot.ResinBoot,具体的选择,还是要参考META-INF/MANIFEST.MF文件的Main-Class值;

完成以上各步之后,点击Run即可启动resin。

如果需要在启动resin的时候加上一些参数,可以在Arguments中的VM arguments中输入。

比如: -Djava.util.logging.manager=com.caucho.log.LogManagerImpl。

实际上,真正的部署与eclipse是没有直接关系的,eclipse在这里仅仅是启动/关闭eclipse的作用。我们如果直接在开发机上搞得花,就与eclipse无关了,因此还是需要掌握手工部署的技巧。

相关文章