ikvmc的使用

IKVM.NET是一个针对Mono和微软.net框架的java实现，其设计目的是在.NET平台上运行java程序。本文将比较详细的介绍这个工具的原理、使用入门（如何java应用转换为.NET应用、），希望能给大家带来惊喜。

 

一、介绍

IKVM.NET是一个针对Mono和微软.NET框架的java实现，其设计目的是在.NET平台上运行java程序。它包含了以下的组件：
一个用.NET实现的java虚拟机。
一个java类库的.NET实现。
致力于在java和.NET之间交互的工具。

 

二、IKVM.NET的组件

IKVM.NET包含以下的部分：
IKVM.Runtime.dll VM运行时和所有支持代码。它包括以下的功能：
Byte Code JIT 编译器和验证器，使用JIT将Java Byte Code编译为CIL（C中间语言）。
对象模式映射结构，将.NET中的System.Object，System.String，System.Exception映射为JAVA代码中的java.lang.Object， java.lang.String，java.lang.Throwable。
管理本地方法（在Classpath中）的.NET重新实现。
IKVM.GNU.Classpath.dll 被编译的GNU Classpath版本，它是由自由软件基金会实现的JAVA类库和一些IKVM.NET附加代码组成的。注意：这里的GNU Classpath不是IKVM.NET的一部分，但是前者被用在IKVM.NET中。
IKVM.JNI.dll 通过实现JNI接口管理C++汇编。作为一个可选部分，只在程序使用自己的本地库时才被用到。而对于纯JAVA程序来讲是不会被用到的。
ikvm.exe 与java.exe很类似的启动执行程序（动态模式）。
ikvmc.exe 静态编译器，被用来编译java类和jar使其成为.NET汇编（静态模式）。
ikvmstub.exe 一个从.NET汇编生成存根类的工具，就如javap一样反编译.NET汇编。IKVM.NET了解如何存根并用实际的.NET类型引用替换对存根的引用。
IKVM.AWT.WinForms.dll 非常有限的零散AWT实现。

三、IKVM原理

1．如何替换JVM
IKVM应用包含了采用.NET实现的java虚拟机。在一些场合，我们可以用它替换掉java。例如： java -jar myapp.jar 将被替换为 ikvm -jar myapp.jar。
2．在.NET应用中使用java类库
IKVM.NET包含ikvmc，这个在java bytecode与.NET中间语言的转换器。如果我们使用一个被用在.NET平台的java库的话， 运行ikvmc –targetlibrary mylib.jar（mylib.jar在这里指代我们的jar文件）来生成mylib.dll。例如apache FOP项目是一个开源的XSL-FO处理器项目，它使用java语言编写的用于从xml生成PDF文档。使用IKVM.NET技术，我们可以将apache FOP用在任何的.NET应用中。这样在开发.NET应用的同时利用IKVM便可以使用java开源项目这个免费的软件仓库。尽管在IKVM.NET没有提供在.NET中使用的java编译器，但是我们可用开源的Jikes编译器将java源代码编译为JVM bytecode，然后使用ikvmc –targetexe myapp.jar来生产.NET执行文件。我们甚至可以通过包含ikvmstub应用的方式在我们的java代码中用.NET API。

四 语法（译者注：这个工具是在windows命令提示窗中使用的）

ikvmc [ options ] classOrJarfile [ classOrJarfile ... ]

参数见下：
类文件（.class）或包文件（.jar）
Java类或包文件的名字可以含有通配符（如*.class）。

参数－－－－参数说明

-out:输出文件－－－－指定输出文件的文件名。文件名应含有扩展名.dll（参数-target设为library时）或.exe（参数-target设为exe或winexe时）。一般地，缺省状态下ikvmc会根据输入文件名和-target参数来确定输出文件名。但是，如果在输入文件名中使用了通配符，那么就必须使用这个选项来指定输出文件名。

-assembly:程序集名称－－－－指定生成的程序集名称。一般地，缺省状态下，程序集名就是输出文件名。

-target:目标类型－－－－指定生成目标.exe或.dll文件的类型，可以指定如下值：
exe——生成一个在windows命令窗口中运行的可执行程序。
winexe——生成一个带有界面的.exe应用程序。
library——生成一个动态链接库（.dll）文件。
module——生成一个.net模块。

在Linux平台上，exe与winexe两个参数是没有区别的。

-keyfile:主文件名－－－－主文件名用于指定结果程序集。

-version:M.m.b.r －－－－指定程序集版本。

-main:类名－－－－指定含有main函数的类的名称。缺省情况下，如果-target参数设置为exe或winexe，ikvmc会搜寻合法的main函数，在找到的情况下会给用户提示。

-reference:－－－－指定类库位置 。 如果Java代码使用了.NET的编程接口（API），那么使用这个选项指定这些动态链接库（dll）。如果引用了不止一个类库文件，那么此选项可以多次使用。可以使用通配符（例如：c:\libs\*.dll）。

- recurse:filespec－－－－ 处理当前文件夹下所有可与filespec匹配的文件。例如：- recurse: *.class

-nojni－－－－对于非Java函数（native methods）不要生成用于非Java代码的Java接口（JNI）。

-resource:路径名－－－－指定Java资源的引用路径名。

-exclude:文件名－－－－ 要排除的类名列表。

-debug－－－－将调试信息输出。注意：只有当.class文件含有调试信息（即使用javac-g参数编译）时才有用。

-srcpath:路径－－－－指定源代码的位置。与-debug同时使用。程序会将包中类的搜索路径指定为此路径，并从中搜索类的源代码。

-Xtrace:名称－－－－ 显示所有该指定名称的跟踪点。

-Xmethodtrace:函数名 －－－－ 指定的生成的函数名，将函数跟踪器（method trace）生成到此函数中。

几点说明：
ikvmc利用Java类文件和包文件生成.NET程序集。它将输入文件中的Java二进行代码转化成.NET公共中间语言（CIL）。并利用它来生成：
.NET可执行文件（-target:exe or –target:winexe）
.NET类库（-target:library）
.NET模块（-target:module）
Java程序一般由一系列的包文件组成。ikvmc可以将多个包文件（和类文件）转化成一个单独的.NET可执行程序或类库文件。例如，一个程序包含main.jar、lib1.jar和lib2.jar可以转化成一个单独的main.exe文件。
处理多个包文件时，如果有多个相同的类或源文件，ikvmc会使用第一个读入的版本，而忽略以后读到的。这时会产生警告信息。因此，包文件的顺序至关重要。
注意：
为了得到最佳结果，使用ikvmc转换Java程序时，请按照Java程序中类路径的顺序在，把要转换包的列表键入ikvmc的命令行。

 

五 使用入门

1. 到IKVM官方网站下载IKVM需要的组件 1） ikvm-0.40.0.1.zip ；2）ikvmbin-0.40.0.1.zip ；3）openjdk6-b12-stripped.zip
2. 解压ikvm-0.40.0.1.zip,并将%IKVM_HOME%\bin添加到path中。此处的%IKVM_HOME%是指解压后ikvm的主目录。
3. 到Debian IKVM下载IKVM.OpenJDK.ClassLibrary.dll。 或者到rayfile去下载data.tar.gz。这个文件可以直接用winrar解压。
4. 你需要下载一个简单的工具undeb去解压.deb文件。
5. 解压ikvm_0.38.0.2+dfsg-2_all.deb文件。
6. 新建一个Java文件, 如

   1: package myPackage;

   2: public class Hello

   3:  {

   4:     public String sayHello()

   5:     {

   6:         String str = "Hello, this String is from java program.";

   7:         return str;

   8:     }

   9: }

7. 编译Hello.java文件，然后将myPackage打包成一个jar文件，例如jar cvf myJava.jar myPackage

8. 使用ikvmc -out:myJava.dll myJava.jar。你现在应该在看到一个myJava.dll文件。亦可以在转换时指定结果程序集 如: ikvmc -target:library myJava.jar - keyfile:key.snk

9. 新建一个C#.NET项目，首先添加一下必须的DLL。

1) %IKVM_HOME%\bin\IKVM.OpenJDK.Core.dll;
2) %IKVM_HOME%\bin\IKVM.Runtime.dll ;
3) %IKVM_HOME% \bin\IKVM.Runtime.JNI.dll ; ( IKVM.OpenJDK.ClassLibrary.dll[这的DLL在ikvm_0.38.0.2+dfsg-2_all.deb\usr\lib\cli文件夹中。或者也可在data.tar.gz中的usr\lib\cli中找到)

10. 添加第8步生成的myJava.dll到C#.NET项目中，然后using %package_name%就可以实现对Java的调用。

   1: using System;

   2: using System.Collections.Generic;

   3: using System.Drawing;

   4: using System.Windows.Forms;

   5: 

   6: using myPackage;

   7: namespace testIkvm

   8: {

   9:     public partial class frmTest: Form

  10:     {

  11:         private void btnTestJar_Click(object sender, EventArgs e)

  12:         {

  13:             Hello h1 = new Hello();

  14:             String s1 = h1.sayHello();

  15:             tbTest.Text = s1;

  16:         }

  17:     }

  18: }