fileuploadbase.html

ava 项目中

<a name="457" href="#457">457</a>             fieldName = (String) params.get(<span class="string">"name"</span>);
<a name="458" href="#458">458</a>             <strong>if</strong> (fieldName != <strong>null</strong>) {
<a name="459" href="#459">459</a>                 fieldName = fieldName.trim();
<a name="460" href="#460">460</a>             }
<a name="461" href="#461">461</a>         }
<a name="462" href="#462">462</a>         <strong>return</strong> fieldName;
<a name="463" href="#463">463</a>     }
<a name="464" href="#464">464</a> 
<a name="465" href="#465">465</a> 
<a name="466" href="#466">466</a>     <em>/**</em>
<a name="467" href="#467">467</a> <em>     * Creates a new {@link FileItem} instance.</em>
<a name="468" href="#468">468</a> <em>     *</em>
<a name="469" href="#469">469</a> <em>     * @param headers       A &lt;code>Map&lt;/code> containing the HTTP request</em>
<a name="470" href="#470">470</a> <em>     *                      headers.</em>
<a name="471" href="#471">471</a> <em>     * @param isFormField   Whether or not this item is a form field, as</em>
<a name="472" href="#472">472</a> <em>     *                      opposed to a file.</em>
<a name="473" href="#473">473</a> <em>     *</em>
<a name="474" href="#474">474</a> <em>     * @return A newly created &lt;code>FileItem&lt;/code> instance.</em>
<a name="475" href="#475">475</a> <em>     *</em>
<a name="476" href="#476">476</a> <em>     * @throws FileUploadException if an error occurs.</em>
<a name="477" href="#477">477</a> <em>     * @deprecated This method is no longer used in favour of</em>
<a name="478" href="#478">478</a> <em>     *   internally created instances of {@link FileItem}.</em>
<a name="479" href="#479">479</a> <em>     */</em>
<a name="480" href="#480">480</a>     <strong>protected</strong> <a href="../../../../org/apache/commons/fileupload/FileItem.html">FileItem</a> createItem(Map <em class="comment">/*<em class="comment"> String, String */</em> headers,</em>
<a name="481" href="#481">481</a>                                   <strong>boolean</strong> isFormField)
<a name="482" href="#482">482</a>         throws <a href="../../../../org/apache/commons/fileupload/FileUploadException.html">FileUploadException</a> {
<a name="483" href="#483">483</a>         <strong>return</strong> getFileItemFactory().createItem(getFieldName(headers),
<a name="484" href="#484">484</a>                 getHeader(headers, CONTENT_TYPE),
<a name="485" href="#485">485</a>                 isFormField,
<a name="486" href="#486">486</a>                 getFileName(headers));
<a name="487" href="#487">487</a>     }
<a name="488" href="#488">488</a> 
<a name="489" href="#489">489</a> 
<a name="490" href="#490">490</a>     <em>/**</em>
<a name="491" href="#491">491</a> <em>     * &lt;p> Parses the &lt;code>header-part&lt;/code> and returns as key/value</em>
<a name="492" href="#492">492</a> <em>     * pairs.</em>
<a name="493" href="#493">493</a> <em>     *</em>
<a name="494" href="#494">494</a> <em>     * &lt;p> If there are multiple headers of the same names, the name</em>
<a name="495" href="#495">495</a> <em>     * will map to a comma-separated list containing the values.</em>
<a name="496" href="#496">496</a> <em>     *</em>
<a name="497" href="#497">497</a> <em>     * @param headerPart The &lt;code>header-part&lt;/code> of the current</em>
<a name="498" href="#498">498</a> <em>     *                   &lt;code>encapsulation&lt;/code>.</em>
<a name="499" href="#499">499</a> <em>     *</em>
<a name="500" href="#500">500</a> <em>     * @return A &lt;code>Map&lt;/code> containing the parsed HTTP request headers.</em>
<a name="501" href="#501">501</a> <em>     */</em>
<a name="502" href="#502">502</a>     <strong>protected</strong> Map <em class="comment">/*<em class="comment"> String, String */</em> parseHeaders(String headerPart) {</em>
<a name="503" href="#503">503</a>         <strong>final</strong> <strong>int</strong> len = headerPart.length();
<a name="504" href="#504">504</a>         Map headers = <strong>new</strong> HashMap();
<a name="505" href="#505">505</a>         <strong>int</strong> start = 0;
<a name="506" href="#506">506</a>         <strong>for</strong> (;;) {
<a name="507" href="#507">507</a>             <strong>int</strong> end = parseEndOfLine(headerPart, start);
<a name="508" href="#508">508</a>             <strong>if</strong> (start == end) {
<a name="509" href="#509">509</a>                 <strong>break</strong>;
<a name="510" href="#510">510</a>             }
<a name="511" href="#511">511</a>             String header = headerPart.substring(start, end);
<a name="512" href="#512">512</a>             start = end + 2;
<a name="513" href="#513">513</a>             <strong>while</strong> (start &lt; len) {
<a name="514" href="#514">514</a>                 <strong>int</strong> nonWs = start;
<a name="515" href="#515">515</a>                 <strong>while</strong> (nonWs &lt; len) {
<a name="516" href="#516">516</a>                     <strong>char</strong> c = headerPart.<strong>char</strong>At(nonWs);
<a name="517" href="#517">517</a>                     <strong>if</strong> (c != ' '  &amp;&amp;  c != '\t') {
<a name="518" href="#518">518</a>                         <strong>break</strong>;
<a name="519" href="#519">519</a>                     }
<a name="520" href="#520">520</a>                     ++nonWs;
<a name="521" href="#521">521</a>                 }
<a name="522" href="#522">522</a>                 <strong>if</strong> (nonWs == start) {
<a name="523" href="#523">523</a>                     <strong>break</strong>;
<a name="524" href="#524">524</a>                 }
<a name="525" href="#525">525</a>                 <em class="comment">// Continuation line found</em>
<a name="526" href="#526">526</a>                 end = parseEndOfLine(headerPart, nonWs);
<a name="527" href="#527">527</a>                 header += <span class="string">" "</span> + headerPart.substring(nonWs, end);
<a name="528" href="#528">528</a>                 start = end + 2;
<a name="529" href="#529">529</a>             }
<a name="530" href="#530">530</a>             parseHeaderLine(headers, header);
<a name="531" href="#531">531</a>         }
<a name="532" href="#532">532</a>         <strong>return</strong> headers;
<a name="533" href="#533">533</a>     }
<a name="534" href="#534">534</a> 
<a name="535" href="#535">535</a>     <em>/**</em>
<a name="536" href="#536">536</a> <em>     * Skips bytes until the end of the current line.</em>
<a name="537" href="#537">537</a> <em>     * @param headerPart The headers, which are being parsed.</em>
<a name="538" href="#538">538</a> <em>     * @param end Index of the last byte, which has yet been</em>
<a name="539" href="#539">539</a> <em>     *   processed.</em>
<a name="540" href="#540">540</a> <em>     * @return Index of the \r\n sequence, which indicates</em>
<a name="541" href="#541">541</a> <em>     *   end of line.</em>
<a name="542" href="#542">542</a> <em>     */</em>
<a name="543" href="#543">543</a>     <strong>private</strong> <strong>int</strong> parseEndOfLine(String headerPart, <strong>int</strong> end) {
<a name="544" href="#544">544</a>         <strong>int</strong> index = end;
<a name="545" href="#545">545</a>         <strong>for</strong> (;;) {
<a name="546" href="#546">546</a>             <strong>int</strong> offset = headerPart.indexOf('\r', index);
<a name="547" href="#547">547</a>             <strong>if</strong> (offset == -1  ||  offset + 1 >= headerPart.length()) {
<a name="548" href="#548">548</a>                 <strong>throw</strong> <strong>new</strong> IllegalStateException(
<a name="549" href="#549">549</a>                     <span class="string">"Expected headers to be terminated by an empty line."</span>);
<a name="550" href="#550">550</a>             }
<a name="551" href="#551">551</a>             <strong>if</strong> (headerPart.charAt(offset + 1) == '\n') {
<a name="552" href="#552">552</a>                 <strong>return</strong> offset;
<a name="553" href="#553">553</a>             }
<a name="554" href="#554">554</a>             index = offset + 1;
<a name="555" href="#555">555</a>         }
<a name="556" href="#556">556</a>     }
<a name="557" href="#557">557</a> 
<a name="558" href="#558">558</a>     <em>/**</em>
<a name="559" href="#559">559</a> <em>     * Reads the next header line.</em>
<a name="560" href="#560">560</a> <em>     * @param headers String with all headers.</em>
<a name="561" href="#561">561</a> <em>     * @param header Map where to store the current header.</em>
<a name="562" href="#562">562</a> <em>     */</em>
<a name="563" href="#563">563</a>     <strong>private</strong> <strong>void</strong> parseHeaderLine(Map headers, String header) {
<a name="564" href="#564">564</a>         <strong>final</strong> <strong>int</strong> colonOffset = header.indexOf(':');
<a name="565" href="#565">565</a>         <strong>if</strong> (colonOffset == -1) {
<a name="566" href="#566">566</a>             <em class="comment">// This header line is malformed, skip it.</em>
<a name="567" href="#567">567</a>             <strong>return</strong>;
<a name="568" href="#568">568</a>         }
<a name="569" href="#569">569</a>         String headerName = header.substring(0, colonOffset)
<a name="570" href="#570">570</a>             .trim().toLowerCase();
<a name="571" href="#571">571</a>         String headerValue =
<a name="572" href="#572">572</a>             header.substring(header.indexOf(':') + 1).trim();
<a name="573" href="#573">573</a>         <strong>if</strong> (getHeader(headers, headerName) != <strong>null</strong>) {
<a name="574" href="#574">574</a>             <em class="comment">// More that one heder of that name exists,</em>
<a name="575" href="#575">575</a>             <em class="comment">// append to the list.</em>
<a name="576" href="#576">576</a>             headers.put(headerName,
<a name="577" href="#577">577</a>                     getHeader(headers, headerName) + ','
<a name="578" href="#578">578</a>                     + headerValue);
<a name="579" href="#579">579</a>         } <strong>else</strong> {
<a name="580" href="#580">580</a>             headers.put(headerName, headerValue);
<a name="581" href="#581">581</a>         }
<a name="582" href="#582">582</a>     }
<a name="583" href="#583">583</a> 
<a name="584" href="#584">584</a>     <em>/**</em>
<a name="585" href="#585">585</a> <em>     * Returns the header with the specified name from the supplied map. The</em>
<a name="586" href="#586">586</a> <em>     * header lookup is case-insensitive.</em>
<a name="587" href="#587">587</a> <em>     *</em>
<a name="588" href="#588">588</a> <em>     * @param headers A &lt;code>Map&lt;/code> containing the HTTP request headers.</em>
<a name="589" href="#589">589</a> <em>     * @param name    The name of the header to return.</em>
<a name="590" href="#590">590</a> <em>     *</em>
<a name="591" href="#591">591</a> <em>     * @return The value of specified header, or a comma-separated list if</em>
<a name="592" href="#592">592</a> <em>     *         there were multiple headers of that name.</em>
<a name="593" href="#593">593</a> <em>     */</em>
<a name="594" href="#594">594</a>     <strong>protected</strong> <strong>final</strong> String getHeader(Map <em class="comment">/*<em class="comment"> String, String */</em> headers,</em>
<a name="595" href="#595">595</a>             String name) {
<a name="596" href="#596">596</a>         <strong>return</strong> (String) headers.get(name.toLowerCase());
<a name="597" href="#597">597</a>     }
<a name="598" href="#598">598</a> 
<a name="599" href="#599">599</a>     <em>/**</em>
<a name="600" href="#600">600</a> <em>     * The iterator, which is returned by</em>
<a name="601" href="#601">601</a> <em>     * {@link FileUploadBase#getItemIterator(RequestContext)}.</em>
<a name="602" href="#602">602</a> <em>     */</em>
<a name="603" href="#603">603</a>     <strong>private</strong> <strong>class</strong> FileItemIteratorImpl implements <a href="../../../../org/apache/commons/fileupload/FileItemIterator.html">FileItemIterator</a> {
<a name="604" href="#604">604</a>         <em>/**</em>
<a name="605" href="#605">605</a> <em>         * Default implementation of {@link FileItemStream}.</em>
<a name="606" href="#606">606</a> <em>         */</em>
<a name="607" href="#607">607</a>         <strong>private</strong> <strong>class</strong> FileItemStreamImpl implements <a href="../../../../org/apache/commons/fileupload/FileItemStream.html">FileItemStream</a> {
<a name="608" href="#608">608</a>             <em>/**</em><em> The file items content type.</em>
<a name="609" href="#609">609</a> <em>             */</em>
<a name="610" href="#610">610</a>             <strong>private</strong> <strong>final</strong> String contentType;
<a name="611" href="#611">611</a>             <em>/**</em><em> The file items field name.</em>