MessageBodyWriter (Jakarta EE 8 仕様 API)

型パラメーター:
T - 書き込み可能なタイプ。
```
public interface MessageBodyWriter<T>
```
Java 型からストリームへの変換をサポートするプロバイダーの契約。MessageBodyWriter 実装には、Produces でアノテーションを付けて、適切と見なされるメディアタイプを制限できます。
MessageBodyWriter 契約を実装するプロバイダーは、プログラムで API ランタイムに登録するか、プロバイダーのスキャンフェーズ中にランタイムによって自動的に検出される @Provider アノテーションを付ける必要があります。
導入:
1.0
作成者:
Paul Sandoz, Marc Hadley
関連事項:
Provider, Produces

メソッドのサマリー

すべてのメソッドインスタンスメソッド抽象メソッドデフォルトメソッド
修飾子と型	メソッドと説明
`default long`	`getSize(T t, ClassSE<?> type, TypeSE genericType, AnnotationSE[] annotations, MediaType mediaType)` 元々、このメソッドは `writeTo` の前に呼び出され、シリアライズされた形式の `t` の長さ（バイト単位）を確認していました。
`boolean`	`isWriteable(ClassSE<?> type, TypeSE genericType, AnnotationSE[] annotations, MediaType mediaType)` MessageBodyWriter が特定のタイプをサポートしているかどうかを確認します。
`void`	`writeTo(T t, ClassSE<?> type, TypeSE genericType, AnnotationSE[] annotations, MediaType mediaType, MultivaluedMap<StringSE, ObjectSE> httpHeaders, OutputStreamSE entityStream)` タイプを HTTP メッセージに書き込みます。

- メソッドの詳細
  - isWriteable
```
boolean isWriteable(ClassSE<?> type,
                    TypeSE genericType,
                    AnnotationSE[] annotations,
                    MediaType mediaType)
```
    MessageBodyWriter が特定のタイプをサポートしているかどうかを確認します。
    パラメーター:
    type - 書き込まれるインスタンスのクラス。
    genericType - 書き込まれるインスタンスのタイプ。リソースメソッドの戻り値のタイプを反映するか、返されたインスタンスのインスペクションを介して取得されます。GenericEntity は、実行時にこの情報を指定する方法を提供します。
    annotations - メッセージエンティティインスタンスに添付されたアノテーションの配列。
    mediaType - HTTP エンティティのメディアタイプ。
    戻り値:
    タイプがサポートされている場合は true、それ以外の場合は false。
  - getSize
```
default long getSize(T t,
                     ClassSE<?> type,
                     TypeSE genericType,
                     AnnotationSE[] annotations,
                     MediaType mediaType)
```
    元々、このメソッドは writeTo の前に呼び出され、シリアライズされた形式の t の長さ（バイト単位）を確認していました。HTTP Content-Length ヘッダーで負でない戻り値が使用されています。
    この API のバージョン 2.0 以降、メソッドは非推奨になり、メソッドによって返された値は API ランタイムによって無視されます。すべての MessageBodyWriter 実装は、メソッドから -1 を返すことをお勧めします。実際の Content-Length ヘッダー値を計算する責任は、ランタイムに委譲されています。
    パラメーター:
    t - 書き込むインスタンス
    type - 書き込まれるインスタンスのクラス。
    genericType - 書き込むインスタンスのタイプ。GenericEntity は、実行時にこの情報を指定する方法を提供します。
    annotations - メッセージエンティティインスタンスに添付されたアノテーションの配列。
    mediaType - HTTP エンティティのメディアタイプ。
    戻り値:
    バイト単位の長さ、または長さが事前に決定できない場合は -1。
  - writeTo
```
void writeTo(T t,
             ClassSE<?> type,
             TypeSE genericType,
             AnnotationSE[] annotations,
             MediaType mediaType,
             MultivaluedMap<StringSE,ObjectSE> httpHeaders,
             OutputStreamSE entityStream)
      throws IOExceptionSE,
             WebApplicationException
```
    タイプを HTTP メッセージに書き込みます。メッセージヘッダーマップは変更可能ですが、ヘッダーはメッセージ本文を書き込む前にフラッシュされるため、出力ストリームに書き込む前に変更を行う必要があります。
    パラメーター:
    t - 書き込むインスタンス。
    type - 書き込まれるインスタンスのクラス。
    genericType - 書き込むインスタンスのタイプ。GenericEntity は、実行時にこの情報を指定する方法を提供します。
    annotations - メッセージエンティティインスタンスに添付されたアノテーションの配列。
    mediaType - HTTP エンティティのメディアタイプ。
    httpHeaders - HTTP メッセージヘッダーの変更可能なマップ。
    entityStream - HTTP エンティティの OutputStreamSE。実装は出力ストリームを閉じてはなりません。
    例外:
    IOExceptionSE - IO エラーが発生した場合。
    WebApplicationException - 特定の HTTP エラーレスポンスを生成する必要がある場合。メッセージがコミットされる前にスローされた場合にのみ有効です。

インターフェース MessageBodyWriter<T>

メソッドのサマリー

メソッドの詳細

isWriteable

getSize

writeTo