fileuploadbase.html

ava 项目中

<a name="612" href="#612">612</a> <em>             */</em>
<a name="613" href="#613">613</a>             <strong>private</strong> <strong>final</strong> String fieldName;
<a name="614" href="#614">614</a>             <em>/**</em><em> The file items file name.</em>
<a name="615" href="#615">615</a> <em>             */</em>
<a name="616" href="#616">616</a>             <strong>private</strong> <strong>final</strong> String name;
<a name="617" href="#617">617</a>             <em>/**</em><em> Whether the file item is a form field.</em>
<a name="618" href="#618">618</a> <em>             */</em>
<a name="619" href="#619">619</a>             <strong>private</strong> <strong>final</strong> <strong>boolean</strong> formField;
<a name="620" href="#620">620</a>             <em>/**</em><em> The file items input stream.</em>
<a name="621" href="#621">621</a> <em>             */</em>
<a name="622" href="#622">622</a>             <strong>private</strong> <strong>final</strong> InputStream stream;
<a name="623" href="#623">623</a>             <em>/**</em><em> Whether the file item was already opened.</em>
<a name="624" href="#624">624</a> <em>             */</em>
<a name="625" href="#625">625</a>             <strong>private</strong> <strong>boolean</strong> opened;
<a name="626" href="#626">626</a> 
<a name="627" href="#627">627</a>             <em>/**</em>
<a name="628" href="#628">628</a> <em>             * CReates a new instance.</em>
<a name="629" href="#629">629</a> <em>             * @param pName The items file name, or null.</em>
<a name="630" href="#630">630</a> <em>             * @param pFieldName The items field name.</em>
<a name="631" href="#631">631</a> <em>             * @param pContentType The items content type, or null.</em>
<a name="632" href="#632">632</a> <em>             * @param pFormField Whether the item is a form field.</em>
<a name="633" href="#633">633</a> <em>             */</em>
<a name="634" href="#634">634</a>             FileItemStreamImpl(String pName, String pFieldName,
<a name="635" href="#635">635</a>                     String pContentType, <strong>boolean</strong> pFormField) {
<a name="636" href="#636">636</a>                 name = pName;
<a name="637" href="#637">637</a>                 fieldName = pFieldName;
<a name="638" href="#638">638</a>                 contentType = pContentType;
<a name="639" href="#639">639</a>                 formField = pFormField;
<a name="640" href="#640">640</a>                 InputStream istream = multi.newInputStream();
<a name="641" href="#641">641</a>                 <strong>if</strong> (fileSizeMax != -1) {
<a name="642" href="#642">642</a>                     istream = <strong>new</strong> <a href="../../../../org/apache/commons/fileupload/util/LimitedInputStream.html">LimitedInputStream</a>(istream, fileSizeMax) {
<a name="643" href="#643">643</a>                         <strong>protected</strong> <strong>void</strong> raiseError(<strong>long</strong> pSizeMax, <strong>long</strong> pCount)
<a name="644" href="#644">644</a>                                 throws IOException {
<a name="645" href="#645">645</a>                             <a href="../../../../org/apache/commons/fileupload/FileUploadException.html">FileUploadException</a> e =
<a name="646" href="#646">646</a>                                 <strong>new</strong> FileSizeLimitExceededException(
<a name="647" href="#647">647</a>                                     <span class="string">"The field "</span> + fieldName
<a name="648" href="#648">648</a>                                     + <span class="string">" exceeds its maximum permitted "</span>
<a name="649" href="#649">649</a>                                     + <span class="string">" size of "</span> + pSizeMax
<a name="650" href="#650">650</a>                                     + <span class="string">" characters."</span>,
<a name="651" href="#651">651</a>                                     pCount, pSizeMax);
<a name="652" href="#652">652</a>                             <strong>throw</strong> <strong>new</strong> FileUploadIOException(e);
<a name="653" href="#653">653</a>                         }
<a name="654" href="#654">654</a>                     };
<a name="655" href="#655">655</a>                 }
<a name="656" href="#656">656</a>                 stream = istream;
<a name="657" href="#657">657</a>             }
<a name="658" href="#658">658</a> 
<a name="659" href="#659">659</a>             <em>/**</em>
<a name="660" href="#660">660</a> <em>             * Returns the items content type, or null.</em>
<a name="661" href="#661">661</a> <em>             * @return Content type, if known, or null.</em>
<a name="662" href="#662">662</a> <em>             */</em>
<a name="663" href="#663">663</a>             <strong>public</strong> String getContentType() {
<a name="664" href="#664">664</a>                 <strong>return</strong> contentType;
<a name="665" href="#665">665</a>             }
<a name="666" href="#666">666</a> 
<a name="667" href="#667">667</a>             <em>/**</em>
<a name="668" href="#668">668</a> <em>             * Returns the items field name.</em>
<a name="669" href="#669">669</a> <em>             * @return Field name.</em>
<a name="670" href="#670">670</a> <em>             */</em>
<a name="671" href="#671">671</a>             <strong>public</strong> String getFieldName() {
<a name="672" href="#672">672</a>                 <strong>return</strong> fieldName;
<a name="673" href="#673">673</a>             }
<a name="674" href="#674">674</a> 
<a name="675" href="#675">675</a>             <em>/**</em>
<a name="676" href="#676">676</a> <em>             * Returns the items file name.</em>
<a name="677" href="#677">677</a> <em>             * @return File name, if known, or null.</em>
<a name="678" href="#678">678</a> <em>             */</em>
<a name="679" href="#679">679</a>             <strong>public</strong> String getName() {
<a name="680" href="#680">680</a>                 <strong>return</strong> name;
<a name="681" href="#681">681</a>             }
<a name="682" href="#682">682</a> 
<a name="683" href="#683">683</a>             <em>/**</em>
<a name="684" href="#684">684</a> <em>             * Returns, whether this is a form field.</em>
<a name="685" href="#685">685</a> <em>             * @return True, if the item is a form field,</em>
<a name="686" href="#686">686</a> <em>             *   otherwise false.</em>
<a name="687" href="#687">687</a> <em>             */</em>
<a name="688" href="#688">688</a>             <strong>public</strong> <strong>boolean</strong> isFormField() {
<a name="689" href="#689">689</a>                 <strong>return</strong> formField;
<a name="690" href="#690">690</a>             }
<a name="691" href="#691">691</a> 
<a name="692" href="#692">692</a>             <em>/**</em>
<a name="693" href="#693">693</a> <em>             * Returns an input stream, which may be used to</em>
<a name="694" href="#694">694</a> <em>             * read the items contents.</em>
<a name="695" href="#695">695</a> <em>             * @return Opened input stream.</em>
<a name="696" href="#696">696</a> <em>             * @throws IOException An I/O error occurred.</em>
<a name="697" href="#697">697</a> <em>             */</em>
<a name="698" href="#698">698</a>             <strong>public</strong> InputStream openStream() throws IOException {
<a name="699" href="#699">699</a>                 <strong>if</strong> (opened) {
<a name="700" href="#700">700</a>                     <strong>throw</strong> <strong>new</strong> IllegalStateException(
<a name="701" href="#701">701</a>                             <span class="string">"The stream was already opened."</span>);
<a name="702" href="#702">702</a>                 }
<a name="703" href="#703">703</a>                 <strong>if</strong> (((Closeable) stream).isClosed()) {
<a name="704" href="#704">704</a>                     <strong>throw</strong> <strong>new</strong> FileItemStream.ItemSkippedException();
<a name="705" href="#705">705</a>                 }
<a name="706" href="#706">706</a>                 <strong>return</strong> stream;
<a name="707" href="#707">707</a>             }
<a name="708" href="#708">708</a> 
<a name="709" href="#709">709</a>             <em>/**</em>
<a name="710" href="#710">710</a> <em>             * Closes the file item.</em>
<a name="711" href="#711">711</a> <em>             * @throws IOException An I/O error occurred.</em>
<a name="712" href="#712">712</a> <em>             */</em>
<a name="713" href="#713">713</a>             <strong>void</strong> close() throws IOException {
<a name="714" href="#714">714</a>                 stream.close();
<a name="715" href="#715">715</a>             }
<a name="716" href="#716">716</a>         }
<a name="717" href="#717">717</a> 
<a name="718" href="#718">718</a>         <em>/**</em>
<a name="719" href="#719">719</a> <em>         * The multi part stream to process.</em>
<a name="720" href="#720">720</a> <em>         */</em>
<a name="721" href="#721">721</a>         <strong>private</strong> <strong>final</strong> <a href="../../../../org/apache/commons/fileupload/MultipartStream.html">MultipartStream</a> multi;
<a name="722" href="#722">722</a>         <em>/**</em>
<a name="723" href="#723">723</a> <em>         * The notifier, which used for triggering the</em>
<a name="724" href="#724">724</a> <em>         * {@link ProgressListener}.</em>
<a name="725" href="#725">725</a> <em>         */</em>
<a name="726" href="#726">726</a>         <strong>private</strong> <strong>final</strong> MultipartStream.ProgressNotifier notifier;
<a name="727" href="#727">727</a>         <em>/**</em>
<a name="728" href="#728">728</a> <em>         * The boundary, which separates the various parts.</em>
<a name="729" href="#729">729</a> <em>         */</em>
<a name="730" href="#730">730</a>         <strong>private</strong> <strong>final</strong> byte[] boundary;
<a name="731" href="#731">731</a>         <em>/**</em>
<a name="732" href="#732">732</a> <em>         * The item, which we currently process.</em>
<a name="733" href="#733">733</a> <em>         */</em>
<a name="734" href="#734">734</a>         <strong>private</strong> FileItemStreamImpl currentItem;
<a name="735" href="#735">735</a>         <em>/**</em>
<a name="736" href="#736">736</a> <em>         * The current items field name.</em>
<a name="737" href="#737">737</a> <em>         */</em>
<a name="738" href="#738">738</a>         <strong>private</strong> String currentFieldName;
<a name="739" href="#739">739</a>         <em>/**</em>
<a name="740" href="#740">740</a> <em>         * Whether we are currently skipping the preamble.</em>
<a name="741" href="#741">741</a> <em>         */</em>
<a name="742" href="#742">742</a>         <strong>private</strong> <strong>boolean</strong> skipPreamble;
<a name="743" href="#743">743</a>         <em>/**</em>
<a name="744" href="#744">744</a> <em>         * Whether the current item may still be read.</em>
<a name="745" href="#745">745</a> <em>         */</em>
<a name="746" href="#746">746</a>         <strong>private</strong> <strong>boolean</strong> itemValid;
<a name="747" href="#747">747</a>         <em>/**</em>
<a name="748" href="#748">748</a> <em>         * Whether we have seen the end of the file.</em>
<a name="749" href="#749">749</a> <em>         */</em>
<a name="750" href="#750">750</a>         <strong>private</strong> <strong>boolean</strong> eof;
<a name="751" href="#751">751</a> 
<a name="752" href="#752">752</a>         <em>/**</em>
<a name="753" href="#753">753</a> <em>         * Creates a new instance.</em>
<a name="754" href="#754">754</a> <em>         * @param ctx The request context.</em>
<a name="755" href="#755">755</a> <em>         * @throws FileUploadException An error occurred while</em>
<a name="756" href="#756">756</a> <em>         *   parsing the request.</em>
<a name="757" href="#757">757</a> <em>         * @throws IOException An I/O error occurred.</em>
<a name="758" href="#758">758</a> <em>         */</em>
<a name="759" href="#759">759</a>         FileItemIteratorImpl(<a href="../../../../org/apache/commons/fileupload/RequestContext.html">RequestContext</a> ctx)
<a name="760" href="#760">760</a>                 throws FileUploadException, IOException {
<a name="761" href="#761">761</a>             <strong>if</strong> (ctx == <strong>null</strong>) {
<a name="762" href="#762">762</a>                 <strong>throw</strong> <strong>new</strong> NullPointerException(<span class="string">"ctx parameter"</span>);
<a name="763" href="#763">763</a>             }
<a name="764" href="#764">764</a> 
<a name="765" href="#765">765</a>             String contentType