Hibernate.orgCommunity Documentation

Preface

This guide describes how to download, install, configure, and run the Technology Compatibility Kit (TCK) used to verify the compatibility of an implementation of JSR 349: Bean Validation 1.1.

The Bean Validation TCK is built atop Arquillian, a portable and configurable automated test suite for authoring unit and integration tests in a Java EE environment.

The Bean Validation TCK is provided under the Apache Public License 2.0.

1. Who Should Use This Guide

This guide is for implementors of the Bean Validation specification to assist in running the test suite that verifies the compatibility of their implementation.

2. Before You Read This Guide

The Bean Validation TCK is based on the Bean Validation specification 1.1 (JSR 349). Information about the specification can be found on the JSR-349 JCP page.

3. How This Guide Is Organized

If you are running the Bean Validation TCK for the first time, read Chapter 1, Introduction completely for the necessary background information about the TCK. Once you have reviewed that material, perform the steps outlined in the remaining chapters.

  • Chapter 1, Introduction gives an overview of the principles that apply generally to all Technology Compatibility Kits (TCKs), outlines the appeals process and describes the Bean Validation TCK architecture and components.

  • Chapter 2, Appeals Process explains the process to be followed by an implementor should they wish to challenge any test in the TCK.

  • Chapter 3, Installation explains where to obtain the required software for the Bean Validation TCK and how to install it.

  • Chapter 4, Reports explains the test reports that are generated by the TCK test suite and introduces the TCK audit report as a tool for measuring the completeness of the TCK in testing the JSR 349 specification and in understanding how test cases relate to the specification.

  • Chapter 5, Running the TCK test suite details the configuration of the test harness and documents how to create a TCK runner for executing the TCK test suite, either in standalone or container mode.

  • Chapter 6, Running the Signature Test finally documents how to use the SigTest tool for ensuring compatibility of types provided in the package javax.validation.* with the official API signature defined by the specification.

Copyright © 2009 - 2014 Red Hat, Inc.