[update] updates

Author: houbb

.travis.yml

@@ -1,6 +1,6 @@
 language: java
 jdk:
-- oraclejdk8
+- openjdk8
 install: mvn install -DskipTests=true -Dmaven.javadoc.skip=true
 script: mvn test
 after_success:

CHANGELOG.md

@@ -53,3 +53,11 @@
 | A | 新增 ZhConverterUtil#toSimple(String) | 2020-1-12 14:42:30 | |
 | A | 新增 ZhConverterUtil#toTraditional(String) | 2020-1-12 14:42:30 | |
 | O | 优化 ZhConverterUtil 获取转换实例为单例 | 2020-1-12 14:42:30 | |
+
+# release_1.4.0
+
+| 类型 | 变化 | 时间 | 备注 |
+|:---|:---|:---|:---|
+| A | 新增 ZhConverterUtil#isSimple()/#isTraditional() | 2020-2-2 13:04:58 | |
+| A | 新增 ZhConverterUtil#simpleList()/#traditionalList() | 2020-2-2 13:04:58 | |
+

README.md

@@ -1,11 +1,12 @@
 # opencc4j
 
-Opencc4j 支持中文繁简体转换，考虑到词组级别。
+[Opencc4j](https://github.com/houbb/opencc4j) 支持中文繁简体转换，考虑到词组级别。
 
+[![Build Status](https://travis-ci.com/houbb/opencc4j.svg?branch=master)](https://travis-ci.com/houbb/opencc4j)
 [![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.houbb/opencc4j/badge.svg)](http://mvnrepository.com/artifact/com.github.houbb/opencc4j)
 [![Coverage Status](https://coveralls.io/repos/github/houbb/opencc4j/badge.svg)](https://coveralls.io/github/houbb/opencc4j)
 [![](https://img.shields.io/badge/license-Apache2-FF0080.svg)](https://github.com/houbb/opencc4j/blob/master/LICENSE.txt)
-
+[![Open Source Love](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://github.com/houbb/opencc4j)
 
 > [变更日志](CHANGELOG.md)
 
@@ -29,6 +30,10 @@ Opencc4j 支持中文繁简体转换，考虑到词组级别。
 
 - 支持返回字符串中简体/繁体的列表信息 
 
+### 最新版本特性
+
+- 新增工具类常用方法
+
 ## 测试代码
 
 见 test 文件夹。
@@ -53,11 +58,17 @@ Opencc4j 支持中文繁简体转换，考虑到词组级别。
 <dependency>
     <groupId>com.github.houbb</groupId>
     <artifactId>opencc4j</artifactId>
-    <version>1.3.0</version>
+    <version>1.4.0</version>
 </dependency>
 ```
 
-## 转为简体
+## 使用示例
+
+## 繁简体转换
+
+对字符串进行繁简体转换，默认支持中文分词。
+
+### 转为简体
 
 ```java
 String original = "生命不息，奮鬥不止";
@@ -70,7 +81,7 @@ String result = ZhConverterUtil.toSimple(original);
 生命不息，奋斗不止
 ```
 
-## 转为繁体
+### 转为繁体
 
 ```java
 String original = "生命不息，奋斗不止";
@@ -83,6 +94,60 @@ String result = ZhConverterUtil.toTraditional(original);
 生命不息，奮鬥不止
 ```
 
+## 繁简体判断
+
+对单个字符或者词组进行繁简体判断。
+
+### 是否为简体
+
+```java
+final String simpleChar = "奋";
+final String simplePhrase = "奋斗";
+final String traditionalChar = "奮";
+final String traditionalPhrase = "奮鬥";
+
+Assert.assertTrue(ZhConverterUtil.isSimple(simpleChar));
+Assert.assertTrue(ZhConverterUtil.isSimple(simplePhrase));
+Assert.assertFalse(ZhConverterUtil.isSimple(traditionalChar));
+Assert.assertFalse(ZhConverterUtil.isSimple(traditionalPhrase));
+```
+
+### 是否为繁体
+
+```java
+final String simpleChar = "奋";
+final String simplePhrase = "奋斗";
+final String traditionalChar = "奮";
+final String traditionalPhrase = "奮鬥";
+
+Assert.assertTrue(ZhConverterUtil.isTraditional(traditionalChar));
+Assert.assertTrue(ZhConverterUtil.isTraditional(traditionalPhrase));
+Assert.assertFalse(ZhConverterUtil.isTraditional(simpleChar));
+Assert.assertFalse(ZhConverterUtil.isTraditional(simplePhrase));
+```
+
+## 繁简体列表返回
+
+返回字符串中繁简体对应的词、字列表，默认支持中文分词。
+
+### 简体列表
+
+```java
+final String original = "生命不息奋斗不止";
+final List<String> resultList = ZhConverterUtil.simpleList(original);
+
+Assert.assertEquals("[生命不息, 奋斗, 不止]", resultList.toString());
+```
+
+### 繁体列表
+
+```java
+final String original = "生命不息奮鬥不止";
+final List<String> resultList = ZhConverterUtil.traditionalList(original);
+
+Assert.assertEquals("[奮鬥]", resultList.toString());
+```
+
 # 引导类方式
 
 ## 为什么需要引导类
@@ -101,7 +166,9 @@ v1.1.0 之后引入了类 [ZhConvertBootstrap](https://github.com/houbb/opencc4j
 
 ## 引导类使用案例
 
-和工具类类似。
+和工具类保持相同的 api，降低学习成本。
+
+此处演示其中一个功能。
 
 - 转为简体
 
@@ -110,18 +177,18 @@ final String original = "生命不息，奮鬥不止";
 final String result = ZhConvertBootstrap.newInstance().toSimple(original);
 Assert.assertEquals("生命不息，奋斗不止", result);
 ```
+# 自定义分词方式
 
-- 转为繁体
+## 系统内置分词方式
 
-```java
-final String original = "生命不息，奋斗不止";
-final String result = ZhConvertBootstrap.newInstance().toTraditional(original);
-Assert.assertEquals("生命不息，奮鬥不止", result);
-```
+你可以通过 `Segments` 工具类获取系统内置的分词实现。
 
-# 自定义分词方式
+| 序号 | 方法 | 准确性 | 性能 | 备注 |
+|:---|:---|:---|:---|:---|
+| 1 | defaults() | 高 | 一般 | 默认分词形式，暂时为结巴分词。 |
+| 2 | chars() | 低 | 高 | 将字符串转换为单个字符列表，一般不建议使用。 |
 
-## 用途
+## 应用场景
 
 你有时候可能除了上述的两种分词方式，会有更加适合自己业务的分词实现。
 
@@ -146,7 +213,7 @@ public interface Segment {
 }
 ```
 
-备注： 默认使用的是 [花瓣分词](https://github.com/houbb/opencc4j/blob/master/src/main/java/com/github/houbb/opencc4j/support/segment/impl/HuaBanSegment.java)
+备注： 暂时默认使用的是 [花瓣分词](https://github.com/houbb/opencc4j/blob/master/src/main/java/com/github/houbb/opencc4j/support/segment/impl/HuaBanSegment.java)
 
 ## 测试代码
 
@@ -176,161 +243,6 @@ final String result2 = ZhConvertBootstrap.newInstance().segment(new FooSegment()
 Assert.assertEquals("寥落古行宮，宮花寂寞紅。白頭宮女在，閒坐說玄宗。測試", result2);
 ```
 
-- 创建时指定分词器
-
-你可以在创建引导类的时候，直接指定分词器实现。
-
-```java
-final String original = "寥落古行宫，宫花寂寞红。白头宫女在，闲坐说玄宗。";
-final String result = ZhConvertBootstrap.newInstance(new FooSegment()).toTraditional(original);
-Assert.assertEquals("寥落古行宮，宮花寂寞紅。白頭宮女在，閒坐說玄宗。測試", result);
-```
-
-# V1.2.0 新特性使用说明
-
-## 获取分词列表
-
-- 方法
-
-```java
-/**
- * 获取分词后的字符串列表
- * （1）如果原始字符串为空，则返回空列表
- * @param original 原始字符串
- * @return 字符串列表
- * @since 1.2.0
- */
-List<String> doSeg(final String original);
-```
-
-- 测试
-
-```java
-final String original = "生命不息奋斗不止";
-final List<String> resultList = ZhConvertBootstrap.newInstance().doSeg(original);
-
-String expectToString = "[生命不息, 奋斗, 不止]";
-Assert.assertEquals(expectToString, resultList.toString());
-```
-
-## 判断是否为繁体
-
-- 方法
-
-```java
-/**
- * 是否为繁体
- * 1. 原始字符串为空，直接返回 false
- * 2. 如果长度为1，则根据繁体字列表中是否存在，直接返回结果
- * 3. 如果长度大于1，则判断繁体词组类表中是否存在，如果为 true，则直接返回。
- * 4. 如果 3 为 false，则继续判断分成单个字进行判断，如果每一个字都是繁体，则认为是繁体。
- * @param charOrPhrase 单个字或者词组
- * @return true: 是; false: 否
- * @since 1.2.0
- */
-boolean isTraditional(final String charOrPhrase);
-```
-
-- 测试
-
-```java
-final String simpleChar = "奋";
-final String simplePhrase = "奋斗";
-final String traditionalChar = "奮";
-final String traditionalPhrase = "奮鬥";
-
-ZhConvertBootstrap convertBootstrap = ZhConvertBootstrap.newInstance();
-
-Assert.assertTrue(convertBootstrap.isTraditional(traditionalChar));
-Assert.assertTrue(convertBootstrap.isTraditional(traditionalPhrase));
-Assert.assertFalse(convertBootstrap.isTraditional(simpleChar));
-Assert.assertFalse(convertBootstrap.isTraditional(simplePhrase));
-```
-
-## 判断是否为简体
-
-- 方法
-
-```java
-/**
- * 是否为简体
- * （1）原始字符串为空，直接返回 false
- * （2）其他情况，则和 {@link #isTraditional(String)} 取反
- * @param charOrPhrase 单个字或者词组
- * @return true: 是; false: 否
- * @since 1.2.0
- */
-boolean isSimple(final String charOrPhrase);
-```
-
-- 测试
-
-```java
-final String simpleChar = "奋";
-final String simplePhrase = "奋斗";
-final String traditionalChar = "奮";
-final String traditionalPhrase = "奮鬥";
-
-ZhConvertBootstrap convertBootstrap = ZhConvertBootstrap.newInstance();
-
-Assert.assertTrue(convertBootstrap.isSimple(simpleChar));
-Assert.assertTrue(convertBootstrap.isSimple(simplePhrase));
-Assert.assertFalse(convertBootstrap.isSimple(traditionalChar));
-Assert.assertFalse(convertBootstrap.isSimple(traditionalPhrase));
-```
-
-## 返回简体字符串列表
-
-- 方法
-
-```java
-/**
- * 返回简体字列表
- * 说明：返回 {@link #doSeg(String)} 列表中符合 {@link #isSimple(String)} 的字符串列表
- * @param original 原始字符串列表
- * @return 包含的简体字符串列表
- * @since 1.2.0
- */
-List<String> simpleList(final String original);
-```
-
-- 测试
-
-```java
-final String original = "生命不息奋斗不止";
-ZhConvertBootstrap zhConvertBootstrap = ZhConvertBootstrap.newInstance();
-final List<String> resultList = zhConvertBootstrap.simpleList(original);
-
-String expectToString = "[生命不息, 奋斗, 不止]";
-Assert.assertEquals(expectToString, resultList.toString());
-```
-
-## 返回繁体字符串列表
-
-- 方法
-
-```java
-/**
- * 返回繁体字列表
- * 说明：返回 {@link #doSeg(String)} 列表中符合 {@link #isTraditional(String)} 的字符串列表
- * @param original 原始字符串列表
- * @return 包含的繁体字符的列表
- * @since 1.2.0
- */
-List<String> traditionalList(final String original);
-```
-
-- 测试
-
-```java
-final String original = "生命不息奮鬥不止";
-ZhConvertBootstrap zhConvertBootstrap = ZhConvertBootstrap.newInstance();
-final List<String> resultList = zhConvertBootstrap.traditionalList(original);
-
-String expectToString = "[奮鬥]";
-Assert.assertEquals(expectToString, resultList.toString());
-```
-
 # 技术鸣谢
 
 ## OpenCC

doc/ISSUES.md

@@ -37,4 +37,11 @@ ps: 只提供一个 add(key, value)，新的 key 会覆盖旧的 key。
 
 使用者无感知。
 
-ps: 多线程处理性能提升不明显，因为每一个词语的转换很快。
+ps: 多线程处理性能提升不明显，因为每一个词语的转换很快。
+
+# 分词默认实现替换
+
+从 jieba==>segment
+
+保留原始实现，用于需要引入 jar。
+

src/main/java/com/github/houbb/opencc4j/core/impl/ZhConvertBootstrap.java

@@ -17,6 +17,7 @@
 import com.github.houbb.opencc4j.support.segment.Segment;
 import com.github.houbb.opencc4j.support.segment.impl.CharSegment;
 import com.github.houbb.opencc4j.support.segment.impl.HuaBanSegment;
+import com.github.houbb.opencc4j.support.segment.impl.Segments;
 
 import java.util.List;
 import java.util.Map;
@@ -36,7 +37,7 @@ public class ZhConvertBootstrap implements ZhConvert {
      * 1. 默认使用花瓣分词。
      * @since 1.1.0
      */
-    private Segment segment = Instances.singleton(HuaBanSegment.class);
+    private Segment segment = Segments.defaults();
 
     /**
      * 构造器私有化
@@ -55,10 +56,12 @@ public static ZhConvertBootstrap newInstance() {
 
     /**
      * 创建分词实例，并且制定分词实现
+     * （1）不是很建议使用，后期配置属性较多时，这样显然不够优雅。
      * @param segment 分词类
      * @return this
      * @since 1.2.0
      */
+    @Deprecated
     public static ZhConvertBootstrap newInstance(final Segment segment) {
         ZhConvertBootstrap bs = newInstance();
         bs.segment(segment);