org.josef.ejb.crud

Class CrudControllerBean

java.lang.Object

org.josef.ejb.crud.CrudControllerBean

All Implemented Interfaces:

CrudControllerLocal, CrudControllerRemote

public class CrudControllerBean
extends Object
implements CrudControllerLocal

CRUD (Create Read Update Delete) Controller Bean using generic methods.
Note: This implementation is quite different from the AbstractCrud... classes that use generic classes. It is quite similar though, to the EntityDataAccess class. Use whichever version you find appropriate.
Note: Even though this is a CRUD controller, its methods reflect the actions uses by JPA like: persist, find, merge and remove respectively.

Version:

1.0 $Revision: 5451 $

Author:

Kees Schotanus

Constructor Summary

Constructors

Constructor and Description
CrudControllerBean()

Method Summary

Modifier and Type	Method and Description
<T> T	findById(Class<T> type, Number primaryKey) Finds a persisted entity by its primary key.
<T> List<T>	findByNamedQuery(Class<T> type, String queryName, Map<String,Object> queryParameters) Finds entities using a named query with the supplied queryName.
<T> T	merge(T entity) Merges the supplied entity with the persisted state of the supplied entity.
<T> T	persist(T entity) Persists (creates) the supplied entity.
<T> void	remove(Class<T> type, Number primaryKey) Removes a previously persisted entity.
String	testLocal() Simple test method to verify this controller works using a local call.
String	testRemote() Simple test method to verify this controller works using a remote call.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CrudControllerBean

public CrudControllerBean()

Method Detail

testRemote

public String testRemote()

Simple test method to verify this controller works using a remote call.

Specified by:

testRemote in interface CrudControllerRemote

Returns:

"Remote!".

testLocal

public String testLocal()

Simple test method to verify this controller works using a local call.

Specified by:

testLocal in interface CrudControllerLocal

Returns:

"Local!".

persist

public <T> T persist(T entity)

Persists (creates) the supplied entity.

Specified by:

persist in interface CrudControllerRemote

Type Parameters:

T - The type of entity to persist.

Parameters:

entity - The entity to persist.

Returns:

The persisted entity.

findById

public <T> T findById(Class<T> type,
                      Number primaryKey)

Finds a persisted entity by its primary key.

Specified by:

findById in interface CrudControllerRemote

Type Parameters:

T - The type of the entity to find.

Parameters:

type - The class type of the entity to find.

primaryKey - The primary key of the entity to find.

Returns:

The entity with the supplied primaryKey or null when no entity with the supplied primary key exists.

merge

public <T> T merge(T entity)

Merges the supplied entity with the persisted state of the supplied entity.

Specified by:

merge in interface CrudControllerRemote

Type Parameters:

T - The type of the entity to merge.

Parameters:

entity - The entity to merge.

Returns:

A copy of the merged state of the supplied entity.

remove

public <T> void remove(Class<T> type,
                       Number primaryKey)

Removes a previously persisted entity.

Specified by:

remove in interface CrudControllerRemote

Type Parameters:

T - The type of the entity to remove.

Parameters:

type - The class type of the entity to remove.

primaryKey - The primary key of the entity to remove.

findByNamedQuery

public <T> List<T> findByNamedQuery(Class<T> type,
                                    String queryName,
                                    Map<String,Object> queryParameters)

Finds entities using a named query with the supplied queryName.

Specified by:

findByNamedQuery in interface CrudControllerRemote

Type Parameters:

T - The type of the entities to find.

Parameters:

type - The class type of the entities to find.

queryName - Name of the named query.

queryParameters - Query parameters of the named query or null when no query parameters exist.

Returns:

List of entities of the supplied type.