Bean 検証を使用して、アプリケーション・ロジックで使用されるデータを検証するために 1 つ以上の制約を使用することができます。事前定義された制約を使用するか、独自の制約を作成することができます。
始める前に
最上位の機能の
「Web 開発ツール」を選択して、Bean 検証ツールを自動的に組み込みます。
このタスクについて
制約の注釈または XML デプロイメント記述子ファイルを使用して、Bean 検証を構成し、カスタム制約宣言を記述します。
手順
- 制約の注釈を使用して Bean 検証を構成します。
- 事前定義された制約の注釈を選択するか、メタ注釈 @Constraint を使用して、カスタム制約を作成し、アプリケーション・ロジックで使用します。 Interface ConstraintValidator をカスタム制約クラスとして使用する場合は、実装しておく必要があります。
重要: 事前定義された制約の注釈は、すべてがパッケージ javax.validation.constraints 内にあり、13 個 (@AssertFalse、@AssertTrue、@DecimalMax、@DecimalMin、@Digits、@Future、@Max、@Min、@NotNull、@Null、@Past、@Pattern、および @Size) あります。
- 選択した注釈をフィールド宣言の前で使用して、アプリケーション・ロジックで使用されるデータを検証します。 例えば、事前定義された注釈 @NotNull を変数宣言の前で使用して、メソッド変数が NULL ではないことを検証できます。 検証をフィールド、メソッド・パラメーター、およびクラスのレベルで使用して、一度に複数のデータ・ポイントを検査できます。
- XML デプロイメント記述子ファイルを使用して Bean 検証を構成します。
- validation.xml ファイルを作成するには、WebSphere® Developer Tools でをクリックします。
- 新規制約マッピングを作成するには、以下のステップを実行します。
- validation.xml ファイルをダブルクリックして、「Bean 検証構成エディター (Bean Validation configuration editor)」で開きます。
- 「検証の構成 (Validation Configuration)」を選択して、「追加」をクリックします。
- 「制約マッピング (Constraint Mapping)」を選択して、「OK」をクリックします。
- 「制約宣言ファイルの作成 (Create constraints declaration file)」ウィザードを開くには、「詳細」セクションの「参照」をクリックします。
- 「終了」をクリックします。
制約マッピングは、validation.xml ファイル内で <constraint-mapping> タグによって宣言されます。制約マッピング・ファイルは、命名方式に従いません。ファイルは、アーカイブの META-IF/validation ディレクトリーに自動的に配置されます。
- デプロイメント記述子エディターを使用して、アプリケーション・ロジックで使用する検証の制約を構成して宣言します。