[版权申明:本文系作者原创,转载请注明出处]
文章出处: 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