検索

48.2. プレーンな Java コンストラクトを返します。

download PDF

概要

多くの場合、リソースクラスは標準の Java タイプ、JAXB オブジェクト、またはアプリケーションにエンティティープロバイダーがある任意のオブジェクトを返すことができます。このような場合には、ランタイムは返されるオブジェクトの Java クラスを使用して MIME タイプの情報を決定します。ランタイムは、コンシューマーに送信する適切な HTTP リターンコードも決定します。

戻り値の型

リソースメソッドは、void またはエンティティーライターが提供されている Java 型を返すことができます。デフォルトでは、ランタイムには以下のプロバイダーがあります。

  • Java プリミティブ
  • Java プリミティブの Number 表現
  • JAXB オブジェクト

「ネイティブでサポートされるタイプ」 は、デフォルトでサポートされるすべての戻り値のタイプを一覧表示します。「カスタムライター」 は、カスタムエンティティーライターの実装方法を記述します。

MIME タイプ

ランタイムは、最初にリソースメソッドおよび @Produces アノテーションのリソースクラスをチェックして、返されるエンティティーの MIME タイプを決定します。見つかった場合は、アノテーションで指定された MIME タイプを使用します。リソース実装によって指定されたものが見つからない場合は、エンティティープロバイダーにより、適切な MIME タイプを決定します。

デフォルトでは、ランタイムは MIME タイプを以下のように割り当てます。

  • Java プリミティブおよびその Number 表現には、MIME タイプの application/octet-stream が割り当てられます。
  • JAXB オブジェクトには、application/xml の MIME タイプが割り当てられます。

アプリケーションは、「カスタムライター」 で説明されているようにカスタムエンティティープロバイダーを実装して、他のマッピングを使用できます。

レスポンスコード

リソースメソッドがプレーンな Java 構造を返す場合、リソースメソッドが例外を出力せずに完了すると、ランタイムは応答のステータスコードを自動的に設定します。ステータスコードは以下のように設定されます。

  • 204 (コンテンツなし) - リソースメソッドの戻り値の型は void です。
  • 204 (コンテンツなし) - 返されるエンティティーの値は null です。
  • 200 (OK) - 返されるエンティティーの値は null ではありません。

リソースメソッドが完了する前に例外が出力された場合に、50章例外処理 で説明されているようにリターンステータスコードを設定します。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.