首页 > 代码库 > (转)淘淘商城系列——实现图片上传功能

(转)淘淘商城系列——实现图片上传功能

http://blog.csdn.net/yerenyuan_pku/article/details/72808000

上文我们使用FastDFS-Client进行了简单的文件上传操作测试,淘淘商城项目中添加商品时上传图片的功能还没实现,如下图所示。本文将花大量笔墨来教大家如何实现图片上传这个功能。 
技术分享
我们来看下item-add.jsp页面,可以看到上传图片触发的方法是通过叫做picFileUpload的class来处理的,在<a>标签的下方是一个隐藏域,是用来接收图片上传到图片服务器的回显地址的,当我们提交表单的时候,可以把这些图片地址保存到数据库中。 
技术分享
图片上传的流程是这样的,item-add.jsp页面加载完之后,会自动调用TAOTAO.init进行初始化,如下图所示。 
技术分享
TAOTAO是在common.js文件中定义的,我们来看下common.js,可以看到TAOTAO=TT都是在这里定义的,在init方法中this.initPicUpload(data);是用来初始化上传组件的。初始化上传组件中就有我们在item-add.jsp页面中定义的叫做picFileUpload的class,由于上传操作可能不只一个地方调用,因此$(".picFileUpload").each(function(i,e){用来对所有调用上传组件的页面进行初始化。如果已经上传过图片,现在处于编辑状态的话,那么就使用_ele.siblings(".pics").find("ul").append("...")来加载原来已经添加过的图片。点击上传图片按钮后,就会加载富文本编辑的上传图片界面,富文本编辑器的参数是在上面var TT = TAOTAO = {的下面,指定了上传文件参数的名称,请求的url是/pic/upload,上传类型是image、flash、media、file四种。 
技术分享
下面我们来实现图片上传这个功能。

实现图片上传功能

导包

上传图片需要依赖commons-io和commons-fileupload开发包,我们需要在taotao-manger-web工程的Maven依赖中查看一下是否有这两个jar包,目前是有commons-io-1.3.2.jar这个jar包的(它是在taotao-common工程的Maven依赖中,而taotao-manager-web依赖了taotao-common,因此它也有了这个jar包),但目前没有commons-fileupload,因此我们需要在taotao-manager-web工程的pom.xml文件中添加对commons-fileupload的依赖。 
技术分享 
添加的依赖如下,由于在taotao-parent工程当中统一定义了版本号,因此这里不用指定版本号。

<!-- 文件上传组件 --><dependency>    <groupId>commons-fileupload</groupId>    <artifactId>commons-fileupload</artifactId></dependency>

配置文件上传解析器

我们需要在taotao-manager-web工程的springmvc.xml文件当中配置一下文件上传解析器,如下图所示。 
技术分享
为方便大家复制,现把文件上传解析器的配置贴出:

<!-- 定义文件上传解析器 --><bean id="multipartResolver"    class="org.springframework.web.multipart.commons.CommonsMultipartResolver">    <!-- 设定默认编码 -->    <property name="defaultEncoding" value=http://www.mamicode.com/"UTF-8"></property>    <!-- 设定文件上传的最大值5MB,5*1024*1024 -->    <property name="maxUploadSize" value=http://www.mamicode.com/"5242880"></property></bean>
  • 1

配置访问图片前缀

我们在访问图片时是以http的方式访问的,例如http://192.168.25.133/group1/M00/00/00/wKicDVjxPn2AOBiGAAHk-VzqZ6w952.jpg,从上文中我们知道图片服务器返回的图片路径是group1/M00/00/00/wKicDVjxPn2AOBiGAAHk-VzqZ6w952.jpg,也就是说没有前面那部分路径,即http://192.168.25.133/,而我们又不能在代码中写死前缀,因为IP及端口号都有可能更改,因此最好是放到配置文件当中,我们在src/main/resources/resource目录下新建一个resource.properties文件,配置文件中输入IMAGE_SERVER_URL=http://192.168.25.133/,这说明图片服务器中的nginx配置的访问端口是默认的80端口,如下图所示。 
技术分享

加载配置文件

我们在上面新建了resource.properties文件之后,在Spring容器中我们就需要加载该配置文件了,因此我们在springmvc.xml配置文件中加入如下配置:

<context:property-placeholder location="classpath:resource/resource.properties" />
  • 1
  • 1

如下图所示: 
技术分享
如此一来,springmvc.xml配置文件的完整内容就如下了。

<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"    xmlns:context="http://www.springframework.org/schema/context"    xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"     xmlns:mvc="http://www.springframework.org/schema/mvc"    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.2.xsd        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd        http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd">    <!-- 加载属性文件 -->    <context:property-placeholder location="classpath:resource/resource.properties" />    <context:component-scan base-package="com.taotao.controller" />    <mvc:annotation-driven />    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">        <property name="prefix" value=http://www.mamicode.com/"/WEB-INF/jsp/" />        <property name="suffix" value=http://www.mamicode.com/".jsp" />    </bean>    <!-- 静态资源映射 -->    <mvc:resources location="/WEB-INF/js/" mapping="/js/**"/>    <mvc:resources location="/WEB-INF/css/" mapping="/css/**"/>    <!-- 定义文件上传解析器 -->    <bean id="multipartResolver"        class="org.springframework.web.multipart.commons.CommonsMultipartResolver">        <!-- 设定默认编码 -->        <property name="defaultEncoding" value=http://www.mamicode.com/"UTF-8"></property>        <!-- 设定文件上传的最大值5MB,5*1024*1024 -->        <property name="maxUploadSize" value=http://www.mamicode.com/"5242880"></property>    </bean>    <!-- 引用dubbo服务 -->    <dubbo:application name="taotao-manager-web"/>    <dubbo:registry protocol="zookeeper" address="192.168.25.128:2181"/>        <dubbo:reference interface="com.taotao.service.ItemService" id="itemService" />    <dubbo:reference interface="com.taotao.service.ItemCatService" id="itemCatService" /></beans>
  • 1

创建Controller

我们需要新建一个PictureController类来处理图片上传操作,如下图所示。 
技术分享
上图中@Value("${IMAGE_SERVER_URL}")是为了注入我们在配置文件resource.properties中配置的图片访问前缀。@RequestMapping("/pic/upload")指定上传文件(图片)请求的url,与下图指定的url一样,上图uploadPic方法中的形参——uploadFile与下图的上传文件的参数名称是要一样的。 
技术分享
那么方法uploadPic应该返回什么样的格式呢,我们可以从kindeditor官网查看一下,如下图所示,可以看到返回值格式是json串,那么我们便有三种实现方式。第一种是直接返回Map格式的数据,json和Map数据都是key和value的形式,因此返回Map是没问题的。第二种是创建一个pojo类,该类有三个属性,分别是error、url、message,然后将该类转换为json之后返回。第三种是将Map转变为json字符串返回。这里我们暂且使用第一种方式。 
技术分享
为了方便大家复制,现把PictureController类的代码粘贴如下:

/** * 图片上传Controller * <p>Title: PictureController</p> * <p>Description: </p> * <p>Company: www.itcast.cn</p>  * @version 1.0 */@Controllerpublic class PictureController {    @Value("${IMAGE_SERVER_URL}")    private String IMAGE_SERVER_URL;    @RequestMapping("/pic/upload")    @ResponseBody    public Map uploadPic(MultipartFile uploadFile) {        try {            // 首先接收页面上传的文件            byte[] content = uploadFile.getBytes();            // 取出文件的扩展名            String originalFilename = uploadFile.getOriginalFilename();            String ext = originalFilename.substring(originalFilename.lastIndexOf(".") + 1);            // 把这个文件内容上传到图片服务器            FastDFSClient fastDFSClient = new FastDFSClient("classpath:resource/fast_dfs.conf");            String url = fastDFSClient.uploadFile(content, ext);            // 从配置文件中取图片服务器的url            // 创建返回结果对象            Map result = new HashMap();            result.put("error", 0);            result.put("url", IMAGE_SERVER_URL + url);            // 返回结果            return result;        } catch (Exception e) {            e.printStackTrace();            Map result = new HashMap();            result.put("error", 1);            result.put("message", "图片上传失败");            return result;        }    }}
  • 1

测试图片上传功能

上面我们都配置完后,现在我们就来试试图片上传功能,如下图所示,发现点击”开始上传”之后图片正常回显了。 
技术分享
接着我们点击”全部插入”按钮,可以看到在”上传图片”按钮的下方有我们刚才上传的四张图片,我们是可以点击任何一张图片在浏览器中浏览的,比如我们点击第三张图片——a.jpg。 
技术分享
在浏览器中访问的效果如下图所示。这样我们的图片上传功能便实现了。 
技术分享

(转)淘淘商城系列——实现图片上传功能