文件一键上传、汉字转拼音、excel文件上传下载功能模块的实现
----------------------------------------------------------------------------------------------
[版权申明：本文系作者原创，转载请注明出处]
文章出处：http://blog.csdn.net/sdksdk0/article/details/52557755
作者：朱培 ID：sdksdk0
--------------------------------------------------------------------------------------------
今天要分享的功能是一键上传excel文件，然后显示在页面中，以及将网页上的数据已excel文件的形式下载下来。使用的是Apache的POI,本文分享的实例是SSH框架完成的一个项目中的一个功能模块之一，使用了Maven，所以相关的jar包都贴出了maven的相关jar坐标。因为这个项目设计了很多ssh的配置，这里本文就不在一一列出，只写了关键的代码，文末提供源码下载，希望可以帮助到有需要的开发者。
一、POI简介
Apache POI 是用Java编写的免费开源的跨平台的 Java API，Apache POI提供API给Java程式对Microsoft Office格式档案读和写的功能。POI为“Poor Obfuscation Implementation”的首字母缩写，意为“可怜的模糊实现”。
Apache POI 是创建和维护操作各种符合Office Open XML（OOXML）标准和微软的OLE 2复合文档格式（OLE2）的Java API。用它可以使用Java读取和创建,修改MS Excel文件.而且,还可以使用Java读取和创建MS Word和MSPowerPoint文件。Apache POI 提供Java操作Excel解决方案（适用于Excel97-2008）。
网址是http://poi.apache.org/，我们可以通过添加maven倚赖的方式下载，poi的坐标是：
<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>3.9</version> </dependency>
二、实例准备
页面效果如下：
（这里的数据我是随便写的，仅作为参考数据，不是真实数据）
通过点击页面上的批量导入按钮，可以实现界面无刷新一次性导入写好的数据。我们先excel中准备好数据：注意的是在excel中的数字都要改为文本格式的，不能是“常规",否则导入会失败的。
三、一键上传
jsp页面代码：
需要先导入：jquery.ocupload-1.1.2.js
然后再页面中给你的按钮的id添加upload的方法。 （以下片段在文末项目中的位置是：/BOS/src/main/webapp/WEB-INF/pages/base/region.jsp）
// 对批量导入添加一键上传效果
$('#button-import').upload({
name : 'upload',
action : '${pageContext.request.contextPath}/region_OCimport', // 表单提交路径
onComplete : function(response){
var data = eval("("+response+")");
$.messager.alert('信息',data.msg,'info');
$('#grid').datagrid('reload');
}
});
这个我转到的是Action中：
这里的话我就是加了pinyin4j来将汉字转为拼音，这样的话做的就是简码了；
在pom.xml中添加maven依赖：（以下片段在文末项目中的位置是：/BOS/pom.xml）
<dependency> <groupId>com.belerweb</groupId> <artifactId>pinyin4j</artifactId> <version>2.5.0</version> </dependency>
在Action中处理：（以下片段在文末项目中的位置是：/BOS/src/main/java/cn/tf/bos/web/action/bc/RegionAction.java）
//接收上传的数据
public String OCimport() throws IOException{
// 1、 工作薄对象
HSSFWorkbook hssfWorkbook = new HSSFWorkbook(new FileInputStream(upload));
// 解析工作薄
hssfWorkbook.setMissingCellPolicy(Row.CREATE_NULL_AS_BLANK); // 避免空指针异常
// 2、 获得Sheet
HSSFSheet sheet = hssfWorkbook.getSheetAt(0); // 获得第一个sheet
// 3、遍历每一行
for (Row row : sheet) {
if (row.getRowNum() == 0) {
continue;
}
// 从第二行 开始解析
Region region = new Region();
String id = row.getCell(0).getStringCellValue(); // 获得第一个单元格信息
if (id.trim().equals("")) {
// id 无值，跳过
continue;
}
region.setId(id);
region.setProvince(row.getCell(1).getStringCellValue());
region.setCity(row.getCell(2).getStringCellValue());
region.setDistrict(row.getCell(3).getStringCellValue());
region.setPostcode(row.getCell(4).getStringCellValue());
//使用pinyin4j生成编码和简码
String str=region.getProvince()+region.getCity()+region.getDistrict();
str=str.replaceAll("省", "").replaceAll("市", "").replaceAll("区", "").replaceAll("县", "");
String[] arr=PinYin4jUtils.getHeadByString(str);
StringBuffer sb = new StringBuffer();
for (String headChar : arr) {
sb.append(headChar);
}
region.setShortcode(sb.toString()); // 简码
// 生成城市编码
region.setCitycode(PinYin4jUtils.hanziToPinyin(region.getCity(), ""));
//保存数据时出错
try {
regionService.saveRegion(region);
} catch (Exception e) {
// 导入region失败，记录日志
LOG.error("区域导入失败，编号：" + region.getId(), e);
}
}
//返回json
Map<String,Object> map=new HashMap<String,Object>();
map.put("result", "success");
map.put("msg", "区域导入完成");
ActionContext.getContext().put("map", map);
return "OCimport";
}
private File upload;
public void setUpload(File upload) {
this.upload = upload;
}
汉字转换为拼音的工具类为：（以下片段在文末项目中的位置是：/BOS/src/main/java/cn/tf/bos/utils/PinYin4jUtils.java）
public class PinYin4jUtils {
/**
* 将字符串转换成拼音数组
*
* @param src
* @return
*/
public static String[] stringToPinyin(String src) {
return stringToPinyin(src, false, null);
}
/**
* 将字符串转换成拼音数组
*
* @param src
* @return
*/
public static String[] stringToPinyin(String src, String separator) {
return stringToPinyin(src, true, separator);
}
/**
* 将字符串转换成拼音数组
*
* @param src
* @param isPolyphone
* 是否查出多音字的所有拼音
* @param separator
* 多音字拼音之间的分隔符
* @return
*/
public static String[] stringToPinyin(String src, boolean isPolyphone,
String separator) {
// 判断字符串是否为空
if ("".equals(src) || null == src) {
return null;
}
char[] srcChar = src.toCharArray();
int srcCount = srcChar.length;
String[] srcStr = new String[srcCount];
for (int i = 0; i < srcCount; i++) {
srcStr[i] = charToPinyin(srcChar[i], isPolyphone, separator);
}
return srcStr;
}
/**
* 将单个字符转换成拼音
*
* @param src
* @return
*/
public static String charToPinyin(char src, boolean isPolyphone,
String separator) {
// 创建汉语拼音处理类
HanyuPinyinOutputFormat defaultFormat = new HanyuPinyinOutputFormat();
// 输出设置，大小写，音标方式
defaultFormat.setCaseType(HanyuPinyinCaseType.LOWERCASE);
defaultFormat.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
StringBuffer tempPinying = new StringBuffer();
// 如果是中文
if (src > 128) {
try {
// 转换得出结果
String[] strs = PinyinHelper.toHanyuPinyinStringArray(src,
defaultFormat);
// 是否查出多音字，默认是查出多音字的第一个字符
if (isPolyphone && null != separator) {
for (int i = 0; i < strs.length; i++) {
tempPinying.append(strs[i]);
if (strs.length != (i + 1)) {
// 多音字之间用特殊符号间隔起来
tempPinying.append(separator);
}
}
} else {
tempPinying.append(strs[0]);
}
} catch (BadHanyuPinyinOutputFormatCombination e) {
e.printStackTrace();
}
} else {
tempPinying.append(src);
}
return tempPinying.toString();
}
public static String hanziToPinyin(String hanzi) {
return hanziToPinyin(hanzi, " ");
}
/**
* 将汉字转换成拼音
*
* @param hanzi
* @param separator
* @return
*/
public static String hanziToPinyin(String hanzi, String separator) {
// 创建汉语拼音处理类
HanyuPinyinOutputFormat defaultFormat = new HanyuPinyinOutputFormat();
// 输出设置，大小写，音标方式
defaultFormat.setCaseType(HanyuPinyinCaseType.LOWERCASE);
defaultFormat.setToneType(HanyuPinyinToneType.WITHOUT_TONE);
String pinyingStr = "";
try {
pinyingStr = PinyinHelper.toHanyuPinyinString(hanzi, defaultFormat,
separator);
} catch (BadHanyuPinyinOutputFormatCombination e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return pinyingStr;
}
/**
* 将字符串数组转换成字符串
*
* @param str
* @param separator
* 各个字符串之间的分隔符
* @return
*/
public static String stringArrayToString(String[] str, String separator) {
StringBuffer sb = new StringBuffer();
for (int i = 0; i < str.length; i++) {
sb.append(str[i]);
if (str.length != (i + 1)) {
sb.append(separator);
}
}
return sb.toString();
}
/**
* 简单的将各个字符数组之间连接起来
*
* @param str
* @return
*/
public static String stringArrayToString(String[] str) {
return stringArrayToString(str, "");
}
/**
* 将字符数组转换成字符串
*
* @param str
* @param separator
* 各个字符串之间的分隔符
* @return
*/
public static String charArrayToString(char[] ch, String separator) {
StringBuffer sb = new StringBuffer();
for (int i = 0; i < ch.length; i++) {
sb.append(ch[i]);
if (ch.length != (i + 1)) {
sb.append(separator);
}
}
return sb.toString();
}
/**
* 将字符数组转换成字符串
*
* @param str
* @return
*/
public static String charArrayToString(char[] ch) {
return charArrayToString(ch, " ");
}
/**
* 取汉字的首字母
*
* @param src
* @param isCapital
* 是否是大写
* @return
*/
public static char[] getHeadByChar(char src, boolean isCapital) {
// 如果不是汉字直接返回
if (src <= 128) {
return new char[] { src };
}
// 获取所有的拼音
String[] pinyingStr = PinyinHelper.toHanyuPinyinStringArray(src);
// 创建返回对象
int polyphoneSize = pinyingStr.length;
char[] headChars = new char[polyphoneSize];
int i = 0;
// 截取首字符
for (String s : pinyingStr) {
char headChar = s.charAt(0);
// 首字母是否大写，默认是小写
if (isCapital) {
headChars[i] = Character.toUpperCase(headChar);
} else {
headChars[i] = headChar;
}
i++;
}
return headChars;
}
/**
* 取汉字的首字母(默认是大写)
*
* @param src
* @return
*/
public static char[] getHeadByChar(char src) {
return getHeadByChar(src, true);
}
/**
* 查找字符串首字母
*
* @param src
* @return
*/
public static String[] getHeadByString(String src) {
return getHeadByString(src, true);
}
/**
* 查找字符串首字母
*
* @param src
* @param isCapital
* 是否大写
* @return
*/
public static String[] getHeadByString(String src, boolean isCapital) {
return getHeadByString(src, isCapital, null);
}
/**
* 查找字符串首字母
*
* @param src
* @param isCapital
* 是否大写
* @param separator
* 分隔符
* @return
*/
public static String[] getHeadByString(String src, boolean isCapital,
String separator) {
char[] chars = src.toCharArray();
String[] headString = new String[chars.length];
int i = 0;
for (char ch : chars) {
char[] chs = getHeadByChar(ch, isCapital);
StringBuffer sb = new StringBuffer();
if (null != separator) {
int j = 1;
for (char ch1 : chs) {
sb.append(ch1);
if (j != chs.length) {
sb.append(separator);
}
j++;
}
} else {
sb.append(chs[0]);
}
headString[i] = sb.toString();
i++;
}
return headString;
}
}
在struts.xml中配置返回：（以下片段在文末项目中的位置是：/BOS/src/main/resources/struts.xml）
<action name="region_*" class="regionAction" method="{1}">
<result name="OCimport" type="json">
<param name="root">map</param>
</result> </action>
这样的话就全部实现了上传的功能了。
四、文件下载
接下来说一下下载的功能：
例如我们要将这个页面中的内容变为excel文件下载下来。
在下载的jsp页面中：
点击按钮触发这个下载的函数,我们有一个函数：点击后跳转到action中。（以下片段在文末项目中的位置是：/BOS/src/main/webapp/WEB-INF/pages/base/subarea.jsp）
function doExport(){
location.href="${pageContext.request.contextPath}/subarea_exportFile";
}
在action中：（以下片段在文末项目中的位置是：/BOS/src/main/java/cn/tf/bos/web/action/bc/SubareaAction.java）
public String exportFile() throws IOException{
// 对文件名进行编码
String downloadFileName = "分区数据.xls";
// 获得用户使用浏览器类型
String agent = ServletActionContext.getRequest().getHeader("user-agent");
// 对下载文件名编码
downloadFileName = FileUtils.encodeDownloadFilename(downloadFileName, agent);
// 将结果放入值栈
ActionContext.getContext().put("downloadFileName", downloadFileName);
return "exportFile";
}
//文件下载流
public InputStream getInputStream() throws IOException{
PageResponseBean pageResponseBean=(PageResponseBean) ServletActionContext.getRequest().getSession().getAttribute("pageResponseBean");
List<Subarea> subareas=pageResponseBean.getRows();
HSSFWorkbook hssfWorkbook=new HSSFWorkbook();
HSSFSheet sheet=hssfWorkbook.createSheet("分区数据");
HSSFRow headRow=sheet.createRow(0);
headRow.createCell(0).setCellValue("分区编号");
headRow.createCell(1).setCellValue("关键字");
headRow.createCell(2).setCellValue("起始号");
headRow.createCell(3).setCellValue("结束号");
headRow.createCell(4).setCellValue("是否区分单双号号");
headRow.createCell(5).setCellValue("位置信息");
// 向excel写数据
for (Subarea subarea : subareas) {
// 每个分区一行
HSSFRow dataRow = sheet.createRow(sheet.getLastRowNum() + 1);
dataRow.createCell(0).setCellValue(subarea.getId());
dataRow.createCell(1).setCellValue(subarea.getAddresskey());
dataRow.createCell(2).setCellValue(subarea.getStartnum());
dataRow.createCell(3).setCellValue(subarea.getEndnum());
dataRow.createCell(4).setCellValue(subarea.getSingle());
dataRow.createCell(5).setCellValue(subarea.getPosition());
}
// 将数据缓存到字节数组
ByteArrayOutputStream arrayOutputStream = new ByteArrayOutputStream();
hssfWorkbook.write(arrayOutputStream);
arrayOutputStream.close();
byte[] data = arrayOutputStream.toByteArray();
// 再通过字节数组输入流读取数据
return new ByteArrayInputStream(data);
}
在struts.xml中配置：
<result name="exportFile" type="stream">
<param name="contentType">application/vnd.ms-excel</param>
<param name="contentDisposition">attachment;filename=${downloadFileName}</param>
</result>
这样我们就可以把数据下载出来了：
总结：文本使用的都是非常经典的技术来实现了文件一键上传、汉字转拼音、文件上传、文件下载的功能，具有非常好的实际意义，属于开发者必备技能之一。
项目地址：https://github.com/sdksdk0/BOS
