样例

Hasor 内置了 apache 的 fileuplaod 组件，并且对该组件做了精简优化。因此在使用 Hasor 的文件上传时不需要引入任何第三方 jar 即可使用。

首先使用文件上传，必须通过 WebController 类进行操作，这里有文件上传例子：

@MappingTo("/fileupload.do")public class FileUpLoad extends WebController {    public void execute() throws IOException {        FileItem multipart = this.getOneMultipart("upfile");        multipart.writeTo(…);        multipart.deleteOrSkip();    }}

而对应的 html 页面是一个普通的表单上传，但是要注意 form 标签的 enctype 属性要改成 multipart/form-data

<form action="/fileupload.do" method="post" enctype="multipart/form-data">
    <input type="file" name="upfile"/>
    <input type="submit" value="上传"/>
</form>

流式上传

流式文件上传，流式上传最大的好处就是不需要缓存就可以处理大文件的上传：

@MappingTo("/fileupload.do")public class FileUpLoad extends WebController {    public void execute() throws IOException {        Iterator<FileItemStream> multiStream = this.getMultipartIterator();        while (multiStream.hasNext()){            FileItemStream next = multiStream.next();            if (!next.getName().equals("xxxxx")){                continue;            }            InputStream inputStream = next.openStream();            try{                stream copy …            }finally {                inputStream.close();            }        }    }}

上传缓存

在非流式上传中，大一点的文件在上传过程中都需要缓存上传数据。Hasor 可以在代码中处理上传时临时指定上传路径：

@MappingTo("/fileupload.do")public class FileUpLoad extends WebController {    public void execute() throws IOException {        String cacheDirectory = "…";        Integer maxPostSize = 1024 * 1024;        FileItem multipart1 = this.getOneMultipart("upfile", cacheDirectory, maxPostSize);    }}

如果使用默认缓存路径来保存上传的临时数据那么程序代码可以简化为：

@MappingTo("/fileupload.do")public class FileUpLoad extends WebController {    public void execute() throws IOException {        FileItem multipart = this.getOneMultipart("upfile");        multipart.writeTo(new File(""));        multipart.deleteOrSkip();    }}

框架中默认缓存路径是 %USER.HOME%/hasor-work/temp/fragment 这个路径可以通过下面这个配置改变：

<?xml version="1.0" encoding="UTF-8"?>
<config xmlns="http://www.hasor.net/sechma/main">
    <hasor>
        <fileupload>
            <!-- 上传文件缓存目录 -->
            <cacheDirectory>%WORK_HOME%/temp/fragment</cacheDirectory>
        </fileupload>
    </hasor>
</config>

缓存配置

Hasor 在上传中可以配置的缓存信息有：

<?xml version="1.0" encoding="UTF-8"?>
<config xmlns="http://www.hasor.net/sechma/main">
    <hasor>
        <fileupload>
            <!-- 上传文件缓存目录 -->
            <cacheDirectory>%WORK_HOME%/temp/fragment</cacheDirectory>
            <!-- 允许的请求大小 ( -1 表示不限制)-->
            <maxRequestSize>${HASOR_UPLOAD_MAX_REQUEST_SIZE}</maxRequestSize>
            <!-- 允许上传的单个文件大小( -1 表示不限制) -->
            <maxFileSize>${HASOR_UPLOAD_MAX_FILE_SIZE}</maxFileSize>
        </fileupload>
    </hasor>
</config>

其中环境变量的值关系为：

提示

• 用户主目录如果是 linux 系统那么这个目录通常在这里：“/home/xxx/hasor-work/temp/fragment”

• 用户主目录如果是 window 用户住目录会在：“c:/users/xxx/hasor-work/temp/fragment”