com.xkzhangsan.time.nlp

Class TimeNLPUtil

java.lang.Object

com.xkzhangsan.time.nlp.TimeNLPUtil

public class TimeNLPUtil
extends Object

时间自然语言分析工具类
作为xk-time的一个扩展应用功能，主要原理是根据TimeRegex.Gzip正则集合识别时间词语，然后计算得到结果。
包括功能：
（1）以当前时间为基础分析时间自然语言。
（2）以指定时间为基础分析时间自然语言。
（3）增加多种调用方式，比如parseConcurrent 并发执行，可设置超时时间和自定义线程池等，提高执行效率。
修改自 https://github.com/shinyke/Time-NLP
做了一些修改如下：
（1）封装属性，重命名使符合驼峰命名标准。
（2）将加载正则资源文件改为单例加载。
（3）将类按照功能重新划分为单独的多个类。
（4）使用Java8日期API重写。
（5）增加注释说明，优化代码。
（6）修复原项目中的issue：标准时间yyyy-MM-dd、yyyy-MM-dd HH:mm:ss和yyyy-MM-dd HH:mm解析问题。
（7）修复原项目中的issue：1小时后，1个半小时后，1小时50分钟等解析问题；并且支持到秒，比如50秒后，10分钟30秒后等。
（8）修复原项目中的issue：修复当前时间是上午10点，那么下午三点 会识别为明天下午三点问题。
（9）修复原项目中的issue：修复小数解析异常问题。

注意：NLP会有一定的识别失败率，在不断迭代开发提高成功率

Author:

xkzhangsan

Method Summary

Modifier and Type	Method and Description
static List<TimeNLP>	parse(String text) 时间自然语言分析
static List<TimeNLP>	parse(String text, String timeBase) 时间自然语言分析
static List<TimeNLP>	parse(String text, String timeBase, long timeout, TimeUnit unit, ExecutorService executorService) 时间自然语言分析，使用线程池并发执行
static List<TimeNLP>	parseConcurrent(String text) 时间自然语言分析，使用线程池并发执行
static List<TimeNLP>	parseConcurrent(String text, long timeout, TimeUnit unit) 时间自然语言分析，使用线程池并发执行，设置超时时间和单位
static List<TimeNLP>	parseConcurrent(String text, long timeout, TimeUnit unit, ExecutorService executorService) 时间自然语言分析，使用线程池并发执行，设置超时时间和单位，使用自定义线程池
static List<TimeNLP>	parseConcurrentDefaultTime(String text) 时间自然语言分析，使用线程池并发执行，默认3秒超时

Methods inherited from class java.lang.Object

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

Method Detail

parse

public static List<TimeNLP> parse(String text)

时间自然语言分析

Parameters:

text - 待分析文本

Returns:

结果列表

parseConcurrent

public static List<TimeNLP> parseConcurrent(String text)
                                     throws InterruptedException,
                                            ExecutionException,
                                            TimeoutException

时间自然语言分析，使用线程池并发执行

Parameters:

text - 待分析文本

Returns:

结果列表

Throws:

InterruptedException - 被中止异常

ExecutionException - 执行异常

TimeoutException - 超时异常

parseConcurrentDefaultTime

public static List<TimeNLP> parseConcurrentDefaultTime(String text)
                                                throws InterruptedException,
                                                       ExecutionException,
                                                       TimeoutException

时间自然语言分析，使用线程池并发执行，默认3秒超时

Parameters:

text - 待分析文本

Returns:

结果列表

Throws:

InterruptedException - 被中止异常

ExecutionException - 执行异常

TimeoutException - 超时异常

parseConcurrent

public static List<TimeNLP> parseConcurrent(String text,
                                            long timeout,
                                            TimeUnit unit)
                                     throws InterruptedException,
                                            ExecutionException,
                                            TimeoutException

时间自然语言分析，使用线程池并发执行，设置超时时间和单位

Parameters:

text - 待分析文本

timeout - 超时时间

unit - 超时时间单位

Returns:

结果列表

Throws:

InterruptedException - 被中止异常

ExecutionException - 执行异常

TimeoutException - 超时异常

parseConcurrent

public static List<TimeNLP> parseConcurrent(String text,
                                            long timeout,
                                            TimeUnit unit,
                                            ExecutorService executorService)
                                     throws InterruptedException,
                                            ExecutionException,
                                            TimeoutException

时间自然语言分析，使用线程池并发执行，设置超时时间和单位，使用自定义线程池

Parameters:

text - 待分析文本

timeout - 超时时间

unit - 超时时间单位

executorService - 自定义线程池

Returns:

结果列表

Throws:

InterruptedException - 被中止异常

ExecutionException - 执行异常

TimeoutException - 超时异常

parse

public static List<TimeNLP> parse(String text,
                                  String timeBase)

时间自然语言分析

Parameters:

text - 待分析文本

timeBase - 指定时间

Returns:

结果列表

parse

public static List<TimeNLP> parse(String text,
                                  String timeBase,
                                  long timeout,
                                  TimeUnit unit,
                                  ExecutorService executorService)
                           throws InterruptedException,
                                  ExecutionException,
                                  TimeoutException

时间自然语言分析，使用线程池并发执行

Parameters:

text - 待分析文本

timeBase - 指定时间

timeout - 超时时间

unit - 超时时间单位

executorService - 自定义线程池

Returns:

结果列表

Throws:

InterruptedException - 被中止异常

ExecutionException - 执行异常

TimeoutException - 超时异常