文件上传组件设计.docVIP

文件上传组件设计 一、技术选择 通过网络上传文件一直是基于BS结构系统的常用功能，在以往的开发过程中，我们使用过JSPSmartUpload、commonFileUpload、orellay等组件，前两种使用的相对教多些。 Jspsmartupload 使用起来比较灵活，有丰富的API，但是它上传的时候把上传文件放到内存里，所以上传文件的大小会和内存有关系。 commonFileUpload Apache提供的一个开源组件，没有很多API，它上传的过程中会采用两种方式处理文件：1、如果上传文件小于Java虚拟机管理的内存大小，文件放入内存；2、如果文件大小大于Java虚拟机管理的内存大小，它会把上传的文件先写入磁盘。所以通过commonFileUpload上传文件的大小只是带宽有关系，因此可以处理超大文件。 因此，在设计系统框架公共上传组件时我们还是选用commonFileUpload作为封装基础。 二、功能需求 BS结构系统中进行文件上传，我们会遇到以下问题： 上传文件的数量 上传单个的文件； 上传一组相同类型的文件； 上传一组不同类型的文件； 上传文件的来源 由客户端磁盘读取文件； 由网络其他地址获得文件； 用户通过客户端浏览器组件创建的临时文件； 上传文件的存放 存放至服务器端指定目录； 存放至服务器端固定目录； 存放至数据库； 仅读入服务器内存； 程序的跨平台使用 路径的处理； 中文编码处理。 三、功能设计 公共组件的使用者为系统最前端的编码人员，如何满足编码人员需求、如何对上传组件进行封装、提供怎样的接口调用以方便编码人员使用，这些问题都是设计公共组建功能需要重点考虑的。 3.1 包、类设置 系统公共类包路径为：ms，上传文件涉及公共类包括获取当前操作系统文件分隔符、路径及文件名校验、编码转换等。 上传相关类统一包路径为：com.zzxy.fileupload，此包内放置上传文件的公共处理类。 基于Struts2标签的上传类，其包路径为：com.zzxy.fileupload.action，此包内放置基于Struts2标签上传文件的相关处理类，主类名为FileUploadAction。 直接封装commonFileUpload组件的上传类，其包路径为：com.zzxy.fileupload.util，此包内放置直接封装commonFileUpload组件的相关处理类，主类名为FileUploadUtil。 3.2 接口结构 3.2.1 ISToBytesUtil 序号 方法名 参数 返回值 方法说明 1 toBytes InputStream is;//输入流 Byte[] 将一个输入流写入到一个byte[]数组里 3.2.1 ISToBytesUtil 序号 方法名 参数 返回值 方法说明 1 无 static final int UPLOAD_SUCCESS=0; //上传成功 static final int FILE_IS_NULL=1; //上传文件为空 static final int FILE_TOO_BIG=2; //上传文件超过规定允许的最大值 static final int TYPE_NOT_ALLOWED=3; //上传类型不允许 static final int UPLOAD_FAIL=4; //上传失败 无 接口。定义了FileUploadAction和FileUploadUtil各个方法返回信息的值 3.2.3 FileUploadAction 序号 方法名 参数 返回值 方法说明 1 uploadFile File file;// 实际上传文件 String fileFileName; // 上传文件名，不包括文件路径 String path;//将文件上传到此路径下 int 上传单个文件，单个文件最大值及允许上传类类型在配置文件里配置。 2 uploadFiles File[] file; String[] fileFileNames; String path; int 上传多个文件，单个文件最大值及允许上传类类型在配置文件里配置。 3 uploadFiles ListFile file ListString fileFileNames; String path; int 上传多个文件，单个文件最大值及允许上传类类型在配置文件里配置。 3.2.4 FileUploadUtil 相关说明:下面每个方法中都有一个参数 long sizeMax //最大文件尺寸，需要程序员自己指定sizeMax，即每个上传文件允许的最大值。与每个方法相对应的还有实现功能完全一样的方法，未列出，唯一不同的就是，参数中没有sizeMax这个参数，当调用此方法时，则按照程序默认的sizeMa