public interface ContainerResponseContext
修飾子と型 | メソッドと説明 |
---|---|
SetSE<StringSE> | getAllowedMethods() Allow HTTP ヘッダーから許可された HTTP メソッドを取得します。 |
MapSE<StringSE, NewCookie> | getCookies() レスポンスメッセージに設定された新しい Cookie を取得します。 |
DateSE | getDate() メッセージの日付を取得します。 |
ObjectSE | getEntity() メッセージエンティティの Java インスタンスを取得します。 |
AnnotationSE[] | getEntityAnnotations() エンティティインスタンスに添付されたアノテーションを取得します。 |
ClassSE<?> | getEntityClass() 生のエンティティ型情報を取得します。 |
OutputStreamSE | getEntityStream() エンティティ出力ストリームを取得します。 |
EntityTag | getEntityTag() エンティティタグを取得します。 |
TypeSE | getEntityType() 一般的なエンティティ型情報を取得します。 |
MultivaluedMap<StringSE, ObjectSE> | getHeaders() 可変レスポンスヘッダーの多値マップを取得します。 |
StringSE | getHeaderString(StringSE name) メッセージヘッダーを単一の文字列値として取得します。 |
LocaleSE | getLanguage() エンティティの言語を取得します。 |
DateSE | getLastModified() 最終更新日を取得します。 |
int | getLength() Content-Length 値を取得します。 |
Link | getLink(StringSE relation) 関係のリンクを取得します。 |
Link.Builder | getLinkBuilder(StringSE relation) リレーションの Link.Builder を返す簡易メソッド。 |
SetSE<Link> | getLinks() メッセージに添付されたリンクをヘッダーとして取得します。 |
URISE | getLocation() 場所を取得します。 |
MediaType | getMediaType() エンティティのメディア型を取得します。 |
int | getStatus() レスポンスに関連付けられたステータスコードを取得します。 |
Response.StatusType | getStatusInfo() レスポンスに関連する完全なステータス情報を取得します。 |
MultivaluedMap<StringSE, StringSE> | getStringHeaders() メッセージに関連付けられたヘッダー値の文字列ビューを取得します。 |
boolean | hasEntity() レスポンスで使用可能なエンティティがあるかどうかを確認します。 |
boolean | hasLink(StringSE relation) リレーションのリンクが存在するかどうかを確認します。 |
void | setEntity(ObjectSE entity) 新しいメッセージエンティティを設定します。 |
void | setEntity(ObjectSE entity, AnnotationSE[] annotations, MediaType mediaType) 添付されたアノテーションとメディア型を含む、新しいメッセージエンティティを設定します。 |
void | setEntityStream(OutputStreamSE outputStream) 新しいエンティティ出力ストリームを設定します。 |
void | setStatus(int code) 新しいレスポンスステータスコードを設定します。 |
void | setStatusInfo(Response.StatusType statusInfo) レスポンスに関連付けられた完全なステータス情報(ステータスコードと理由フレーズ)を設定します。 |
int getStatus()
void setStatus(int code)
code
- 新しいステータスコード。Response.StatusType getStatusInfo()
null
void setStatusInfo(Response.StatusType statusInfo)
statusInfo
- レスポンスステータス情報。MultivaluedMap<StringSE,ObjectSE> getHeaders()
getStringHeaders()
, getHeaderString(String)
MultivaluedMap<StringSE,StringSE> getStringHeaders()
headers map
の変更は、このビューに反映されます。 このメソッドは、値のクラスに RuntimeDelegate.createHeaderDelegate(java.lang.Class)
を介して使用できる場合は RuntimeDelegate.HeaderDelegate
を使用し、ヘッダーデリゲートが使用できない場合は値 toString
メソッドを使用して、非文字列ヘッダー値を文字列に変換します。
getHeaders()
, getHeaderString(String)
StringSE getHeaderString(StringSE name)
RuntimeDelegate.createHeaderDelegate(java.lang.Class)
を介して使用できる場合は RuntimeDelegate.HeaderDelegate
を使用して、またはヘッダーデリゲートが使用できない場合はその toString
メソッドを使用して文字列に変換されます。name
- メッセージヘッダー。null
が返されます。メッセージヘッダーは存在するが値がない場合は、空の文字列が返されます。メッセージヘッダーが複数存在する場合、の値は結合され、"," 文字で区切られます。getHeaders()
, getStringHeaders()
SetSE<StringSE> getAllowedMethods()
DateSE getDate()
null
が存在しません。LocaleSE getLanguage()
null
int getLength()
MediaType getMediaType()
null
(例: レスポンスエンティティがない)MapSE<StringSE,NewCookie> getCookies()
new cookie
へのクッキー名(文字列)の読み取り専用マップ。EntityTag getEntityTag()
null
が存在しません。DateSE getLastModified()
null
。URISE getLocation()
null
。SetSE<Link> getLinks()
Set
SE を返すことがあります。null
を返しません。boolean hasLink(StringSE relation)
relation
- リンク関係。true
、それ以外の場合は false
。Link getLink(StringSE relation)
relation
- リンク関係。null
。Link.Builder getLinkBuilder(StringSE relation)
Link.Builder
を返す簡易メソッド。relation
- リンク関係。null
が存在しません。boolean hasEntity()
true
を返し、それ以外の場合は false
を返します。true
、それ以外の場合は false
。ObjectSE getEntity()
null
を返します。null
ClassSE<?> getEntityClass()
TypeSE getEntityType()
void setEntity(ObjectSE entity)
annotations
および media type
は保持されます。 ジェネリクス型の保持が必要な場合、実際のエンティティを GenericEntity
でラップするのは呼び出し側の責任です。
entity
- エンティティオブジェクト。setEntity(Object, java.lang.annotation.Annotation[], javax.ws.rs.core.MediaType)
, MessageBodyWriter
void setEntity(ObjectSE entity, AnnotationSE[] annotations, MediaType mediaType)
ジェネリクス型の保持が必要な場合、実際のエンティティを GenericEntity
でラップするのは呼び出し側の責任です。
entity
- エンティティオブジェクト。annotations
- エンティティインスタンスに添付されたアノテーション。mediaType
- エンティティメディア型。setEntity(Object)
, MessageBodyWriter
AnnotationSE[] getEntityAnnotations()
返されるアノテーション配列には、エンティティインスタンスに明示的にアタッチされたアノテーション(Response.ResponseBuilder.entity(Object, java.lang.annotation.Annotation[])
メソッドを使用してアタッチされたアノテーションや、レスポンスを返したリソースメソッドにアタッチされたアノテーションなど)のみが含まれることに注意してください。エンティティインスタンスのアノテーション配列には、エンティティ実装クラスまたはその祖先で宣言されたアノテーションは含まれません。
フィルターチェーンで以前に呼び出されたコンテナーレスポンスフィルターはエンティティアノテーション値を変更する可能性があることに注意してください。この場合、この getter メソッドは、フィルターチェーンで以前に呼び出されたコンテナーレスポンスフィルターによって設定された最後のアノテーション値を返します。
例:
@Path("my-resource") public class MyResource { private final Annotations[] extras = ... ; @GET @Custom public String getAnnotatedMe() { return Response.ok().entity("Annotated me", extras).build(); } ... }
上記の getMe()
メソッドから返されたレスポンスのコンテナーレスポンスコンテキストには、getAnnotatedMe()
メソッドで宣言されたすべてのアノテーション(@GET
、@Custom
)と、extras
フィールドからのすべてのアノテーションが含まれます(この値がコンテナーレスポンスに置き換えられていない場合)。以前に呼び出されたフィルター。
同様に:
@Custom public class AnnotatedMe { ... } @Path("my-resource") public class MyResource { private final Annotations[] extras = ... ; @GET public AnnotatedMe getMe() { return Response.ok().entity(new AnnotatedMe(), extras).build(); } ... }
値が以前に呼び出されたコンテナーレスポンスフィルターで置き換えられていない場合、上記の getMe()
メソッドから返されたレスポンスのコンテナーレスポンスコンテキストには、getMe()
メソッド(@GET
)のすべてのアノテーションと extras
のすべてのアノテーションが含まれます。フィールド。ただし、AnnotatedMe
クラスで宣言されたアノテーションは含まれません。
OutputStreamSE getEntityStream()
void setEntityStream(OutputStreamSE outputStream)
outputStream
- 新しいエンティティ出力ストリーム。Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.