Eric Kok
4 years ago
committed by
GitHub
98 changed files with 2332 additions and 5572 deletions
@ -1,86 +0,0 @@ |
|||||||
/* |
|
||||||
* $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//httpclient/src/java/org/apache/commons/httpclient/methods/multipart/ByteArrayPartSource.java,v 1.7 2004/04/18 23:51:37 jsdever Exp $
|
|
||||||
* $Revision: 480424 $ |
|
||||||
* $Date: 2006-11-29 06:56:49 +0100 (Wed, 29 Nov 2006) $ |
|
||||||
* |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* Licensed to the Apache Software Foundation (ASF) under one or more |
|
||||||
* contributor license agreements. See the NOTICE file distributed with |
|
||||||
* this work for additional information regarding copyright ownership. |
|
||||||
* The ASF licenses this file to You under the Apache License, Version 2.0 |
|
||||||
* (the "License"); you may not use this file except in compliance with |
|
||||||
* the License. You may obtain a copy of the License at |
|
||||||
* |
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
* |
|
||||||
* Unless required by applicable law or agreed to in writing, software |
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS, |
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
||||||
* See the License for the specific language governing permissions and |
|
||||||
* limitations under the License. |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* This software consists of voluntary contributions made by many |
|
||||||
* individuals on behalf of the Apache Software Foundation. For more |
|
||||||
* information on the Apache Software Foundation, please see |
|
||||||
* <http://www.apache.org/>.
|
|
||||||
* |
|
||||||
*/ |
|
||||||
|
|
||||||
package com.android.internalcopy.http.multipart; |
|
||||||
|
|
||||||
import java.io.ByteArrayInputStream; |
|
||||||
import java.io.InputStream; |
|
||||||
|
|
||||||
/** |
|
||||||
* A PartSource that reads from a byte array. This class should be used when |
|
||||||
* the data to post is already loaded into memory. |
|
||||||
* |
|
||||||
* @author <a href="mailto:becke@u.washington.edu">Michael Becke</a> |
|
||||||
* |
|
||||||
* @since 2.0 |
|
||||||
*/ |
|
||||||
public class ByteArrayPartSource implements PartSource { |
|
||||||
|
|
||||||
/** Name of the source file. */ |
|
||||||
private String fileName; |
|
||||||
|
|
||||||
/** Byte array of the source file. */ |
|
||||||
private byte[] bytes; |
|
||||||
|
|
||||||
/** |
|
||||||
* Constructor for ByteArrayPartSource. |
|
||||||
* |
|
||||||
* @param fileName the name of the file these bytes represent |
|
||||||
* @param bytes the content of this part |
|
||||||
*/ |
|
||||||
public ByteArrayPartSource(String fileName, byte[] bytes) { |
|
||||||
|
|
||||||
this.fileName = fileName; |
|
||||||
this.bytes = bytes; |
|
||||||
|
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* @see PartSource#getLength() |
|
||||||
*/ |
|
||||||
public long getLength() { |
|
||||||
return bytes.length; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* @see PartSource#getFileName() |
|
||||||
*/ |
|
||||||
public String getFileName() { |
|
||||||
return fileName; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* @see PartSource#createInputStream() |
|
||||||
*/ |
|
||||||
public InputStream createInputStream() { |
|
||||||
return new ByteArrayInputStream(bytes); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
@ -1,244 +0,0 @@ |
|||||||
/* |
|
||||||
* $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//httpclient/src/java/org/apache/commons/httpclient/methods/multipart/FilePart.java,v 1.19 2004/04/18 23:51:37 jsdever Exp $
|
|
||||||
* $Revision: 480424 $ |
|
||||||
* $Date: 2006-11-29 06:56:49 +0100 (Wed, 29 Nov 2006) $ |
|
||||||
* |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* Licensed to the Apache Software Foundation (ASF) under one or more |
|
||||||
* contributor license agreements. See the NOTICE file distributed with |
|
||||||
* this work for additional information regarding copyright ownership. |
|
||||||
* The ASF licenses this file to You under the Apache License, Version 2.0 |
|
||||||
* (the "License"); you may not use this file except in compliance with |
|
||||||
* the License. You may obtain a copy of the License at |
|
||||||
* |
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
* |
|
||||||
* Unless required by applicable law or agreed to in writing, software |
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS, |
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
||||||
* See the License for the specific language governing permissions and |
|
||||||
* limitations under the License. |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* This software consists of voluntary contributions made by many |
|
||||||
* individuals on behalf of the Apache Software Foundation. For more |
|
||||||
* information on the Apache Software Foundation, please see |
|
||||||
* <http://www.apache.org/>.
|
|
||||||
* |
|
||||||
*/ |
|
||||||
|
|
||||||
package com.android.internalcopy.http.multipart; |
|
||||||
|
|
||||||
import java.io.File; |
|
||||||
import java.io.FileNotFoundException; |
|
||||||
import java.io.IOException; |
|
||||||
import java.io.InputStream; |
|
||||||
import java.io.OutputStream; |
|
||||||
import org.apache.http.util.EncodingUtils; |
|
||||||
|
|
||||||
/** |
|
||||||
* This class implements a part of a Multipart post object that |
|
||||||
* consists of a file. |
|
||||||
* |
|
||||||
* @author <a href="mailto:mattalbright@yahoo.com">Matthew Albright</a> |
|
||||||
* @author <a href="mailto:jsdever@apache.org">Jeff Dever</a> |
|
||||||
* @author <a href="mailto:adrian@ephox.com">Adrian Sutton</a> |
|
||||||
* @author <a href="mailto:becke@u.washington.edu">Michael Becke</a> |
|
||||||
* @author <a href="mailto:mdiggory@latte.harvard.edu">Mark Diggory</a> |
|
||||||
* @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a> |
|
||||||
* @author <a href="mailto:oleg@ural.ru">Oleg Kalnichevski</a> |
|
||||||
* |
|
||||||
* @since 2.0 |
|
||||||
* |
|
||||||
*/ |
|
||||||
public class FilePart extends PartBase { |
|
||||||
|
|
||||||
/** Default content encoding of file attachments. */ |
|
||||||
public static final String DEFAULT_CONTENT_TYPE = "application/octet-stream"; |
|
||||||
|
|
||||||
/** Default charset of file attachments. */ |
|
||||||
public static final String DEFAULT_CHARSET = "ISO-8859-1"; |
|
||||||
|
|
||||||
/** Default transfer encoding of file attachments. */ |
|
||||||
public static final String DEFAULT_TRANSFER_ENCODING = "binary"; |
|
||||||
|
|
||||||
/** Attachment's file name */ |
|
||||||
protected static final String FILE_NAME = "; filename="; |
|
||||||
|
|
||||||
/** Attachment's file name as a byte array */ |
|
||||||
private static final byte[] FILE_NAME_BYTES = |
|
||||||
EncodingUtils.getAsciiBytes(FILE_NAME); |
|
||||||
|
|
||||||
/** Source of the file part. */ |
|
||||||
private PartSource source; |
|
||||||
|
|
||||||
/** |
|
||||||
* FilePart Constructor. |
|
||||||
* |
|
||||||
* @param name the name for this part |
|
||||||
* @param partSource the source for this part |
|
||||||
* @param contentType the content type for this part, if <code>null</code> the |
|
||||||
* {@link #DEFAULT_CONTENT_TYPE default} is used |
|
||||||
* @param charset the charset encoding for this part, if <code>null</code> the |
|
||||||
* {@link #DEFAULT_CHARSET default} is used |
|
||||||
*/ |
|
||||||
public FilePart(String name, PartSource partSource, String contentType, String charset) { |
|
||||||
|
|
||||||
super( |
|
||||||
name, |
|
||||||
contentType == null ? DEFAULT_CONTENT_TYPE : contentType, |
|
||||||
charset == null ? "ISO-8859-1" : charset, |
|
||||||
DEFAULT_TRANSFER_ENCODING |
|
||||||
); |
|
||||||
|
|
||||||
if (partSource == null) { |
|
||||||
throw new IllegalArgumentException("Source may not be null"); |
|
||||||
} |
|
||||||
this.source = partSource; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* FilePart Constructor. |
|
||||||
* |
|
||||||
* @param name the name for this part |
|
||||||
* @param partSource the source for this part |
|
||||||
*/ |
|
||||||
public FilePart(String name, PartSource partSource) { |
|
||||||
this(name, partSource, null, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* FilePart Constructor. |
|
||||||
* |
|
||||||
* @param name the name of the file part |
|
||||||
* @param file the file to post |
|
||||||
* |
|
||||||
* @throws FileNotFoundException if the <i>file</i> is not a normal |
|
||||||
* file or if it is not readable. |
|
||||||
*/ |
|
||||||
public FilePart(String name, File file) |
|
||||||
throws FileNotFoundException { |
|
||||||
this(name, new FilePartSource(file), null, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* FilePart Constructor. |
|
||||||
* |
|
||||||
* @param name the name of the file part |
|
||||||
* @param file the file to post |
|
||||||
* @param contentType the content type for this part, if <code>null</code> the |
|
||||||
* {@link #DEFAULT_CONTENT_TYPE default} is used |
|
||||||
* @param charset the charset encoding for this part, if <code>null</code> the |
|
||||||
* {@link #DEFAULT_CHARSET default} is used |
|
||||||
* |
|
||||||
* @throws FileNotFoundException if the <i>file</i> is not a normal |
|
||||||
* file or if it is not readable. |
|
||||||
*/ |
|
||||||
public FilePart(String name, File file, String contentType, String charset) |
|
||||||
throws FileNotFoundException { |
|
||||||
this(name, new FilePartSource(file), contentType, charset); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* FilePart Constructor. |
|
||||||
* |
|
||||||
* @param name the name of the file part |
|
||||||
* @param fileName the file name |
|
||||||
* @param file the file to post |
|
||||||
* |
|
||||||
* @throws FileNotFoundException if the <i>file</i> is not a normal |
|
||||||
* file or if it is not readable. |
|
||||||
*/ |
|
||||||
public FilePart(String name, String fileName, File file) |
|
||||||
throws FileNotFoundException { |
|
||||||
this(name, new FilePartSource(fileName, file), null, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* FilePart Constructor. |
|
||||||
* |
|
||||||
* @param name the name of the file part |
|
||||||
* @param fileName the file name |
|
||||||
* @param file the file to post |
|
||||||
* @param contentType the content type for this part, if <code>null</code> the |
|
||||||
* {@link #DEFAULT_CONTENT_TYPE default} is used |
|
||||||
* @param charset the charset encoding for this part, if <code>null</code> the |
|
||||||
* {@link #DEFAULT_CHARSET default} is used |
|
||||||
* |
|
||||||
* @throws FileNotFoundException if the <i>file</i> is not a normal |
|
||||||
* file or if it is not readable. |
|
||||||
*/ |
|
||||||
public FilePart(String name, String fileName, File file, String contentType, String charset) |
|
||||||
throws FileNotFoundException { |
|
||||||
this(name, new FilePartSource(fileName, file), contentType, charset); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write the disposition header to the output stream |
|
||||||
* @param out The output stream |
|
||||||
* @throws IOException If an IO problem occurs |
|
||||||
* @see Part#sendDispositionHeader(OutputStream) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
protected void sendDispositionHeader(OutputStream out) |
|
||||||
throws IOException { |
|
||||||
super.sendDispositionHeader(out); |
|
||||||
String filename = this.source.getFileName(); |
|
||||||
if (filename != null) { |
|
||||||
out.write(FILE_NAME_BYTES); |
|
||||||
out.write(QUOTE_BYTES); |
|
||||||
out.write(EncodingUtils.getAsciiBytes(filename)); |
|
||||||
out.write(QUOTE_BYTES); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write the data in "source" to the specified stream. |
|
||||||
* @param out The output stream. |
|
||||||
* @throws IOException if an IO problem occurs. |
|
||||||
* @see Part#sendData(OutputStream) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
protected void sendData(OutputStream out) throws IOException { |
|
||||||
if (lengthOfData() == 0) { |
|
||||||
|
|
||||||
// this file contains no data, so there is nothing to send.
|
|
||||||
// we don't want to create a zero length buffer as this will
|
|
||||||
// cause an infinite loop when reading.
|
|
||||||
return; |
|
||||||
} |
|
||||||
|
|
||||||
byte[] tmp = new byte[4096]; |
|
||||||
InputStream instream = source.createInputStream(); |
|
||||||
try { |
|
||||||
int len; |
|
||||||
while ((len = instream.read(tmp)) >= 0) { |
|
||||||
out.write(tmp, 0, len); |
|
||||||
} |
|
||||||
} finally { |
|
||||||
// we're done with the stream, close it
|
|
||||||
instream.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the source of the file part. |
|
||||||
* |
|
||||||
* @return The source. |
|
||||||
*/ |
|
||||||
protected PartSource getSource() { |
|
||||||
return this.source; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the length of the data. |
|
||||||
* @return The length. |
|
||||||
* @see Part#lengthOfData() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
protected long lengthOfData() { |
|
||||||
return source.getLength(); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
@ -1,131 +0,0 @@ |
|||||||
/* |
|
||||||
* $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//httpclient/src/java/org/apache/commons/httpclient/methods/multipart/FilePartSource.java,v 1.10 2004/04/18 23:51:37 jsdever Exp $
|
|
||||||
* $Revision: 480424 $ |
|
||||||
* $Date: 2006-11-29 06:56:49 +0100 (Wed, 29 Nov 2006) $ |
|
||||||
* |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* Licensed to the Apache Software Foundation (ASF) under one or more |
|
||||||
* contributor license agreements. See the NOTICE file distributed with |
|
||||||
* this work for additional information regarding copyright ownership. |
|
||||||
* The ASF licenses this file to You under the Apache License, Version 2.0 |
|
||||||
* (the "License"); you may not use this file except in compliance with |
|
||||||
* the License. You may obtain a copy of the License at |
|
||||||
* |
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
* |
|
||||||
* Unless required by applicable law or agreed to in writing, software |
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS, |
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
||||||
* See the License for the specific language governing permissions and |
|
||||||
* limitations under the License. |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* This software consists of voluntary contributions made by many |
|
||||||
* individuals on behalf of the Apache Software Foundation. For more |
|
||||||
* information on the Apache Software Foundation, please see |
|
||||||
* <http://www.apache.org/>.
|
|
||||||
* |
|
||||||
*/ |
|
||||||
|
|
||||||
package com.android.internalcopy.http.multipart; |
|
||||||
|
|
||||||
import java.io.ByteArrayInputStream; |
|
||||||
import java.io.File; |
|
||||||
import java.io.FileInputStream; |
|
||||||
import java.io.FileNotFoundException; |
|
||||||
import java.io.IOException; |
|
||||||
import java.io.InputStream; |
|
||||||
|
|
||||||
/** |
|
||||||
* A PartSource that reads from a File. |
|
||||||
* |
|
||||||
* @author <a href="mailto:becke@u.washington.edu">Michael Becke</a> |
|
||||||
* @author <a href="mailto:mdiggory@latte.harvard.edu">Mark Diggory</a> |
|
||||||
* @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a> |
|
||||||
* |
|
||||||
* @since 2.0 |
|
||||||
*/ |
|
||||||
public class FilePartSource implements PartSource { |
|
||||||
|
|
||||||
/** File part file. */ |
|
||||||
private File file = null; |
|
||||||
|
|
||||||
/** File part file name. */ |
|
||||||
private String fileName = null; |
|
||||||
|
|
||||||
/** |
|
||||||
* Constructor for FilePartSource. |
|
||||||
* |
|
||||||
* @param file the FilePart source File. |
|
||||||
* |
|
||||||
* @throws FileNotFoundException if the file does not exist or |
|
||||||
* cannot be read |
|
||||||
*/ |
|
||||||
public FilePartSource(File file) throws FileNotFoundException { |
|
||||||
this.file = file; |
|
||||||
if (file != null) { |
|
||||||
if (!file.isFile()) { |
|
||||||
throw new FileNotFoundException("File is not a normal file."); |
|
||||||
} |
|
||||||
if (!file.canRead()) { |
|
||||||
throw new FileNotFoundException("File is not readable."); |
|
||||||
} |
|
||||||
this.fileName = file.getName(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Constructor for FilePartSource. |
|
||||||
* |
|
||||||
* @param fileName the file name of the FilePart |
|
||||||
* @param file the source File for the FilePart |
|
||||||
* |
|
||||||
* @throws FileNotFoundException if the file does not exist or |
|
||||||
* cannot be read |
|
||||||
*/ |
|
||||||
public FilePartSource(String fileName, File file) |
|
||||||
throws FileNotFoundException { |
|
||||||
this(file); |
|
||||||
if (fileName != null) { |
|
||||||
this.fileName = fileName; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the length of the file |
|
||||||
* @return the length of the file. |
|
||||||
* @see PartSource#getLength() |
|
||||||
*/ |
|
||||||
public long getLength() { |
|
||||||
if (this.file != null) { |
|
||||||
return this.file.length(); |
|
||||||
} else { |
|
||||||
return 0; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the current filename |
|
||||||
* @return the filename. |
|
||||||
* @see PartSource#getFileName() |
|
||||||
*/ |
|
||||||
public String getFileName() { |
|
||||||
return (fileName == null) ? "noname" : fileName; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Return a new {@link FileInputStream} for the current filename. |
|
||||||
* @return the new input stream. |
|
||||||
* @throws IOException If an IO problem occurs. |
|
||||||
* @see PartSource#createInputStream() |
|
||||||
*/ |
|
||||||
public InputStream createInputStream() throws IOException { |
|
||||||
if (this.file != null) { |
|
||||||
return new FileInputStream(this.file); |
|
||||||
} else { |
|
||||||
return new ByteArrayInputStream(new byte[] {}); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
@ -1,225 +0,0 @@ |
|||||||
/* |
|
||||||
* $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//httpclient/src/java/org/apache/commons/httpclient/methods/multipart/MultipartRequestEntity.java,v 1.1 2004/10/06 03:39:59 mbecke Exp $
|
|
||||||
* $Revision: 502647 $ |
|
||||||
* $Date: 2007-02-02 17:22:54 +0100 (Fri, 02 Feb 2007) $ |
|
||||||
* |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* Licensed to the Apache Software Foundation (ASF) under one or more |
|
||||||
* contributor license agreements. See the NOTICE file distributed with |
|
||||||
* this work for additional information regarding copyright ownership. |
|
||||||
* The ASF licenses this file to You under the Apache License, Version 2.0 |
|
||||||
* (the "License"); you may not use this file except in compliance with |
|
||||||
* the License. You may obtain a copy of the License at |
|
||||||
* |
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
* |
|
||||||
* Unless required by applicable law or agreed to in writing, software |
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS, |
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
||||||
* See the License for the specific language governing permissions and |
|
||||||
* limitations under the License. |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* This software consists of voluntary contributions made by many |
|
||||||
* individuals on behalf of the Apache Software Foundation. For more |
|
||||||
* information on the Apache Software Foundation, please see |
|
||||||
* <http://www.apache.org/>.
|
|
||||||
* |
|
||||||
*/ |
|
||||||
|
|
||||||
package com.android.internalcopy.http.multipart; |
|
||||||
|
|
||||||
import java.io.ByteArrayInputStream; |
|
||||||
import java.io.ByteArrayOutputStream; |
|
||||||
import java.io.IOException; |
|
||||||
import java.io.InputStream; |
|
||||||
import java.io.OutputStream; |
|
||||||
import java.util.Random; |
|
||||||
|
|
||||||
import org.apache.http.Header; |
|
||||||
import org.apache.http.entity.AbstractHttpEntity; |
|
||||||
import org.apache.http.message.BasicHeader; |
|
||||||
import org.apache.http.params.HttpParams; |
|
||||||
import org.apache.http.protocol.HTTP; |
|
||||||
import org.apache.http.util.EncodingUtils; |
|
||||||
|
|
||||||
/** |
|
||||||
* Implements a request entity suitable for an HTTP multipart POST method. |
|
||||||
* <p> |
|
||||||
* The HTTP multipart POST method is defined in section 3.3 of |
|
||||||
* <a href="http://www.ietf.org/rfc/rfc1867.txt">RFC1867</a>: |
|
||||||
* <blockquote> |
|
||||||
* The media-type multipart/form-data follows the rules of all multipart |
|
||||||
* MIME data streams as outlined in RFC 1521. The multipart/form-data contains |
|
||||||
* a series of parts. Each part is expected to contain a content-disposition |
|
||||||
* header where the value is "form-data" and a name attribute specifies |
|
||||||
* the field name within the form, e.g., 'content-disposition: form-data; |
|
||||||
* name="xxxxx"', where xxxxx is the field name corresponding to that field. |
|
||||||
* Field names originally in non-ASCII character sets may be encoded using |
|
||||||
* the method outlined in RFC 1522. |
|
||||||
* </blockquote> |
|
||||||
* </p> |
|
||||||
* <p>This entity is designed to be used in conjunction with the |
|
||||||
* {@link org.apache.http.HttpRequest} to provide |
|
||||||
* multipart posts. Example usage:</p> |
|
||||||
* <pre> |
|
||||||
* File f = new File("/path/fileToUpload.txt"); |
|
||||||
* HttpRequest request = new HttpRequest("http://host/some_path"); |
|
||||||
* Part[] parts = { |
|
||||||
* new StringPart("param_name", "value"), |
|
||||||
* new FilePart(f.getName(), f) |
|
||||||
* }; |
|
||||||
* filePost.setEntity( |
|
||||||
* new MultipartRequestEntity(parts, filePost.getParams()) |
|
||||||
* ); |
|
||||||
* HttpClient client = new HttpClient(); |
|
||||||
* int status = client.executeMethod(filePost); |
|
||||||
* </pre> |
|
||||||
* |
|
||||||
* @since 3.0 |
|
||||||
*/ |
|
||||||
public class MultipartEntity extends AbstractHttpEntity { |
|
||||||
|
|
||||||
/** The Content-Type for multipart/form-data. */ |
|
||||||
private static final String MULTIPART_FORM_CONTENT_TYPE = "multipart/form-data"; |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the value to use as the multipart boundary. |
|
||||||
* <p> |
|
||||||
* This parameter expects a value if type {@link String}. |
|
||||||
* </p> |
|
||||||
*/ |
|
||||||
public static final String MULTIPART_BOUNDARY = "http.method.multipart.boundary"; |
|
||||||
|
|
||||||
/** |
|
||||||
* The pool of ASCII chars to be used for generating a multipart boundary. |
|
||||||
*/ |
|
||||||
private static byte[] MULTIPART_CHARS = EncodingUtils.getAsciiBytes( |
|
||||||
"-_1234567890abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"); |
|
||||||
|
|
||||||
/** |
|
||||||
* Generates a random multipart boundary string. |
|
||||||
*/ |
|
||||||
private static byte[] generateMultipartBoundary() { |
|
||||||
Random rand = new Random(); |
|
||||||
byte[] bytes = new byte[rand.nextInt(11) + 30]; // a random size from 30 to 40
|
|
||||||
for (int i = 0; i < bytes.length; i++) { |
|
||||||
bytes[i] = MULTIPART_CHARS[rand.nextInt(MULTIPART_CHARS.length)]; |
|
||||||
} |
|
||||||
return bytes; |
|
||||||
} |
|
||||||
|
|
||||||
/** The MIME parts as set by the constructor */ |
|
||||||
protected Part[] parts; |
|
||||||
|
|
||||||
private byte[] multipartBoundary; |
|
||||||
|
|
||||||
private HttpParams params; |
|
||||||
|
|
||||||
private boolean contentConsumed = false; |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a new multipart entity containing the given parts. |
|
||||||
* @param parts The parts to include. |
|
||||||
* @param params The params of the HttpMethod using this entity. |
|
||||||
*/ |
|
||||||
public MultipartEntity(Part[] parts, HttpParams params) { |
|
||||||
if (parts == null) { |
|
||||||
throw new IllegalArgumentException("parts cannot be null"); |
|
||||||
} |
|
||||||
if (params == null) { |
|
||||||
throw new IllegalArgumentException("params cannot be null"); |
|
||||||
} |
|
||||||
this.parts = parts; |
|
||||||
this.params = params; |
|
||||||
} |
|
||||||
|
|
||||||
public MultipartEntity(Part[] parts) { |
|
||||||
setContentType(MULTIPART_FORM_CONTENT_TYPE); |
|
||||||
if (parts == null) { |
|
||||||
throw new IllegalArgumentException("parts cannot be null"); |
|
||||||
} |
|
||||||
this.parts = parts; |
|
||||||
this.params = null; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the MIME boundary string that is used to demarcate boundaries of |
|
||||||
* this part. The first call to this method will implicitly create a new |
|
||||||
* boundary string. To create a boundary string first the |
|
||||||
* HttpMethodParams.MULTIPART_BOUNDARY parameter is considered. Otherwise |
|
||||||
* a random one is generated. |
|
||||||
* |
|
||||||
* @return The boundary string of this entity in ASCII encoding. |
|
||||||
*/ |
|
||||||
protected byte[] getMultipartBoundary() { |
|
||||||
if (multipartBoundary == null) { |
|
||||||
String temp = null; |
|
||||||
if (params != null) { |
|
||||||
temp = (String) params.getParameter(MULTIPART_BOUNDARY); |
|
||||||
} |
|
||||||
if (temp != null) { |
|
||||||
multipartBoundary = EncodingUtils.getAsciiBytes(temp); |
|
||||||
} else { |
|
||||||
multipartBoundary = generateMultipartBoundary(); |
|
||||||
} |
|
||||||
} |
|
||||||
return multipartBoundary; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns <code>true</code> if all parts are repeatable, <code>false</code> otherwise. |
|
||||||
*/ |
|
||||||
public boolean isRepeatable() { |
|
||||||
for (int i = 0; i < parts.length; i++) { |
|
||||||
if (!parts[i].isRepeatable()) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
/* (non-Javadoc) |
|
||||||
*/ |
|
||||||
public void writeTo(OutputStream out) throws IOException { |
|
||||||
Part.sendParts(out, parts, getMultipartBoundary()); |
|
||||||
} |
|
||||||
/* (non-Javadoc) |
|
||||||
* @see org.apache.commons.http.AbstractHttpEntity.#getContentType() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public Header getContentType() { |
|
||||||
StringBuffer buffer = new StringBuffer(MULTIPART_FORM_CONTENT_TYPE); |
|
||||||
buffer.append("; boundary="); |
|
||||||
buffer.append(EncodingUtils.getAsciiString(getMultipartBoundary())); |
|
||||||
return new BasicHeader(HTTP.CONTENT_TYPE, buffer.toString()); |
|
||||||
|
|
||||||
} |
|
||||||
|
|
||||||
/* (non-Javadoc) |
|
||||||
*/ |
|
||||||
public long getContentLength() { |
|
||||||
try { |
|
||||||
return Part.getLengthOfParts(parts, getMultipartBoundary()); |
|
||||||
} catch (Exception e) { |
|
||||||
return 0; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
public InputStream getContent() throws IOException, IllegalStateException { |
|
||||||
if(!isRepeatable() && this.contentConsumed ) { |
|
||||||
throw new IllegalStateException("Content has been consumed"); |
|
||||||
} |
|
||||||
this.contentConsumed = true; |
|
||||||
|
|
||||||
ByteArrayOutputStream baos = new ByteArrayOutputStream(); |
|
||||||
Part.sendParts(baos, this.parts, this.multipartBoundary); |
|
||||||
ByteArrayInputStream bais = new ByteArrayInputStream(baos.toByteArray()); |
|
||||||
return bais; |
|
||||||
} |
|
||||||
|
|
||||||
public boolean isStreaming() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
@ -1,425 +0,0 @@ |
|||||||
/* |
|
||||||
* $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//httpclient/src/java/org/apache/commons/httpclient/methods/multipart/Part.java,v 1.16 2005/01/14 21:16:40 olegk Exp $
|
|
||||||
* $Revision: 480424 $ |
|
||||||
* $Date: 2006-11-29 06:56:49 +0100 (Wed, 29 Nov 2006) $ |
|
||||||
* |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* Licensed to the Apache Software Foundation (ASF) under one or more |
|
||||||
* contributor license agreements. See the NOTICE file distributed with |
|
||||||
* this work for additional information regarding copyright ownership. |
|
||||||
* The ASF licenses this file to You under the Apache License, Version 2.0 |
|
||||||
* (the "License"); you may not use this file except in compliance with |
|
||||||
* the License. You may obtain a copy of the License at |
|
||||||
* |
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
* |
|
||||||
* Unless required by applicable law or agreed to in writing, software |
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS, |
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
||||||
* See the License for the specific language governing permissions and |
|
||||||
* limitations under the License. |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* This software consists of voluntary contributions made by many |
|
||||||
* individuals on behalf of the Apache Software Foundation. For more |
|
||||||
* information on the Apache Software Foundation, please see |
|
||||||
* <http://www.apache.org/>.
|
|
||||||
* |
|
||||||
*/ |
|
||||||
|
|
||||||
package com.android.internalcopy.http.multipart; |
|
||||||
|
|
||||||
import java.io.ByteArrayOutputStream; |
|
||||||
import java.io.IOException; |
|
||||||
import java.io.OutputStream; |
|
||||||
|
|
||||||
import org.apache.http.util.EncodingUtils; |
|
||||||
|
|
||||||
/** |
|
||||||
* Abstract class for one Part of a multipart post object. |
|
||||||
* |
|
||||||
* @author <a href="mailto:mattalbright@yahoo.com">Matthew Albright</a> |
|
||||||
* @author <a href="mailto:jsdever@apache.org">Jeff Dever</a> |
|
||||||
* @author <a href="mailto:adrian@ephox.com">Adrian Sutton</a> |
|
||||||
* @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a> |
|
||||||
* @author <a href="mailto:oleg@ural.ru">Oleg Kalnichevski</a> |
|
||||||
* |
|
||||||
* @since 2.0 |
|
||||||
*/ |
|
||||||
public abstract class Part { |
|
||||||
|
|
||||||
/** |
|
||||||
* The boundary |
|
||||||
* @deprecated use {@link org.apache.http.client.methods.multipart#MULTIPART_BOUNDARY} |
|
||||||
*/ |
|
||||||
protected static final String BOUNDARY = "----------------314159265358979323846"; |
|
||||||
|
|
||||||
/** |
|
||||||
* The boundary as a byte array. |
|
||||||
* @deprecated |
|
||||||
*/ |
|
||||||
protected static final byte[] BOUNDARY_BYTES = EncodingUtils.getAsciiBytes(BOUNDARY); |
|
||||||
|
|
||||||
/** |
|
||||||
* The default boundary to be used if {@link #setPartBoundary(byte[])} has not |
|
||||||
* been called. |
|
||||||
*/ |
|
||||||
private static final byte[] DEFAULT_BOUNDARY_BYTES = BOUNDARY_BYTES; |
|
||||||
|
|
||||||
/** Carriage return/linefeed */ |
|
||||||
protected static final String CRLF = "\r\n"; |
|
||||||
|
|
||||||
/** Carriage return/linefeed as a byte array */ |
|
||||||
protected static final byte[] CRLF_BYTES = EncodingUtils.getAsciiBytes(CRLF); |
|
||||||
|
|
||||||
/** Content dispostion characters */ |
|
||||||
protected static final String QUOTE = "\""; |
|
||||||
|
|
||||||
/** Content dispostion as a byte array */ |
|
||||||
protected static final byte[] QUOTE_BYTES = |
|
||||||
EncodingUtils.getAsciiBytes(QUOTE); |
|
||||||
|
|
||||||
/** Extra characters */ |
|
||||||
protected static final String EXTRA = "--"; |
|
||||||
|
|
||||||
/** Extra characters as a byte array */ |
|
||||||
protected static final byte[] EXTRA_BYTES = |
|
||||||
EncodingUtils.getAsciiBytes(EXTRA); |
|
||||||
|
|
||||||
/** Content dispostion characters */ |
|
||||||
protected static final String CONTENT_DISPOSITION = "Content-Disposition: form-data; name="; |
|
||||||
|
|
||||||
/** Content dispostion as a byte array */ |
|
||||||
protected static final byte[] CONTENT_DISPOSITION_BYTES = |
|
||||||
EncodingUtils.getAsciiBytes(CONTENT_DISPOSITION); |
|
||||||
|
|
||||||
/** Content type header */ |
|
||||||
protected static final String CONTENT_TYPE = "Content-Type: "; |
|
||||||
|
|
||||||
/** Content type header as a byte array */ |
|
||||||
protected static final byte[] CONTENT_TYPE_BYTES = |
|
||||||
EncodingUtils.getAsciiBytes(CONTENT_TYPE); |
|
||||||
|
|
||||||
/** Content charset */ |
|
||||||
protected static final String CHARSET = "; charset="; |
|
||||||
|
|
||||||
/** Content charset as a byte array */ |
|
||||||
protected static final byte[] CHARSET_BYTES = |
|
||||||
EncodingUtils.getAsciiBytes(CHARSET); |
|
||||||
|
|
||||||
/** Content type header */ |
|
||||||
protected static final String CONTENT_TRANSFER_ENCODING = "Content-Transfer-Encoding: "; |
|
||||||
|
|
||||||
/** Content type header as a byte array */ |
|
||||||
protected static final byte[] CONTENT_TRANSFER_ENCODING_BYTES = |
|
||||||
EncodingUtils.getAsciiBytes(CONTENT_TRANSFER_ENCODING); |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the boundary string. |
|
||||||
* @return the boundary string |
|
||||||
* @deprecated uses a constant string. Rather use {@link #getPartBoundary} |
|
||||||
*/ |
|
||||||
public static String getBoundary() { |
|
||||||
return BOUNDARY; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* The ASCII bytes to use as the multipart boundary. |
|
||||||
*/ |
|
||||||
private byte[] boundaryBytes; |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the name of this part. |
|
||||||
* @return The name. |
|
||||||
*/ |
|
||||||
public abstract String getName(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the content type of this part. |
|
||||||
* @return the content type, or <code>null</code> to exclude the content type header |
|
||||||
*/ |
|
||||||
public abstract String getContentType(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the character encoding of this part. |
|
||||||
* @return the character encoding, or <code>null</code> to exclude the character |
|
||||||
* encoding header |
|
||||||
*/ |
|
||||||
public abstract String getCharSet(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the transfer encoding of this part. |
|
||||||
* @return the transfer encoding, or <code>null</code> to exclude the transfer encoding header |
|
||||||
*/ |
|
||||||
public abstract String getTransferEncoding(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets the part boundary to be used. |
|
||||||
* @return the part boundary as an array of bytes. |
|
||||||
* |
|
||||||
* @since 3.0 |
|
||||||
*/ |
|
||||||
protected byte[] getPartBoundary() { |
|
||||||
if (boundaryBytes == null) { |
|
||||||
// custom boundary bytes have not been set, use the default.
|
|
||||||
return DEFAULT_BOUNDARY_BYTES; |
|
||||||
} else { |
|
||||||
return boundaryBytes; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the part boundary. Only meant to be used by |
|
||||||
* {@link Part#sendParts(OutputStream, Part[], byte[])} |
|
||||||
* and {@link Part#getLengthOfParts(Part[], byte[])} |
|
||||||
* @param boundaryBytes An array of ASCII bytes. |
|
||||||
* @since 3.0 |
|
||||||
*/ |
|
||||||
void setPartBoundary(byte[] boundaryBytes) { |
|
||||||
this.boundaryBytes = boundaryBytes; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Tests if this part can be sent more than once. |
|
||||||
* @return <code>true</code> if {@link #sendData(OutputStream)} can be successfully called |
|
||||||
* more than once. |
|
||||||
* @since 3.0 |
|
||||||
*/ |
|
||||||
public boolean isRepeatable() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write the start to the specified output stream |
|
||||||
* @param out The output stream |
|
||||||
* @throws IOException If an IO problem occurs. |
|
||||||
*/ |
|
||||||
protected void sendStart(OutputStream out) throws IOException { |
|
||||||
out.write(EXTRA_BYTES); |
|
||||||
out.write(getPartBoundary()); |
|
||||||
out.write(CRLF_BYTES); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write the content disposition header to the specified output stream |
|
||||||
* |
|
||||||
* @param out The output stream |
|
||||||
* @throws IOException If an IO problem occurs. |
|
||||||
*/ |
|
||||||
protected void sendDispositionHeader(OutputStream out) throws IOException { |
|
||||||
out.write(CONTENT_DISPOSITION_BYTES); |
|
||||||
out.write(QUOTE_BYTES); |
|
||||||
out.write(EncodingUtils.getAsciiBytes(getName())); |
|
||||||
out.write(QUOTE_BYTES); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write the content type header to the specified output stream |
|
||||||
* @param out The output stream |
|
||||||
* @throws IOException If an IO problem occurs. |
|
||||||
*/ |
|
||||||
protected void sendContentTypeHeader(OutputStream out) throws IOException { |
|
||||||
String contentType = getContentType(); |
|
||||||
if (contentType != null) { |
|
||||||
out.write(CRLF_BYTES); |
|
||||||
out.write(CONTENT_TYPE_BYTES); |
|
||||||
out.write(EncodingUtils.getAsciiBytes(contentType)); |
|
||||||
String charSet = getCharSet(); |
|
||||||
if (charSet != null) { |
|
||||||
out.write(CHARSET_BYTES); |
|
||||||
out.write(EncodingUtils.getAsciiBytes(charSet)); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write the content transfer encoding header to the specified |
|
||||||
* output stream |
|
||||||
* |
|
||||||
* @param out The output stream |
|
||||||
* @throws IOException If an IO problem occurs. |
|
||||||
*/ |
|
||||||
protected void sendTransferEncodingHeader(OutputStream out) throws IOException { |
|
||||||
String transferEncoding = getTransferEncoding(); |
|
||||||
if (transferEncoding != null) { |
|
||||||
out.write(CRLF_BYTES); |
|
||||||
out.write(CONTENT_TRANSFER_ENCODING_BYTES); |
|
||||||
out.write(EncodingUtils.getAsciiBytes(transferEncoding)); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write the end of the header to the output stream |
|
||||||
* @param out The output stream |
|
||||||
* @throws IOException If an IO problem occurs. |
|
||||||
*/ |
|
||||||
protected void sendEndOfHeader(OutputStream out) throws IOException { |
|
||||||
out.write(CRLF_BYTES); |
|
||||||
out.write(CRLF_BYTES); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write the data to the specified output stream |
|
||||||
* @param out The output stream |
|
||||||
* @throws IOException If an IO problem occurs. |
|
||||||
*/ |
|
||||||
protected abstract void sendData(OutputStream out) throws IOException; |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the length of the main content |
|
||||||
* |
|
||||||
* @return long The length. |
|
||||||
* @throws IOException If an IO problem occurs |
|
||||||
*/ |
|
||||||
protected abstract long lengthOfData() throws IOException; |
|
||||||
|
|
||||||
/** |
|
||||||
* Write the end data to the output stream. |
|
||||||
* @param out The output stream |
|
||||||
* @throws IOException If an IO problem occurs. |
|
||||||
*/ |
|
||||||
protected void sendEnd(OutputStream out) throws IOException { |
|
||||||
out.write(CRLF_BYTES); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write all the data to the output stream. |
|
||||||
* If you override this method make sure to override |
|
||||||
* #length() as well |
|
||||||
* |
|
||||||
* @param out The output stream |
|
||||||
* @throws IOException If an IO problem occurs. |
|
||||||
*/ |
|
||||||
public void send(OutputStream out) throws IOException { |
|
||||||
sendStart(out); |
|
||||||
sendDispositionHeader(out); |
|
||||||
sendContentTypeHeader(out); |
|
||||||
sendTransferEncodingHeader(out); |
|
||||||
sendEndOfHeader(out); |
|
||||||
sendData(out); |
|
||||||
sendEnd(out); |
|
||||||
} |
|
||||||
|
|
||||||
|
|
||||||
/** |
|
||||||
* Return the full length of all the data. |
|
||||||
* If you override this method make sure to override |
|
||||||
* #send(OutputStream) as well |
|
||||||
* |
|
||||||
* @return long The length. |
|
||||||
* @throws IOException If an IO problem occurs |
|
||||||
*/ |
|
||||||
public long length() throws IOException { |
|
||||||
if (lengthOfData() < 0) { |
|
||||||
return -1; |
|
||||||
} |
|
||||||
ByteArrayOutputStream overhead = new ByteArrayOutputStream(); |
|
||||||
sendStart(overhead); |
|
||||||
sendDispositionHeader(overhead); |
|
||||||
sendContentTypeHeader(overhead); |
|
||||||
sendTransferEncodingHeader(overhead); |
|
||||||
sendEndOfHeader(overhead); |
|
||||||
sendEnd(overhead); |
|
||||||
return overhead.size() + lengthOfData(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Return a string representation of this object. |
|
||||||
* @return A string representation of this object. |
|
||||||
* @see java.lang.Object#toString() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
return this.getName(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write all parts and the last boundary to the specified output stream. |
|
||||||
* |
|
||||||
* @param out The stream to write to. |
|
||||||
* @param parts The parts to write. |
|
||||||
* |
|
||||||
* @throws IOException If an I/O error occurs while writing the parts. |
|
||||||
*/ |
|
||||||
public static void sendParts(OutputStream out, final Part[] parts) |
|
||||||
throws IOException { |
|
||||||
sendParts(out, parts, DEFAULT_BOUNDARY_BYTES); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Write all parts and the last boundary to the specified output stream. |
|
||||||
* |
|
||||||
* @param out The stream to write to. |
|
||||||
* @param parts The parts to write. |
|
||||||
* @param partBoundary The ASCII bytes to use as the part boundary. |
|
||||||
* |
|
||||||
* @throws IOException If an I/O error occurs while writing the parts. |
|
||||||
* |
|
||||||
* @since 3.0 |
|
||||||
*/ |
|
||||||
public static void sendParts(OutputStream out, Part[] parts, byte[] partBoundary) |
|
||||||
throws IOException { |
|
||||||
|
|
||||||
if (parts == null) { |
|
||||||
throw new IllegalArgumentException("Parts may not be null"); |
|
||||||
} |
|
||||||
if (partBoundary == null || partBoundary.length == 0) { |
|
||||||
throw new IllegalArgumentException("partBoundary may not be empty"); |
|
||||||
} |
|
||||||
for (int i = 0; i < parts.length; i++) { |
|
||||||
// set the part boundary before the part is sent
|
|
||||||
parts[i].setPartBoundary(partBoundary); |
|
||||||
parts[i].send(out); |
|
||||||
} |
|
||||||
out.write(EXTRA_BYTES); |
|
||||||
out.write(partBoundary); |
|
||||||
out.write(EXTRA_BYTES); |
|
||||||
out.write(CRLF_BYTES); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the total sum of all parts and that of the last boundary |
|
||||||
* |
|
||||||
* @param parts The parts. |
|
||||||
* @return The total length |
|
||||||
* |
|
||||||
* @throws IOException If an I/O error occurs while writing the parts. |
|
||||||
*/ |
|
||||||
public static long getLengthOfParts(Part[] parts) |
|
||||||
throws IOException { |
|
||||||
return getLengthOfParts(parts, DEFAULT_BOUNDARY_BYTES); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets the length of the multipart message including the given parts. |
|
||||||
* |
|
||||||
* @param parts The parts. |
|
||||||
* @param partBoundary The ASCII bytes to use as the part boundary. |
|
||||||
* @return The total length |
|
||||||
* |
|
||||||
* @throws IOException If an I/O error occurs while writing the parts. |
|
||||||
* |
|
||||||
* @since 3.0 |
|
||||||
*/ |
|
||||||
public static long getLengthOfParts(Part[] parts, byte[] partBoundary) throws IOException { |
|
||||||
if (parts == null) { |
|
||||||
throw new IllegalArgumentException("Parts may not be null"); |
|
||||||
} |
|
||||||
long total = 0; |
|
||||||
for (int i = 0; i < parts.length; i++) { |
|
||||||
// set the part boundary before we calculate the part's length
|
|
||||||
parts[i].setPartBoundary(partBoundary); |
|
||||||
long l = parts[i].length(); |
|
||||||
if (l < 0) { |
|
||||||
return -1; |
|
||||||
} |
|
||||||
total += l; |
|
||||||
} |
|
||||||
total += EXTRA_BYTES.length; |
|
||||||
total += partBoundary.length; |
|
||||||
total += EXTRA_BYTES.length; |
|
||||||
total += CRLF_BYTES.length; |
|
||||||
return total; |
|
||||||
} |
|
||||||
} |
|
@ -1,150 +0,0 @@ |
|||||||
/* |
|
||||||
* $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//httpclient/src/java/org/apache/commons/httpclient/methods/multipart/PartBase.java,v 1.5 2004/04/18 23:51:37 jsdever Exp $
|
|
||||||
* $Revision: 480424 $ |
|
||||||
* $Date: 2006-11-29 06:56:49 +0100 (Wed, 29 Nov 2006) $ |
|
||||||
* |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* Licensed to the Apache Software Foundation (ASF) under one or more |
|
||||||
* contributor license agreements. See the NOTICE file distributed with |
|
||||||
* this work for additional information regarding copyright ownership. |
|
||||||
* The ASF licenses this file to You under the Apache License, Version 2.0 |
|
||||||
* (the "License"); you may not use this file except in compliance with |
|
||||||
* the License. You may obtain a copy of the License at |
|
||||||
* |
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
* |
|
||||||
* Unless required by applicable law or agreed to in writing, software |
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS, |
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
||||||
* See the License for the specific language governing permissions and |
|
||||||
* limitations under the License. |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* This software consists of voluntary contributions made by many |
|
||||||
* individuals on behalf of the Apache Software Foundation. For more |
|
||||||
* information on the Apache Software Foundation, please see |
|
||||||
* <http://www.apache.org/>.
|
|
||||||
* |
|
||||||
*/ |
|
||||||
|
|
||||||
package com.android.internalcopy.http.multipart; |
|
||||||
|
|
||||||
|
|
||||||
/** |
|
||||||
* Provides setters and getters for the basic Part properties. |
|
||||||
* |
|
||||||
* @author Michael Becke |
|
||||||
*/ |
|
||||||
public abstract class PartBase extends Part { |
|
||||||
|
|
||||||
/** Name of the file part. */ |
|
||||||
private String name; |
|
||||||
|
|
||||||
/** Content type of the file part. */ |
|
||||||
private String contentType; |
|
||||||
|
|
||||||
/** Content encoding of the file part. */ |
|
||||||
private String charSet; |
|
||||||
|
|
||||||
/** The transfer encoding. */ |
|
||||||
private String transferEncoding; |
|
||||||
|
|
||||||
/** |
|
||||||
* Constructor. |
|
||||||
* |
|
||||||
* @param name The name of the part |
|
||||||
* @param contentType The content type, or <code>null</code> |
|
||||||
* @param charSet The character encoding, or <code>null</code> |
|
||||||
* @param transferEncoding The transfer encoding, or <code>null</code> |
|
||||||
*/ |
|
||||||
public PartBase(String name, String contentType, String charSet, String transferEncoding) { |
|
||||||
|
|
||||||
if (name == null) { |
|
||||||
throw new IllegalArgumentException("Name must not be null"); |
|
||||||
} |
|
||||||
this.name = name; |
|
||||||
this.contentType = contentType; |
|
||||||
this.charSet = charSet; |
|
||||||
this.transferEncoding = transferEncoding; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the name. |
|
||||||
* @return The name. |
|
||||||
* @see Part#getName() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public String getName() { |
|
||||||
return this.name; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the content type of this part. |
|
||||||
* @return String The name. |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public String getContentType() { |
|
||||||
return this.contentType; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the character encoding of this part. |
|
||||||
* @return String The name. |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public String getCharSet() { |
|
||||||
return this.charSet; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the transfer encoding of this part. |
|
||||||
* @return String The name. |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public String getTransferEncoding() { |
|
||||||
return transferEncoding; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the character encoding. |
|
||||||
* |
|
||||||
* @param charSet the character encoding, or <code>null</code> to exclude the character |
|
||||||
* encoding header |
|
||||||
*/ |
|
||||||
public void setCharSet(String charSet) { |
|
||||||
this.charSet = charSet; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the content type. |
|
||||||
* |
|
||||||
* @param contentType the content type, or <code>null</code> to exclude the content type header |
|
||||||
*/ |
|
||||||
public void setContentType(String contentType) { |
|
||||||
this.contentType = contentType; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the part name. |
|
||||||
* |
|
||||||
* @param name |
|
||||||
*/ |
|
||||||
public void setName(String name) { |
|
||||||
if (name == null) { |
|
||||||
throw new IllegalArgumentException("Name must not be null"); |
|
||||||
} |
|
||||||
this.name = name; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the transfer encoding. |
|
||||||
* |
|
||||||
* @param transferEncoding the transfer encoding, or <code>null</code> to exclude the |
|
||||||
* transfer encoding header |
|
||||||
*/ |
|
||||||
public void setTransferEncoding(String transferEncoding) { |
|
||||||
this.transferEncoding = transferEncoding; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
@ -1,72 +0,0 @@ |
|||||||
/* |
|
||||||
* $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//httpclient/src/java/org/apache/commons/httpclient/methods/multipart/PartSource.java,v 1.6 2004/04/18 23:51:37 jsdever Exp $
|
|
||||||
* $Revision: 480424 $ |
|
||||||
* $Date: 2006-11-29 06:56:49 +0100 (Wed, 29 Nov 2006) $ |
|
||||||
* |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* Licensed to the Apache Software Foundation (ASF) under one or more |
|
||||||
* contributor license agreements. See the NOTICE file distributed with |
|
||||||
* this work for additional information regarding copyright ownership. |
|
||||||
* The ASF licenses this file to You under the Apache License, Version 2.0 |
|
||||||
* (the "License"); you may not use this file except in compliance with |
|
||||||
* the License. You may obtain a copy of the License at |
|
||||||
* |
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
* |
|
||||||
* Unless required by applicable law or agreed to in writing, software |
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS, |
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
||||||
* See the License for the specific language governing permissions and |
|
||||||
* limitations under the License. |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* This software consists of voluntary contributions made by many |
|
||||||
* individuals on behalf of the Apache Software Foundation. For more |
|
||||||
* information on the Apache Software Foundation, please see |
|
||||||
* <http://www.apache.org/>.
|
|
||||||
* |
|
||||||
*/ |
|
||||||
|
|
||||||
package com.android.internalcopy.http.multipart; |
|
||||||
|
|
||||||
import java.io.IOException; |
|
||||||
import java.io.InputStream; |
|
||||||
|
|
||||||
/** |
|
||||||
* An interface for providing access to data when posting MultiPart messages. |
|
||||||
* |
|
||||||
* @see FilePart |
|
||||||
* |
|
||||||
* @author <a href="mailto:becke@u.washington.edu">Michael Becke</a> |
|
||||||
* |
|
||||||
* @since 2.0 |
|
||||||
*/ |
|
||||||
public interface PartSource { |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets the number of bytes contained in this source. |
|
||||||
* |
|
||||||
* @return a value >= 0 |
|
||||||
*/ |
|
||||||
long getLength(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets the name of the file this source represents. |
|
||||||
* |
|
||||||
* @return the fileName used for posting a MultiPart file part |
|
||||||
*/ |
|
||||||
String getFileName(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets a new InputStream for reading this source. This method can be |
|
||||||
* called more than once and should therefore return a new stream every |
|
||||||
* time. |
|
||||||
* |
|
||||||
* @return a new InputStream |
|
||||||
* |
|
||||||
* @throws IOException if an error occurs when creating the InputStream |
|
||||||
*/ |
|
||||||
InputStream createInputStream() throws IOException; |
|
||||||
|
|
||||||
} |
|
@ -1,143 +0,0 @@ |
|||||||
/* |
|
||||||
* $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//httpclient/src/java/org/apache/commons/httpclient/methods/multipart/StringPart.java,v 1.11 2004/04/18 23:51:37 jsdever Exp $
|
|
||||||
* $Revision: 480424 $ |
|
||||||
* $Date: 2006-11-29 06:56:49 +0100 (Wed, 29 Nov 2006) $ |
|
||||||
* |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* Licensed to the Apache Software Foundation (ASF) under one or more |
|
||||||
* contributor license agreements. See the NOTICE file distributed with |
|
||||||
* this work for additional information regarding copyright ownership. |
|
||||||
* The ASF licenses this file to You under the Apache License, Version 2.0 |
|
||||||
* (the "License"); you may not use this file except in compliance with |
|
||||||
* the License. You may obtain a copy of the License at |
|
||||||
* |
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
* |
|
||||||
* Unless required by applicable law or agreed to in writing, software |
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS, |
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
||||||
* See the License for the specific language governing permissions and |
|
||||||
* limitations under the License. |
|
||||||
* ==================================================================== |
|
||||||
* |
|
||||||
* This software consists of voluntary contributions made by many |
|
||||||
* individuals on behalf of the Apache Software Foundation. For more |
|
||||||
* information on the Apache Software Foundation, please see |
|
||||||
* <http://www.apache.org/>.
|
|
||||||
* |
|
||||||
*/ |
|
||||||
|
|
||||||
package com.android.internalcopy.http.multipart; |
|
||||||
|
|
||||||
import java.io.OutputStream; |
|
||||||
import java.io.IOException; |
|
||||||
|
|
||||||
import org.apache.http.util.EncodingUtils; |
|
||||||
|
|
||||||
/** |
|
||||||
* Simple string parameter for a multipart post |
|
||||||
* |
|
||||||
* @author <a href="mailto:mattalbright@yahoo.com">Matthew Albright</a> |
|
||||||
* @author <a href="mailto:jsdever@apache.org">Jeff Dever</a> |
|
||||||
* @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a> |
|
||||||
* @author <a href="mailto:oleg@ural.ru">Oleg Kalnichevski</a> |
|
||||||
* |
|
||||||
* @since 2.0 |
|
||||||
*/ |
|
||||||
public class StringPart extends PartBase { |
|
||||||
|
|
||||||
/** Default content encoding of string parameters. */ |
|
||||||
public static final String DEFAULT_CONTENT_TYPE = "text/plain"; |
|
||||||
|
|
||||||
/** Default charset of string parameters*/ |
|
||||||
public static final String DEFAULT_CHARSET = "US-ASCII"; |
|
||||||
|
|
||||||
/** Default transfer encoding of string parameters*/ |
|
||||||
public static final String DEFAULT_TRANSFER_ENCODING = "8bit"; |
|
||||||
|
|
||||||
/** Contents of this StringPart. */ |
|
||||||
private byte[] content; |
|
||||||
|
|
||||||
/** The String value of this part. */ |
|
||||||
private String value; |
|
||||||
|
|
||||||
/** |
|
||||||
* Constructor. |
|
||||||
* |
|
||||||
* @param name The name of the part |
|
||||||
* @param value the string to post |
|
||||||
* @param charset the charset to be used to encode the string, if <code>null</code> |
|
||||||
* the {@link #DEFAULT_CHARSET default} is used |
|
||||||
*/ |
|
||||||
public StringPart(String name, String value, String charset) { |
|
||||||
|
|
||||||
super( |
|
||||||
name, |
|
||||||
DEFAULT_CONTENT_TYPE, |
|
||||||
charset == null ? DEFAULT_CHARSET : charset, |
|
||||||
DEFAULT_TRANSFER_ENCODING |
|
||||||
); |
|
||||||
if (value == null) { |
|
||||||
throw new IllegalArgumentException("Value may not be null"); |
|
||||||
} |
|
||||||
if (value.indexOf(0) != -1) { |
|
||||||
// See RFC 2048, 2.8. "8bit Data"
|
|
||||||
throw new IllegalArgumentException("NULs may not be present in string parts"); |
|
||||||
} |
|
||||||
this.value = value; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Constructor. |
|
||||||
* |
|
||||||
* @param name The name of the part |
|
||||||
* @param value the string to post |
|
||||||
*/ |
|
||||||
public StringPart(String name, String value) { |
|
||||||
this(name, value, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets the content in bytes. Bytes are lazily created to allow the charset to be changed |
|
||||||
* after the part is created. |
|
||||||
* |
|
||||||
* @return the content in bytes |
|
||||||
*/ |
|
||||||
private byte[] getContent() { |
|
||||||
if (content == null) { |
|
||||||
content = EncodingUtils.getBytes(value, getCharSet()); |
|
||||||
} |
|
||||||
return content; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Writes the data to the given OutputStream. |
|
||||||
* @param out the OutputStream to write to |
|
||||||
* @throws IOException if there is a write error |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
protected void sendData(OutputStream out) throws IOException { |
|
||||||
out.write(getContent()); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the length of the data. |
|
||||||
* @return The length of the data. |
|
||||||
* @see Part#lengthOfData() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
protected long lengthOfData() { |
|
||||||
return getContent().length; |
|
||||||
} |
|
||||||
|
|
||||||
/* (non-Javadoc) |
|
||||||
* @see org.apache.commons.httpclient.methods.multipart.BasePart#setCharSet(java.lang.String) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void setCharSet(String charSet) { |
|
||||||
super.setCharSet(charSet); |
|
||||||
this.content = null; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
File diff suppressed because it is too large
Load Diff
@ -1,65 +0,0 @@ |
|||||||
/* |
|
||||||
* Licensed to the Apache Software Foundation (ASF) under one |
|
||||||
* or more contributor license agreements. See the NOTICE file |
|
||||||
* distributed with this work for additional information |
|
||||||
* regarding copyright ownership. The ASF licenses this file |
|
||||||
* to you under the Apache License, Version 2.0 (the |
|
||||||
* "License"); you may not use this file except in compliance |
|
||||||
* with the License. You may obtain a copy of the License at |
|
||||||
* |
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
* |
|
||||||
* Unless required by applicable law or agreed to in writing, |
|
||||||
* software distributed under the License is distributed on an |
|
||||||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
|
||||||
* KIND, either express or implied. See the License for the |
|
||||||
* specific language governing permissions and limitations |
|
||||||
* under the License. |
|
||||||
*/ |
|
||||||
package org.apache.openjpa.lib.util; |
|
||||||
|
|
||||||
/** |
|
||||||
* Base 16 encoder. |
|
||||||
* |
|
||||||
* @author Marc Prud'hommeaux |
|
||||||
* @nojavadoc |
|
||||||
*/ |
|
||||||
public class Base16Encoder { |
|
||||||
|
|
||||||
private final static char[] HEX = new char[]{ |
|
||||||
'0', '1', '2', '3', '4', '5', '6', '7', |
|
||||||
'8', '9', 'A', 'B', 'C', 'D', 'E', 'F' }; |
|
||||||
|
|
||||||
/** |
|
||||||
* Convert bytes to a base16 string. |
|
||||||
*/ |
|
||||||
public static String encode(byte[] byteArray) { |
|
||||||
StringBuffer hexBuffer = new StringBuffer(byteArray.length * 2); |
|
||||||
for (int i = 0; i < byteArray.length; i++) |
|
||||||
for (int j = 1; j >= 0; j--) |
|
||||||
hexBuffer.append(HEX[(byteArray[i] >> (j * 4)) & 0xF]); |
|
||||||
return hexBuffer.toString(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Convert a base16 string into a byte array. |
|
||||||
*/ |
|
||||||
public static byte[] decode(String s) { |
|
||||||
int len = s.length(); |
|
||||||
byte[] r = new byte[len / 2]; |
|
||||||
for (int i = 0; i < r.length; i++) { |
|
||||||
int digit1 = s.charAt(i * 2), digit2 = s.charAt(i * 2 + 1); |
|
||||||
if (digit1 >= '0' && digit1 <= '9') |
|
||||||
digit1 -= '0'; |
|
||||||
else if (digit1 >= 'A' && digit1 <= 'F') |
|
||||||
digit1 -= 'A' - 10; |
|
||||||
if (digit2 >= '0' && digit2 <= '9') |
|
||||||
digit2 -= '0'; |
|
||||||
else if (digit2 >= 'A' && digit2 <= 'F') |
|
||||||
digit2 -= 'A' - 10; |
|
||||||
|
|
||||||
r[i] = (byte) ((digit1 << 4) + digit2); |
|
||||||
} |
|
||||||
return r; |
|
||||||
} |
|
||||||
} |
|
File diff suppressed because it is too large
Load Diff
@ -1,4 +1,6 @@ |
|||||||
package com.android.internalcopy.http.multipart; |
package org.transdroid.multipart; |
||||||
|
|
||||||
|
import com.android.internal.http.multipart.PartBase; |
||||||
|
|
||||||
import java.io.IOException; |
import java.io.IOException; |
||||||
import java.io.OutputStream; |
import java.io.OutputStream; |
@ -1,19 +1,30 @@ |
|||||||
|
// Top-level build file where you can add configuration options common to all sub-projects/modules. |
||||||
|
|
||||||
buildscript { |
buildscript { |
||||||
repositories { |
repositories { |
||||||
google() |
google() |
||||||
jcenter() |
jcenter() |
||||||
|
maven { url "https://jitpack.io" } |
||||||
mavenCentral() |
mavenCentral() |
||||||
} |
} |
||||||
|
|
||||||
dependencies { |
dependencies { |
||||||
classpath 'com.android.tools.build:gradle:3.6.3' |
classpath 'com.android.tools.build:gradle:4.0.0' |
||||||
|
|
||||||
|
// NOTE: Do not place your application dependencies here; they belong |
||||||
|
// in the individual module build.gradle files |
||||||
} |
} |
||||||
} |
} |
||||||
|
|
||||||
allprojects { |
allprojects { |
||||||
repositories { |
repositories { |
||||||
google() |
google() |
||||||
mavenCentral() |
|
||||||
jcenter() |
jcenter() |
||||||
maven { url "https://jitpack.io" } |
maven { url "https://jitpack.io" } |
||||||
|
mavenCentral() |
||||||
} |
} |
||||||
} |
} |
||||||
|
|
||||||
|
task clean(type: Delete) { |
||||||
|
delete rootProject.buildDir |
||||||
|
} |
||||||
|
Binary file not shown.
Loading…
Reference in new issue