Package org.glassfish.jersey.server
Class ContainerResponse
- java.lang.Object
-
- org.glassfish.jersey.server.ContainerResponse
-
- All Implemented Interfaces:
ContainerResponseContext
public class ContainerResponse extends Object implements ContainerResponseContext
Jersey container response context.- Author:
- Marek Potociar
-
-
Constructor Summary
Constructors Constructor Description ContainerResponse(ContainerRequest requestContext, Response response)Create a new Jersey container response context.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidclose()Closes the response.voidcommitStream()Commit theentity streamunless already committed.voidenableBuffering(Configuration configuration)Enable a buffering of serialized entity.Set<String>getAllowedMethods()Map<String,NewCookie>getCookies()DategetDate()ObjectgetEntity()Annotation[]getEntityAnnotations()Class<?>getEntityClass()OutputStreamgetEntityStream()EntityTaggetEntityTag()TypegetEntityType()MultivaluedMap<String,Object>getHeaders()StringgetHeaderString(String name)LocalegetLanguage()DategetLastModified()intgetLength()LinkgetLink(String relation)Link.BuildergetLinkBuilder(String relation)Set<Link>getLinks()URIgetLocation()MediaTypegetMediaType()ContainerRequestgetRequestContext()Get the associated container request context paired with this response context.intgetStatus()Response.StatusTypegetStatusInfo()MultivaluedMap<String,String>getStringHeaders()OutboundMessageContextgetWrappedMessageContext()Get the wrapped response message context.booleanhasEntity()booleanhasLink(String relation)booleanisChunked()Returnstrueif the response entity is aChunkedOutputinstance.booleanisCommitted()Returnstrueif the entity stream has been committed.booleanisMappedFromException()Returns true if the response is result of the exception (for example created duringexception mapping).voidsetEntity(Object entity)Set a new message message entity.voidsetEntity(Object entity, Annotation[] annotations)Set a new message message entity.voidsetEntity(Object entity, Annotation[] annotations, MediaType mediaType)voidsetEntity(Object entity, Type type, Annotation[] annotations)Set a new message message entity.voidsetEntityAnnotations(Annotation[] annotations)Set the annotations attached to the entity.voidsetEntityStream(OutputStream outputStream)voidsetEntityType(Type type)Set the message entity type information.voidsetMappedFromException(boolean mappedFromException)Sets the flag indicating whether the response was created based on the exception.voidsetMediaType(MediaType mediaType)Set the message content media type.voidsetStatus(int code)voidsetStatusInfo(Response.StatusType status)voidsetStreamProvider(OutboundMessageContext.StreamProvider streamProvider)Set the output stream provider callback.
-
-
-
Constructor Detail
-
ContainerResponse
public ContainerResponse(ContainerRequest requestContext, Response response)
Create a new Jersey container response context.- Parameters:
requestContext- associated container request context.response- response instance initializing the response context.
-
-
Method Detail
-
isMappedFromException
public boolean isMappedFromException()
Returns true if the response is result of the exception (for example created duringexception mapping).- Returns:
- True if this response was created based on the exception, false otherwise.
-
setMappedFromException
public void setMappedFromException(boolean mappedFromException)
Sets the flag indicating whether the response was created based on the exception.- Parameters:
mappedFromException- True if this exception if result of the exception (for example result ofexception mapping).
-
getStatus
public int getStatus()
- Specified by:
getStatusin interfaceContainerResponseContext
-
setStatus
public void setStatus(int code)
- Specified by:
setStatusin interfaceContainerResponseContext
-
setStatusInfo
public void setStatusInfo(Response.StatusType status)
- Specified by:
setStatusInfoin interfaceContainerResponseContext
-
getStatusInfo
public Response.StatusType getStatusInfo()
- Specified by:
getStatusInfoin interfaceContainerResponseContext
-
getRequestContext
public ContainerRequest getRequestContext()
Get the associated container request context paired with this response context.- Returns:
- associated container request context.
-
getCookies
public Map<String,NewCookie> getCookies()
- Specified by:
getCookiesin interfaceContainerResponseContext
-
getWrappedMessageContext
public OutboundMessageContext getWrappedMessageContext()
Get the wrapped response message context.- Returns:
- wrapped response message context.
-
getHeaderString
public String getHeaderString(String name)
- Specified by:
getHeaderStringin interfaceContainerResponseContext
-
getHeaders
public MultivaluedMap<String,Object> getHeaders()
- Specified by:
getHeadersin interfaceContainerResponseContext
-
getStringHeaders
public MultivaluedMap<String,String> getStringHeaders()
- Specified by:
getStringHeadersin interfaceContainerResponseContext
-
getDate
public Date getDate()
- Specified by:
getDatein interfaceContainerResponseContext
-
getLanguage
public Locale getLanguage()
- Specified by:
getLanguagein interfaceContainerResponseContext
-
getMediaType
public MediaType getMediaType()
- Specified by:
getMediaTypein interfaceContainerResponseContext
-
getAllowedMethods
public Set<String> getAllowedMethods()
- Specified by:
getAllowedMethodsin interfaceContainerResponseContext
-
getLength
public int getLength()
- Specified by:
getLengthin interfaceContainerResponseContext
-
getEntityTag
public EntityTag getEntityTag()
- Specified by:
getEntityTagin interfaceContainerResponseContext
-
getLastModified
public Date getLastModified()
- Specified by:
getLastModifiedin interfaceContainerResponseContext
-
getLocation
public URI getLocation()
- Specified by:
getLocationin interfaceContainerResponseContext
-
getLinks
public Set<Link> getLinks()
- Specified by:
getLinksin interfaceContainerResponseContext
-
hasLink
public boolean hasLink(String relation)
- Specified by:
hasLinkin interfaceContainerResponseContext
-
getLink
public Link getLink(String relation)
- Specified by:
getLinkin interfaceContainerResponseContext
-
getLinkBuilder
public Link.Builder getLinkBuilder(String relation)
- Specified by:
getLinkBuilderin interfaceContainerResponseContext
-
hasEntity
public boolean hasEntity()
- Specified by:
hasEntityin interfaceContainerResponseContext
-
getEntity
public Object getEntity()
- Specified by:
getEntityin interfaceContainerResponseContext
-
setEntity
public void setEntity(Object entity)
Set a new message message entity.- Specified by:
setEntityin interfaceContainerResponseContext- Parameters:
entity- entity object.- See Also:
MessageBodyWriter
-
setEntity
public void setEntity(Object entity, Annotation[] annotations)
Set a new message message entity.- Parameters:
entity- entity object.annotations- annotations attached to the entity.- See Also:
MessageBodyWriter
-
setEntity
public void setEntity(Object entity, Type type, Annotation[] annotations)
Set a new message message entity.- Parameters:
entity- entity object.type- declared entity class.annotations- annotations attached to the entity.- See Also:
MessageBodyWriter
-
setEntity
public void setEntity(Object entity, Annotation[] annotations, MediaType mediaType)
- Specified by:
setEntityin interfaceContainerResponseContext
-
setMediaType
public void setMediaType(MediaType mediaType)
Set the message content media type.- Parameters:
mediaType- message content media type.
-
getEntityClass
public Class<?> getEntityClass()
- Specified by:
getEntityClassin interfaceContainerResponseContext
-
getEntityType
public Type getEntityType()
- Specified by:
getEntityTypein interfaceContainerResponseContext
-
setEntityType
public void setEntityType(Type type)
Set the message entity type information. This method overrides any computed or previously set entity type information.- Parameters:
type- overriding message entity type.
-
getEntityAnnotations
public Annotation[] getEntityAnnotations()
- Specified by:
getEntityAnnotationsin interfaceContainerResponseContext
-
setEntityAnnotations
public void setEntityAnnotations(Annotation[] annotations)
Set the annotations attached to the entity.- Parameters:
annotations- entity annotations.
-
getEntityStream
public OutputStream getEntityStream()
- Specified by:
getEntityStreamin interfaceContainerResponseContext
-
setEntityStream
public void setEntityStream(OutputStream outputStream)
- Specified by:
setEntityStreamin interfaceContainerResponseContext
-
setStreamProvider
public void setStreamProvider(OutboundMessageContext.StreamProvider streamProvider)
Set the output stream provider callback. This method must be called before first bytes are written to theentity stream.- Parameters:
streamProvider- non-nulloutput stream provider.
-
enableBuffering
public void enableBuffering(Configuration configuration)
Enable a buffering of serialized entity. The buffering will be configured from configuration. The property determining the size of the buffer isCommonProperties.OUTBOUND_CONTENT_LENGTH_BUFFER. The buffering functionality is by default disabled and could be enabled by calling this method. In this case this method must be called before first bytes are written to theentity stream.- Parameters:
configuration- runtime configuration.
-
commitStream
public void commitStream() throws IOExceptionCommit theentity streamunless already committed.- Throws:
IOException- in case of the IO error.
-
isCommitted
public boolean isCommitted()
Returnstrueif the entity stream has been committed.- Returns:
trueif the entity stream has been committed. Otherwise returnsfalse.
-
close
public void close()
Closes the response. Flushes and closes the entity stream, frees up container resources associated with the corresponding request.
-
isChunked
public boolean isChunked()
Returnstrueif the response entity is aChunkedOutputinstance.- Returns:
trueif the entity is aChunkedOutputinstance,falseotherwise.
-
-