CRUD operations like a breeze for AdminFaces applications based on Apache DeltaSpike Data module.

This module depends on JSF, CDI and JPA and was tested with respective implementations and versions:

Following are the steps you need to follow in order to use Admin Persistence:

1. Classpath

   First include it in your classpath:

   <dependency>
       <groupId>com.github.adminfaces</groupId>
       <artifactId>admin-persistence</artifactId>
       <version>1.0.7</version>
   </dependency>

   ❗

   Admin persistence will bring the following transitive dependencies: <dependency> <groupId>org.primefaces</groupId> <artifactId>primefaces</artifactId> <version>7.0</version> </dependency> <dependency> <groupId>org.apache.deltaspike.core</groupId> <artifactId>deltaspike-core-impl</artifactId> <version>1.8.2</version> </dependency> <dependency> <groupId>org.apache.deltaspike.core</groupId> <artifactId>deltaspike-core-api</artifactId> <version>1.8.2</version> </dependency> <dependency> <groupId>org.apache.deltaspike.modules</groupId> <artifactId>deltaspike-data-module-api</artifactId> <version>1.8.2</version> </dependency> <dependency> <groupId>org.apache.deltaspike.modules</groupId> <artifactId>deltaspike-data-module-impl</artifactId> <version>1.8.2</version> </dependency> Of cource you can override them in your pom.xml as needed.

2. JPA Metamodel

   As Admin Persistence uses DeltaSpike typesafe criteria you’ll need to generate JPA metamodel. There are various ways to do that, here is a maven plugin example:

   <plugin>
       <groupId>com.mysema.maven</groupId>
       <artifactId>apt-maven-plugin</artifactId>
       <version>1.1.3</version>
       <executions>
           <execution>
               <id>metamodel</id>
               <goals>
                   <goal>process</goal>
               </goals>
               <configuration>
                   <outputDirectory>target/generated-sources/metamodel</outputDirectory>
                   <processor>org.hibernate.jpamodelgen.JPAMetaModelEntityProcessor</processor>
               </configuration>
           </execution>
       </executions>
       <dependencies>
           <dependency>
               <groupId>org.hibernate</groupId>
               <artifactId>hibernate-jpamodelgen</artifactId>
               <version>4.3.8.Final</version>
           </dependency>
       </dependencies>
   </plugin>

   💡	See this tutorial for configuring it on your IDE.

3. Entity Manager

   Admin persistence needs an exposed entity manager as CDI Bean, you can do that by using a CDI producer:

   @ApplicationScoped
   public class EntityManagerProducer {
   
       @PersistenceContext
       EntityManager em;
   
       @Produces
       public EntityManager produce() {
           return em;
       }
   }

4. Persistence Entity

   Every JPA entity must be typed as a PersistenceEntity, it is an interface with only a method, getId():

   import com.github.adminfaces.persistence.model.PersistenceEntity;
   
   @Entity
   @Table(name = "car")
   public class Car implements PersistenceEntity {
   
   @Override
   public Integer getId() {
           return id;
       }
   
   }

   💡	You can extend BaseEntity to gain equals(),hashCode() and toString().

5. Service layer

   Now to create a service which will hold your business logic you need to extend CrudService:

   @Stateless
   public class CarService extends CrudService<Car, Integer>  {
   
   }

   💡	Full source code for CarService can be found here.

   ℹ️	For some examples of CrudService usage see integration tests here.

6. Controller

   Finally on the controller layer (JSF managed beans) you need to extend CrudMB which will enable CRUD support for your JSF pages:

   @Named
   @ViewScoped
   public class CarListMB extends CrudMB<Car> implements Serializable {
   
       @Inject
       CarService carService;
   
       @Inject
       @Service
       CrudService<Car, Integer> crudService; //generic injection
   
       @Inject
       public void initService() {
          setCrudService(carService); (1)
       }
   
   }

   1. Needed by CrudMB otherwise it will throw an exception asking for CrudService initialization.

   💡	You can use @BeanService annotation to provide CrudService: @Named @ViewScoped @BeanService(CarService.class)//use annotation instead of setter injection public class CarListMB extends CrudMB<Car> implements Serializable { }

   💡	Full source code for CarListMB can be found here.

Real pagination involves lots of boilerplate code, in admin-persistence it is a matter of using a Primefaces lazy datatable and bind it to the CrudMB list variable:

For filtering on the lazy datatable you just need to override configRestrictions method in the managed bean’s service (the service we set in CarListMB) and add your restrictions based on a filter:

For an example project using Admin Persistence see admin-starter-persistence.

Snapshots are published to maven central on each commit, to use it just declare the repository below on your pom.xml: