人事信息管理系统中,需要管理用户的个人身份照片。通常这种格式的照片只有几 K 到几十 K 大小,保存在数据库中易于进行管理和维护(如果放在文件夹下容易发生误操作而引起数据被修改或丢失)。
功能设计:给用户提供一个上传的界面,并设定上传文件的尺寸上限。用户上传的照片先统一保存在一个临时文件夹中,之后可以用 <img> 指向临时文件夹中的这个图片,让用户可以预览自己上传的照片。当所有的用户信息都收集完成后,将图片和其他信息一并提交,保存到数据库中。保存成功以后,删除临时文件夹中的图片。
实现步骤:
我使用的是从 struts 主页上下载的 struts-1.2.8-src ,其中 web/examples/ 目录下有一个 upload 的例子,稍微修改了一下就直接拿过来用了。这是一个 JSP 页面、 ActionForm 和 Action 的组合。下面分别列出各自的代码。
upload.jsp 的部分源代码:
<html:form action="/UploadSubmit" enctype="multipart/form-data">
请选择需要上传的照片 :
<html:file property="theFile"/>
<html:submit value=" 上传 "/>
</html:form>
接下来需要在 ActionForm 中声明这个属性,并设置 getter 和 setter 方法,这部分源代码如下:
public class UploadForm extends ActionForm {
protected FormFile theFile;
public FormFile getTheFile() {
return theFile;
}
public void setTheFile(FormFile theFile) {
this.theFile = theFile;
}
}
这个表单的 theFile 属性不是 String 或 boolean ,而是 org.apache.struts.upload.FormFile 。因为用户上传的是一个二进制文件,而 HTTP 协议是以文本形式传输数据的,这就需要进行转换。打个比方,一辆汽车需要从甲地送到乙地,但是两地之间只有一条索道,汽车没法开,所以就想个办法在甲地把汽车先拆了,把零件送到乙地再重新组装成一辆汽车。 FormFile 起的就是拆卸和组装的作用,只不过它把拆卸、传输和组装的过程都封装起来了,我们看到的是一辆汽车从甲地开进 FormFile ,过一会它就从乙地开出来了 J 我们要决定的只是把它停到什么地方,这就是 Action 的活了。
按照功能设计, Action 要把这部车停到一个临时文件夹下面,这部分源代码如下:
public ActionForward execute(ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response)
throws Exception {
if (form instanceof UploadForm) {
UploadForm theForm = (UploadForm) form;
//获取上传的数据文件
FormFile file = theForm.getTheFile();
// 获取文件名
String filename= file.getFileName();
// 设置图片文件临时存放的路径
HttpSession session = request.getSession();
String path = session.getServletContext().getRealPath("/") + "temp//" + filename;
try {
// 读取文件中的数据,获取二进制的数据流
InputStream stream = file.getInputStream();
// 把数据写到指定路径
OutputStream bos = new FileOutputStream(path);
int bytesRead = 0;
byte[] buffer = new byte[8192];
while ((bytesRead = stream.read(buffer, 0, 8192)) != -1) {
bos.write(buffer, 0, bytesRead);
}
bos.close();
logger.info("The file has been written to /""
+ path + "/"");
// 设计一个标记,说明用户已经上传过照片了。
session.setAttribute("p_w_picpathuploaded","true");
session.setAttribute("filename",filename);
// close the stream
stream.close();
bos.flush();
bos.close();
}catch (FileNotFoundException fnfe) {
return null;
}catch (IOException ioe) {
return null;
}
//destroy the temporary file created
file.destroy();
// 转向下一个页面
return mapping.findForward("next");
}
//this shouldn't happen in this example
return null;
}
这样图片就被放在 temp 的临时文件夹下,显示的时候,只需要先检查一下标记,看看用户是否上传了照片,如果已经上传,就用一个 <img src=””> 引用这个图片。还有一个小地方需要修改,因为限定上传的是身份照片,需要限定一个尺寸上限,这个在 struts 的 upload 里面有现成的例子。先在 struts-config.xml 中配置这个 ActionForm和 Action :
<form-bean name="uploadForm"
type="org.apache.struts.webapp.upload.UploadForm"/>
……
<action input="/pages/hr/error.jsp" name="uploadForm"
path="/UploadSubmit" scope="request"
type="org.apache.struts.webapp.upload.UploadAction" validate="true">
<forward name="next" path="/pages/hr/input.jsp"/>
</action>
……
<controller maxFileSize="2M" inputForward="true" />
在配置文件中已经看到 <action> 的 validate 属性被设置成“ true ”,这就是说表单提交之前先要对其内容进行验证,这里我们要验证的就是 theFile 是否超出了 controller 中设定的最大尺寸 ”2M” 。这个验证是通过ActionForm 的 validate 方法来实现的:
/**
* Check to make sure the client hasn't exceeded the maximum allowed upload size inside of this validate method.
**/
public ActionErrors validate(ActionMapping mapping,
HttpServletRequest request) {
ActionErrors errors = null;
//has the maximum length been exceeded?
Boolean maxLengthExceeded =
(Boolean) request.getAttribute(
MultipartRequestHandler.ATTRIBUTE_MAX_LENGTH_EXCEEDED);
if ((maxLengthExceeded != null) && (maxLengthExceeded.booleanValue())) {
errors = new ActionErrors();
errors.add(
ActionMessages.GLOBAL_MESSAGE ,
new ActionMessage("maxLengthExceeded"));
errors.add(
ActionMessages.GLOBAL_MESSAGE ,
new ActionMessage("maxLengthExplanation"));
}
return errors;
}
这里我估计有个 hook 之类的东西先截获了表单(应该和 controller 有关),对 theFile 的尺寸进行校验,然后把结果保存在 request scope 中。 Validate 方法只要检查一下这个结果就可以了,如果尺寸超标,表单就不会被提交给 Action 。
以上算是完成了第一步,从用户那里拿到照片,并保存在临时文件夹当中。接下来要做的就是把照片保存到MySQL 数据库中,这个字段我用的是 MEDIUMBLOB ,因为 BLOB 最大长度是 216-1 字节,大约 64K ;MEDIUMBLOB 是 224-1 字节,约 16M ,足够用了。保存图片的主要代码如下:
/**
* 将用户的照片保存在数据表中,添加成功后,删除临时文件夹中的图片。
* @param id 用户的身份号,作为图片的标识码
* @param path 图片存放的路径。一般存放在一个临时文件夹中。
* @return
*/
public static void saveImage(int id, String path) throws SQLException{
String time = new java.util.Date().toString();
Connection conn = null;
PreparedStatement pstmt = null;
boolean flag = false;
// 获取连接
try {
conn = DbManager.getConnection();
logger.info(time + ":saveImage() 从 DbManager 数据库连接池获取一个连接。 ");
} catch (SQLException e) {
// 如果没有能够从 DbManager 获取连接,此次查询操作失败
logger.error(time + ": saveImage() 不能获取数据库连接,无法保存图片! ");
throw new SQLException(":saveImage() 不能获取数据库连接,无法保存图片! ");
}
// 执行查询
try {
pstmt = conn.prepareStatement("UPDATE hr01 SET hr01_photo=? where hr01_id=?");
FileInputStream in = new FileInputStream(path);
pstmt.setBinaryStream(1,in,in.available());
pstmt.setInt(2,id);
pstmt.executeUpdate();
pstmt.executeUpdate("COMMIT");
logger.info(" 图片 " + path + " 被添加到数据库中! ");
flag = true;
}catch(IOException e){
logger.error(" 图片 " + path + " 文件读写错误!请检查文件路径是否正确 ");
throw new SQLException(" 无法保存图片! ");
}catch (SQLException ex) {
logger.error(new java.util.Date() + "Error:Insert into table."
+ ex.getMessage());
logger.error(" 图片 " + path +" 没有被保存到数据库 .");
throw new SQLException(" 图片 " + path +" 没有被保存到数据库 .");
} finally {
try {
pstmt.close();
conn.close();
logger.info("DbHrinfo saveImage() closed the connection created at " + time);
} catch (SQLException e) {
}
}
>
// 图片添加成功以后就删除临时文件夹中的图片数据
if(flag == true){
File file = new File(path);
if(file.exists()){
file.delete();
}
}
}
需要注意的是 pstmt.executeUpdate("COMMIT"); 这行代码,最初我并没有写这行,程序能顺利执行,日志中也显示“图片××被添加到数据库中”,但是到库里一查询,什么都没有。 SQL 语句被提交,但是数据库里面没有即时的显示,估计是缓冲区的作用,它把我的 SQL 语句缓存起来而不是立即提交给数据库。后来我在 textpad 里面单独执行这段代码,发现不用“ COMMIT ” SQL 语句就立即被提交了。这个地方还没有弄清楚,以后需要继续研究。
功能上做一点小改进,用户提交了照片以后,浏览了一下觉得不满意,只要还没有最终提交数据,当然允许他重新上传一个照片。我们只需要在 <img src=””> 下面提供一个“重新提交”的链接就可以了。这个链接指向一个AlterImageAction ,它的功能就是清除 session 中用户已经上传照片的标记,并把刚才保存到临时文件夹中的照片删掉,等待用户重新上传。这部分代码如下:
public ActionForward execute(ActionMapping mapping,
ActionForm form,HttpServletRequest request,
HttpServletResponse response)
throws IOException,ServletException{
HttpSession session = request.getSession();
//1. 从临时文件夹中删除图片
String filename = (String)session.getAttribute("filename");
String path = session.getServletContext().getRealPath("/")
+ "temp//" + filename;
File file = new File(path);
if(file.exists()){
file.delete();
logger.info(" 文件 " + path + " 已经被删除 ");
}
//2. 从 session 中清除上传图片的标记
session.removeAttribute("p_w_picpathuploaded");
session.removeAttribute("filename");
return mapping.findForward("next");
}
提交和保存到此功德圆满。下次用户想要查询自己的信息的时候,因为临时文件夹中已经没有用户照片,需要从数据库中读取。用一个 ShowImageAction 来实现这个功能:
public ActionForward execute(ActionMapping mapping,
ActionForm form, HttpServletRequest request,
HttpServletResponse response)
throws IOException,ServletException{
// 需要的情况下设置数据源
if (!DbManager.hasSetDataSource()) {
javax.sql.DataSource dataSource;
try {
dataSource = getDataSource(request);
DbManager.setDataSource(dataSource);
} catch (Exception e) {
logger.error(e.getMessage());
mapping.findForward("error");
}
}
String photo_no = request.getParameter("photo_no");
Connection conn = null;
Statement stmt = null;
// 获取连接
try {
conn = DbManager.getConnection();
logger.info("showp_w_picpath.jsp 从 DbManager 数据库连接池获取一个连接。 ");
} catch (SQLException e) {
// 如果没有能够从 DbManager 获取连接,此次查询操作失败
logger.error(" showp_w_picpath.jsp 不能获取数据库连接,无法读取图片! ");
}
try {
// 准备语句执行对象
stmt = conn.createStatement();
String sql = " SELECT hr01_photo FROM hr01 WHERE hr01_id='" + photo_no + "'";
ResultSet rs = stmt.executeQuery(sql);
if (rs.next()) {
InputStream in = rs.getBinaryStream("hr01_photo");
int bytesRead = 0;
byte[] buffer = new byte[8192];
response.setContentType("p_w_picpath/jpeg");
response.setContentLength(in.available());
OutputStream outs = response.getOutputStream();
while ((bytesRead = in.read(buffer, 0, 8192)) != -1) {
outs.write(buffer, 0, bytesRead);
}
outs.flush();
in.close();
rs.close();
} else {
rs.close();
response.sendRedirect("error.jsp");
}
}catch(SQLException e){
}finally {
try{
stmt.close();
conn.close();
}catch(SQLException ex){
}
}
return null;
}
以前一直不清楚 execute 方法中的 response 参数的用法,因为处理完以后总要 redirect 到另外一个页面,所以用的最多的就是把数据保存在 session 中,在另一个页面里再取出来用。这次纯粹是试验性地在 response 中写入 p_w_picpath/jpeg 内容,然后返回一个 null 值。最后的执行结果跟我预期的一样,在浏览器中直接显示从数据库中读出的图片。那么接下来就很好做了,只需要在 JSP 页面中设置一个 <p_w_picpath> 标签,指向这个 Action 就可以,当然,在这之前需要在 struts-config.xml 中先部署这个 Action :
<action path="/ShowImage"
type="software.action.ShowImageAction"></action>
然后在 JSP 页面中引用这个 Action 来显示图像 :
<img src="/tibet/ShowImage.do?photo_no=666542">
转载于:https://blog.51cto.com/qyweiyy/1696867