# opencc4j

**Repository Path**: didi1212/opencc4j

## Basic Information

- **Project Name**: opencc4j
- **Description**: Open Chinese Convert is an opensource project for conversion between Traditional Chinese and Simplified Chinese.(java 中文繁简体转换)
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-05-21
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# opencc4j

Opencc4j 支持中文繁简体转换，考虑到词组级别。

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.houbb/opencc4j/badge.svg)](http://mvnrepository.com/artifact/com.github.houbb/opencc4j)
[![Build Status](https://www.travis-ci.org/houbb/opencc4j.svg?branch=master)](https://www.travis-ci.org/houbb/opencc4j)
[![Coverage Status](https://coveralls.io/repos/github/houbb/opencc4j/badge.svg)](https://coveralls.io/github/houbb/opencc4j)

> [变更日志](CHANGELOG.md)

## Features 特點

- 嚴格區分「一簡對多繁」和「一簡對多異」。

- 完全兼容異體字，可以實現動態替換。

- 嚴格審校一簡對多繁詞條，原則爲「能分則不合」。

- 詞庫和函數庫完全分離，可以自由修改、導入、擴展。

- 兼容 Windows、Linux、Mac 平臺。

## 更多特性

- 支持 jdk1.7(v1.0.3)

- 支持自定义分词(v1.1.0)

## 创作缘由

- OpenCC

[OpenCC](https://github.com/BYVoid/OpenCC) 的思想非常优秀，做的也特别棒。但是没有特别为 java 提供的工具。

- jopencc

[jopencc](https://github.com/carlostse/jopencc) 没有提供分词功能。



# 快速开始

## maven 引入

```xml
<dependency>
    <groupId>com.github.houbb</groupId>
    <artifactId>opencc4j</artifactId>
    <version>${最新版本}</version>
</dependency>
```

## 转为简体

```java
String original = "生命不息，奮鬥不止";
String result = ZhConverterUtil.convertToSimple(original);
```

结果为

```
生命不息，奋斗不止
```

## 转为繁体

```java
String original = "生命不息，奋斗不止";
String result = ZhConverterUtil.convertToTraditional(original);
```

结果为

```
生命不息，奮鬥不止
```

## 其他支持

上述两个方法都默认使用的花瓣分词，都有第二个参数，是否启用花瓣分词。
如果不启用，则默认使用普通的一个 char 作为一个转换的对象。(不建议，唯一的优势性能好一点，但是准确性不行)

```java
/**
 * 转换为简体
 * @param original 原始内容
 * @param huabanSegment 是否花瓣分词
 * @return 转换后的内容
 */
public static String convertToSimple(String original, boolean huabanSegment);
```

# 更多支持

[自定义分词方式](doc/user/自定义分词.md)

# 技术鸣谢

## OpenCC

[OpenCC](https://github.com/BYVoid/OpenCC) 提供的原始数据信息。

## 花瓣

[jieba-analysis](https://github.com/huaban/jieba-analysis) 提供中文分词

# Issues & Bugs

[需求和 BUG](https://github.com/houbb/opencc4j/issues) 在这里，欢迎提供宝贵的建议。