KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > commons > httpclient > methods > StringRequestEntity


1 /*
2  * $HeadURL: https://svn.apache.org/repos/asf/jakarta/commons/proper/httpclient/trunk/src/java/org/apache/commons/httpclient/methods/StringRequestEntity.java $
3  * $Revision: 480424 $
4  * $Date: 2006-11-29 05:56:49 +0000 (Wed, 29 Nov 2006) $
5  *
6  * ====================================================================
7  *
8  * Licensed to the Apache Software Foundation (ASF) under one or more
9  * contributor license agreements. See the NOTICE file distributed with
10  * this work for additional information regarding copyright ownership.
11  * The ASF licenses this file to You under the Apache License, Version 2.0
12  * (the "License"); you may not use this file except in compliance with
13  * the License. You may obtain a copy of the License at
14  *
15  * http://www.apache.org/licenses/LICENSE-2.0
16  *
17  * Unless required by applicable law or agreed to in writing, software
18  * distributed under the License is distributed on an "AS IS" BASIS,
19  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20  * See the License for the specific language governing permissions and
21  * limitations under the License.
22  * ====================================================================
23  *
24  * This software consists of voluntary contributions made by many
25  * individuals on behalf of the Apache Software Foundation. For more
26  * information on the Apache Software Foundation, please see
27  * <http://www.apache.org/>.
28  *
29  * [Additional notices, if required by prior licensing conditions]
30  *
31  */

32 package org.apache.commons.httpclient.methods;
33
34 import java.io.IOException JavaDoc;
35 import java.io.OutputStream JavaDoc;
36 import java.io.UnsupportedEncodingException JavaDoc;
37
38 import org.apache.commons.httpclient.HeaderElement;
39 import org.apache.commons.httpclient.NameValuePair;
40
41 /**
42  * A RequestEntity that contains a String.
43  *
44  * @since 3.0
45  */

46 public class StringRequestEntity implements RequestEntity {
47
48     /** The content */
49     private byte[] content;
50     
51     /** The charset */
52     private String JavaDoc charset;
53
54     /** The content type (i.e. text/html; charset=EUC-JP). */
55     private String JavaDoc contentType;
56     
57     /**
58      * <p>Creates a new entity with the given content. This constructor
59      * will use the default platform charset to convert the content string
60      * and will provide no content type.</p>
61      *
62      * @see #StringRequestEntity(String, String, String)
63      *
64      * @param content The content to set.
65      *
66      * @deprecated use {@link #StringRequestEntity(String, String, String)} instead
67      */

68     public StringRequestEntity(String JavaDoc content) {
69         super();
70         if (content == null) {
71             throw new IllegalArgumentException JavaDoc("The content cannot be null");
72         }
73         this.contentType = null;
74         this.charset = null;
75         this.content = content.getBytes();
76     }
77
78     /**
79      * Creates a new entity with the given content, content type, and charset.
80      *
81      * @param content The content to set.
82      * @param contentType The type of the content, or <code>null</code>. The value retured
83      * by {@link #getContentType()}. If this content type contains a charset and the charset
84      * parameter is null, the content's type charset will be used.
85      * @param charset The charset of the content, or <code>null</code>. Used to convert the
86      * content to bytes. If the content type does not contain a charset and charset is not null,
87      * then the charset will be appended to the content type.
88      */

89     public StringRequestEntity(String JavaDoc content, String JavaDoc contentType, String JavaDoc charset)
90         throws UnsupportedEncodingException JavaDoc {
91         super();
92         if (content == null) {
93             throw new IllegalArgumentException JavaDoc("The content cannot be null");
94         }
95         
96         this.contentType = contentType;
97         this.charset = charset;
98         
99         // resolve the content type and the charset
100
if (contentType != null) {
101             HeaderElement[] values = HeaderElement.parseElements(contentType);
102             NameValuePair charsetPair = null;
103             for (int i = 0; i < values.length; i++) {
104                 if ((charsetPair = values[i].getParameterByName("charset")) != null) {
105                     // charset found
106
break;
107                 }
108             }
109             if (charset == null && charsetPair != null) {
110                 // use the charset from the content type
111
this.charset = charsetPair.getValue();
112             } else if (charset != null && charsetPair == null) {
113                 // append the charset to the content type
114
this.contentType = contentType + "; charset=" + charset;
115             }
116         }
117         if (this.charset != null) {
118             this.content = content.getBytes(this.charset);
119         } else {
120             this.content = content.getBytes();
121         }
122     }
123
124     /* (non-Javadoc)
125      * @see org.apache.commons.httpclient.methods.RequestEntity#getContentType()
126      */

127     public String JavaDoc getContentType() {
128         return contentType;
129     }
130
131     /**
132      * @return <code>true</code>
133      */

134     public boolean isRepeatable() {
135         return true;
136     }
137
138     /* (non-Javadoc)
139      * @see org.apache.commons.httpclient.RequestEntity#writeRequest(java.io.OutputStream)
140      */

141     public void writeRequest(OutputStream JavaDoc out) throws IOException JavaDoc {
142         if (out == null) {
143             throw new IllegalArgumentException JavaDoc("Output stream may not be null");
144         }
145         out.write(this.content);
146         out.flush();
147     }
148
149     /**
150      * @return The length of the content.
151      */

152     public long getContentLength() {
153         return this.content.length;
154     }
155
156     /**
157      * @return Returns the content.
158      */

159     public String JavaDoc getContent() {
160         if (this.charset != null) {
161             try {
162                 return new String JavaDoc(this.content, this.charset);
163             } catch (UnsupportedEncodingException JavaDoc e) {
164                 return new String JavaDoc(this.content);
165             }
166         } else {
167             return new String JavaDoc(this.content);
168         }
169     }
170
171     /**
172      * @return Returns the charset used to convert the content to bytes. <code>null</code> if
173      * no charset as been specified.
174      */

175     public String JavaDoc getCharset() {
176         return charset;
177     }
178 }
179
Popular Tags