monad.mmseg

Class Dictionary

java.lang.Object

monad.mmseg.Dictionary

public class Dictionary
extends Object

词典类. 词库目录单例模式.
保存单字与其频率,还有词库.
有检测词典变更的接口，外部程序可以使用 wordsFileIsChange() 和 reload() 来完成检测与加载的工作.

Author:

chenlb 2009-2-20 下午11:34:29

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Dictionary.FileLoading

Method Summary

Methods

Modifier and Type	Method and Description
static Dictionary	clear(File path) 从单例缓存中去除
static Dictionary	clear(String path)
protected void	finalize()
static File	getDefalutPath() 当 words.dic 是从 jar 里加载时, 可能 defalut 不存在
File	getDicPath() 注意：当 words.dic 是从 jar 里加载时，此时 File 可能是不存在的。
Map<Character,CharNode>	getDict() 仅仅用来观察词库.
static Dictionary	getInstance() 从默认目录加载词库文件. 查找默认目录顺序: 从系统属性mmseg.dic.path指定的目录中加载 从classpath/data目录 从user.dir/data目录
static Dictionary	getInstance(File path)
static Dictionary	getInstance(String path)
long	getLastLoadTime() 最后加载词库的时间
CharNode	head(char ch)
boolean	isUnit(Character ch)
protected File[]	listWordsFiles() 只要 wordsXXX.dic的文件
static int	load(InputStream fin, Dictionary.FileLoading loading) 加载词文件的模板
boolean	match(String word) word 能否在词库里找到
int	maxMatch(char[] sen, int offset)
ArrayList<Integer>	maxMatch(CharNode node, ArrayList<Integer> tailLens, char[] sen, int offset)
int	maxMatch(CharNode node, char[] sen, int offset)
static File	normalizeFile(File file)
boolean	reload() 全新加载词库，没有成功加载会回滚。 注意：重新加载时，务必有两倍的词库树结构的内存，默认词库是 50M/个 左右。否则抛出 OOM。
int	search(CharNode node, char[] sen, int offset, int tailLen) sen[offset] 后 tailLen 长的词是否存在.
boolean	wordsFileIsChange() 词典文件是否有修改过

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static Dictionary getInstance()

从默认目录加载词库文件.

查找默认目录顺序:

1. 从系统属性mmseg.dic.path指定的目录中加载
2. 从classpath/data目录
3. 从user.dir/data目录

See Also:

getDefalutPath()

getInstance

public static Dictionary getInstance(String path)

Parameters:

path - 词典的目录

getInstance

public static Dictionary getInstance(File path)

Parameters:

path - 词典的目录

normalizeFile

public static File normalizeFile(File file)

clear

public static Dictionary clear(String path)

See Also:

clear(File)

clear

public static Dictionary clear(File path)

从单例缓存中去除

Parameters:

path -

Returns:

没有返回 null

load

public static int load(InputStream fin,
       Dictionary.FileLoading loading)
                throws IOException

加载词文件的模板

Returns:

文件总行数

Throws:

IOException

getDefalutPath

public static File getDefalutPath()

当 words.dic 是从 jar 里加载时, 可能 defalut 不存在

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

listWordsFiles

protected File[] listWordsFiles()

只要 wordsXXX.dic的文件

Returns:

wordsFileIsChange

public boolean wordsFileIsChange()

词典文件是否有修改过

Returns:

reload

public boolean reload()

全新加载词库，没有成功加载会回滚。

注意：重新加载时，务必有两倍的词库树结构的内存，默认词库是 50M/个 左右。否则抛出 OOM。

Returns:

是否成功加载

match

public boolean match(String word)

word 能否在词库里找到

head

public CharNode head(char ch)

search

public int search(CharNode node,
         char[] sen,
         int offset,
         int tailLen)

sen[offset] 后 tailLen 长的词是否存在.

See Also:

CharNode.indexOf(char[], int, int)

maxMatch

public int maxMatch(char[] sen,
           int offset)

maxMatch

public int maxMatch(CharNode node,
           char[] sen,
           int offset)

maxMatch

public ArrayList<Integer> maxMatch(CharNode node,
                          ArrayList<Integer> tailLens,
                          char[] sen,
                          int offset)

isUnit

public boolean isUnit(Character ch)

getDict

public Map<Character,CharNode> getDict()

仅仅用来观察词库.

getDicPath

public File getDicPath()

注意：当 words.dic 是从 jar 里加载时，此时 File 可能是不存在的。

getLastLoadTime

public long getLastLoadTime()

最后加载词库的时间