AbstractService (Gemma 1.29.8 API)

java.lang.Object
- ubic.gemma.persistence.service.AbstractService<O>

Type Parameters:

O - the Identifiable Object type that this service is handling.

All Implemented Interfaces:

BaseService<O>

Direct Known Subclasses:

AbstractDesignElementDataVectorService, AbstractVoEnabledService, AnnotationAssociationServiceImpl, AuditTrailServiceImpl, BlatAssociationServiceImpl, ChromosomeServiceImpl, CompoundServiceImpl, ContactServiceImpl, DifferentialExpressionResultServiceImpl, ExperimentalDesignServiceImpl, ExpressionExperimentSubSetServiceImpl, ExternalDatabaseServiceImpl, Gene2GOAssociationServiceImpl, PhenotypeAssociationServiceImpl, PrincipalComponentAnalysisServiceImpl, ProtocolServiceImpl
```
public abstract class AbstractService<O extends Identifiable>
extends Object
implements BaseService<O>
```
Base for all services handling DAO access.

Author:

tesarst

Field Summary

Fields
Modifier and Type Field and Description

protected static org.apache.commons.logging.Log log

Fields
Modifier and Type	Field and Description
`protected static org.apache.commons.logging.Log`	`log`

Constructor Summary

Constructors
Modifier Constructor and Description

protected AbstractService(BaseDao<O> mainDao)

Constructors
Modifier	Constructor and Description
`protected`	`AbstractService(BaseDao<O> mainDao)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`long`	`countAll()`
`Collection<O>`	`create(Collection<O> entities)` Creates all the given entities in a persistent storage
`O`	`create(O entity)` Creates the given entity in the persistent storage.
`O`	`find(O entity)` Does a search for the entity in the persistent storage
`O`	`findOrCreate(O entity)` Does a search for the entity in the persistent storage, and if not found, creates it.
`O`	`findOrFail(O entity)`
`Collection<O>`	`load(Collection<Long> ids)` Loads objects with given ids.
`O`	`load(Long id)` Loads object with given ID.
`Collection<O>`	`loadAll()` Loads all the entities of specific type.
`O`	`loadOrFail(Long id)` Convenience for running `BaseService.load(Long)` and checking if the result is null.
`void`	`remove(Collection<O> entities)` Removes all the given entities from persistent storage.
`void`	`remove(Long id)` Removes the entity with given ID from the persistent storage.
`void`	`remove(O entity)` Removes the given entity from the persistent storage.
`void`	`removeAll()` Remove all entities from the persistent storage.
`Collection<O>`	`save(Collection<O> entities)`
`O`	`save(O entity)`
`void`	`update(Collection<O> entities)` Updates all entities in the given collection in the persistent storage.
`void`	`update(O entity)` Updates the given entity in the persistent storage.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - log
```
protected static final org.apache.commons.logging.Log log
```
- Constructor Detail
  - AbstractService
```
protected AbstractService(BaseDao<O> mainDao)
```
- Method Detail
  - find
```
@Transactional(readOnly=true)
public O find(O entity)
```
    Description copied from interface: BaseService
    
    Does a search for the entity in the persistent storage
    
    Specified by:
    
    find in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    entity - the entity to be searched for
    
    Returns:
    
    the version of entity retrieved from the persistent storage, if found, otherwise null.
  - findOrFail
```
@Nonnull
 @Transactional(readOnly=true)
public O findOrFail(O entity)
```
    Specified by:
    
    findOrFail in interface BaseService<O extends Identifiable>
  - findOrCreate
```
@Transactional
public O findOrCreate(O entity)
```
    Description copied from interface: BaseService
    
    Does a search for the entity in the persistent storage, and if not found, creates it.
    
    Specified by:
    
    findOrCreate in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    entity - the entity to look for, and create if not found.
    
    Returns:
    
    the entity retrieved from the persistent storage, either found or created.
  - create
```
@Transactional
public Collection<O> create(Collection<O> entities)
```
    Description copied from interface: BaseService
    
    Creates all the given entities in a persistent storage
    
    Specified by:
    
    create in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    entities - the entities to be created.
    
    Returns:
    
    collection of objects referencing the persistent instances of given entities.
  - create
```
@Transactional
 @OverridingMethodsMustInvokeSuper
public O create(O entity)
```
    Description copied from interface: BaseService
    
    Creates the given entity in the persistent storage.
    
    Specified by:
    
    create in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    entity - the entity to be created.
    
    Returns:
    
    object referencing the persistent instance of the given entity.
  - save
```
@Transactional
public Collection<O> save(Collection<O> entities)
```
    Specified by:
    
    save in interface BaseService<O extends Identifiable>
    
    See Also:
    
    BaseDao.save(Collection)
  - save
```
@Transactional
 @OverridingMethodsMustInvokeSuper
public O save(O entity)
```
    Specified by:
    
    save in interface BaseService<O extends Identifiable>
    
    See Also:
    
    BaseDao.save(Object)
  - load
```
@Transactional(readOnly=true)
public Collection<O> load(Collection<Long> ids)
```
    Description copied from interface: BaseService
    
    Loads objects with given ids.
    
    Specified by:
    
    load in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    ids - the ids of objects to be loaded.
    
    Returns:
    
    collection containing object with given IDs.
  - load
```
@Transactional(readOnly=true)
public O load(Long id)
```
    Description copied from interface: BaseService
    
    Loads object with given ID.
    
    Specified by:
    
    load in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    id - the ID of entity to be loaded.
    
    Returns:
    
    the entity with matching ID, or null if the entity does not exist or if the passed ID was null
  - loadOrFail
```
@Nonnull
 @Transactional(readOnly=true)
public O loadOrFail(Long id)
```
    Description copied from interface: BaseService
    
    Convenience for running BaseService.load(Long) and checking if the result is null.
    
    Specified by:
    
    loadOrFail in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    id - the ID used to retrieve the entity
    
    Returns:
    
    the entity as per BaseService.load(Long), never null
  - loadAll
```
@Transactional(readOnly=true)
public Collection<O> loadAll()
```
    Description copied from interface: BaseService
    
    Loads all the entities of specific type.
    
    Specified by:
    
    loadAll in interface BaseService<O extends Identifiable>
    
    Returns:
    
    collection of all entities currently available in the persistent storage.
  - countAll
```
@Transactional(readOnly=true)
public long countAll()
```
    Specified by:
    
    countAll in interface BaseService<O extends Identifiable>
  - remove
```
@Transactional
public void remove(Collection<O> entities)
```
    Description copied from interface: BaseService
    
    Removes all the given entities from persistent storage.
    
    Specified by:
    
    remove in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    entities - the entities to be removed.
  - remove
```
@Transactional
public void remove(Long id)
```
    Description copied from interface: BaseService
    
    Removes the entity with given ID from the persistent storage.
    
    Specified by:
    
    remove in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    id - the ID of entity to be removed.
  - remove
```
@Transactional
 @OverridingMethodsMustInvokeSuper
public void remove(O entity)
```
    Description copied from interface: BaseService
    
    Removes the given entity from the persistent storage.
    
    Specified by:
    
    remove in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    entity - the entity to be removed.
  - removeAll
```
@Transactional
public void removeAll()
```
    Description copied from interface: BaseService
    
    Remove all entities from the persistent storage.
    
    Specified by:
    
    removeAll in interface BaseService<O extends Identifiable>
  - update
```
@Transactional
public void update(Collection<O> entities)
```
    Description copied from interface: BaseService
    
    Updates all entities in the given collection in the persistent storage.
    
    Specified by:
    
    update in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    entities - the entities to be updated.
  - update
```
@Transactional
 @OverridingMethodsMustInvokeSuper
public void update(O entity)
```
    Description copied from interface: BaseService
    
    Updates the given entity in the persistent storage.
    
    Specified by:
    
    update in interface BaseService<O extends Identifiable>
    
    Parameters:
    
    entity - the entity to be updated.

Class AbstractService<O extends Identifiable>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

log

Constructor Detail

AbstractService

Method Detail

find

findOrFail

findOrCreate

create

create

save

save

load

load

loadOrFail

loadAll

countAll

remove

remove

remove

removeAll

update

update