1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30 package org.apache.commons.httpclient.methods;
31
32 import java.io.IOException;
33 import java.io.OutputStream;
34
35 /***
36 * @since 3.0
37 */
38 public interface RequestEntity {
39
40 /***
41 * Tests if {@link #writeRequest(OutputStream)} can be called more than once.
42 *
43 * @return <tt>true</tt> if the entity can be written to {@link OutputStream} more than once,
44 * <tt>false</tt> otherwise.
45 */
46 boolean isRepeatable();
47
48 /***
49 * Writes the request entity to the given stream.
50 * @param out
51 * @throws IOException
52 */
53 void writeRequest(OutputStream out) throws IOException;
54
55 /***
56 * Gets the request entity's length.
57 * @return either a number >= 0 or
58 * {@link org.apache.commons.httpclient.methods.EntityEnclosingMethod#CONTENT_LENGTH_CHUNKED}
59 */
60 long getContentLength();
61
62 /***
63 * Gets the entity's content type. This content type will be used as the value for the
64 * "Content-Type" header.
65 * @return the entity's content type
66 * @see org.apache.commons.httpclient.HttpMethod#setRequestHeader(String, String)
67 */
68 String getContentType();
69
70 }