abk.dao
Interface IDataMap<K,T>

Type Parameters:

K - Tipo de la clave de la entidad.

T - Tipo del objeto, extensión de ADataItem.

All Superinterfaces:

Map<K,T>

All Known Implementing Classes:

ADataMap, MockDataMap

public interface IDataMap<K,T>
extends Map<K,T>

Interfaz que representa acciones típicas de mapas de clave-valor habituales cuando existe detrás una capa de persistencia que respalda al mapa.

El mapa además de implementar estos métodos, debe rechazar el uso de claves o valores nulos.

Se supone que el mapa de datos almacena o respalda copias de los elementos. En consecuencia, las operaciones estándar de un Map deben realizarse guardando o devolviendo copias de las instancias que recibe o que almacena.

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Method Summary

boolean	delete(K key) Borra del mapa el elmento asociado a la clave que se le pasa.
int	deleteAll() Borra todos los elementos del mapa.
K	insert(T data) Realiza una inserción del objeto en el mapa, generando una clave automática.
boolean	load(T data) Rellena los datos de la entidad con los datos de la instancia del mapa cuya clave coincida con la del objeto que se le pasa.
T	put(T data) Realiza una operación de inserción o de actualización del objeto en el mapa, en función de que ya haya una instancia con la misma clave.
void	save(T data) Inserta en el mapa el objeto indicado, que debe tener una clave diferente a los ya existentes.
void	saveAll(Iterable<? extends T> all) Graba una copia profunda de todos los objetos que se le pasan.
boolean	update(T data) Actualiza un objeto del mapa con los datos de otro que se le pasa.

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values

Method Detail

load

boolean load(T data)

Rellena los datos de la entidad con los datos de la instancia del mapa cuya clave coincida con la del objeto que se le pasa. A diferencia de Map.get(Object), se garantiza que el objeto recuperado es una copia profunda del objeto del mapa. Nunca será el mismo objeto.

Parameters:

data - Entidad a cargar. El campo con la clave debe estar inicializado.

Returns:

Devuelve true si el dato se ha cargado, o false si no se ha encontrado el objeto con la misma clave que data.

Throws:

NullPointerException - si data es nulo, o lo es su clave.

save

void save(T data)

Inserta en el mapa el objeto indicado, que debe tener una clave diferente a los ya existentes.

Parameters:

data - Instancia que se quiere grabar.

Throws:

NullPointerException - si data es nulo, o lo es su clave.

IllegalArgumentException - si ya existe una entrada con la misma clave que data o si se produce un error general de acceso al mapa.

saveAll

void saveAll(Iterable<? extends T> all)

Graba una copia profunda de todos los objetos que se le pasan.

Parameters:

all - Lista de objetos a grabar.

Throws:

NullPointerException - si alguno de los elementos es nulo, o lo es su clave.

IllegalArgumentException - si para alguno de los elementos ya existe una entrada con la misma clave.

insert

K insert(T data)

Realiza una inserción del objeto en el mapa, generando una clave automática.

Parameters:

data - Objeto a insertar en la base de datos. Su propiedad key es ignorada.

Returns:

La clave asignada al registro insertado, o null si la inserción ha fallado.

Throws:

NullPointerException - si data es nulo, o lo es su clave.

update

boolean update(T data)

Actualiza un objeto del mapa con los datos de otro que se le pasa.

Parameters:

data - Datos para actualizar.

Returns:

true si la operación se realizó con éxito.

Throws:

NullPointerException - si alguno de los elementos es nulo, o lo es su clave.

put

T put(T data)

Realiza una operación de inserción o de actualización del objeto en el mapa, en función de que ya haya una instancia con la misma clave.

Parameters:

data -

Returns:

Objeto con los valores que figuraban en la base de datos, o null si no había ningún registro con la misma clave de data.

Throws:

NullPointerException - si data es nulo, o lo es su clave.

delete

boolean delete(K key)

Borra del mapa el elmento asociado a la clave que se le pasa.

Parameters:

key - Clave del elemento a eliminar del mapa.

Returns:

true si la clave identificaba a un registro y éste ha sido borrado. false en otro caso, incluyendo que key sea nulo.

deleteAll

int deleteAll()

Borra todos los elementos del mapa.

Returns:

Número de elementos que se han borrado, el número de valores que tenía el mapa.