org.fryske_akademy.ejb

Class AbstractCrudService

java.lang.Object

org.fryske_akademy.ejb.AbstractCrudService

All Implemented Interfaces:

Serializable, CrudReadService, CrudWriteService

Direct Known Subclasses:

AbstractCrudServiceEnvers

@DeclareRoles(value="editor")
public abstract class AbstractCrudService
extends Object
implements CrudWriteService

This base class enables you to create minimal crud service beans. All you have to do is override, implement getEntityManager and annotate with

Author:

eduard

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.fryske_akademy.ejb.CrudReadService

CrudReadService.SORTORDER

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_PAGE_SIZE default page size (max results), used when no maximum is given.
static String	EDITORROLE

Constructor Summary

Constructors

Constructor and Description
AbstractCrudService()

Method Summary

Modifier and Type	Method and Description
int	batchCreate(Collection<? extends Serializable> t, Integer flushCount) creates multiple entities, when flushCount != null flushes and clears the entitymanager every flushCount entities.
int	batchDelete(Collection<? extends Serializable> t, Integer flushCount) deletes multiple entities, when flushCount != null flushes and clears the entitymanager every flushCount entities.
int	batchUpdate(Collection<? extends Serializable> t, Integer flushCount) updates multiple entities, when flushCount != null flushes and clears the entitymanager every flushCount entities.
int	count(String namedQuery, List<Param> params) Use in conjunction with CrudReadService.find(java.lang.String, java.util.List, java.lang.Integer, java.lang.Integer, java.lang.Class) or CrudReadService.findNative(java.lang.String, java.util.List, java.lang.Integer, java.lang.Integer, java.lang.Class).
int	countDynamic(List<Param> params, Class type)
<T extends Serializable> T	create(T t) When overriding look into Transactional and roles to use, these are not inherited.
void	delete(Serializable t) When overriding look into Transactional and roles to use, these are not inherited.
<T extends Serializable> T	find(Serializable id, Class<T> type)
<T extends Serializable> List<T>	find(String namedQuery, List<Param> params, Integer first, Integer max, Class<T> type)
<T extends Serializable> List<T>	findAll(Class<T> type)
<T extends Serializable> List<T>	findDynamic(Integer first, Integer pageSize, Map<String,CrudReadService.SORTORDER> sort, List<Param> params, Class<T> type)
<T extends Serializable> List<T>	findNative(String namedNativeQuery, List<Param> params, Integer first, Integer max, Class<T> type)
<T extends Serializable> T	findOne(String namedQuery, List<Param> params, Class<T> type) return one result or null, multiple results throws an exception
protected abstract javax.persistence.EntityManager	getEntityManager()
<T extends AbstractEntity> T	save(T t) create or update depending on AbstractEntity.isTransient().
<T extends Serializable> T	update(T t) When overriding look into Transactional and roles to use, these are not inherited.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_PAGE_SIZE

public static final int DEFAULT_PAGE_SIZE

default page size (max results), used when no maximum is given.

See Also:

Constant Field Values

EDITORROLE

public static final String EDITORROLE

See Also:

Constant Field Values

Constructor Detail

AbstractCrudService

public AbstractCrudService()

Method Detail

getEntityManager

protected abstract javax.persistence.EntityManager getEntityManager()

find

public <T extends Serializable> T find(Serializable id,
                                       Class<T> type)

Specified by:

find in interface CrudReadService

findAll

public <T extends Serializable> List<T> findAll(Class<T> type)

Specified by:

findAll in interface CrudReadService

findDynamic

public <T extends Serializable> List<T> findDynamic(Integer first,
                                                    Integer pageSize,
                                                    Map<String,CrudReadService.SORTORDER> sort,
                                                    List<Param> params,
                                                    Class<T> type)

Specified by:

findDynamic in interface CrudReadService

Type Parameters:

T -

Parameters:

first - defaults to 0

pageSize - defaults to DEFAULT_PAGE_SIZE, negative value means no limit

sort -

params -

type -

Returns:

countDynamic

public int countDynamic(List<Param> params,
                        Class type)

Specified by:

countDynamic in interface CrudReadService

find

public <T extends Serializable> List<T> find(String namedQuery,
                                             List<Param> params,
                                             Integer first,
                                             Integer max,
                                             Class<T> type)

Specified by:

find in interface CrudReadService

Type Parameters:

T -

Parameters:

namedQuery -

params -

first - defaults to 0

max - defaults to DEFAULT_PAGE_SIZE, negative value means no limit

type -

Returns:

findNative

public <T extends Serializable> List<T> findNative(String namedNativeQuery,
                                                   List<Param> params,
                                                   Integer first,
                                                   Integer max,
                                                   Class<T> type)

Specified by:

findNative in interface CrudReadService

Type Parameters:

T -

Parameters:

namedNativeQuery -

params -

first -

max - defaults to DEFAULT_PAGE_SIZE, negative value means no limit

type -

Returns:

count

public int count(String namedQuery,
                 List<Param> params)

Description copied from interface: CrudReadService

Use in conjunction with CrudReadService.find(java.lang.String, java.util.List, java.lang.Integer, java.lang.Integer, java.lang.Class) or CrudReadService.findNative(java.lang.String, java.util.List, java.lang.Integer, java.lang.Integer, java.lang.Class).

Specified by:

count in interface CrudReadService

Returns:

findOne

public <T extends Serializable> T findOne(String namedQuery,
                                          List<Param> params,
                                          Class<T> type)

Description copied from interface: CrudReadService

return one result or null, multiple results throws an exception

Specified by:

findOne in interface CrudReadService

Returns:

create

@RolesAllowed(value="editor")
public <T extends Serializable> T create(T t)

When overriding look into Transactional and roles to use, these are not inherited. If you don't need security, override and use PermitAll.

Specified by:

create in interface CrudWriteService

Type Parameters:

T -

Parameters:

t -

Returns:

save

@RolesAllowed(value="editor")
public <T extends AbstractEntity> T save(T t)

create or update depending on AbstractEntity.isTransient().

Specified by:

save in interface CrudWriteService

Type Parameters:

T -

Parameters:

t -

Returns:

update

@RolesAllowed(value="editor")
public <T extends Serializable> T update(T t)

When overriding look into Transactional and roles to use, these are not inherited. If you don't need security, override and use PermitAll.

Specified by:

update in interface CrudWriteService

Type Parameters:

T -

Parameters:

t -

Returns:

delete

@RolesAllowed(value="editor")
public void delete(Serializable t)

When overriding look into Transactional and roles to use, these are not inherited. If you don't need security, override and use PermitAll.

Specified by:

delete in interface CrudWriteService

Parameters:

t -

batchCreate

@RolesAllowed(value="editor")
public int batchCreate(Collection<? extends Serializable> t,
                                                     Integer flushCount)

creates multiple entities, when flushCount != null flushes and clears the entitymanager every flushCount entities. NOTE that this method executes in one (possibly big) sql transaction!

Specified by:

batchCreate in interface CrudWriteService

Parameters:

t -

flushCount -

Returns:

the number of entities created

batchUpdate

@RolesAllowed(value="editor")
public int batchUpdate(Collection<? extends Serializable> t,
                                                     Integer flushCount)

updates multiple entities, when flushCount != null flushes and clears the entitymanager every flushCount entities. NOTE that this method executes in one (possibly big) sql transaction!

Specified by:

batchUpdate in interface CrudWriteService

Parameters:

t -

flushCount -

Returns:

the number of entities updated

batchDelete

@RolesAllowed(value="editor")
public int batchDelete(Collection<? extends Serializable> t,
                                                     Integer flushCount)

deletes multiple entities, when flushCount != null flushes and clears the entitymanager every flushCount entities. NOTE that this method executes in one (possibly big) sql transaction!

Specified by:

batchDelete in interface CrudWriteService

Parameters:

t -

flushCount -

Returns:

the number of entities deleted