今天有用户想在CSharp里调用HanLP的API,遇到了些小问题。所以我干脆自己写了个指南,一步步演示IKVM与HanLP的集成方法,供广大C#程序员参考。本方法也可推广到用C#调用任何Java jar类库,并解决classpath的问题。
IKVM简介
IKVM.NET是一款开源的Java虚拟机,可以将hanlp.jar类库转为dll直接供C#程序调用,也可以直接当JVM让hanlp.jar运行在.NET平台上。请自行下载IKVM,本文使用的是ikvm-7.2.4630.5。
HanLP简介
HanLP是一个致力于向生产环境普及NLP技术的开源Java工具包,支持中文分词(N-最短路分词、CRF分词、索引分词、用户自定义词典、词性标注),命名实体识别(中国人名、音译人名、日本人名、地名、实体机构名识别),关键词提取,自动摘要,短语提取,拼音转换,简繁转换,文本推荐,依存句法分析(MaxEnt依存句法分析、神经网络依存句法分析)。
HanLP由3部分组成:类库hanlp.jar包、模型data包、配置文件hanlp.properties,请前往项目主页下载最新版:https://github.com/hankcs/HanLP/releases
下载后,你需要编辑配置文件第一行的root指向data的父目录,详见文档。
在IKVM中运行hanlp.jar
准备工作
Native JVM情况下,我们是这样调用hanlp.jar的,新建一个目录(假定为C:hanlp),把hanlp.jar和hanlp.properties放进去:
然后cd到这个目录内,一句命令行:
java -cp .;hanlp-1.2.7.jar com.hankcs.hanlp.summary.TextRankSentence
就能运行成功了:
[无限算法的产生是由于未能确定的定义终止条件, 这类算法在有限的时间内终止, 有限的非确定算法]
这里通过-cp选项指定了classpath为当前目录,这样HanLP就能找到hanlp.properties了。
另外,在新版HanLP中,移除了所有的main方法,所以可能会报找不到main方法的异常。新版用户不必纠结于命令行调用,直接写代码调用即可。
IKVM命令行
使用IKVM的话,只要将java换成ikvm即可:
C:ikvm-7.2.4630.5binikvm -cp .;hanlp-1.2.7.jar com.hankcs.hanlp.summary.TextRankSentence
效果是一样的:
在C#中调用HanLP
将hanlp.jar转为hanlp.dll
CSharp是不能直接调用jar包的,需要转为dll。IKVM提供了一个转换工具ikvmc,使用方法如下:
C:hanlp>C:ikvm-7.2.4630.5binikvmc -target:library C:hanlphanlp-1.2.7.jar
ikvmc会输出消息:
IKVM.NET Compiler version 7.2.4630.5
Copyright (C) 2002-2012 Jeroen Frijters
http://www.ikvm.net/
note IKVMC0002: Output file is "hanlp-1.2.7.dll"
同时会在C:hanlp目录下生成hanlp-1.2.7.dll。
在Visual Studio中使用hanlp.dll
首先新建一个CSharp项目:
然后引用刚才生成的hanlp.dll和ikvm-7.2.4630.5bin目录下的IKVM.OpenJDK.Core.dll这两个dll:
确定后就能在解决方案资源管理器中看到这两个dll了:
双击hanlp还能进入到类视图:
那么就可以愉快地写代码调用HanLP了:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using com.hankcs.hanlp;
namespace HanLPSharp
{
class Program
{
static void Main(string[] args)
{
java.lang.System.getProperties().setProperty("java.class.path", "C:\\hanlp");
Console.WriteLine(HanLP.segment("你好,欢迎在CSharp中调用HanLP的API!"));
Console.ReadKey();
}
}
}
解释一下,
java.lang.System.getProperties().setProperty("java.class.path", "C:\hanlp");
这句的作用是设置classpath到hanlp.properties所在的目录,请根据情况自由调整。
编译运行,效果如下:
这说明HanLP在CSharp中工作良好。
更多丰富的API
请参考HanLP的项目主页:https://github.com/hankcs/HanLP
Reference
http://stackoverflow.com/questions/3466698/where-does-ikvm-get-its-classpath-from
文章来源于网络