apache common FileUpload

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » Net » apache common FileUpload 
FileUpload
License:Apache License
URL:http://commons.apache.org/fileupload/
Description:File upload capability for your servlets and web applications.
Package NameComment
org.apache.commons.fileupload Overview of the org.apache.commons.fileupload component

A component for handling HTML file uploads as specified by RFC 1867. This component provides support for uploads within both servlets (JSR 53) and portlets (JSR 168).

While this package provides the generic functionality for file uploads, these classes are not typically used directly. Instead, normal usage involves one of the provided extensions of {@link org.apache.commons.fileupload.FileUpload FileUpload} such as {@link org.apache.commons.fileupload.servlet.ServletFileUpload ServletFileUpload} or {@link org.apache.commons.fileupload.portlet.PortletFileUpload PortletFileUpload}, together with a factory for {@link org.apache.commons.fileupload.FileItem FileItem} instances, such as {@link org.apache.commons.fileupload.disk.DiskFileItemFactory DiskFileItemFactory}.

The following is a brief example of typical usage in a servlet, storing the uploaded files on disk.

    public void doPost(HttpServletRequest req, HttpServletResponse res) {
        DiskFileItemFactory factory = new DiskFileItemFactory();
        // maximum size that will be stored in memory
        factory.setSizeThreshold(4096);
        // the location for saving data that is larger than getSizeThreshold()
        factory.setRepository(new File("/tmp"));

        ServletFileUpload upload = new ServletFileUpload(factory);
        // maximum size before a FileUploadException will be thrown
        upload.setSizeMax(1000000);

        List fileItems = upload.parseRequest(req);
        // assume we know there are two files. The first file is a small
        // text file, the second is unknown and is written to a file on
        // the server
        Iterator i = fileItems.iterator();
        String comment = ((FileItem)i.next()).getString();
        FileItem fi = (FileItem)i.next();
        // filename on the client
        String fileName = fi.getName();
        // save comment and filename to database
        ...
        // write the file
        fi.write(new File("/www/uploads/", fileName));
    }

In the example above, the first file is loaded into memory as a String. Before calling the getString method, the data may have been in memory or on disk depending on its size. The second file we assume it will be large and therefore never explicitly load it into memory, though if it is less than 4096 bytes it will be in memory before it is written to its final location. When writing to the final location, if the data is larger than the threshold, an attempt is made to rename the temporary file to the given location. If it cannot be renamed, it is streamed to the new location.

Please see the FileUpload User Guide for further details and examples of how to use this package.

org.apache.commons.fileupload.disk Overview of the org.apache.commons.fileupload.disk component

A disk-based implementation of the {@link org.apache.commons.fileupload.FileItem FileItem} interface. This implementation retains smaller items in memory, while writing larger ones to disk. The threshold between these two is configurable, as is the location of files that are written to disk.

In typical usage, an instance of {@link org.apache.commons.fileupload.disk.DiskFileItemFactory DiskFileItemFactory} would be created, configured, and then passed to a {@link org.apache.commons.fileupload.FileUpload FileUpload} implementation such as {@link org.apache.commons.fileupload.servlet.ServletFileUpload ServletFileUpload} or {@link org.apache.commons.fileupload.portlet.PortletFileUpload PortletFileUpload}.

The following code fragment demonstrates this usage.

        DiskFileItemFactory factory = new DiskFileItemFactory();
        // maximum size that will be stored in memory
        factory.setSizeThreshold(4096);
        // the location for saving data that is larger than getSizeThreshold()
        factory.setRepository(new File("/tmp"));

        ServletFileUpload upload = new ServletFileUpload(factory);

Please see the FileUpload User Guide for further details and examples of how to use this package.

org.apache.commons.fileupload.portlet Overview of the org.apache.commons.fileupload.portlet component

An implementation of {@link org.apache.commons.fileupload.FileUpload FileUpload} for use in portlets conforming to JSR 168. This implementation requires only access to the portlet's current ActionRequest instance, and a suitable {@link org.apache.commons.fileupload.FileItemFactory FileItemFactory} implementation, such as {@link org.apache.commons.fileupload.disk.DiskFileItemFactory DiskFileItemFactory}.

The following code fragment demonstrates typical usage.

        DiskFileItemFactory factory = new DiskFileItemFactory();
        // Configure the factory here, if desired.
        PortletFileUpload upload = new PortletFileUpload(factory);
        // Configure the uploader here, if desired.
        List fileItems = upload.parseRequest(request);

Please see the FileUpload User Guide for further details and examples of how to use this package.

org.apache.commons.fileupload.servlet Overview of the org.apache.commons.fileupload.servlet component

An implementation of {@link org.apache.commons.fileupload.FileUpload FileUpload} for use in servlets conforming to JSR 53. This implementation requires only access to the servlet's current HttpServletRequest instance, and a suitable {@link org.apache.commons.fileupload.FileItemFactory FileItemFactory} implementation, such as {@link org.apache.commons.fileupload.disk.DiskFileItemFactory DiskFileItemFactory}.

The following code fragment demonstrates typical usage.

        DiskFileItemFactory factory = new DiskFileItemFactory();
        // Configure the factory here, if desired.
        ServletFileUpload upload = new ServletFileUpload(factory);
        // Configure the uploader here, if desired.
        List fileItems = upload.parseRequest(request);

Please see the FileUpload User Guide for further details and examples of how to use this package.

org.apache.commons.fileupload.util Overview of the org.apache.commons.fileupload.util component

This package contains various IO related utility classes or methods, which are basically reusable and not necessarily restricted to the scope of a file upload.

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.