Pinyin4j使用手册，HanyuPinyinVCharType的意义

一般用法 
pinyin4j的使用很方便，一般转换只需要使用PinyinHelper类的静态工具方法即可： String[] pinyin = PinyinHelper.toHanyuPinyinStringArray(‘刘’); 
//该类还有其他的拼音转换形式，但是基本上用不到，就不介绍了 
返回的数组即是该字符的拼音，如上例就是pinyin[0]=liu2，后面的数字代表声调，声调为5表示轻读，无声调。之所谓返回数组，是因为被判定的汉字有可能有多个读音。如果输入的参数不是汉字，则返回null。  
拼音格式化 
如果对于拼音转换后的结果有一些特定的格式要求目前pinyin4j支持：  声调格式化。例如：“刘”字的格式化后为“liu2”或“liu”或“liú”  对特殊拼音ü的的显示格式。例如“u:”或“v”或“ü” 
 大小写的转换。例如：“liu2”或“LIU2” 
以上这些格式可以混合使用，下面就来介绍具体的使用方法，首先需要创建格式化对象HanyuPinyinOutputFormat，例如： 
HanyuPinyinOutputFormat outputFormat = new HanyuPinyinOutputFormat(); 然后分别调用outputFormat的set方法设置上述一些格式要求： 设置声调格式： 
outputFormat.setToneType(HanyuPinyinToneType);  
方法参数HanyuPinyinToneType有以下常量对象： 
HanyuPinyinToneType.WITH_TONE_NUMBER 用数字表示声调，例如：liu2 HanyuPinyinToneType.WITHOUT_TONE 无声调表示，例如：liu 
HanyuPinyinToneType.WITH_TONE_MARK 用声调符号表示，例如：liú 设置特殊拼音ü的显示格式： 
outputFormat.setVCharType(HanyuPinyinVCharType);  
方法参数HanyuPinyinVCharType有以下常量对象： 
HanyuPinyinVCharType.WITH_U_AND_COLON 以U和一个冒号表示该拼音，例如：lu: HanyuPinyinVCharType.WITH_V 以V表示该字符，例如：lv HanyuPinyinVCharType.WITH_U_UNICODE 以ü表示 


       var script = document.createElement('script'); script.src = 'http://static.pay.baidu.com/resource/baichuan/ns.js'; document.body.appendChild(script);    

设置大小写格式 
outputFormat.setCaseType(HanyuPinyinCaseType); 
HanyuPinyinCaseType.LOWERCASE 转换后以全小写方式输出 HanyuPinyinCaseType.UPPERCASE 转换后以全大写方式输出  
设置好格式对象后还是利用上述的工具类方法进行拼音转换，只不过需要将格式化对象当成方法参数传入转换方法，告知要转换的格式要求： 
String[] pinyin = PinyinHelper.toHanyuPinyinStringArray(‘刘’, outputFormat); 但该方法会有异常抛出，注意处理。  
示例 
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.HanyuPinyinVCharType; import 
net.sourceforge.pinyin4j.format.exception.BadHanyuPinyinOutputFormatCombination; 
public class Test {  public static void main(String[] args) {   HanyuPinyinOutputFormat outputFormat = new 
HanyuPinyinOutputFormat(); 
  
outputFormat.setToneType(HanyuPinyinToneType.WITH_TONE_MARK); 
  outputFormat.setVCharType(HanyuPinyinVCharType.WITH_U_UNICODE);   outputFormat.setCaseType(HanyuPinyinCaseType.UPPERCASE);   try { 
  
 
System.out.println(concatPinyinStringArray(PinyinHelper.toHanyuPi
nyinStringArray('刘',outputFormat)));   } catch (BadHanyuPinyinOutputFormatCombination e) {    // TODO Auto-generated catch block    e.printStackTrace(); 
  } 
 }   
 
private static String concatPinyinStringArray(String[] pinyinArray) 
    { 
        StringBuffer pinyinStrBuf = new StringBuffer(); 
        if ((null != pinyinArray) && (pinyinArray.length > 0)) 
        { 
            for (int i = 0; i < pinyinArray.length; i++)             { 
                pinyinStrBuf.append(pinyinArray[i]);                 
pinyinStrBuf.append(System.getProperty("line.separator"));             }         } 
        String outputString = pinyinStrBuf.toString();         return outputString;     } } 
输出结果为：LIÚ 
 
其他 
 PinyinHelper还有其他的静态方法，但示例和讲解中使用的方法是常见的拼音格式，因
此其他静态方法我没有调研其含义。 
 貌似支持生僻字，我试过很怪异的字，都可以将其读音拼写出来，因此这个工具包还是
很强的。

附上一个小小的工具类()

---

public static String getPingYin(String src) {
        char[] t1 = null;
        t1 = src.toCharArray();
        String[] dest = new String[t1.length];
        HanyuPinyinOutputFormat format = new HanyuPinyinOutputFormat();
        format.setCaseType(HanyuPinyinCaseType.LOWERCASE);
        format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
        format.setVCharType(HanyuPinyinVCharType.WITH_V);
        String pinyin = "";
        int length = t1.length;
        try {
            for (int i = 0;i < length; i++) {
                //判断是否为汉字字符
                if (java.lang.Character.toString(t1[i]).matches( "[\\u4E00-\\u9FA5]+")) {
                    dest = PinyinHelper.toHanyuPinyinStringArray(t1[i], format);
                    pinyin += dest[0].charAt(0);
                } else {
                    pinyin += java.lang.Character.toString(t1[i]);
                }
            }
            return pinyin;
        } catch (Exception e) {
            e.printStackTrace();
        }
        return pinyin;
    }