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的成熟的图片裁剪的插件。如图：

该插件使用比较简单：

<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(<span style="color:#ff0000;">200 </span>/ c.w * boundx) + 'px', <span style="color:#ff0000;">//200 为预览div的宽和高</span>
    height: Math.round(<span style="color:#ff0000;">200 </span>/ 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;
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";
}
}

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

来源：http://blog.csdn.net/csd_xuming/article/details/8848939