Class ODataResponse
- java.lang.Object
-
- org.apache.olingo.odata2.api.processor.ODataResponse
-
public abstract class ODataResponse extends Object
An
ODataResponseis usually created by anODataProcessorduring request handling.The handler can use a serializer to create an OData body (== response entity) and can set various response headers. A response can be created using the builder pattern:
ODataResponse response = ODataResponse.entity("hello world").setStatus(HttpStatusCodes.OK).build();
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classODataResponse.ODataResponseBuilderImplementation of the builder pattern to create instances of this type of object.
-
Field Summary
Fields Modifier and Type Field Description static PatternCHARSET_MATCHER_PATTERN
-
Constructor Summary
Constructors Modifier Constructor Description protectedODataResponse()Do not subclass ODataResponse!
-
Method Summary
-
-
-
Field Detail
-
CHARSET_MATCHER_PATTERN
public static final Pattern CHARSET_MATCHER_PATTERN
-
-
Method Detail
-
getStatus
public abstract HttpStatusCodes getStatus()
- Returns:
- HTTP status code of this response
-
getEntity
public abstract Object getEntity()
- Returns:
- a response entity which becomes the body part of a response message
-
getEntityAsStream
public InputStream getEntityAsStream() throws ODataException
- Returns:
- a response entity as inputStream which becomes the body part of a response message
- Throws:
ODataException- throws ODataException in case of entity is not a stream (internal ClassCastException)
-
close
public abstract void close() throws IOExceptionClose the underlying entity input stream (if such a stream is available) and release all with this repsonse associated resources.- Throws:
IOException- if something goes wrong during close ofODataResponse
-
getHeader
public abstract String getHeader(String name)
- Parameters:
name- HTTP response header name- Returns:
- a header value or null if not set
-
getContentHeader
public abstract String getContentHeader()
- Returns:
- Content-Type header value or null if not set
-
getIdLiteral
public abstract String getIdLiteral()
- Returns:
- Location header value or null if not set
-
getETag
public abstract String getETag()
- Returns:
- ETag header value or null if not available
-
getHeaderNames
public abstract Set<String> getHeaderNames()
- Returns:
- a set of all available header names
-
containsHeader
public abstract boolean containsHeader(String header)
Case insensitive check if the header is available in this ODataResponse- Parameters:
header- header name- Returns:
- true/false
-
status
public static ODataResponse.ODataResponseBuilder status(HttpStatusCodes status)
- Parameters:
status- HTTP status code- Returns:
- a builder object
-
fromResponse
public static ODataResponse.ODataResponseBuilder fromResponse(ODataResponse response)
- Parameters:
response- Response- Returns:
- a new builder object
-
entity
public static ODataResponse.ODataResponseBuilder entity(Object entity)
- Parameters:
entity- Entity- Returns:
- a builder object
-
entities
public static ODataResponse.ODataResponseBuilder entities(List<Map<String,Object>> entities)
-
header
public static ODataResponse.ODataResponseBuilder header(String name, String value)
- Parameters:
name- HTTP header namevalue- associated value- Returns:
- a builder object
-
contentHeader
public static ODataResponse.ODataResponseBuilder contentHeader(String value)
- Parameters:
value- content header value- Returns:
- a builder object
-
newBuilder
public static ODataResponse.ODataResponseBuilder newBuilder()
- Returns:
- returns a new builder object
-
-