Category

Development Platform
Home > SourceCode/Document > Java Develop > View Code
FilenameMangler.java
Package: HTTP客户端.zip　[view]
Upload User: demmber
Upload Date: 2007-12-22
Package Size: 717k
Code Size: 3k
Category:

Java Develop

Development Platform:

Java

FilenameMangler.java：Code Content
  1. /*
  2.  * @(#)FilenameMangler.java 0.3-3 06/05/2001
  3.  *
  4.  *  This file is part of the HTTPClient package
  5.  *  Copyright (C) 1996-2001 Ronald Tschal鋜
  6.  *
  7.  *  This library is free software; you can redistribute it and/or
  8.  *  modify it under the terms of the GNU Lesser General Public
  9.  *  License as published by the Free Software Foundation; either
  10.  *  version 2 of the License, or (at your option) any later version.
  11.  *
  12.  *  This library is distributed in the hope that it will be useful,
  13.  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  14.  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15.  *  Lesser General Public License for more details.
  16.  *
  17.  *  You should have received a copy of the GNU Lesser General Public
  18.  *  License along with this library; if not, write to the Free
  19.  *  Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
  20.  *  MA 02111-1307, USA
  21.  *
  22.  *  For questions, suggestions, bug-reports, enhancement-requests etc.
  23.  *  I may be contacted at:
  24.  *
  25.  *  ronald@innovation.ch
  26.  *
  27.  *  The HTTPClient's home page is located at:
  28.  *
  29.  *  http://www.innovation.ch/java/HTTPClient/ 
  30.  *
  31.  */
  33. package HTTPClient;
  36. /**
  37.  * {@link Codecs#mpFormDataDecode(byte[], java.lang.String, java.lang.String,
  38.  * HTTPClient.FilenameMangler) Codecs.mpFormDataDecode} and {@link
  39.  * Codecs#mpFormDataEncode(HTTPClient.NVPair[], HTTPClient.NVPair[],
  40.  * HTTPClient.NVPair[], HTTPClient.FilenameMangler) Codecs.mpFormDataEncode}
  41.  * may be handed an instance of a class which implements this interface in
  42.  * order to control names of the decoded files or the names sent in the encoded
  43.  * data.
  44.  *
  45.  * @version 0.3-3  06/05/2001
  46.  * @author Ronald Tschal鋜
  47.  * @since V0.3-1
  48.  */
  49. public interface FilenameMangler
  50. {
  51.     /**
  52.      * This is invoked by {@link Codecs#mpFormDataDecode(byte[],
  53.      * java.lang.String, java.lang.String, HTTPClient.FilenameMangler)
  54.      * Codecs.mpFormDataDecode} for each file found in the data, just before
  55.      * the file is created and written. If null is returned then the file is
  56.      * not created or written. This allows you to control which files are
  57.      * written and the names of the resulting files.
  58.      *
  59.      * <P>For {@link Codecs#mpFormDataEncode(HTTPClient.NVPair[],
  60.      * HTTPClient.NVPair[], HTTPClient.NVPair[], HTTPClient.FilenameMangler)
  61.      * Codecs.mpFormDataEncode} this is also invoked on each filename, allowing
  62.      * you to control the actual name used in the <var>filename</var> attribute
  63.      * of the Content-Disposition header. This does not change the name of the
  64.      * file actually read. If null is returned then the file is ignored.
  65.      *
  66.      * @param filename  the original filename in the Content-Disposition header
  67.      * @param fieldname the name of the this field, i.e. the value of the
  68.      *                  <var>name</var> attribute in Content-Disposition
  69.      *                  header
  70.      * @return the new file name, or null if the file is to be ignored.
  71.      */
  72.     public String mangleFilename(String filename, String fieldname);
  73. }