Package org.simpleframework.http.message
Interface Body
-
- All Known Implementing Classes:
BufferBody
public interface Body
TheBody
interface is used to represent the body of a HTTP entity. It contains the information that is delivered with the request. The body is represented by a stream of bytes. In order to access the entity body this interface provides a stream which can be used to read it. Also, should the message be encoded as a multipart message the individual parts can be read using theAttachment
instance for it.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.lang.String
getContent()
This will acquire the contents of the body in UTF-8.java.lang.String
getContent(java.lang.String charset)
This will acquire the contents of the body in the specified charset.java.io.InputStream
getInputStream()
This is used to acquire the contents of the body as a stream.Part
getPart(java.lang.String name)
This method is used to acquire aPart
from the HTTP request using a known name for the part.java.util.List<Part>
getParts()
This method is used to get allPart
objects that are associated with the request.
-
-
-
Method Detail
-
getContent
java.lang.String getContent() throws java.io.IOException
This will acquire the contents of the body in UTF-8. If there is no content encoding and the user of the request wants to deal with the body as a string then this method can be used. It will simply create a UTF-8 string using the body bytes.- Returns:
- returns a UTF-8 string representation of the body
- Throws:
java.io.IOException
-
getContent
java.lang.String getContent(java.lang.String charset) throws java.io.IOException
This will acquire the contents of the body in the specified charset. Typically this will be given the charset as taken from the HTTP Content-Type header. Although any encoding can be specified to convert the body to a string representation.- Returns:
- returns an encoded string representation of the body
- Throws:
java.io.IOException
-
getInputStream
java.io.InputStream getInputStream() throws java.io.IOException
This is used to acquire the contents of the body as a stream. Each time this method is invoked a new stream is created that will read the contents of the body from the first byte. This ensures that the stream can be acquired several times without any issues arising from previous reads.- Returns:
- this returns a new string used to read the body
- Throws:
java.io.IOException
-
getPart
Part getPart(java.lang.String name)
This method is used to acquire aPart
from the HTTP request using a known name for the part. This is typically used when there is a file upload with a multipart POST request. All parts that are not files can be acquired as string values from the attachment object.- Parameters:
name
- this is the name of the part object to acquire- Returns:
- the named part or null if the part does not exist
-
getParts
java.util.List<Part> getParts()
This method is used to get allPart
objects that are associated with the request. Each attachment contains the body and headers associated with it. If the request is not a multipart POST request then this will return an empty list.- Returns:
- the list of parts associated with this request
-
-