使用Java Service Wrapper 将Java应用注册为后台服务

 

使用Java Service Wrapper 将Java应用注册为后台服务

项目中有一个java应用程序，交付后用户要求要把这个程序做成后台服务程序，即：系统启动后该程序可以自动启动，并且在前台不要出现运行窗口，维护人员只要在“服务管理”(Windows)中选择启动或停止即可.
解决办法如下：

Linux
在Linux中注册后台服务程序相对容易，只需编辑/etc/init.d/boot.local文件，在boot.local文件里加上下面这句脚本：

/iapappserver/MessageServer2.1/run.sh

其中run.sh是java应用的运行脚本

Windows
在Windows下的情况较为复杂，需要使用Windows提供的两个工具：instsrv.exe(下载)和Srvany.exe(下载).
instsrv: 这个工具是把win32程序变成系统服务。
基本用法:

 

 

由于应用的需求，需要把Java App作为NT服务来运行，于是就找来了Java service wrapper这个工具来帮忙了。官方网址：http://wrapper.tanukisoftware.org/doc/english /download.jsp。

    Java Service Wrapper提供了4种方式来Java App注册为服务运行（Integration Methods）。

1. 使 用 WrapperSimpleApp帮助类来启动应用。 这种方法是最简单的方法。使用这种方法需要注意的是Java Service Wrapper停止Java App的时候不会调用Java App的相应的接收方法，而是直接调用System.exit()来结束Java App。
2. 使 用 WrapperStartStopApp帮助类来启动应用。这种方法假设Java App有相应的启动，停止类。由ClassX负责启动Java App，ClassY负责停止Java App。当然了，具体使用的时候也可以用同一个类来启动或者停止Java App，只要初始化该类的不同启动或停止参数就可以了。
3. 使 用WrapperManager类来启动应用。这种方法是最灵活的启动方式，而且需要Java App的启动类必须实现 WrapperListener接口。 WrapperListener接口有start(String[] arg0)和stop(int arg0)方法，需要Java App的启动类来实现。这就就可以用WrapperManager类来管理Java App的主类了。
4. 使用 WrapperJarApp 帮助类来启动应用。这种方法和WrapperSimpleApp帮助类相似，只是使用这种方法的时候，Java App要求打包为可执行的Jar文件。

    我使用第二种方式启动自己的Java App。下载Java Service Wrapper后首先是copy一些文件到自己的Java App应用相应的目录下。给目录的结构类似下面这个样子：

    src

      |

      |--bin

      |     |--wrapper.exe

      |     |--App.bat

      |     |--InstallApp-NT.bat     

      |     |--UninstallApp-NT.bat

      |

      |--conf

      |     |--wrapper.conf

      |

      |--lib

      |     |--Wrapper.dll

      |     |--Wrapper.jar

      |

      |--logs

      |     |--wrapper.log

      |

      |--<Your own Source Classes here>

    当然了，如果你的应用程序已经写好了，不行改变已有目录的名称，那就修改Java Service Wrapper的配置文件吧。比如conf文件目录原来的名称为configuration，那就你就可以修改bin目录下引用wrapper.conf 的bat文件中相应的地方即可。

    然后就是配置文件wrapper.conf的修改了。

   wrapper .java .command=java :  指定要运行的Java .如果已经设定了Java的环境变量，这里可以不修改；如果没有，可以使用绝对路径指向 JDKbin 目录下的java。

   wrapper .java .mainclass=org.tanukisoftware.wrapper.WrapperStartStopApp:  指定要运行的帮助类，这个类是上面说的4中方式的启动类之一。Java Service Wrapper是用自己的类来启动应用程序，并把实际要启动的Java应用程序的主类作为该类的第一个参数传进去。 

   wrapper .java .classpath.1=../lib/wrapper .jar ：配置Java 的类路径，这里的将 wrapper .jar 也包含在内，这里可以设置参数的位置，而且这个位置必须得从 1  开始，不能跳过，必须顺序指定，指定类路径的时候还有根据依赖关系来排列 , 被依赖的排在前面，否则会出现 ClassNotFoundException 的错误，这里支持绝对路径和相对路径，也支持通配符 "*" ，比如 wrapper .java .classpath.1=../lib/wrapper * , 不过这个通配符只能用于匹配文件名，不能用于匹配文件夹名称。当然了，这里也必须添加上当前目录或者上一级目录，取决于你的主类所在的目录。

   wrapper .java .library.path.1=../lib： 指定Wrapper 自带的类库文件存放文件夹，比如 Wrapper .DLL 文件等，只要指定到对应的上级目录名称就行，支持通配符。

   wrapper .app.parameter.1= : 指启动类，如上面说的ClassX 。

   wrapper .app.parameter.2= : 指启动类main方法需要的参数个数 。

   wrapper .app.parameter.3= : 指启动类main方法的实际参数，依次列出。

   wrapper .app.parameter.x= : 实际参数。

   wrapper .app.parameter.y= : 指停止类，如上面说的ClassY 。当然了，也可以和启动类一样为ClassX，但是需要参数来区分相应的操作。

 

   wrapper .console.title=Java App ： 控制台窗口显示标题，

   wrapper .ntservice.name=Service Name：  系统服务的名称 ，

   wrapper .ntservice.displayname= Service Name ： 在服务管理中显示的名称

   wrapper .ntservice.description= Service Name 的介绍信息 :  在服务管理器显示服务的描述信息

   wrapper .ntservice.starttype=AUTO_START：  配置服务启动方式，可以选择AUTO_START( 自动 ) 和 DEMAND_START( 手动 ) 两种方式。默认为自动。