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

上文我们使用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="UTF-8"></property>
<!-- 设定文件上传的最大值5MB，5*1024*1024 -->
<property name="maxUploadSize" value="5242880"></property>
</bean>

配置访问图片前缀

我们在访问图片时是以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" />

如下图所示：



如此一来，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="/WEB-INF/jsp/" />
<property name="suffix" value=".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="UTF-8"></property>
<!-- 设定文件上传的最大值5MB，5*1024*1024 -->
<property name="maxUploadSize" value="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>

创建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
*/
@Controller
public 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;
}
}
}

测试图片上传功能

上面我们都配置完后，现在我们就来试试图片上传功能，如下图所示，发现点击”开始上传”之后图片正常回显了。



接着我们点击”全部插入”按钮，可以看到在”上传图片”按钮的下方有我们刚才上传的四张图片，我们是可以点击任何一张图片在浏览器中浏览的，比如我们点击第三张图片——a.jpg。



在浏览器中访问的效果如下图所示。这样我们的图片上传功能便实现了。