<rich:fileUpload>上传组件

  
官网关于fileupload标签的说明：http://docs.jboss.org/richfaces/3.3.2.GA/en/devguide/html/rich_fileUpload.html

       首先，这里使用的版本是：3.3.2sr1，使用richfaces组件先得加入相关包，



其中用到了facelets，所以有jsf-facelets.jar

web.xml中的richfaces过滤器

<filter>
        <display-name>RichFaces Filter</display-name>
        <filter-name>richfaces</filter-name>
        <filter-class>org.ajax4jsf.Filter</filter-class>

<!--初始化参数在这里配置-->
    </filter>
    <filter-mapping>
        <filter-name>richfaces</filter-name>
        <servlet-name>Faces Servlet</servlet-name>
        <dispatcher>REQUEST</dispatcher>
        <dispatcher>FORWARD</dispatcher>
        <dispatcher>INCLUDE</dispatcher>
    </filter-mapping>

上传bean(FileUploadBean)：

import java.io.IOException;
import java.io.OutputStream;
import java.util.ArrayList;
import org.richfaces.event.UploadEvent;
import org.richfaces.model.UploadItem;


/**
*
* @author Administrator
*/
public class FileUploadBean {

    /** Creates a new instance of FileUploadBean */
    public FileUploadBean() {
    }
private ArrayList<File> files = new ArrayList<File>();
    private int uploadsAvailable = 5;
    private boolean autoUpload = false;
    private boolean useFlash = false;
    public int getSize() {
        if (getFiles().size()>0){
            return getFiles().size();
        }else
        {
            return 0;
        }
    }

    public void paint(OutputStream stream, Object object) throws IOException {
        stream.write(getFiles().get((Integer)object).getData());
    }
    public void listener(UploadEvent event) throws Exception{
        UploadItem item = event.getUploadItem();
        File file = new File(); //自己定义的类型，不IO包中的File
        file.setLength(item.getFileSize());
        file.setName(item.getFileName());
        file.setData(item.getData());
        files.add(file);
        uploadsAvailable--;
    }

}

在faces-config.xml中配置：

<faces-config version="1.2"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd">

<!--如果不使用facelets下面的FaceletViewHandler可以注解-->
    <application> 
        <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>
    </application>
    <managed-bean>
        <managed-bean-name>fileUploadBean</managed-bean-name>
        <managed-bean-class>com.FileUploadBean</managed-bean-class>
        <managed-bean-scope>request</managed-bean-scope>
    </managed-bean>
</faces-config>

页面组件：

  <rich:fileUpload
                maxFilesQuantity="3"
                noDuplicate="true"
                fileUploadListener="#{fileUploadBean.listener}"
                addControlLabel="Add file..."
                clearAllControlLabel="Clear all"
                clearControlLabel="Clear"
                stopEntryControlLabel="Stop process"
                uploadControlLabel="Upload file"
                id="upload"
                immediateUpload="false"
                acceptedTypes="jpg, gif, png, bmp" allowFlash="true">
                <f:facet name="label">
                    <h:outputText value="{_KB}KB from {KB}KB uploaded --- {mm}:{ss}" />
                </f:facet>
            </rich:fileUpload>

属性说明：noDuplicate="true" 本次上传的文件中不能有重复文件

                 acceptedTypes="jpg, gif, png, bmp" 上传所允许的文件格式，这个格式就是个结尾字符串而已，你把一个不是图片的文件改成这样的文件照样是可以上传的

                 allowFlash="true" 在打开的文件选择窗口中自动筛选符合文件格式(acceptedTypes)的文件

这里要注意的fileUploadBean.listener方法

在这个方法里面

UploadItem item = event.getUploadItem();

      有几个文件就要调用几次listener方法，除非调用一次得到所有文件，而且我们得知道在调用这个方法之前文件已经存在于服务上了（以内存或者临时文件的形式）。如果有三个文件要上传，并不是说三个都在了，而是轮到哪个文件调用listener的时候，这个文件已经上传过了，剩下的工作就是程序员处理文件了。

       再多讲点儿，jsf的上传组件在上传的过程中都是在Filter中就完成了上传任务，因为JSF的生命周中不能处理带有这种流形式的请求，上传完后，将文件的引用设置到请求中,交给jsf的生命周期进行处理（也就是listener处理了）

       若要得到一个文件的上传信息，通过item.isTempFile()来判断这个文件是以临时文件方式存在还是以byte[]方式存在（意思是说在内存里面），如果它返回true，则是临时文件，会在服务器的临时目录下(eg. tomcat_home\temp)生成.upload的临时文件（如果是另外生成文件的话这里的临时文件一定要记得删除掉，如果是只是重命名（移动文件），则不需要）这时候要保存文件就要通过item.getFile获得文件并处理；如果它返回的false，则上传的文件在内存里面，要通过item.getData()获得byte数组来处理，如果上传的文件比较大的话，这种方式不推荐使用。

如果是临时文件你调用getData方法得到的是null值，如果还要获取数组大小则会报空指针异常；如果是以内存的方式存在，用getFile得到的也是null值。

如果不在RichFace过滤器(web.xml中)配置以什么方式存储上传文件时，默认方式为临时文件方式。

如果要改为内存方式存储（小文件推荐，大小界线自己衡量），在过滤器中加入

<init-param>

        <param-name>createTempFiles</param-name>

        <param-value>false</param-value>

</init-param>