用途
在做完一个项目程序后,有时会有两种需求想法。
1.在每次机器重启后自动运行程序。
2.在程序运行过程中如果发生了死锁、内存溢出或程序崩溃等问题时程序能自动重启。
当然。要实现这两种效果的方案有很多。可以在系统引导文件中加入开机运行程序引导,也可以写一个系统监听程序等等。
现在有一个更简单的解决方案。有一个java程序叫Java Service Wrapper。这是用来在windows或unix/linux系统中将java程序包装成系统服务并执行守护进程。
Java Service Wrapper有三个版本。professional/standard/community 前两个版本要收费功能也更多。对我们来说,社区版的已经够用了,(对于死锁重启需要收费版的)。
分析
从软件的名子上就能看出来。这个软件是用来包装的。我们的程序完成以后会有一个main入口。wrapper就是将这个main方法进行包装再提供自己的一个main入口。这样,我们在运行时都是运行的wrapper的程序。它会建立各种监控和服务,在建立完成后再加载运行被包装的方法。等监控到运行的程序出问题了就会进行相应的处理。
所需文件(以windows版本为例)
1.从官网http://wrapper.tanukisoftware.com上下载wrapper的软件。
2.我们只需要几个核心的文件
- wrapper.jar 核心文件,位于lib文件夹中
- wrapper.exe 因为是在windows系统中运行所以需要。位于bin文件夹中
- wrapper.dll 因为是在windows系统中运行所以需要。 位于lib文件夹中
- wrapper.conf 核心配置文件,位于src/conf文件夹中,将后缀名conf.in改成conf
- App.bat (可选)运行你的程序,位于src/bin文件夹中, 将后缀名conf.in改成conf
- InstallApp-NT.bat (可选)将你的程序配置为系统服务,位于src/bin文件夹中, 将后缀名conf.in改成conf
- UninstallApp-NT.bat (可选)将你的程序从系统服务中删除,位于src/bin文件夹中, 将后缀名conf.in改成conf
- StartApp-NT.bat (可选)启动程序的系统服务,位于src/bin文件夹中, 将后缀名conf.in改成conf
- StopApp-NT.bat (可选)停止程序的系统服务,位于src/bin文件夹中, 将后缀名conf.in改成conf
- XXX.jar/XXX.class 你的程序
实现方式
针对不同程序有不同的实现方式。
1.如果你的程序是不间断运行的。则只需要设置配置文件即可。
2.如果你的程序只是在系统启动时运行一次,或不需要连续运行的,则要加入入口包装类。不然,虽然你的程序已经执行成功且退出了(如:在系统启动时检查下环境再给你的提示信息就结束)。但wrapper会认为你的程序不应该结束,会不停的重启你的服务。这时你要加入包装类就没有这个问题了。
示例(我的原程序名为Out.java)
一、通用配置
二、原程序不间断运行
原程序内容
public class Out{
public static void main(String[] args) throws Exception{
System.out.println("\u7a0b\u5e8f\u5f00\u59cb\u8fd0\u884c...");
}
}
原程序中只是打印一句话就结束。而我们要的效果是不间断运行,所以wrapper会不断的重启原程序,而会不断的打印语句。
只要改配置文件中的 wrapper.java.mainclass=Out 即可
在运行App.bat之后,你会发现程序会不断的被重启。
三、在内存溢出后重启
原程序内容
public class Out{
public static void main(String[] args) throws Exception{
System.out.println("\u7a0b\u5e8f\u5f00\u59cb\u8fd0\u884c...");
String a="a";
try{
Thread.sleep(2000);
}catch(Exception e){}
System.out.println("\u7a0b\u5e8f\u5f00\u59cb\u5185\u5b58\u6ea2\u51fa...");
for(int i=0;i<999999999;i++){
a+=a;
}
System.out.println("end");
}
}
原程序中应该能打印3句话,但在打印第二句后就会内存被溢出,最后的end不会被打印。但wrapper发现内存溢出后,会自动重启程序,再次不停的打印前两句和重启。
更改配置文件中内容
wrapper.java.mainclass=Out
wrapper.filter.trigger.1000=Exception in thread "*" java.lang.OutOfMemoryError
wrapper.filter.action.1000=RESTART
四、程序只运行一次,但如果在运行中出现问题程序将重启
public class Out{
public static void main(String[] args) throws Exception{
System.out.println("\u7a0b\u5e8f\u5f00\u59cb\u8fd0\u884c...");
String a="a";
try{
Thread.sleep(2000);
}catch(Exception e){}
if(args.length>0){
System.out.println("\u7a0b\u5e8f\u5f00\u59cb\u5185\u5b58\u6ea2\u51fa...");
for(int i=0;i<999999999;i++){
a+=a;
}
}
System.out.println("end");
}
}
import org.tanukisoftware.wrapper.WrapperListener;
import org.tanukisoftware.wrapper.WrapperManager;
public class Main implements WrapperListener{
public static void main(String[] args) throws Exception{
Out.main(args);
WrapperManager.start(new Main(),args);
}
public Integer start(String[] args) {
System.out.println("start()");
return null;
}
public int stop(int exitCode) {
System.out.println("stop(" + exitCode + ")");
return exitCode;
}
public void controlEvent(int event) {
System.out.println("controlEvent(" + event + ")");
}
}
wrapper.filter.trigger.1000=Exception in thread "*" java.lang.OutOfMemoryError
wrapper.filter.action.1000=RESTART
备用
好了,Java Service Wrapper的基本使用就是这么简单。
把第四个示例的内存溢出打个包在这里备份下。以便自己以后使用。