george.gu

浏览: 71180 次
性别:
来自: 北京

最近访客更多访客>>

luojianbing

highinsky0109

callmeNeo

lfrick

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

File upload and download in Java Web Application.

博客分类：

每日一得

Web Java Servlet SOAP HTML

最近在项目中遇到一个下载文件的老问题。之所以说是老问题，因为在以前的很多项目中都遇到过，但是当时赶进度，所以在找到解决方案后就草草了事，没有深入的研究、总结一下各种方法，实乃憾事。

既然再次遇到，就不能放过。争取在依然很紧张的项目进度中，找出一点时间总结一下Java Web Application开发中涉及到的文件上传、下载解决方案。鉴于博客是写给自己看的，加上时间紧张，所以我会持续更新，不求一气呵成。

Upload File through Html FORM:

/html/body/form/@enctype: ENCTYPE determines how the form data is encoded. Whenever data is transmitted from one place to another, there needs to be an agreed upon means of representing that data.
FORM ENCTYPE has three different values:

application/x-www-form-urlencoded : All characters are encoded in URL encoding before sent (this is default). Only value attribute inside form will be processed.
multipart/form-data : data will be transformed in byte code stream. This value is required when you are using forms that have a file upload control. In
text/plain : Spaces are converted to "+" symbols, but no special characters are encoded

So if you want to upload file through web, you have to first set form ENCTYPE to be "multipart/form-data".

Using pure Servlet:

In fact, file download and upload in Java Web Application are to manage files through InputStream from HttpServletRequest and OutputStream from HttpServletResponse.

Even we can simply the development and configuration by using some framework, but anyway we should know what is the kernel for file uploading and download.

File Upload web interface:

fileUpload.html

<html>

<head>

<title>Upload a File</title>

</head>

<body>

<h1>Upload File </h1>

<h2>Warning: Please make sure your web browser support file uploading.</h2>

Select a file to upload: <input type="file" size="40" name="upl-file"/> </BR>

</form>

</body>

</html>

Read file from HttpServletRequest Inputstream:

/**

* Servlet.doPost: reads the uploaded data from the request and writes it to

* a file.

public void doPost(HttpServletRequest request, HttpServletResponse response) {

DataInputStream in = null;

try {

// get content type of client request

String contentType = request.getContentType();

// make sure content type is multipart/form-data

if (contentType != null

&& contentType.indexOf("multipart/form-data ") != -1) {

// open input stream from client to capture upload file

in = new DataInputStream(request.getInputStream()) ;

// get length of content data

int formDataLength = request.getContentLength();

byte dataBytes[] = new byte[1024];

int bytesRead;

while ((bytesRead = in.read(dataBytes)) != -1) {

// write the data to server file.

}

// here you can perform some other checks.

}

} catch (Exception e) {

}

This is just a draft demo on how to upload file through servlet. There is no control on large files and user rights.

Download file through HttpServletResponse OutputStream

/**

* Servlet.doPost: get data to be sent to client and output it through Response.outputStream. Web browser will pop-up a save file window to let User download file.

public void doPost(HttpServletRequest request, HttpServletResponse response) {

response.setContentType("text/csv");

response.setHeader("Content-Disposition",

"attachment; filename=unknownModels.csv");

OutputStream out;

// PrintWriter printWriter;

try {

out = response.getOutputStream();

// printWriter = response.getWriter();

...

// output your content with printWriter. It will output content to client.

...

out.flush();

// printWriter.flush();

} catch (IOException e) {

System.err.println("Met a error when download file.");

System.exit(1);

}

Content-Disposition used to define download file or open a file in web browsers:

attachment; filename=myfile.txt: download a file with default name myfile.txt

inline; filename=myfile.txt: open the file in web browser. default file name myfile.txt

Using commons-fileupload.jar to Upload file

TBD

Using Struts1

File upload through Struts1:

In struts-config_1_3.dtd, we can find controller definition to control file uploading through struts1.*

struts-config/controller:
                @bufferSize            The size of the input buffer used when processing
                                      file uploads.
                                      [4096]
                @maxFileSize         The maximum size (in bytes) of a file to be accepted as a
                                     file upload. Can be expressed as a number followed by a
                                     "K", "M", or "G", which are interpreted to mean kilobytes,
                                      megabytes, or gigabytes, respectively.
                                      ["250M"]
                @memFileSize         The maximum size (in bytes) of a file whose contents will
                                         be retained in memory after uploading. Files larger than
                                     this threshold will be written to some alternative storage
                                     medium, typically a hard disk. Can be expressed as a number
                                     followed by a "K", "M", or "G", which are interpreted to
                                     mean kilobytes, megabytes, or gigabytes, respectively.
                                     ["256K"]
                @multipartClass The fully qualified Java class name of the multipart
                                      request handler class to be used with this module.
                                      ["org.apache.struts.upload.CommonsMultipartRequestHandler"]
                @nocache             Set to "true" if you want the controller to add HTTP
                                      headers for defeating caching to every response from
                                      this module. [false]
                @tempDir             Temporary working directory to use when processing
                                      file uploads.
                                      [{Directory provided by servlet container}]

By default struts 1 provide org.apache.struts.upload.CommonsMultipartRequestHandler to process file uploading transform. CommonsMultipartRequestHandler encapsulate apache-commons-fileupload for file uploading processing. If you want to know how CommonsMultipartRequestHandler manage file uploading or you want to implement your own MultipartRequestHandler, please refer to struts source code for that.

Your form should extends ActionForm and contains a FileForm named with same value as html:file/@name.
Then config your upload Action in struts-config.xml to map to this form-bean.

After that, we can use FormFile.getInputStream() to get file data and no need to care about file uploading processing.

File download through Struts1:

Struts 1 provide DownloadAction:

org.apache.struts.actions.DownloadAction.

Here is a snapshot of org.apache.struts.actions.DownloadAction.java:

public abstract class DownloadAction extends BaseAction {
    /**
     * Process the specified HTTP request, and create the corresponding HTTP
     * response (or forward to another web component that will create it).
     * Return an <code>ActionForward</code> instance describing where and how
     * control should be forwarded, or <code>null</code> if the response has
     * already been completed.
     *
     * @param mapping The ActionMapping used to select this instance.
     * @param form     The optional ActionForm bean for this request (if
     *                 any).
     * @param request The HTTP request we are processing.
     * @param response The HTTP response we are creating.
     * @return The forward to which control should be transferred, or
     *         <code>null</code> if the response has been completed.
     * @throws Exception if an exception occurs.
     */
    public ActionForward execute(ActionMapping mapping, ActionForm form,
        HttpServletRequest request, HttpServletResponse response)
        throws Exception {
        StreamInfo info = getStreamInfo(mapping, form, request, response);
        String contentType = info.getContentType();
        InputStream stream = info.getInputStream();

        try {
            response.setContentType(contentType);
            copy(stream, response.getOutputStream());
        } finally {
            if (stream != null) {
                stream.close();
            }
        }

           // Tell Struts that we are done with the response.
        return null;
    }

    /**
     * Returns the information on the file, or other stream, to be downloaded
     * by this action. This method must be implemented by an extending class.
     *
     * @param mapping The ActionMapping used to select this instance.
     * @param form     The optional ActionForm bean for this request (if
     *                 any).
     * @param request The HTTP request we are processing.
     * @param response The HTTP response we are creating.
     * @return The information for the file to be downloaded.
     * @throws Exception if an exception occurs.
     */
    protected abstract StreamInfo getStreamInfo (ActionMapping mapping,
        ActionForm form, HttpServletRequest request,
        HttpServletResponse response)
        throws Exception;


    /**
     * Copy bytes from an <code>InputStream</code> to an
     * <code>OutputStream</code>.
     *
     * @param input The <code>InputStream</code> to read from.
     * @param output The <code>OutputStream</code> to write to.
     * @return the number of bytes copied
     * @throws IOException In case of an I/O problem
     */
    public int copy(InputStream input, OutputStream output)
        throws IOException {
        byte[] buffer = new byte[getBufferSize()];
        int count = 0;
        int n = 0;

        while (-1 != (n = input.read(buffer))) {
            output.write(buffer, 0, n);
            count += n;
        }

        return count;
    }

    ......
}

So we should define an Action that extends DownloadAction and implement method:

StreamInfo getStreamInfo(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response);

Inside your implementation, you can read file from file system or get them from romote server, and then format it into a StreamInfo object which will be used by DownloadAction to open a InputStream.

Using Struts2

Struts2 vs Struts1:

Since Struts2 realize webwork2 and provides different configuration as struts1. So it is more like a new MVC framework rather than upgrade of struts1. Here are some new features in struts2:

Action should implement ActionSupport
Each action's parameter fields will represent dedicated HTML/form data, so there is no need to define ActionForm (form-beans/form-bean in struts1) again.
Struts2 introduce AOP interceptor and IOC (like /package/action/param)
Configuration file changed a lot.
...

File uploading through struts2:

For file uploading, struts2 introduce three new parameters in Action to represent File information:

File XXX: represent the File to be uploaded. XXX is the value of attribute: HTML/form/file/@name.
String XXXFileName: represent the original file name of file XXX.
String XXXContentType: represent the content type of file XXX.

If you want to upload a set of files, those three parameters should be defined as:

File[] XXX: represent the File to be uploaded. XXX is the value of attribute: HTML/form/file/@name. All the file upload form should use same file/@name definition.
String[] XXXFileName: represent the original file names of file XXX.
String[] XXXContentType: represent the content types of files XXX.

So you should define your own upload Action as following:

First extend ActionSupport and contain those three necessary parameters
Then you can use File XXX to read data from InputStream.

Because in my current project, we do not use struts2, so I do not study the source code of struts2. But anyway, we can image there is a MultipartRequestHandler which will process file uploading and convert it into Action.XXX for us.

File Download through Struts2

About download, we can talk about it later.

But anyway, I am always thinking that even framework provide encapsulation of complex operation for us, but the kernel should always the same: send file data through Response OutputStream.

Attach file management in SOAP

TBD

分享到：

XML Parser:DOM + XPath | Manage zip content using Java APIs

2011-04-21 21:08
浏览 1675
评论(0)
分类:企业架构
查看更多

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

File upload and download in Java Web Application.

Upload File through Html FORM:

Using pure Servlet:

File Upload web interface:

Read file from HttpServletRequest Inputstream:

Download file through HttpServletResponse OutputStream

Using commons-fileupload.jar to Upload file

Using Struts1

File upload through Struts1:

File download through Struts1:

Using Struts2

Struts2 vs Struts1:

File uploading through struts2:

File Download through Struts2

Attach file management in SOAP

评论

发表评论

相关推荐

最近访客 更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

File upload and download in Java Web Application.

Upload File through Html FORM:

Using pure Servlet:

File Upload web interface:

Read file from HttpServletRequest Inputstream:

Download file through HttpServletResponse OutputStream

Using commons-fileupload.jar to Upload file

Using Struts1

File upload through Struts1:

File download through Struts1:

Using Struts2

Struts2 vs Struts1:

File uploading through struts2:

File Download through Struts2

Attach file management in SOAP

评论

发表评论

相关推荐

javax.naming.CommunicationException: remote side declared peer gone on this JVM.

Generate special format numbers

Singleton Service in Weblogic Cluster

Scheduled ThreadPool Executor suppressed or stopped after error happen

Bad version number in .class file

User Data Header in SMPP SUBMIT_SM

jQuery study

Java is Pass-by-Value or Pass-by-Reference?

java.util.Properties: a subclass of java.util.Hashtable

Jmock usage

Oracle Index Usage

AOP(2)：AOP与动态代理JDK Proxy and Cglib Proxy

AOP(1)：应用中的几个小故事

异步系统设计：push vs pull

Velocity Usage

Java Regular Expression (Java正则表达式)

XML Parser:DOM + XPath

Manage zip content using Java APIs

Beanshell: how and where to use beanshell

OXM: JAXB2.0 in JDK1.6

最近访客更多访客>>