2
* $HeadURL: https://svn.apache.org/repos/asf/httpcomponents/httpcore/tags/4.0.1/httpcore/src/main/java/org/apache/http/entity/StringEntity.java $
4
* $Date: 2009-02-14 17:57:41 +0100 (Sat, 14 Feb 2009) $
6
* ====================================================================
7
* Licensed to the Apache Software Foundation (ASF) under one
8
* or more contributor license agreements. See the NOTICE file
9
* distributed with this work for additional information
10
* regarding copyright ownership. The ASF licenses this file
11
* to you under the Apache License, Version 2.0 (the
12
* "License"); you may not use this file except in compliance
13
* with the License. You may obtain a copy of the License at
15
* http://www.apache.org/licenses/LICENSE-2.0
17
* Unless required by applicable law or agreed to in writing,
18
* software distributed under the License is distributed on an
19
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
20
* KIND, either express or implied. See the License for the
21
* specific language governing permissions and limitations
23
* ====================================================================
25
* This software consists of voluntary contributions made by many
26
* individuals on behalf of the Apache Software Foundation. For more
27
* information on the Apache Software Foundation, please see
28
* <http://www.apache.org/>.
32
package org.apache.http.entity;
34
import java.io.ByteArrayInputStream;
35
import java.io.IOException;
36
import java.io.InputStream;
37
import java.io.OutputStream;
38
import java.io.UnsupportedEncodingException;
40
import org.apache.http.protocol.HTTP;
43
* A self contained, repeatable entity that obtains its content from
47
* @version $Revision: 744523 $
51
public class StringEntity extends AbstractHttpEntity implements Cloneable {
53
protected final byte[] content;
55
public StringEntity(final String s, String charset)
56
throws UnsupportedEncodingException {
59
throw new IllegalArgumentException("Source string may not be null");
61
if (charset == null) {
62
charset = HTTP.DEFAULT_CONTENT_CHARSET;
64
this.content = s.getBytes(charset);
65
setContentType(HTTP.PLAIN_TEXT_TYPE + HTTP.CHARSET_PARAM + charset);
68
public StringEntity(final String s)
69
throws UnsupportedEncodingException {
73
public boolean isRepeatable() {
77
public long getContentLength() {
78
return this.content.length;
81
public InputStream getContent() throws IOException {
82
return new ByteArrayInputStream(this.content);
85
public void writeTo(final OutputStream outstream) throws IOException {
86
if (outstream == null) {
87
throw new IllegalArgumentException("Output stream may not be null");
89
outstream.write(this.content);
94
* Tells that this entity is not streaming.
96
* @return <code>false</code>
98
public boolean isStreaming() {
102
public Object clone() throws CloneNotSupportedException {
103
return super.clone();
106
} // class StringEntity