java程式在windows系統作為服務程式執行

weixin_34391854發表於2014-12-05
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應用程式,交付後使用者要求要把這個程式做成後臺服務程式,即:系統啟動後該程式可以自動啟動,並且在前臺不要出現執行視窗,維護人員只要在“服務管理”(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( 手動 ) 兩種方式。預設為自動。

 

相關文章