将Java程序转换为Windows服务 作者:IT168 seasky 2007-09-19

【IT168 专稿】

一、概述

    现在Java语言越来越受到程序员的关注。和Java相关的应用也越来越多。虽然Java是跨平台语言,但在国内有很多的应用都是运行在Windows下的。尤其是一些服务类程序。而一般基于Java的服务类程序都是以控制台方式运行的。这样虽然很直接。但如果服务程序多了,显得很乱。而且要使其在系统启动时运行也比较麻烦。因此,本文将介绍一种可以将Java程序转换为Windows服务的方法。通过这种方法。可以使Java程序象Windows服务程序一样运行。下面就让我们来进行转换吧。

    一般有两种方法可以将Java程序转换为Windows服务:

    1. 使用Windows服务直接在同一个进程运行Java应用程序。(这种方法服务程序无法更好地控制Java程序)。

    2. 在Windows服务程序中建立一个java虚拟机实例(JVM),这个JVM实例和服务程序在同一个上下文中,而且JVM在Windows服务程序的控制之下。

    第一种方法虽然实现起来简单,但这种方法不能很好地控制Java程序。因此,本文使用了第二种方法来运行Java程序。本文将带领读者一步一步地实现所有的内核代码。在实现代码之前,我们需要很好地了解Windows服务和Java本地接口(JNI)的概念和API的使用。

二、使用JVM API模拟Java运行时

    由于Windows任务管理器将所有的Java进程都显示为"Java",因此,我们根本无法通过这种方式区分某一个Java进程。为了给每一个Java应用程序指定一个特殊的名子。我们需要使用JVM API来模拟Java运行时。

    下面先来看看Java运行时(也就是java.exe)在运行时需要些什么。当我们使用java <类名>来运行java程序时,java.exe从系统路径动态装载了一些DLL库。这些Dll如下:

 
1.       java/jdk/jre/bin/client/jvm.dll
这个dll提供了JVM所需要的API。一但我们建立了一个JVM,jvm.dll就会依次装载所需的Dll,这些Dll如下:

2. java/jdk/jre/bin/hpi.dll
3. java/jdk/jre/bin/verify.dll
4. java/jdk/jre/bin/java.dll
5. java/jdk/jre/bin/zip.dll

    下面是java.exe如何处理Dll的过程:
 
1. 装载JVM Dll。
2. 建立一个JVM。
3. 装载指定的Java类。
4. 调用main方法,也就是public static void main (String[] args)。

我们可以使用在jni.h中定义的JNI_CreateJavaVM方法来建立一个JVM实例。我们可
以在JDK的安装目录中找到jni.h。
 

    下面是一个简单的Java程序,在控制台中打印出"Hello World"

下面是使用JNI来模拟java.exe的例子代码。在这里我们使用动态装载jvm.dll方法,而不是静态绑定jvm.lib。这样会更有弹性,如可以自由地选择java的版本。代码如下:
 
int InvokeMain() {
       JavaVM *vm;
       JavaVMInitArgs vm_args;
       JavaVMOption options[1];
       jint res;
       JNIEnv *env;
       jclass cls;
       jmethodID mid;
 
       options[0].optionString = CLASS_PATH;
       vm_args.version = JNI_VERSION_1_4;   // 设置JDK的版本
       vm_args.options = options;
       vm_args.nOptions = 1;
       vm_args.ignoreUnrecognized = JNI_FALSE;
 
       //装载jvm.dll
       HINSTANCE handle = LoadLibrary(RUNTIME_DLL);
       if( handle == 0) {
              printf("Failed to load jvm dll %s/n",
                     RUNTIME_DLL);
              return -1;
       }
    // 得到JNI_CreateJVM指针

       createJVM = (CreateJavaVM)GetProcAddress(handle,
                     "JNI_CreateJavaVM");
 
       res = createJVM(&vm, (void **)&env, &vm_args);
       if (res < 0) {
              printf("Error creating JVM");
              return -1;
       }
 
       // 装载指定的类
       cls = env->FindClass(CLASS_NAME);
       if(cls == 0) {
              printf("Exception in thread /"main/"
                     java.lang.NoClassDefFoundError: %s/n",
                            CLASS_NAME);
              return -1;
       }
       //得到main方法
       mid = env->GetStaticMethodID(cls, "main",
              "([Ljava/lang/String;)V");
       if(mid == 0) {
              printf("Exception in thread /"main/"
                     java.lang.NoSuchMethodError: main/n");
              return -1;
       }
 
    // 调用main方法(不传递参数)
       env->CallStaticVoidMethod(cls, mid, 0);
    // 如果程序抛出异常,打印它
       if(env->ExceptionCheck()) {
              env->ExceptionDescribe();
              return -1;
       }
       return 0;
}

    在装载com.test.Hello时,我们必须使用"/"分割符(如com/test/Hello)。还有我们需要理解JNI调用Java方法的格式。如,为了调用void main(String[] args)方法,格式为:([Ljava/lang/String;)V:,"["表示数组;"L;"描述一个Java对象,V表示这个方法返回void。我们可以从JNI规范得到更多的细节。本文不再详细描述。

 
    
package com.test; public class Hello{ public static void main(String[] args) { System.out.println("Hello World" ); } }
三、集成JNI和Windows服务API

    为了演示Windows服务的功能,我在这设计了一h个叫Dummy的Java类。这个类在main方法等待一个停止事件。并实现了shutdown方法,在这个方法里设置并调用了stop事件。这将保证main线程安全地退出。在Dummy类中还实现了shutdown钩子,这个钩子主要给java.exe使用。Dummy.java的代码如下:

 
    
import java.io.* ; public class Dummy { public static Dummy xyz = null; private boolean stopped = false; public static PrintWriter pw; public Dummy() throws IOException { pw = new PrintWriter(new OutputStreamWriter( new FileOutputStream("C://dummy.log")), true); } public void start() { pw.println("started"); while(!stopped) { synchronized(this) { try { wait(); } catch (InterruptedException ie) {} } } pw.println("stopped"); } public void stop() { pw.println("stopping"); synchronized(this) { stopped = true; notifyAll(); } try { Thread.sleep(1000); } catch(Exception ex){} } public static void main(String[] args) { try { xyz = new Dummy(); Runtime.getRuntime().addShutdownHook(new Thread() { public void run() { pw.println("inside shutdown hook"); xyz.stop(); } }); xyz.start(); } catch (Exception ex) {} } public static void shutdown() { xyz.stop(); } }
典型的Windows服务(除了设备驱动服务外)是由服务控制管理器(SCM,也就是众所周知的services.exe进程)按着服务进程创建和管理的。一个单独的进程包含有多个服务。但在本文的例子中一个服务进程只包含一个JVM实例服务。

    我们可以使用如下的API在SCM中安装一个服务:
 
SC_HANDLE schSCManager = OpenSCManager(..),
SC_MANAGER_CREATE_SERVICE);
SC_HANDLE schService = CreateService(..)
 
也可以使用如下的API来卸载Windows服务程序:

SC_HANDLE schSCManager = OpenSCManager(.., SERVICE_ALL_ACCESS);
SC_HANDLE schService = OpenService( schSCManager, ..);
DeleteService(schService)

    为了启动服务,我们需要使用StartServiceCtrlDispatcher来注册ServiceMain函数。这个ServiceMain函数包含了我们的主要功能。在我们的例子中,就是InvokeMain函数。接下来,调用RegisterServiceCtrlHandler(SERVICE_NAME, ServiceHandler);,这个函数注册一个Handler,并从SCM接收响应的命令。为了防止由于JVM崩溃而导致整个服务瘫痪,我们在另外一个线程里调用InvokeMain方法。上面的程序被写在DummyService.cpp中,通过VS2005将其编译成DummyService.exe。上面的代码可以通过点击此处下载

    接下来我们使用如下的命令来安装、启动、停止以及卸载Windows服务:
 
DummyService /i   // 安装服务
net start DummyService    // 启动服务
net stop DummyService    // 停止服务
DummyService /u   // 卸载服务

    上面的程序只是使用了最小的配置。其实要想充分使用JNI,得需要使用很多参数。一般需要至少15至20个配置参数。下面是在定制满足我们需要的程序的配置参数:
 
1. Windows服务参数:
(1) 服务名
(2) 演示名
(3) 描述
     (4) 执行路径
(5) 启动类型(自动/手动)
(6) 在注册中被保存的参数
     (7) 工作目录
(8) 存在于每个进程的服务或在单进程中的许多服务
     (9) 和桌面交互的选项(如果服务有一个UI接口)
     (10) 登录用户名和密码(当使用用户帐号或本地系统帐号来运行服务时需要)

2. 和Java应用相关的参数:

(11) jvm.dll的路径
(12) JVM选项(-D, -X)
     (13) 类名
(14) 命令行参数
     (15) 关闭超时

3. 日志参数:

(16) 事件日志和文件日志
(17) 用于重定向输入、输出的参数

    我们可以根据具体的要求选择使用哪些参数。我们可以将这些参数保存在被推荐的注册表的位置:HKLM/System/CurrentControlSet/[Service Name]/Parameters. 中。
四、安全地退出Java程序

    我们首先调用System.exit(0)来退出程序。虽然这个方法同时调用了所有的shutdown钩子,也试着关闭JVM。但它在清除和用于和SCM建立的Windows服务通讯的管道时抛出异常。这些错误信息如下:

System error 109 has occurred.
     The pipe has been ended.
    因此,本文采用了更好的方式来关闭服务,也就是实现shutdown方法,并调用它。我建议在线程中使用public static void shutdown()方法(如果这个方法被实现的话),并设置一定的超时,如20秒。这将防止服务如果shutdown方法未返回而收到未响应的信息。但要保证这个超时比系统超时少,否则SCM将终止我们的服务进程。
 

你可能感兴趣的:(将Java程序转换为Windows服务 作者:IT168 seasky 2007-09-19)