KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > net > myvietnam > mvncore > web > fileupload > FileUpload


1 /*
2  * Copyright 2001-2004 The Apache Software Foundation
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 package net.myvietnam.mvncore.web.fileupload;
17
18 /**
19  * <p>High level API for processing file uploads.</p>
20  *
21  * <p>This class handles multiple files per single HTML widget, sent using
22  * <code>multipart/mixed</code> encoding type, as specified by
23  * <a HREF="http://www.ietf.org/rfc/rfc1867.txt">RFC 1867</a>. Use {@link
24  * #parseRequest(HttpServletRequest)} to acquire a list of {@link
25  * org.apache.commons.fileupload.FileItem}s associated with a given HTML
26  * widget.</p>
27  *
28  * <p>How the data for individual parts is stored is determined by the factory
29  * used to create them; a given part may be in memory, on disk, or somewhere
30  * else.</p>
31  *
32  * @author <a HREF="mailto:Rafal.Krzewski@e-point.pl">Rafal Krzewski</a>
33  * @author <a HREF="mailto:dlr@collab.net">Daniel Rall</a>
34  * @author <a HREF="mailto:jvanzyl@apache.org">Jason van Zyl</a>
35  * @author <a HREF="mailto:jmcnally@collab.net">John McNally</a>
36  * @author <a HREF="mailto:martinc@apache.org">Martin Cooper</a>
37  * @author Sean C. Sullivan
38  *
39  * @version $Id: FileUpload.java,v 1.2 2006/02/12 04:43:11 minhnn Exp $
40  */
41 public class FileUpload
42     extends FileUploadBase {
43
44     // ----------------------------------------------------------- Data members
45
46
47     /**
48      * The factory to use to create new form items.
49      */
50     private FileItemFactory fileItemFactory;
51
52
53     // ----------------------------------------------------------- Constructors
54
55
56     /**
57      * Constructs an uninitialised instance of this class. A factory must be
58      * configured, using <code>setFileItemFactory()</code>, before attempting
59      * to parse requests.
60      *
61      * @see #FileUpload(FileItemFactory)
62      */
63     public FileUpload() {
64         super();
65     }
66
67
68     /**
69      * Constructs an instance of this class which uses the supplied factory to
70      * create <code>FileItem</code> instances.
71      *
72      * @see #FileUpload()
73      */
74     public FileUpload(FileItemFactory fileItemFactory) {
75         super();
76         this.fileItemFactory = fileItemFactory;
77     }
78
79
80     // ----------------------------------------------------- Property accessors
81
82
83     /**
84      * Returns the factory class used when creating file items.
85      *
86      * @return The factory class for new file items.
87      */
88     public FileItemFactory getFileItemFactory() {
89         return fileItemFactory;
90     }
91
92
93     /**
94      * Sets the factory class to use when creating file items.
95      *
96      * @param factory The factory class for new file items.
97      */
98     public void setFileItemFactory(FileItemFactory factory) {
99         this.fileItemFactory = factory;
100     }
101
102
103 }
104
Popular Tags