Module bus.extra

Package org.miaixz.bus.extra.pinyin.provider.tinypinyin

Class TinyPinyinProvider

java.lang.Object

org.miaixz.bus.extra.pinyin.provider.tinypinyin.TinyPinyinProvider

All Implemented Interfaces:

Serializable, org.miaixz.bus.core.Provider, PinyinProvider

public class TinyPinyinProvider
extends Object
implements PinyinProvider

Encapsulates the TinyPinyin engine.

The TinyPinyin (https://github.com/promeG/TinyPinyin) provider has not been submitted to Maven Central. Therefore, the version packaged by https://github.com/biezhi/TinyPinyin is used.

To introduce (dependency):

 <dependency>
     <groupId>io.github.biezhi</groupId>
     <artifactId>TinyPinyin</artifactId>
     <version>2.0.3.RELEASE</version>
 </dependency>
 

Since:

Java 17+

Author:

Kimi Liu

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
TinyPinyinProvider()	Constructs a new TinyPinyinProvider instance.
TinyPinyinProvider(com.github.promeg.pinyinhelper.Pinyin.Config config)	Constructs a new TinyPinyinProvider instance with a custom configuration.

Method Summary

Modifier and Type	Method	Description
String	getPinyin(char c, boolean tone)	Converts a single character to its Pinyin, with an option to retain tone marks.
String	getPinyin(String str, String separator, boolean tone)	Retrieves the complete Pinyin for a given string, with an option to retain tone marks.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.miaixz.bus.extra.pinyin.PinyinProvider

getFirstLetter, getFirstLetter, getPinyin, getPinyin, type

Constructor Details

TinyPinyinProvider

public TinyPinyinProvider()

Constructs a new TinyPinyinProvider instance. Initializes TinyPinyin with default configuration.

TinyPinyinProvider

public TinyPinyinProvider(com.github.promeg.pinyinhelper.Pinyin.Config config)

Constructs a new TinyPinyinProvider instance with a custom configuration.

Parameters:

config - The Pinyin.Config to use for TinyPinyin initialization.

Method Details

getPinyin

public String getPinyin(char c,
 boolean tone)

Description copied from interface: PinyinProvider

Converts a single character to its Pinyin, with an option to retain tone marks. If the character is a Chinese character, its Pinyin is returned; otherwise, the character itself is returned as a string.

Specified by:

getPinyin in interface PinyinProvider

Parameters:

c - The character to convert.

tone - true to retain tone marks in the Pinyin, false otherwise.

Returns:

The Pinyin of the Chinese character, or the character itself if not Chinese.

getPinyin

public String getPinyin(String str,
 String separator,
 boolean tone)

Description copied from interface: PinyinProvider

Retrieves the complete Pinyin for a given string, with an option to retain tone marks. Non-Chinese characters remain as is.

Specified by:

getPinyin in interface PinyinProvider

Parameters:

str - The input string.

separator - The separator to use between each Pinyin character.

tone - true to retain tone marks in the Pinyin, false otherwise.

Returns:

The Pinyin representation of the string.