DiskFileUpload类别
1.2.2 DiskFileUpload类DiskFileUpload类是Apache文件上传组件的核心类,应用程序开发者通过这个类来与Apache文件上传组件进行交互。以下介绍DiskFileUpload类中的几个经常使用的重要方法。 1.setSizeMax方法 setSizeMax方法用于设置请求消息实体内容的最大同意大小,以防止client有益通过上传特大的文件来塞满server端的存储空间,单位为字节。其完整语法定义例如以下: public void setSizeMax(long sizeMax) 假设请求消息中的实体内容的大小超过了setSizeMax方法的设置值,该方法将会抛出FileUploadException异常。 2.setSizeThreshold方法 Apache文件上传组件在解析和处理上传数据中的每一个字段内容时,须要暂时保存解析出的数据。由于Java虚拟机默认能够使用的内存空间是有限的(笔者測试不大于100M),超出限制时将会发生“java.lang.OutOfMemoryError”错误,假设上传的文件非常大,比如上传800M的文件,在内存中将无法保存该文件内容,Apache文件上传组件将用暂时文件来保存这些数据;但假设上传的文件非常小,比如上传600个字节的文件,显然将其直接保存在内存中更加有效。setSizeThreshold方法用于设置是否使用暂时文件保存解析出的数据的那个临界值,该方法传入的參数的单位是字节。其完整语法定义例如以下: public void setSizeThreshold(int sizeThreshold) 3. setRepositoryPath方法 setRepositoryPath方法用于设置setSizeThreshold方法中提到的暂时文件的存放文件夹,这里要求使用绝对路径。其完整语法定义例如以下: public void setRepositoryPath(String repositoryPath) 假设不设置存放路径,那么暂时文件将被储存在"java.io.tmpdir"这个JVM环境属性所指定的文件夹中,tomcat 5.5.9将这个属性设置为了“<tomcat安装文件夹>/temp/”文件夹。 4. parseRequest方法 parseRequest 方法是DiskFileUpload类的重要方法,它是对HTTP请求消息进行解析的入口方法, public List parseRequest(HttpServletRequest req) parseRequest 方法另一个重载方法,该方法集中处理上述全部方法的功能,其完整语法定义例如以下: parseRequest(HttpServletRequest req,int sizeThreshold,long sizeMax, String path) 这两个parseRequest方法都会抛出FileUploadException异常。 5. isMultipartContent方法 isMultipartContent方法方法用于推断请求消息中的内容是否是“multipart/form-data”类型,是则返回true,否则返回false。isMultipartContent方法是一个静态方法,不用创建DiskFileUpload类的实例对象就可以被调用,其完整语法定义例如以下: public static final boolean isMultipartContent(HttpServletRequest req) 6. setHeaderEncoding方法 因为浏览器在提交FORM表单时,会将普通表单中填写的文本内容传递给server,对于文件上传字段,除了传递原始的文件内容外,还要传递其文件路径名等信息,如后面的图1.3所看到的。无论FORM表单採用的是“application/x-www-form-urlencoded”编码,还是“multipart/form-data”编码,它们不过将各个FORM表单字段元素内容组织到一起的一种格式,而这些内容又是由某种字符集编码来表示的。关于浏览器採用何种字符集来编码FORM表单字段中的内容,请參看笔者编著的《深入体验java 对于浏览器上传给WEBserver的各个表单字段的描写叙述头内容,Apache文件上传组件都须要将它们转换成字符串形式返回,setHeaderEncoding 方法用于设置转换时所使用的字符集编码,其原理与笔者编著的《深入体验java Web开发内幕——核心基础》一书中的第6.9.4节解说的ServletRequest.setCharacterEncoding方法同样。setHeaderEncoding 方法的完整语法定义例如以下: public void setHeaderEncoding(String encoding) 当中,encoding參数用于指定将各个表单字段的描写叙述头内容转换成字符串时所使用的字符集编码。 注意:假设读者在使用Apache文件上传组件时遇到了中文字符的乱码问题,一般都是没有正确调用setHeaderEncoding方法的原因。 |
以下介绍FileItem类中的几个经常使用的方法:
1. isFormField方法
isFormField方法用于推断FileItem类对象封装的数据是否属于一个普通表单字段,还是属于一个文件表单字段,假设是普通表单字段则返回true,否则返回false。该方法的完整语法定义例如以下:
public boolean isFormField()
2. getName方法
getName方法用于获得文件上传字段中的文件名称,对于图1.3中的第三个分区所看到的的描写叙述头,getName方法返回的结果为字符串“C:/bg.gif”。假设FileItem类对象相应的是普通表单字段,getName方法将返回null。即使用户没有通过网页表单中的文件字段传递不论什么文件,但仅仅要设置了文件表单字段的name属性,浏览器也会将文件字段的信息传递给server,仅仅是文件名称和文件内容部分都为空,但这个表单字段仍然相应一个FileItem对象,此时,getName方法返回结果为空字符串"",读者在调用Apache文件上传组件时要注意考虑这个情况。getName方法的完整语法定义例如以下:
public String getName()
注意:假设用户使用Windows系统上传文件,浏览器将传递该文件的完整路径,假设用户使用Linux或者Unix系统上传文件,浏览器将仅仅传递该文件的名称部分。
3.getFieldName方法
getFieldName方法用于返回表单字段元素的name属性值,也就是返回图1.3中的各个描写叙述头部分中的name属性值,比如“name=p1”中的“p1”。getFieldName方法的完整语法定义例如以下:
public String getFieldName()
4. write方法
write方法用于将FileItem对象中保存的主体内容保存到某个指定的文件里。假设FileItem对象中的主体内容是保存在某个暂时文件里,该方法顺利完毕后,暂时文件有可能会被清除。该方法也可将普通表单字段内容写入到一个文件里,但它主要用途是将上传的文件内容保存在本地文件系统中。其完整语法定义例如以下:
public void write(File file)
5.getString方法
getString方法用于将FileItem对象中保存的主体内容作为一个字符串返回,它有两个重载的定义形式:
public java.lang.String getString()
public java.lang.String getString(java.lang.String encoding)
throws java.io.UnsupportedEncodingException
前者使用缺省的字符集编码将主体内容转换成字符串,后者使用參数指定的字符集编码将主体内容转换成字符串。假设在读取普通表单字段元素的内容时出现了中文乱码现象,请调用第二个getString方法,并为之传递正确的字符集编码名称。
6. getContentType方法
getContentType 方法用于获得上传文件的类型,对于图1.3中的第三个分区所看到的的描写叙述头,getContentType方法返回的结果为字符串“image/gif”,即“Content-Type”字段的值部分。假设FileItem类对象相应的是普通表单字段,该方法将返回null。getContentType 方法的完整语法定义例如以下:
public String getContentType()
7. isInMemory方法
isInMemory方法用来推断FileItem类对象封装的主体内容是存储在内存中,还是存储在暂时文件里,假设存储在内存中则返回true,否则返回false。其完整语法定义例如以下:
public boolean isInMemory()
8. delete方法
delete
方法用来清空
FileItem类对象中存放的主体内容,假设主体内容被保存在暂时文件里,delete
方法将删除该暂时文件。虽然
Apache
组件使用了多种方式来尽量及时清理暂时文件
,但系统出现异常时,仍有可能造成有的暂时文件被永久保存在了硬盘中。在有些情况下,能够调用这种方法来及时删除暂时文件。其完整语法定义例如以下:
public void delete()
1.2.4 FileUploadException类
在文件上传过程中,可能发生各种各样的异常,比如网络中断、数据丢失等等。为了对不同异常进行合适的处理,Apache文件上传组件还开发了四个异常类,当中FileUploadException是其它异常类的父类,其它几个类仅仅是被间接调用的底层类,
对于Apache组件调用人员来说,仅仅需对FileUploadException异常类进行捕获和处理就可以。
DiskFileUpload类别的更多相关文章
- IOS 杂笔-12(类别de巧用 有便于Frame的操作)
在实际开发中很多时候我们都为了控件frame的操作焦头烂额. 例如:我们只想要获取view的width. 我们可以这么操作:view.frame.size.width 有时我们想要改变view的wid ...
- Oracle学习笔记四 SQL命令(二):SQL操作语言类别
SQL分为下列语言类别 1.数据定义语言(DDL) Create.Alter.Drop 2.数据操纵语言(DML) Insert.Select.Delete.Update 3.事务控制语言(TCL) ...
- 类别(Category)与扩展(Extensions)
一.类别(Category) 类别(Category)是一种可以为现有的类(包括类簇:NSString...,甚至源码无法获得的类)添加新方法的方式无需从现有的类继承子类.类别添加的新方法可以被子类继 ...
- SQL Server-语句类别、数据库范式、系统数据库组成(一)
前言 终于等到这一天,我要开始重新系统学习数据库了,关于数据库这块,不出意外的话,每天会定时更新一篇且内容不会包含太多,简短的内容,深入的理解,Always to review the basics. ...
- OC 类别与扩展(匿名类别)
OC 类别与扩展(匿名类别) 类别(Categroy): 又称为扩展类,在类的原基础上扩展方法,且不可添加变量,如果扩展的方法与原始类中的方法相同,则会隐藏原始方法,且不可在扩展方法中通过super调 ...
- OC的类别(分类)和拓展
一.分类: 1.适用范围 当你已经封装好了一个类(也可能是系统类.第三方库),不想在改动这个类了,可是随着程序功能的增加需要在类中增加一个方法,这时我们不必修改主类,只需要给你原来的类增加一 ...
- OC中类别、扩展、协议与委托
一.类别(category) 类别(category)——通过使用类别,我们可以动态地为现有的类添加新方法,而且可以将类定义模块化地分不到多个相关文件中.通常只在类别中定义方法.(类别,接口部分的定义 ...
- objective-c(类别)
objective-c中的Categary(类别)使用相当广泛,其内涵类似于javascript中的prototype,可以扩展某一个类的方法. 下面给出一个基本的例子,参考oc程序设计一书: 实现一 ...
- JavaScript强化教程——jQuery UI API 类别
---恢复内容开始--- 主要介绍:JavaScript强化教程—— jQuery UI API 类别 jQuery UI 在jQuery 内置的特效上添加了一些功能.jQuery UI 支持颜色动 ...
随机推荐
- 基于Predictive Parsing的ABNF语法分析器(十三)——rulelist、rule、rulename、define-as和elements
我们来看看rulelist,它是整个ABNF文法的入口,就是说一个ABNF文法就是一个规则列表rulelist.一个rulelist由若干个rule规则组成,每个rule由规则名rulename.定义 ...
- wordpress搭建后地址栏页面显示IP地址的问题
搭建了wordpress.也在万网加入了A记录,这时訪问站点(我的是yesareno.com),发现仅仅在yesareno的主页,地址栏是域名.点击进入其它界面发现地址栏变成了ip地址,例如以下图 竟 ...
- struts2文件上传限制大小问题
struts2默认文件上传大小为2M,如需改动默认大小,解决方法例如以下: <struts> <constant name="struts.multipart.maxSiz ...
- HTML学习笔记——各种居中对齐
0.前言 水平居中基本方法--指定块的宽度并设定块的左右外边距为auto,上下外边距可取0,那么该块能够在父元素中水平居中. 样式例如以下: 1:margin:0px auto 2:margi ...
- Java8高中并发
Java8中学并发 本文翻译自:http://jaxenter.com/lean-concurrency-in-java-8-49924.html 转载请注明出处:http://blog.csdn.n ...
- c#开发微信公众平台
之前帮公司开发过微信公众账号,今天特别将过程再回顾记录下来. 1.URL配置 启用开发模式需要先成为开发者,而且编辑模式和开发模式只能选择一个,进入微信公众平台-开发模式,如下: 从上面可以看出,点击 ...
- 基于.net开发chrome核心浏览器【一】
原文:基于.net开发chrome核心浏览器[一] 说明: 这是本系列的第一篇文章,我会尽快发后续的文章. 源起 1.加快葬送IE6浏览器的进程 世界上使用IE6浏览器最多的地方在中国 中国使用IE6 ...
- wIndows phone 7 解析Html数据
原文:wIndows phone 7 解析Html数据 在我的上一篇文章中我介绍了windows phone 7的gb2312解码, http://www.cnblogs.com/qingci/arc ...
- KSImageNamed-Xcode
KSImageNamed-Xcode 非常的给力的XCODE图片浏览插件; What is this? Can't remember whether that image you just add ...
- 你不知道的Eclipse的用法:使用MAT分析Android的内存
如果使用DDMS确实发现了我们程序中存在内存泄露,那如何定位到具体出现问题的代码片段,最终找到问题所在呢?如果从头到尾分析代码逻辑,那肯定会把人逼疯,特别是在维护别人写的代码的时候.这里介绍一个极好的 ...