public class NStringEntity extends AbstractHttpEntity implements HttpAsyncContentProducer, ProducingNHttpEntity
String
object.Modifier and Type | Field and Description |
---|---|
protected ByteBuffer |
buffer
Deprecated.
(4.2)
|
protected byte[] |
content
Deprecated.
(4.2)
|
chunked, contentEncoding, contentType, OUTPUT_BUFFER_SIZE
Constructor and Description |
---|
NStringEntity(String s)
Creates a NStringEntity with the specified content.
|
NStringEntity(String s,
Charset charset)
Creates a NStringEntity with the specified content and charset.
|
NStringEntity(String s,
ContentType contentType)
Creates a NStringEntity with the specified content and content type.
|
NStringEntity(String s,
String charset)
Creates a NStringEntity with the specified content and charset.
|
Modifier and Type | Method and Description |
---|---|
void |
close() |
void |
finish()
Deprecated.
(4.2) use
close() |
InputStream |
getContent() |
long |
getContentLength() |
boolean |
isRepeatable()
Determines whether or not this producer is capable of producing
its content more than once.
|
boolean |
isStreaming() |
void |
produceContent(ContentEncoder encoder,
IOControl ioControl)
Invoked to write out a chunk of content to the
ContentEncoder . |
void |
writeTo(OutputStream outStream) |
consumeContent, getContentEncoding, getContentType, isChunked, setChunked, setContentEncoding, setContentEncoding, setContentType, setContentType, toString
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
consumeContent, getContentEncoding, getContentType, isChunked
@Deprecated protected final byte[] content
@Deprecated protected final ByteBuffer buffer
public NStringEntity(String s, ContentType contentType)
s
- content to be used. Not null
.contentType
- content type to be used. May be null
, in which case
ContentType.TEXT_PLAIN
is assumed.IllegalArgumentException
- if the string parameter is nullpublic NStringEntity(String s, String charset) throws UnsupportedEncodingException
s
- content to be used. Not null
.charset
- character set to be used. May be null
, in which case the default
is HTTP.DEF_CONTENT_CHARSET
is assumedIllegalArgumentException
- if the string parameter is nullUnsupportedEncodingException
- Thrown when the named charset is not available in
this instance of the Java virtual machinepublic NStringEntity(String s, Charset charset)
s
- content to be used. Not null
.charset
- character set to be used. May be null
, in which case the default
is HTTP.DEF_CONTENT_CHARSET
is assumedIllegalArgumentException
- if the string parameter is nullpublic NStringEntity(String s) throws UnsupportedEncodingException
ContentType.TEXT_PLAIN
.s
- content to be used. Not null
.IllegalArgumentException
- if the string parameter is nullUnsupportedEncodingException
- if the default HTTP charset is not supported.public boolean isRepeatable()
HttpAsyncContentProducer
isRepeatable
in interface HttpEntity
isRepeatable
in interface HttpAsyncContentProducer
public long getContentLength()
getContentLength
in interface HttpEntity
public void close()
close
in interface Closeable
close
in interface AutoCloseable
@Deprecated public void finish()
close()
finish
in interface ProducingNHttpEntity
public void produceContent(ContentEncoder encoder, IOControl ioControl) throws IOException
HttpAsyncContentProducer
ContentEncoder
.
The IOControl
interface can be used to suspend output event
notifications if the entity is temporarily unable to produce more content.
When all content is finished, the producer MUST call
ContentEncoder.complete()
. Failure to do so may cause the entity
to be incorrectly delimited.
Please note that the ContentEncoder
object is not thread-safe and
should only be used within the context of this method call.
The IOControl
object can be shared and used on other thread
to resume output event notifications when more content is made available.
produceContent
in interface HttpAsyncContentProducer
produceContent
in interface ProducingNHttpEntity
encoder
- content encoder.ioControl
- I/O control of the underlying connection.IOException
public boolean isStreaming()
isStreaming
in interface HttpEntity
public InputStream getContent()
getContent
in interface HttpEntity
public void writeTo(OutputStream outStream) throws IOException
writeTo
in interface HttpEntity
IOException
Copyright © 2005–2022 The Apache Software Foundation. All rights reserved.