2------------NLPIR（ICTCLAS2016）分词系统添加用户词典功能

备注：win7 64位系统，netbeans编程

基本代码框架参见我的另一篇文章：NLPIR分词功能

代码实现：

package cwordseg;  
  
import java.io.UnsupportedEncodingException;  
// import utils.SystemParas;  
import com.sun.jna.Library;  
import com.sun.jna.Native;  
  
/** 
 *  
 * 功能：添加/删除用户自定义词汇/词典 
 * 最后更新时间：2016年3月15日 14:09:49 
 */  
  
public class CWordSeg {  
    public interface CLibrary extends Library {  
        CLibrary Instance = (CLibrary) Native.loadLibrary("D:\NetBeansProjects\CWordSeg\file\win64\NLPIR",CLibrary.class);  
        public int NLPIR_Init(String sDataPath,int encoding,String sLicenceCode);  
        public String NLPIR_ParagraphProcess(String sSrc, int bPOSTagged);  
        // 添加用户词汇  
        public int NLPIR_AddUserWord(String sWord);  
        // 删除用户词汇  
        public int NLPIR_DelUsrWord(String sWord);  
        // 保存用户词汇到用户词典  
        public int NLPIR_SaveTheUsrDic();   
        // 导入用户自定义词典：自定义词典路径，bOverwrite=true表示替代当前的自定义词典，false表示添加到当前自定义词典后    
        public int NLPIR_ImportUserDict(String sFilename, boolean bOverwrite);   
        public String NLPIR_GetLastErrorMsg();  
        public void NLPIR_Exit();  
    }  
      
    public static String transString(String aidString,String ori_encoding,String new_encoding) {  
        try {  
            return new String(aidString.getBytes(ori_encoding),new_encoding);  
        } catch (UnsupportedEncodingException e) {  
            e.printStackTrace();  
        }  
        return null;  
    }  
      
    public static void main(String[] args) throws Exception {  
        String argu = "D:\NetBeansProjects\CWordSeg\file";  
        // String system_charset = "UTF-8";  
        int charset_type = 1;                  
        int init_flag = CLibrary.Instance.NLPIR_Init(argu, charset_type, "0");      
        String nativeBytes;  
  
        // 初始化失败提示  
        if (0 == init_flag) {  
            nativeBytes = CLibrary.Instance.NLPIR_GetLastErrorMsg();   
            System.err.println("初始化失败！原因："+nativeBytes);  
            return;  
        }  
          
        String sInput = "这是一本关于信息检索的书，作者是南京大学的。";   
        try {  
            nativeBytes = CLibrary.Instance.NLPIR_ParagraphProcess(sInput, 1);  // 分词函数，是否标注词性  
            System.out.println("原始的分词结果为： " + nativeBytes);  
              
            // 添加两个用户词汇，此处为单个添加方法  
            CLibrary.Instance.NLPIR_AddUserWord("信息检索 n");  // n为词性  
            CLibrary.Instance.NLPIR_AddUserWord("南京大学 n");  
            nativeBytes = CLibrary.Instance.NLPIR_ParagraphProcess(sInput, 1);  
            System.out.println("增加词汇后结果为： " + nativeBytes);  
              
            CLibrary.Instance.NLPIR_DelUsrWord("南京大学");    // 删除其中一个词汇  
            nativeBytes = CLibrary.Instance.NLPIR_ParagraphProcess(sInput, 1);  
            System.out.println("删除词汇后结果为： " + nativeBytes);  
              
            // CLibrary.Instance.NLPIR_SaveTheUsrDic();  // 保存用户自定义词汇，建议不用  
              
            int nCount = CLibrary.Instance.NLPIR_ImportUserDict("D:\NetBeansProjects\CWordSeg\file\adduserdict.txt",true);   
            System.out.println(String.format("已导入%d个用户词汇", nCount));   
            nativeBytes = CLibrary.Instance.NLPIR_ParagraphProcess(sInput, 1);  
            System.out.println("导入词典后结果为： " + nativeBytes);  
              
            CLibrary.Instance.NLPIR_Exit();     // 退出  
              
        } catch (Exception ex) {  
            // TODO Auto-generated catch block  
            ex.printStackTrace();  
        }  
    }  
}

添加用户词汇的函数说明：

    用户词汇将优先用于分词。

1.

public int NLPIR_AddUserWord(String sWord); 

 

功能：少量词汇逐个添加

参数：sWord表示要添加的词汇，格式为："自定义词汇+空格+词汇词性"，空格可以是多个，也可以用Tab制表符代替；

注意事项：该函数添加的用户自定义词汇具有临时性，即只在本程序的本次运行中有效。因为从Data数据角度来看，该函数并不会修改Data文件夹的词库数据。

2.

public int NLPIR_DelUsrWord(String sWord);

功能：少量词汇逐个删除

参数：sWord表示要删除的词汇，格式为："自定义词汇"。这里没有词性。

注意事项：个人不太明白该函数存在的意义，因为如果想要删除用户词汇的话，只需要将增加临时词汇的NLPIR_AddUserWord()语句注释掉或者删掉即可。该函数既不能删除下面将要提到的NLPIR_SaveTheUsrDic()函数保存的用户词汇，也不能删除NLPIR_ImportUserDict()函数批量导入的词汇。因为该函数不会对Data文件夹里的文件进行修改。

3.

public int NLPIR_SaveTheUsrDic();  

功能：将用户词汇保存到系统词典

参数：没有参数，如果保存成功，返回值为1，否则返回值为0。

注意事项：

（1）会将前面添加的所有用户词汇（不包括又删除掉的）保存到用户词典；

（2）通过该函数保存的用户词汇是永久性的，因为会修改Data文件夹里的UserDict.pdat文件，以后的分词程序都会使用已保存的用户词汇；

（3）只能保存NLPIR_AddUserWord()添加的词汇，不能保存NLPIR_ImportUserDict()导入的词汇。

停用方法：由于永久性效果，可用以下方法停用——
    方法（1）：打开Data文件夹里的Configure.xml文件，将UserDict参数由on改为off；
    方法（2）：用原始的UserDict.pdat文件替换掉现在的。

4.

public int NLPIR_ImportUserDict(String sFilename, boolean bOverwrite);  

功能：从词典文本批量导入用户词汇，返回值是添加词汇的个数。

参数：

    sFilename为词典文本路径；例如：D:\NetBeansProjects\CWordSeg\file\adduserdict.txt

    bOverwrite=true表示新导入的数据将会覆盖原来的用户自定义词典；

    bOverwrite=false表示新导入的数据将会添加到原来用户自定义词典的后面（追加）。

文本词典格式：每行一个，词汇+空格+词性

信息检索 n  
南京大学 n  

注意事项：

（1）通过该函数导入用户词汇会修改Data文件夹里的FieldDict.pdat、FieldDict.pos文件，并会新建一个UserDefinedDict.lst文件，但是不会修改UserDict.pdat文件。所以通过这种方式导入的用户词汇，可以通过导入新的用户词典进行覆盖（bOverwrite=true），或是补充添加新词汇（bOverwrite=false）。

（2）UserDefinedDict.lst文件中记录了已经添加的用户词汇。

（3）如果设置NLPIR_ImportUserDict的参数bOverwrite=false，即新导入的数据不覆盖原有数据，则可以修改UserDefinedDict.lst里的内容（原有词汇），并同时增加新的词汇；
（4）如果设置NLPIR_ImportUserDict的参数bOverwrite=true，新导入的数据将会覆盖原有数据，此时即使修改UserDefinedDict.lst里的内容也会被新数据覆盖掉，最终只保留新导入的词汇。

（5）这种方式导入的用户词汇也是永久性的，分词效果将一直存在。

停用方法：
方法1：打开Data文件夹里的Configure.xml文件，将FieldDict参数由on改为off；
方法2：导入一个空的文本词典；（导入词典可以为空）
方法3：用原始FieldDict.pdat、FieldDict.pos文件替换掉现在的，UserDefinedDict.lst可删可不删。