Pinyin4j之Pinyin4jUtils工具类

介绍

Pinyin4j是一个流行的Java库，支持中文字符和拼音之间的转换，拼音输出格式可以定制。

Pinyin4jUtils工具类是进行包装，进行支持一一些转换方法

支持方法

输入一个字符串可以给我转成首字母返回给我

例如：颐和园 

1. 转换格式：全部大小YHY
2. 转换格式：全部大写（中间加字符串*）Y*H*Y
3. 转换格式：全部小写yhy
4. 转换格式：全部小写（中间加字符串*）y*h*y
5. 转换格式：返回首字母大写Y
6. 转换格式：返回首字母小写y

使用方法

Pinyin4j pinyin4j = new Pinyin4j();
String first1 = pinyin4j.toPinYinUppercase("颐和园");
String first2 = pinyin4j.toPinYinUppercase("颐和园", "**");
String first3 = pinyin4j.toPinYinLowercase("颐和园");
String first4 = pinyin4j.toPinYinLowercase("颐和园","**");
String first5 = pinyin4j.toPinYinUppercaseInitials("颐和园");
String first6 = pinyin4j.toPinYinLowercaseInitials("颐和园");
System.out.println(first1);	//输出结果：YHY
System.out.println(first2);	//输出结果：Y**H**Y
System.out.println(first3);	//输出结果：yhy
System.out.println(first4);	//输出结果：y**h**y
System.out.println(first5);	//输出结果：Y
System.out.println(first6);	//输出结果：y

java工具类代码

import org.junit.Test;
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;
/**
 * 汉字转换成拼音方法
 * @author 蔡龙
 */

public class Pinyin4j {
	
	HanyuPinyinOutputFormat format = null;  
	public static enum Type {  
		UPPERCASE,			  //全部大写  
		LOWERCASE,			  //全部小写  
		FIRSTUPPER            //首字母大写
	}  
  
	public Pinyin4j(){  
		format = new HanyuPinyinOutputFormat();  
		format.setCaseType(HanyuPinyinCaseType.UPPERCASE);  
		format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);  
	}  
  
	/**
	 * 转换全部大写 
	 * @param str 字符串
	 * @return str为颐和园 ,return获取到的是YHY
	 * @throws BadHanyuPinyinOutputFormatCombination
	 */
	public String toPinYinUppercase(String str) throws BadHanyuPinyinOutputFormatCombination{  
		return toPinYin(str, "", Type.UPPERCASE);  
	}  
  
	/**
	 * 转换全部大写
	 * @param str 字符串
	 * @param spera 转换字母间隔加的字符串,如果不需要为""
	 * @return str为颐和园 ,spera为** return获取到的是Y**H**Y
	 * @throws BadHanyuPinyinOutputFormatCombination
	 */
	public String toPinYinUppercase(String str,String spera) throws BadHanyuPinyinOutputFormatCombination{  
		return toPinYin(str, spera, Type.UPPERCASE);  
	} 
	
	/**
	 * 转换全部小写
	 * @param str 字符串
	 * @return	str为颐和园 ,return获取到的是yhy
	 * @throws BadHanyuPinyinOutputFormatCombination
	 */
	public String toPinYinLowercase(String str) throws BadHanyuPinyinOutputFormatCombination{  
		return toPinYin(str, "", Type.LOWERCASE);  
	}  
  
	/**
	 * 转换全部小写
	 * @param str 字符串
	 * @param spera 转换字母间隔加的字符串,如果不需要为""
	 * @return	str为颐和园 ,spera为** return获取到的是y**h**y
	 * @throws BadHanyuPinyinOutputFormatCombination
	 */
	public String toPinYinLowercase(String str,String spera) throws BadHanyuPinyinOutputFormatCombination{  
		return toPinYin(str, spera, Type.LOWERCASE);  
	} 
	
	/** 
	 * 获取拼音首字母(大写)
	 * @param str 字符串
	 * @return str为颐和园 ,return获取到的是Y
	 * @throws BadHanyuPinyinOutputFormatCombination 异常信息
	 */  
	public String toPinYinUppercaseInitials(String str) throws BadHanyuPinyinOutputFormatCombination {  
		String initials = null;
		String py = toPinYinUppercase(str); 
		if(py.length()>1){
			initials = py.substring(0, 1);
		}
		if(py.length()<=1){
			initials = py;
		}
		return initials.trim();  
	} 
	
	/** 
	 * 获取拼音首字母(小写)
	 * @param str 字符串
	 * @return str为颐和园 ,return获取到的是y
	 * @throws BadHanyuPinyinOutputFormatCombination 异常信息
	 */  
	public String toPinYinLowercaseInitials(String str) throws BadHanyuPinyinOutputFormatCombination {  
		String initials = null;
		String py = toPinYinLowercase(str); 
		if(py.length()>1){
			initials = py.substring(0, 1);
		}
		if(py.length()<=1){
			initials = py;
		}
		return initials.trim();  
	} 
  
	/** 
	 * 将str转换成拼音，如果不是汉字或者没有对应的拼音，则不作转换 
	 * @param str    字符串
	 * @param spera  默认,可为""
	 * @param type   转换格式
	 * @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); 
					}
					if(temp.length()>=1){
					   	temp = temp.substring(0, 1);
					}
						py += temp+(i==str.length()-1?"":spera);  
					}  
				}  
			}  
			return py.trim();  
		}  
}
	HanyuPinyinOutputFormat format = null;  
	public static enum Type {  
		UPPERCASE,			  //全部大写  
		LOWERCASE,			  //全部小写  
		FIRSTUPPER            //首字母大写
	}  
  
	public Pinyin4j(){  
		format = new HanyuPinyinOutputFormat();  
		format.setCaseType(HanyuPinyinCaseType.UPPERCASE);  
		format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);  
	}  
  
	/**
	 * 转换全部大写 
	 * @param str 字符串
	 * @return str为颐和园 ,return获取到的是YHY
	 * @throws BadHanyuPinyinOutputFormatCombination
	 */
	public String toPinYinUppercase(String str) throws BadHanyuPinyinOutputFormatCombination{  
		return toPinYin(str, "", Type.UPPERCASE);  
	}  
  
	/**
	 * 转换全部大写
	 * @param str 字符串
	 * @param spera 转换字母间隔加的字符串,如果不需要为""
	 * @return str为颐和园 ,spera为** return获取到的是Y**H**Y
	 * @throws BadHanyuPinyinOutputFormatCombination
	 */
	public String toPinYinUppercase(String str,String spera) throws BadHanyuPinyinOutputFormatCombination{  
		return toPinYin(str, spera, Type.UPPERCASE);  
	} 
	
	/**
	 * 转换全部小写
	 * @param str 字符串
	 * @return	str为颐和园 ,return获取到的是yhy
	 * @throws BadHanyuPinyinOutputFormatCombination
	 */
	public String toPinYinLowercase(String str) throws BadHanyuPinyinOutputFormatCombination{  
		return toPinYin(str, "", Type.LOWERCASE);  
	}  
  
	/**
	 * 转换全部小写
	 * @param str 字符串
	 * @param spera 转换字母间隔加的字符串,如果不需要为""
	 * @return	str为颐和园 ,spera为** return获取到的是y**h**y
	 * @throws BadHanyuPinyinOutputFormatCombination
	 */
	public String toPinYinLowercase(String str,String spera) throws BadHanyuPinyinOutputFormatCombination{  
		return toPinYin(str, spera, Type.LOWERCASE);  
	} 
	
	/** 
	 * 获取拼音首字母(大写)
	 * @param str 字符串
	 * @return str为颐和园 ,return获取到的是Y
	 * @throws BadHanyuPinyinOutputFormatCombination 异常信息
	 */  
	public String toPinYinUppercaseInitials(String str) throws BadHanyuPinyinOutputFormatCombination {  
		String initials = null;
		String py = toPinYinUppercase(str); 
		if(py.length()>1){
			initials = py.substring(0, 1);
		}
		if(py.length()<=1){
			initials = py;
		}
		return initials.trim();  
	} 
	
	/** 
	 * 获取拼音首字母(小写)
	 * @param str 字符串
	 * @return str为颐和园 ,return获取到的是y
	 * @throws BadHanyuPinyinOutputFormatCombination 异常信息
	 */  
	public String toPinYinLowercaseInitials(String str) throws BadHanyuPinyinOutputFormatCombination {  
		String initials = null;
		String py = toPinYinLowercase(str); 
		if(py.length()>1){
			initials = py.substring(0, 1);
		}
		if(py.length()<=1){
			initials = py;
		}
		return initials.trim();  
	} 
  
	/** 
	 * 将str转换成拼音，如果不是汉字或者没有对应的拼音，则不作转换 
	 * @param str    字符串
	 * @param spera  默认,可为""
	 * @param type   转换格式
	 * @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); 
					}
					if(temp.length()>=1){
					   	temp = temp.substring(0, 1);
					}
						py += temp+(i==str.length()-1?"":spera);  
					}  
				}  
			}  
			return py.trim();  
		}  
}