Apache FileUpload文件上传组件API解析
&&&&发布时间：
　　　　Java Web开发人员可以使用Apache文件上传组件来接收浏览器上传的文件，该组件由多个类共同组成，但是，对于使用该组件来编写文件上传功能的Java Web开发人员来说，只需要了解和使用其中的三个类：DiskFileUpload、FileItem和FileUploadException。这三个类全部位于mons.fileupload包中。
　　1. DiskFileUpload类
　　DiskFileUpload类是Apache文件上传组件的核心类，应用程序开发人员通过这个类来与Apache文件上传组件进行交互。但现在Apache建议使用ServletFileUpload类，两个类的方法类似。下面介绍DiskFileUpload类中的几个常用的重要方法。
　　1.1．setSizeMax方法
　　setSizeMax方法用于设置请求消息实体内容的最大允许大小，以防止客户端故意通过上传特大的文件来塞满服务器端的存储空间，单位为字节。其完整语法定义如下：
　　public void setSizeMax（long sizeMax）
　　如果请求消息中的实体内容的大小超过了setSizeMax方法的设置值，该方法将会抛出FileUploadException异常。
　　1.2．setSizeThreshold方法
　　Apache文件上传组件在解析和处理上传数据中的每个字段内容时，需要临时保存解析出的数据。因为Java虚拟机默认可以使用的内存空间是有限的（笔者测试不大于100M），超出限制时将会发生“java.lang.OutOfMemoryError”错误，如果上传的文件很大，例如上传800M的文件，在内存中将无法保存该文件内容，Apache文件上传组件将用临时文件来保存这些数据；但如果上传的文件很小，例如上传600个字节的文件，显然将其直接保存在内存中更加有效。setSizeThreshold方法用于设置是否使用临时文件保存解析出的数据的那个临界值，该方法传入的参数的单位是字节。其完整语法定义如下：
　　public void setSizeThreshold(int sizeThreshold)
　　1.3. setRepositoryPath方法
　　setRepositoryPath方法用于设置setSizeThreshold方法中提到的临时文件的存放目录，这里要求使用绝对路径。其完整语法定义如下：
　　public void setRepositoryPath(String repositoryPath)
　　如果不设置存放路径，那么临时文件将被储存在"java.io.tmpdir"这个JVM环境属性所指定的目录中，tomcat 5.5.9将这个属性设置为了“&tomcat安装目录&/temp/”目录。
　　1.4. parseRequest方法
　　parseRequest 方法是DiskFileUpload类的重要方法，它是对HTTP请求消息进行解析的入口方法，如果请求消息中的实体内容的类型不是“multipart/form-data”，该方法将抛出FileUploadException异常。parseRequest 方法解析出FORM表单中的每个字段的数据，并将它们分别包装成独立的FileItem对象，然后将这些FileItem对象加入进一个List类型的集合对象中返回。parseRequest 方法的完整语法定义如下：
　　public List parseRequest(HttpServletRequest req)
　　parseRequest 方法还有一个重载方法，该方法集中处理上述所有方法的功能，其完整语法定义如下：
　　parseRequest(HttpServletRequest req,int sizeThreshold,long sizeMax,
　　String path)
　　这两个parseRequest方法都会抛出FileUploadException异常。
　　1.5. isMultipartContent方法
　　isMultipartContent方法方法用于判断请求消息中的内容是否是“multipart/form-data”类型，是则返回true，否则返回false。isMultipartContent方法是一个静态方法，不用创建DiskFileUpload类的实例对象即可被调用，其完整语法定义如下：
　　public static final boolean isMultipartContent(HttpServletRequest req)
　　1.6. setHeaderEncoding方法
　　由于浏览器在提交FORM表单时，会将普通表单中填写的文本内容传递给服务器，对于文件上传字段，除了传递原始的文件内容外，还要传递其文件路径名等信息，如后面的图1.3所示。不管FORM表单采用的是“application/x-www-form-urlencoded”编码，还是“multipart/form-data”编码，它们仅仅是将各个FORM表单字段元素内容组织到一起的一种格式，而这些内容又是由某种字符集编码来表示的。关于浏览器采用何种字符集来编码FORM表单字段中的内容，请参看笔者编着的《深入体验java Web开发内幕——核心基础》一书中的第6.9.2的讲解，“multipart/form-data”类型的表单为表单字段内容选择字符集编码的原理和方式与“application/x-www-form-urlencoded”类型的表单是相同的。FORM表单中填写的文本内容和文件上传字段中的文件路径名在内存中就是它们的某种字符集编码的字节数组形式，Apache文件上传组件在读取这些内容时，必须知道它们所采用的字符集编码，才能将它们转换成正确的字符文本返回。
　　对于浏览器上传给WEB服务器的各个表单字段的描述头内容，Apache文件上传组件都需要将它们转换成字符串形式返回，setHeaderEncoding 方法用于设置转换时所使用的字符集编码，其原理与笔者编着的《深入体验java Web开发内幕——核心基础》一书中的第6.9.4节讲解的ServletRequest.setCharacterEncoding方法相同。setHeaderEncoding 方法的完整语法定义如下：
　　public void setHeaderEncoding(String encoding)
　　其中，encoding参数用于指定将各个表单字段的描述头内容转换成字符串时所使用的字符集编码。
　　注意：如果读者在使用Apache文件上传组件时遇到了中文字符的乱码问题，一般都是没有正确调用setHeaderEncoding方法的原因。
　　2.& FileItem类
　　FileItem类用来封装单个表单字段元素的数据，一个表单字段元素对应一个FileItem对象，通过调用FileItem对象的方法可以获得相关表单字段元素的数据。FileItem是一个接口，在应用程序中使用的实际上是该接口一个实现类，该实现类的名称并不重要，程序可以采用FileItem接口类型来对它进行引用和访问，为了便于讲解，这里将FileItem实现类称之为FileItem类。FileItem类还实现了Serializable接口，以支持序列化操作。
　　对于“multipart/form-data”类型的FORM表单，浏览器上传的实体内容中的每个表单字段元素的数据之间用字段分隔界线进行分割，两个分隔界线间的内容称为一个分区，每个分区中的内容可以被看作两部分，一部分是对表单字段元素进行描述的描述头，另外一部是表单字段元素的主体内容，如图1.3所示。
　　图 1.3
　　主体部分有两种可能性，要么是用户填写的表单内容，要么是文件内容。FileItem类对象实际上就是对图1.3中的一个分区的数据进行封装的对象，它内部用了两个成员变量来分别存储描述头和主体内容，其中保存主体内容的变量是一个输出流类型的对象。当主体内容的大小小于DiskFileUpload.setSizeThreshold方法设置的临界值大小时，这个流对象关联到一片内存，主体内容将会被保存在内存中。当主体内容的数据超过DiskFileUpload.setSizeThreshold方法设置的临界值大小时，这个流对象关联到硬盘上的一个临时文件，主体内容将被保存到该临时文件中。临时文件的存储目录由DiskFileUpload.setRepositoryPath方法设置，临时文件名的格式为“upload_（八位或八位以上的数字）.tmp”这种形式，FileItem类内部提供了维护临时文件名中的数值不重复的机制，以保证了临时文件名的唯一性。当应用程序将主体内容保存到一个指定的文件中时，或者在FileItem对象被垃圾回收器回收时，或者Java虚拟机结束时，Apache文件上传组件都会尝试删除临时文件，以尽量保证临时文件能被及时清除。
　　下面介绍FileItem类中的几个常用的方法：
　　2.1. isFormField方法
　　isFormField方法用于判断FileItem类对象封装的数据是否属于一个普通表单字段，还是属于一个文件表单字段，如果是普通表单字段则返回true，否则返回false。该方法的完整语法定义如下：
　　public boolean isFormField()
　　2.2. getName方法
　　getName方法用于获得文件上传字段中的文件名，对于图1.3中的第三个分区所示的描述头，getName方法返回的结果为字符串“C:\bg.gif”。如果FileItem类对象对应的是普通表单字段，getName方法将返回null。即使用户没有通过网页表单中的文件字段传递任何文件，但只要设置了文件表单字段的name属性，浏览器也会将文件字段的信息传递给服务器，只是文件名和文件内容部分都为空，但这个表单字段仍然对应一个FileItem对象，此时，getName方法返回结果为空字符串""，读者在调用Apache文件上传组件时要注意考虑这个情况。getName方法的完整语法定义如下：
　　public String getName()
　　注意：如果用户使用Windows系统上传文件，浏览器将传递该文件的完整路径，如果用户使用Linux或者Unix系统上传文件，浏览器将只传递该文件的名称部分。
　　2.3．getFieldName方法
　　getFieldName方法用于返回表单字段元素的name属性值，也就是返回图1.3中的各个描述头部分中的name属性值，例如“name=p1”中的“p1”。getFieldName方法的完整语法定义如下：
　　public String getFieldName()
　　2.4. write方法
　　write方法用于将FileItem对象中保存的主体内容保存到某个指定的文件中。如果FileItem对象中的主体内容是保存在某个临时文件中，该方法顺利完成后，临时文件有可能会被清除。该方法也可将普通表单字段内容写入到一个文件中，但它主要用途是将上传的文件内容保存在本地文件系统中。其完整语法定义如下：
　　public void write(File file)
　　2.5．getString方法
　　getString方法用于将FileItem对象中保存的主体内容作为一个字符串返回，它有两个重载的定义形式：
　　public java.lang.String getString()
　　public java.lang.String getString(java.lang.String encoding)
　　throws java.io.UnsupportedEncodingException
　　前者使用缺省的字符集编码将主体内容转换成字符串，后者使用参数指定的字符集编码将主体内容转换成字符串。如果在读取普通表单字段元素的内容时出现了中文乱码现象，请调用第二个getString方法，并为之传递正确的字符集编码名称。
　　2.6. getContentType方法
　　getContentType 方法用于获得上传文件的类型，对于图1.3中的第三个分区所示的描述头，getContentType方法返回的结果为字符串“image/gif”，即“Content-Type”字段的值部分。如果FileItem类对象对应的是普通表单字段，该方法将返回null。getContentType 方法的完整语法定义如下：
　　public String getContentType()
　　2.7. isInMemory方法
　　isInMemory方法用来判断FileItem类对象封装的主体内容是存储在内存中，还是存储在临时文件中，如果存储在内存中则返回true，否则返回false。其完整语法定义如下：
　　public boolean isInMemory()
　　2.8. delete方法
　　delete方法用来清空FileItem类对象中存放的主体内容，如果主体内容被保存在临时文件中，delete方法将删除该临时文件。尽管Apache组件使用了多种方式来尽量及时清理临时文件，但系统出现异常时，仍有可能造成有的临时文件被永久保存在了硬盘中。在有些情况下，可以调用这个方法来及时删除临时文件。其完整语法定义如下：
　　public void delete()
　　3. FileUploadException类
　　在文件上传过程中，可能发生各种各样的异常，例如网络中断、数据丢失等等。为了对不同异常进行合适的处理，Apache文件上传组件还开发了四个异常类，其中FileUploadException是其他异常类的父类，其他几个类只是被间接调用的底层类，对于Apache组件调用人员来说，只需对FileUploadException异常类进行捕获和处理即可。
　　4. ServletRequestContext
　　ServletRequestContext类提供访问request的方法。实现RequestContext接口。
南京市民张先生的女儿就读的一家幼儿园，在今年进行了一场军...
九寨沟新开放的景区神仙池，集九寨沟和黄龙之美于一身，近日...
你可能遇到过这样的情况，加油员在加油的时候突然停掉油枪又...
河北唐山到四川广元青川，相距一千八百公里，这两个城市在情...
浙江温州瑞祥高中住校学生小阮在学校食堂打了一份糯米饭，带...
4·20芦山7.0级强烈地震发生后，我省民政部门快速启动应急预...军训小结{2}_百度文库
两大类热门资源免费畅读
续费一年阅读会员，立省24元！
文档贡献者贡献于
评价文档：
暂无相关推荐文档
军训小结{2}|
把文档贴到Blog、BBS或个人站等：
普通尺寸(450*500pix)
较大尺寸(630*500pix)
大小：7.07KB
登录百度文库，专享文档复制特权，财富值每天免费拿！
你可能喜欢当前位置：正文
微信扫一扫分享到朋友圈
红色跑道翻滚着绿色的波浪，步伐铿锵，军乐激昂。9月25日，嘹亮的口号声回荡在浙江传媒学院桐乡校区操场的上空，在经过了数十天辛苦训练后，来自下沙校区和桐乡校区的3000多名新生集聚在桐乡校区田径场，他们将向全体师生们展示这几天的辛苦成果。
下午2点，浙江传媒学院2014级新生军训汇报表演暨总结表彰大会正式召开。浙江传媒学院党委书记奚建华，校长彭少建，党委副书记王文科，党委副书记宣裕方，纪委书记柯力，副校长李军，副校长汤兆武，宣传部长叶蒙荻，浙江陆军预备役步兵师副师长蒋亮东大校，浙江陆军预备役步兵师秘群科科长兼浙江传媒学院2014级新生军训团团长叶江强中校，浙江陆军预备役步兵师炮兵团副团长兼浙江传媒学院2014级新生军训团政委李庆峰中校，浙江陆军预备役步兵师工化科科长兼新生军训团督导员吴志国中校，巴新华中校、徐涛中校等领导及浙江传媒学院2014级学生军训领导小组的成员出席本了本次汇报表演，大会由浙江传媒学院副校长王渊明主持。
庄严的国歌奏响，鲜红的国旗入场，阅兵式正式开始。校党委书记奚建华对每一方阵进行检阅，嘹亮的“首长好”、“为人民服务”的口号声响彻体育场上空，展示出新生们良好的精神风貌，振奋人心。阅兵结束，标兵就位，分列式正式开始。在主持人澎湃激昂的的解说中，桐乡校区的学子们展现了他们非凡的风采。文化创意学院的队伍带着饱满的情绪，口号响亮，步伐铿锵。文学院用他们独特的口号向主席台致敬，整齐的队列赢得了阵阵掌声。管理学院的队伍斗志昂扬，他们挺直脊梁用井然有序的步伐献上军训的成功硕果。音乐学院迈着强健有力的步伐，响亮口号引起热烈掌声。设计艺术学院紧随其后，将专业特色与军人姿态融为一体，表现不凡。在为期数十天的军训中，2014级新生秉承着不抛弃，不放弃的态度，不怕吃苦，不说累的精神，上完大学第一课，交上一份完美的答卷。
分列式结束后，校党委副书记王文科宣读了军训表彰决定。在本次军训中共评选出5个学院为“军训优秀组织奖”，7个方阵被评选为“最佳方阵奖”，10个连获得“优秀连”荣誉称号，13名教师被评选为“优秀指导员”，10名教官获得“优秀教官”荣誉称号，在三千多名新生中共评选出三百余名“军训标兵”和45个“内务卫生优胜寝室”。
颁奖结束后，浙江陆军预备役步兵师副师长蒋亮东大校发表了讲话，他充分肯定了2014级新生在军训中的突出表现，他说：“部队高度重视本次的新生军训，同学们也都积极参与，不怕苦不怕累，在十余天的训练里增强了荣誉感、责任感和使命感，展现出当代大学生的朝气蓬勃。”今日的汇报表演充分展现了同学们积极向上的精神面貌，蒋亮东大校鼓励同学们将军训期间的优良作风发扬到日后的学习生活中去，实现自己的理想，早日成才。
校党委副书记宣裕方作了军训总结。讲话中，他代表学校党委、行政对在此次军训中辛劳付出的浙江陆军预备役步兵师领导和全体教官不辞劳苦、一丝不苟的指导表示衷心的感谢，他高度赞扬了全体参训官兵和广大师生克服重重困难，圆满完成各项任务的精神。同时，宣裕方也对全体2014级新生提出了期望，他表示：“希望同学们继续保持、巩固和发扬在军训中培养出来的好思想、好作风，继续发扬脚踏实地、百折不挠的精神，敢于面对困难和挫折；巩固和发扬集体主义精神，珍惜大学时光，在四年的学习中有所成就。”
2014级新生的军训生活落下了帷幕，大学生活的新篇章正等待着他们去翻开。希望所有新生能带着父母、学校的期盼，把军人艰苦朴素的工作作风和吃苦耐劳的革命精神融入日后的学习生活，为传媒事业的发展贡献自己的力量。新闻中心 文/ 叶希涓
责编/饶晓菁
分享给好友
分享到微信朋友圈：
第一步 打开微信底部扫一扫
第二步 扫下面的文章二维码
第三步 右上角点击转发
相关文章Relevant
微信公众平台推荐
如何喝水才最减肥
饮水以1400卡的热量侵蚀你
一天内的6次饮水时间,能得到1400多卡的热量.而在你自己的减重计划内一定没把这...
《中秋》(唐)李朴皓魄当空宝镜升,云间仙籁寂无声;平分秋色一轮满,长伴云衢千里明;狡兔空从弦外落,妖蟆休向眼前生;灵槎...
“十一”的到来,旅游高峰也随之到来,许多人都做好了外出旅游的准备了外出旅游的准备.但因种种原因,旅行途中则有可能会出现...
米饭是日常不可少的主食,不同的米有不同的功效,比如黑米补肾、糯米排毒、糙米助消化等等,下面就让中医来为我们介绍下不同米...
表妹刚才给我打了一通电话,向我郁闷的倾诉自己最近的感情遭遇.总结起来也许就是很简单的一句毕业季分手季.这样一个说起来很...
1、为什么别人越来越不把你当一回事情,因为你太好说话了.什么事情,别人一找你就答应;什么东西,别人一给你就要.这样你就...
有一个人,不管习总书记在什么场合他都跟随在习总书记身边,网友戏称他为“大内第一高手”,下面一起来看看这位“大内高手”的...
一个年轻美丽的女人躺在医院的病床上,苍白的脸看着眼前这位帅气的男人说,老公,别在折腾了,我们已经没有钱了,男人笑看着女...
这个世界有一种男盆友,他的摄影技术不过关.然后呢?他就没有然后了.这件事情告诉我们两个道理.一个是男人要学会拍照.另一...
■ 点击上面蓝字一键关注 ▲QIBU生活微刊语文提分很困难,作文拉分最常见,仔细分析高分卷,原来里面有诀窍.小时候写作文总是...
小编 今天要介绍的这些名人,如果单独拿出他们年轻、年老时的照片,你绝对不会认出这是同一个人!如果真的有时光机,多少年前,...
(摘自微信号:每天读一点)上海地区大客户订报专线:点击下方“阅读原文”关注报刊文摘服务号可免费试读更多精彩文...求大学军训小结_百度知道
求大学军训小结
要300字以内，谢了
提问者采纳
军训心得体会军训不但培养人有吃苦耐劳的精神，而且能磨练人的坚强意志。苏轼有句话：“古之立大事者，不惟有超世之才，亦必有坚忍不拔之志。”这句话意思是成功的大门从来都是向意志坚强的人敞开的，甚至可以说是弗定崔感诏啡措拾胆浆只向意志坚强的人敞开。 心目中的军训充满教官的训斥；心目中的军训是紧张与艰苦的合奏；心目中的军训更是无常地响起那集合手哨音，还有那瓢泼大雨下的大集合、严训练；心目中的军训生活成百上千次地浮现在我的脑海，闪现在我的眼前。但我还是满怀欣喜与信心地去拥抱我向往已久的军训。 在军训中，很苦很累，但这是一种人生体验，战胜自我，锻炼意志的最佳良机。心里虽有说不出的酸甜苦辣，在烈日酷暑下的曝晒，皮肤变成黑黝黝的，但这何尝不是一种快乐，一种更好地朝人生目标前进的勇气，更增添了一份完善自我的信心吗？ 我满怀信心地开始了真正的训练。教官一遍遍耐心地指导代替了严厉的训斥。训练场上不但有我们整齐的步伐，也有我们阵阵洪亮的口号声，更有我们那嘹亮的军营歌曲。 站军姿，给了你炎黄子孙不屈脊梁的身体，也给了你龙之传人无穷的毅力。练转身，体现了人类活跃敏捷的思维，更体现了集体主义的伟大。不积滴水，无以成江海。没有我们每个人的努力，就不可能有一个完整的，高质量的方队。训练的每一个动作，都让我深深地体会到了团结的力量，合作的力量，以及团队精神的重要，我相信，它将使我终身受益，无论在哪个岗位上。 其实在自己的人生路上，也应该印满一条自己脚步的路，即使那路到处布满了荆棘，即使那路每一步都是那样的泥泞、那样的坎坷，也得让自己去踩、去踏、去摸索、去行进！我想那样的路才是真实的自我写照，决无半点虚假伪装之意。
提问者评价
一千字就写不到了几百字可以吗,楼主?? 回想那短短两周军训的日子，一种潜藏在心中已久的感受便由然而生。的确，军训是辛苦的，但切辛苦
的美丽，辛苦的动人，辛苦的让人难以忘怀。在军训时，我们和训练员在烈日下同甘共苦，他们对每一个动
作都要求严格，一发现我们的动作不规范，不到位，便细心的给我们讲解，纠正我们的错误，争取让我们把
每一个动作...
其他类似问题
按默认排序
其他1条回答
百度一下 你就知道 那一天，我们踏进了某某大学的校门，也就意味着，军训小结 西牧新燃 我们简直是从人转弗定崔感诏啡措拾胆浆变成仅仅的人力资源和人力资本了。没有
军训的相关知识
您可能关注的推广
等待您来回答
下载知道APP
随时随地咨询
出门在外也不愁}