java程序在windows系統做爲服務程序運行

Java程序不少狀況下是做爲服務程序運行的，在Un*x 平臺下能夠利用在命令後加「&」把程序做爲後臺服務運行，但在Windows下看做那個Console窗口在桌面上，你是否一直擔憂別的同時把你 的Console窗口關閉？是否懷念用VC寫的Win32服務程序？
翻開JBOSS、Tomcat的發佈包，發現他們都使用了一個Open source——Java Service Wrapper。用Java Service Wrapper能夠輕鬆解決咱們的需求，讓咱們的服務程序成爲 Win32系統服務。
固然，在Un*x下也可使用Java Service Wrapper，能夠避免加「&」的粗暴方式，致使天天收到一堆mail，經過Java Service Wrapper提供的日誌方式查看運行信息。
Java Service Wrapper功能很強大，同時支持Windows及Un*x平臺，提供三種方式把你的Java程序包裝成系統服務，這裏只介紹最簡單的一種方式，因這種 方式無需對已有的服務程序做任何改變，僅僅增長几個script、配置文件就能夠把你的Java服務程序改形成系統服務程序了。
固然在使用以前須要到http://sourceforge.net/project/showfiles.php?group_id=39428下載Java Service Wrapper的發佈包。

下面簡單介紹一下具體的使用步驟：
1.  將下載的Java Service Wrapper包解壓到本地，目錄爲{WRAPPER_HOME}；
2.  服務應用程序名爲MyServApp，在目錄d:\MyServApp下創建bin、conf、logs、lib目錄；並把你的已有應用程序如NioBlockingServer.class拷貝到該目錄下；
3.  將{WRAPPER_HOME}\src\bin\下的遺如下文件拷貝到MyServApp目錄下，並重命名。
{WRAPPER_HOME}\bin\Wrapper.exe  C:\ MyServApp \bin\Wrapper.exe
{WRAPPER_HOME}\src\bin\App.bat.in  C:\ MyServApp\bin\MyApp.bat
{WRAPPER_HOME}\src\bin\InstallApp-NT.bat.in  C:\ MyServApp\bin\InstallMyApp-NT.bat
{WRAPPER_HOME}\src\bin\UninstallApp-NT.bat.in  C:\ MyServApp\bin\UninstallMyApp-NT.bat
4.  將{WRAPPER_HOME}\lib下的如下文件拷貝到C:\ MyServApp \lib目錄下
{WRAPPER_HOME}\lib\Wrapper.DLL
{WRAPPER_HOME}\lib\wrapper.jar
5.  將{WRAPPER_HOME}\src\conf\wrapper.conf.in拷貝到C:\ MyServApp \conf目錄下並命名爲wrapper.conf；並修改wrapper.conf文件，在其中配置您的應用服務。
主要修改如下幾項便可：
#你的JVM位置：
wrapper.java.command=D:\Sun\j2sdk1.4.0_03\bin\java 
#運行參數：如：
wrapper.java.additional.1=-Dprogram.name=run.bat
#classpath：
wrapper.java.classpath.1=../lib/wrapper.jar
wrapper.java.classpath.2=../bin/.
# Java Library Path (location of Wrapper.DLL or libwrapper.so)
wrapper.java.library.path.1=../lib
#MAIN CLASS 此處決定了使用Java Service Wrapper的方式
wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp
#你的Java應用類
wrapper.app.parameter.1= NonBlockingServer
# 服務名
wrapper.ntservice.name=NB

# Display name of the service
wrapper.ntservice.displayname=Nio Nonblocking Server
# 服務描述
wrapper.ntservice.description=Nio Nonblocking Server
其餘的配置根據你的須要改變便可
6.  對以上配置的MyApp.bat進行測試，運行MyApp.bat，就像在Console窗口下運行Tomcat同樣；
7.  對以上配置的服務進行測試，運行C:\ MyServApp\bin\InstallMyApp-NT.bat將把你的應用（此處爲NioBlockingServer）安裝到Win32系統服務中了。
8.  打開控制面板－管理程序－服務，看到Nio Nonblocking Server已經在系統服務中了，其餘用法就與咱們熟悉的Windows服務同樣了。

Tomcat使用的是Java Service Wrapper模式二，這種方式須要對已有的程序進行小的改動，但能夠經過Socket端口的方式控制服務程序核心的啓動，更加靈活。Java Service Wrapper提供的模式三比較複雜，須要做出更多的編碼，我沒有研究。
採用模式一，便可簡單有效的把咱們的服務程序包裝成爲系統服務程序，並加強了日誌功能，咱們能夠把MyServApp的幾個文件作成模板，每次修改文件名，配置文件就能夠了，有精力的朋友更能夠作成Eclipse的plugin，鼠標點點就把應用配成服務了。

附件是一個模板，能夠直接修改文件名和配置文件就能夠把服務改造了。

 

 

 

Java Service Wrapper（如下簡稱JSW）是一個能夠將Java應用程序封裝成Windows服務（service）或Unix守護程序（daemon）的程序，並且是免費的。它可運行於：

• aix - AIX
• freebsd - FreeBSD
• hpux, hpux64 - HP-UX, 32 and 64-bit versions.
• irix - SGI Irix
• linux - Linux kernels; 2.2.x 2.4.x, 2.6.x. Known to work with Debian and Red Hat, but should work with any distribution.
• macosx - Macintosh OS X.
• osf1 - DEC OSF1.
• solaris - Sun OS, Solaris 7, 8.
• win32 - Windows NT, 2000, XP, and 2003.

JSW的使用有三種方式：

1. 用WrapperSimpleApp class啓動應用程序。這是使用JSW最簡單的方式，也是推薦的方式。但使用這種方式有個問題，由於JSW是直接使用System.exit()退出 JVM的，這等如使用者在應用程序運行期間直接按ctrl-c退出程序同樣。若是應用程序在退出前須要執行clean up的話，須要自行登記shutdown hook，或不要使用這種方式。以這種方式配置JBoss的例子（Win32, Linux / UNIX）。

2. 第二種方式是使用WrapperStartStopApp class。這種方式是給Tomcat之類的應用程序（即在一個類啓動，但以另外一個類結束的應用程序）。一般這類的應用程序都會在啓動時打開一個 server socket，用來等待要求程序結束的鏈接，當接收到要求結束的請求，「結束」類會被執行。而JSW就是在收到中止運行的要求時，直接執行這個「結束」 類。以這這種方式配置Tomcat的例子（Win32, Linux / UNIX）。

3. 第三種方式，也是最複雜，最靈活的一種方式，也是惟一一種須要編程的方式。這種方式要寫一個實現WrapperListener接口的類。有些功能 是這種方式獨有的，例如直接在程序中接收及迴應系統控制事件（如啓動及結束）。但這也增長了程序的複雜程度。若是不須要這些功能的話，仍是使用第一種方式 比較方便。以這種方式配置的例子。

注：使用第一種方式最好不要使用JRE1.3.x或以上，由於1.2.x無shutdown hook的技持。如程序只能使用JRE1.2.x，就須要使用第二或第三種方式使用JSW。

 

 

 

今天在瀏覽all JSRs時，看到一個被withdrawed的JSR 96 Java Daemon，主要是開發一個運行各平臺的Java Daemon框架（容器）。

去google上翻了些資料，鏈到一個有意思的東東Java Service Wrapper（ http://wrapper.tanukisoftware.org/doc/english/introduction.html）major features including:

1. 在windows平臺的以服務運行，在Unix平臺之後臺Daemon運行；
2. 提供應用的高可用性，經過監控JVM進程來實現，發現JVM進程crash或者掛起，就restart it；
3. 針對各平臺提供一致的應用啓動腳本；
4. 提供應用restart自身JVM的能力(Restart on-demand)；
5. 易於安裝和管理，支持JMX

我的感受，特性1和2比較有價值。

很惋惜，在以apache爲首的多國部隊圍剿下，頗有創意的JSR 96被killed。

 

 

 

 

將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的環境變量，這裏能夠不修改；若是沒有，可使用絕對路徑指向 JDK bin 目錄下的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( 手動 ) 兩種方式。默認爲自動。