Module bus.extra

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

Class JPinyinProvider

java.lang.Object

org.miaixz.bus.extra.pinyin.provider.jpinyin.JPinyinProvider

All Implemented Interfaces:

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

public class JPinyinProvider
extends Object
implements PinyinProvider

Encapsulates the Jpinyin engine.

To introduce (dependency):

 <dependency>
     <groupId>com.github.stuxuhai</groupId>
     <artifactId>jpinyin</artifactId>
     <version>1.1.8</version>
 </dependency>
 

Since:

Java 17+

Author:

Kimi Liu

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
JPinyinProvider()	Constructs a new JPinyinProvider instance.

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

JPinyinProvider

public JPinyinProvider()

Constructs a new JPinyinProvider instance. Checks if the Jpinyin library is available (via PinyinHelper class).

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.