[pinyin4j] java版汉字转换拼音（大小写）

pinyin4J 是一个可以将汉字转换成拼音的lib，非常实用，其maven地址为：http://mvnrepository.com/artifact/com.belerweb/pinyin4j/2.5.0

pinyin4J 提供PinyinHelper这个静态类对外提供拼音转换的服务，主要有一下方法：

static public String[] toHanyuPinyinStringArray(char ch)

将char（必须为汉字单字）转化为拼音，实用的是通用的格式，如果ch为非汉字，返回null。

输入：重 输出：[zhong4, chong2]
说明重字有两个读音，拼音后面的1,2,3,4 代表的是读音

static public String[] toHanyuPinyinStringArray(char ch,HanyuPinyinOutputFormat outputFormat)

同上，但是这个方法可以设置输出的格式。HanyuPinyinOutputFormat   可以设置拼音大小写、是否后面加读音数字、特殊读音的显示方式，定义如下：

    /**
     * The option indicates that the output of 'ü' is "u:"
     */
    public static final HanyuPinyinVCharType WITH_U_AND_COLON = new HanyuPinyinVCharType("WITH_U_AND_COLON");
    /**
     * The option indicates that the output of 'ü' is "v"
     */
    public static final HanyuPinyinVCharType WITH_V = new HanyuPinyinVCharType("WITH_V")
    /**
     * The option indicates that the output of 'ü' is "ü" in Unicode form
     */
    public static final HanyuPinyinVCharType WITH_U_UNICODE = new HanyuPinyinVCharType("WITH_U_UNICODE");

static public String[] toTongyongPinyinStringArray(char ch)

转换为通用拼音。通用拼音的介绍见：http://zh.wikipedia.org/zh-cn/%E9%80%9A%E7%94%A8%E6%8B%BC%E9%9F%B3

static public String[] toWadeGilesPinyinStringArray(char ch)

转换为威妥玛拼音：http://zh.wikipedia.org/wiki/%E5%A8%81%E5%A6%A5%E7%91%AA%E6%8B%BC%E9%9F%B3

static public String[] toMPS2PinyinStringArray(char ch)

转换为注音符号拼音：http://zh.wikipedia.org/zh-cn/%E6%B3%A8%E9%9F%B3%E7%AC%A6%E8%99%9F

static public String[] toYalePinyinStringArray(char ch)

转换为耶魯拼音：http://zh.wikipedia.org/zh-cn/%E8%80%B6%E9%AD%AF%E6%8B%BC%E9%9F%B3

static public String[] toGwoyeuRomatzyhStringArray(char ch)

转换为国语罗马字：http://zh.wikipedia.org/wiki/%E5%9C%8B%E8%AA%9E%E7%BE%85%E9%A6%AC%E5%AD%97

对于”重“的拼音转换，以上方法分别得到的结果是：

汉语拼音：[zhong4, chong2]
通用拼音：[jhong4, chong2]
威妥玛拼音：[chung4, ch`ung2]
注音符号拼音：[jung4, chung2]
耶魯拼音：[jung4, chung2]
国语罗马字：[jonq, chorng]

好了，有了上面的基础，我们可以封装一个工具类，用来将汉字转换成拼音，这里只使用了汉字拼音。

首先要将pinyin4j加入项目中，如果是maven项目，可以添加引用：

<span style="white-space:pre">	</span><!-- 增加pinyin4j -->
        <dependency>
            <groupId>com.belerweb</groupId>
            <artifactId>pinyin4j</artifactId>
            <version>2.5.0</version>
        </dependency>

非maven的可以直接将下载好的jar包放入classpath。

然后编写工具类 PinyinTool.java:

package org.nerve.d3lesson.common.tools;

import net.sourceforge.pinyin4j.PinyinHelper;
import net.sourceforge.pinyin4j.format.HanyuPinyinCaseType;
import net.sourceforge.pinyin4j.format.HanyuPinyinOutputFormat;
import net.sourceforge.pinyin4j.format.HanyuPinyinToneType;
import net.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination;

import java.util.Arrays;

/**
 *
 * Created by zengxm on 2014/12/4.
 */
public class PinyinTool {
    HanyuPinyinOutputFormat format = null;
    public static enum Type {
        UPPERCASE,              //全部大写
        LOWERCASE,              //全部小写
        FIRSTUPPER              //首字母大写
    }

    public PinyinTool(){
        format = new HanyuPinyinOutputFormat();
        format.setCaseType(HanyuPinyinCaseType.UPPERCASE);
        format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
    }

    public String toPinYin(String str) throws BadHanyuPinyinOutputFormatCombination{
        return toPinYin(str, "", Type.UPPERCASE);
    }

    public String toPinYin(String str,String spera) throws BadHanyuPinyinOutputFormatCombination{
        return toPinYin(str, spera, Type.UPPERCASE);
    }

    /**
     * 将str转换成拼音，如果不是汉字或者没有对应的拼音，则不作转换
     * 如： 明天 转换成 MINGTIAN
     * @param str
     * @param spera
     * @return
     * @throws BadHanyuPinyinOutputFormatCombination
     */
    public String toPinYin(String str, String spera, Type type) throws BadHanyuPinyinOutputFormatCombination {
        if(str == null || str.trim().length()==0)
            return "";
        if(type == Type.UPPERCASE)
            format.setCaseType(HanyuPinyinCaseType.UPPERCASE);
        else
            format.setCaseType(HanyuPinyinCaseType.LOWERCASE);

        String py = "";
        String temp = "";
        String[] t;
        for(int i=0;i<str.length();i++){
            char c = str.charAt(i);
            if((int)c <= 128)
                py += c;
            else{
                t = PinyinHelper.toHanyuPinyinStringArray(c, format);
                if(t == null)
                    py += c;
                else{
                    temp = t[0];
                    if(type == Type.FIRSTUPPER)
                        temp = t[0].toUpperCase().charAt(0)+temp.substring(1);
                    py += temp+(i==str.length()-1?"":spera);
                }
            }
        }
        return py.trim();
    }
}

写个测试用例看看结果：