struts2+jsp+jquery+Jcrop实现图片裁剪并上传

struts2+jsp+jquery+Jcrop实现图片裁剪并上传

---------------------------------------------------------------------------------------------------------------------------------------------------------------

今天有业务需要制作用户头像的需求，在网上找了个可以裁剪大图制作自己希望大小的图片的方法（基于Struts2）。特此记录一下。

不废话，具体的步骤如下：

<1> 使用html标签上传需要裁剪的大图。

<2> 在页面呈现大图，使用Jcrop（Jquery）对大图进行裁剪，并且可以进行预览。

<3> 选择好截取部分之后发送数据给Action，在服务器端使用 Java API 对大图进行裁剪。

<4> 保存大图裁剪好的头像到指定目录，完成业务。

下面一步一步做：

第一步：使用html标签上传需要裁剪的大图。

这一步说白了也就是使用Struts2自带的FileUpload功能，把图片进行上传具体代码如下：

html页面：

<form id="ulform" action="uploadPic.action" enctype="multipart/form-data" method="post">
    <input type="file" name="pic" id="file" value="选择图片" />
    <input type="submit" value="点击上传" />
</form>

Struts2配置文件

	<action name="uploadPic" class="com.luoxiao.tbms.user.action.UserAction" method="uploadPic">
		<result name="success" type="redirect">changePic.jsp</result>
		<result name="error">changePic.jsp</result>
	</action>

根据配置点击提交按钮，会提交表单，把图片以流的形式发送给 UserAction的uploadPic方法，该方法如下：

public class UserAction{
	private File pic;   //(在此省略 get 和 set 方法)
	private String picFileName; //（省略get和set方法， 该属性Struts2会自动赋值为上传文件的文件名）
	public String uploadPic() {
		String[] str = { ".jpg", ".jpeg", ".bmp", ".gif" };
		// 获取用户登录名
		TbUser curruser = (TbUser) getValue(SCOPE_SESSION, "curruser");
		// 限定文件大小是4MB
		if (pic == null || pic.length() > 4194304) {
			//文件过大
			return "error";
		}
		for (String s : str) {
			if (picFileName.endsWith(s)) {
				String realPath = ServletActionContext.getServletContext().getRealPath("/uploadpic");// 在tomcat中保存图片的实际路径  ==  "webRoot/uploadpic/"
				File saveFile = new File(new File(realPath), "新文件名.jpg"); // 在该实际路径下实例化一个文件
				// 判断父目录是否存在
				if (!saveFile.getParentFile().exists()) {
					saveFile.getParentFile().mkdirs();
				}
				try {
					// 执行文件上传
					// FileUtils 类名 org.apache.commons.io.FileUtils;
					// 是commons-io包中的，commons-fileupload 必须依赖
					// commons-io包实现文件上次，实际上就是将一个文件转换成流文件进行读写
					FileUtils.copyFile(pic, saveFile);
				} catch (IOException e) {
					return "imageError";
				}
			}
		}
		return "success";
	}
}

这样就可以把用户选择的图片上传到tomcat的webRoot/uploadpic/文件夹下。 然后访问页面，页面中就可以显示出刚刚上传的大图了。代码如下。

<div style="width: 500px; height: 500px;">
	<img style="margin-top:20px;" src="../uploadpic/上传文件名称.jpg"/>" id="target" alt="" />
</div>

第一步完成。

第二步：使用Jcrop插件裁剪该图片，并且在页面中预览。

Jcrop是一个基于JQuery的成熟的图片裁剪的插件。如图：

想要使用它，需要去官方网站下载该js，现给出一个地址：(附带jquery)

点击去往Jcrop插件下载页面

该插件使用比较简单：

<1> 在裁剪图片页面中，引入两个js文件，和1个Jcrop需要的css文件(Jcrop包中有，注意引入顺序，先引入jquery)：

	<script src="../js/jquery-1.8.3.min.js" type="text/javascript"></script>
	<script src="../js/jquery.Jcrop.js" type="text/javascript"></script>
	<link rel="stylesheet" href="../css/jquery.Jcrop.css" type="text/css" />

<2> 在html页面中按照Jcrop要求的格式编写两个img标签，一个用作裁剪后的预览，一个用作显示大图，代码如下：

预览：
<div style="width:200px;height:200px;overflow:hidden; border:1px solid gray;">
   <img id="preview" width="200px" height="200px" />
</div>	
原图：
   <img src="../uploadpic/上传大图.jpg" id="target" alt="" />

<3> 在该页面中写js代码，使其可以裁剪图片并且预览：

<script type="text/javascript">
        var x;
	var y;
	var width;
	var height;
	$(function(){
		var jcrop_api, boundx, boundy;
		//使原图具有裁剪功能
		$('#target').Jcrop({
			onChange: updatePreview,
			onSelect: updatePreview,
			aspectRatio: 1
		},function(){
			// Use the API to get the real image size
			var bounds = this.getBounds();
			boundx = bounds[0];
			boundy = bounds[1];
			// Store the API in the jcrop_api variable
			jcrop_api = this;
		});
		//裁剪过程中，每改变裁剪大小执行该函数
		function updatePreview(c){
			if (parseInt(c.w) > 0){	
				$('#preview').css({
					width: Math.round(200 / c.w * boundx) + 'px',  	//200 为预览div的宽和高
					height: Math.round(200 / c.h * boundy) + 'px',
					marginLeft: '-' + Math.round(200 / c.w * c.x) + 'px',
					marginTop: '-' + Math.round(200 / c.h * c.y) + 'px'
				});
				$('#width').val(c.w);  //c.w 裁剪区域的宽
				$('#height').val(c.h); //c.h 裁剪区域的高
				$('#x').val(c.x);  //c.x 裁剪区域左上角顶点相对于图片左上角顶点的x坐标
				$('#y').val(c.y);  //c.y 裁剪区域顶点的y坐标
			}
		  };
	});
  </script>

至此我们已经可以看到裁剪之后的样子了，并且也可以得到裁剪区域的x，y，height，width属性。

第三步：把截取的该区域的属性传递给action，让action根据所得属性，利用javaAPI把原图裁剪成小图。

<1> 设置form表单与隐藏域表单组件，并且在裁剪的时候对该四个组件的value属性赋值

<form action="cutPic.action" method="post">
	点击
	<input type="hidden" name="image.x" id="x"/>
	<input type="hidden" name="image.y" id="y"/>
	<input type="hidden" name="image.width" id="width"/>
	<input type="hidden" name="image.height" id="height"/>
	<input type="submit" value="确定" />
	，设置完成。
</form>

<2> 点击确定，提交该表单，访问action，配置如下：

<action name="cutPic" class="com.luoxiao.tbms.user.action.UserAction" method="cutPic">
	<result name="success" type="redirectAction">../announcement/announcement_list.action</result>
</action>

<3>Struts2带着四个参数访问UserAction，并且会自动给UserAction中的image属性赋值，该image属性为OperateImage的一个实例对象，该类为裁剪图片类，代码如下：

package com.luoxiao.util;

import java.awt.Rectangle;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.Iterator;
import javax.imageio.ImageIO;
import javax.imageio.ImageReadParam;
import javax.imageio.ImageReader;
import javax.imageio.stream.ImageInputStream;

public class OperateImage {
	// ===源图片路径名称如:c:\1.jpg
	private String srcpath;
	// ===剪切图片存放路径名称.如:c:\2.jpg
	private String subpath;
	// ===剪切点x坐标
	private int x;
	private int y;
	// ===剪切点宽度
	private int width;
	private int height;   (省略四个属性的get & set)
	public OperateImage() {
	}
	/** 对图片裁剪，并把裁剪完的新图片保存 */
	public void cut() throws IOException {
		FileInputStream is = null;
		ImageInputStream iis = null;
		try {
			// 读取图片文件
			is = new FileInputStream(srcpath);
			/*
			 * 返回包含所有当前已注册 ImageReader 的 Iterator，这些 ImageReader 声称能够解码指定格式。
			 * 参数：formatName - 包含非正式格式名称 . （例如 "jpeg" 或 "tiff"）等 。
			 */
			Iterator<ImageReader> it = ImageIO.getImageReadersByFormatName("jpg");
			ImageReader reader = it.next();
			// 获取图片流
			iis = ImageIO.createImageInputStream(is);
			/*
			 * <p>iis:读取源.true:只向前搜索 </p>.将它标记为 ‘只向前搜索’。
			 * 此设置意味着包含在输入源中的图像将只按顺序读取，可能允许 reader 避免缓存包含与以前已经读取的图像关联的数据的那些输入部分。
			 */
			reader.setInput(iis, true);
			/*
			 * <p>描述如何对流进行解码的类<p>.用于指定如何在输入时从 Java Image I/O
			 * 框架的上下文中的流转换一幅图像或一组图像。用于特定图像格式的插件 将从其 ImageReader 实现的
			 * getDefaultReadParam 方法中返回 ImageReadParam 的实例。
			 */
			ImageReadParam param = reader.getDefaultReadParam();
			/*
			 * 图片裁剪区域。Rectangle 指定了坐标空间中的一个区域，通过 Rectangle 对象
			 * 的左上顶点的坐标（x，y）、宽度和高度可以定义这个区域。
			 */
			Rectangle rect = new Rectangle(x, y, width, height);
			// 提供一个 BufferedImage，将其用作解码像素数据的目标。
			param.setSourceRegion(rect);
			/*
			 * 使用所提供的 ImageReadParam 读取通过索引 imageIndex 指定的对象，并将 它作为一个完整的
			 * BufferedImage 返回。
			 */
			BufferedImage bi = reader.read(0, param);
			// 保存新图片
			ImageIO.write(bi, "jpg", new File(subpath));
		} finally {
			if (is != null)
				is.close();
			if (iis != null)
				iis.close();
		}

	}
}

<4> 给该类的实例的四个属性 x,y,width,height赋值之后，访问action中的cutPic方法，代码如下：

public class UserAction extends BaseAction {
	private OperateImage image;(省略get set)

	private File pic; // 接收这个上传的文件
	private String picFileName; // Struts2提供的格式，在文件名后+FileName就是上传文件的名字

	/**
	 * 裁剪头像
	 */
	public String cutPic(){
		String name = ServletActionContext.getServletContext().getRealPath("/uploadpic/原图名.jpg");
		image.setSrcpath(name);
		image.setSubpath(ServletActionContext.getServletContext().getRealPath("/uploadpic/裁剪目标图名.jpg"));
		try {
			image.cut(); //执行裁剪操作  执行完后即可生成目标图在对应文件夹内。
		} catch (IOException e) {
			e.printStackTrace();
		}
		return "success";
	}
}

第四步：把截取好的头像保存在具体文件夹下即可,裁剪过程完成。