Package jakarta.data.repository

Annotation Interface Repository

@Documented @Retention(RUNTIME) @Target(TYPE) public @interface Repository

Annotates a repository interface to be implemented by the container/runtime.

This class is a CDI bean-defining annotation when CDI is available. Regardless of whether CDI or custom dependency injection is used, the repository implementation must be made available to applications via the jakarta.inject.Inject annotation.

For example,

 @Repository
 public interface Products extends DataRepository<Product, Long> {

     @OrderBy("price")
     List<Product> findByNameLike(String namePattern);

     @Query("UPDATE Product SET price = price - (price * ?1) WHERE price * ?1 <= ?2")
     int putOnSale(float rateOfDiscount, float maxDiscount);

     ...
 }
 
 @Inject
 Products products;

 ...
 found = products.findByNameLike("%Printer%");
 numUpdated = products.putOnSale(0.15f, 20.0f);

The module Javadoc provides an overview of Jakarta Data.

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    String
    dataStore
    Optionally indicates the data store to use for the repository.
    String
    provider
    Restricts the repository implementation to that of a specific Jakarta Data provider.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    ANY_PROVIDER
    Value for the provider() attribute that allows the use of any available Jakarta Data provider that supports the type of entity annotation that is present on the repository's entity class.
    static final String
    DEFAULT_DATA_STORE
    Value for the dataStore() attribute that indicates to use a default data store.

  • Field Details

    • ANY_PROVIDER

      static final String ANY_PROVIDER
      Value for the provider() attribute that allows the use of any available Jakarta Data provider that supports the type of entity annotation that is present on the repository's entity class.
      See Also:

    • DEFAULT_DATA_STORE

      static final String DEFAULT_DATA_STORE

      Value for the dataStore() attribute that indicates to use a default data store.

      When running in a Jakarta EE profile or platform and the entity annotations indicate a relational database, the default data store is the Jakarta EE default data source, java:comp/DefaultDataSource. Otherwise, the default data store is determined by the Jakarta Data provider.

      The default data store might require additional vendor-specific configuration, depending on the vendor.

      See Also:

  • Element Details

    • dataStore

      String dataStore

      Optionally indicates the data store to use for the repository.

      Precedence for interpreting the dataStore value is as follows, from highest precedence to lowest precedence.

      • If running in an environment where Jakarta Config is available and the value is found in Jakarta Config, an error is raised. Interoperability with Jakarta Config is reserved for future versions of Jakarta Data.
      • If running in a Jakarta EE profile or platform and the entity annotations indicate a relational database and the value begins with java: and matches the name of a jakarta.annotation.sql.DataSourceDefinition, the JNDI name of a data source, or a resource reference to a data source, then the corresponding javax.sql.DataSource is used as the data store. If the same conditions are met but the value matches a persistence unit reference, then the corresponding jakarta.persistence.PersistenceUnit is used as the data store.
      • Otherwise, the value serves as an identifier linking to vendor-specific configuration for the Jakarta Data provider to interpret in a vendor-specific way. Refer to the documentation of the Jakarta Data provider.

      The default value of this attribute is DEFAULT_DATA_STORE.

      Returns:
      the name of a data store or DEFAULT_DATA_STORE.
      Default:
      ""

    • provider

      String provider

      Restricts the repository implementation to that of a specific Jakarta Data provider.

      This is useful when multiple Jakarta Data providers support the same type of entity annotation, in which case the provider attribute clarifies which Jakarta Data provider must be used. Jakarta Data providers must ignore Repository annotations that indicate a different provider's name as the provider.

      The default value of this attribute is ANY_PROVIDER, allowing the use of any available Jakarta Data provider that supports the type of entity annotation that is present on the repository's entity class.

      Returns:
      the name of a Jakarta Data provider or ANY_PROVIDER.
      Default:
      ""