org.drombler.commons.data

Class DataHandlerRegistry

java.lang.Object

org.drombler.commons.data.DataHandlerRegistry

All Implemented Interfaces:

AutoCloseable

public class DataHandlerRegistry
extends Object
implements AutoCloseable

A registry for all open data handlers with a non-null unique key.

Author:

puce

Constructor Summary

Constructors

Constructor and Description
DataHandlerRegistry() Creates a new instance of this class.

Method Summary

Modifier and Type	Method and Description
void	close()
<K,D extends DataHandler<K>> boolean	containsDataHandlerForUniqueKey(Class<D> type, K uniqueKey) Checks if there is a registered DataHandler for the provided unique key.
<K,D extends DataHandler<K>> D	getDataHandler(Class<D> type, K uniqueKey) Gets the DataHandler for the provided unique key.
<K,D extends DataHandler<K>> D	registerDataHandler(D dataHandler) Registers a DataHandler.
void	unregisterDataHandler(DataHandler<?> dataHandler) Unregisters a DataHandler.

Methods inherited from class java.lang.Object

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

Constructor Detail

DataHandlerRegistry

public DataHandlerRegistry()

Creates a new instance of this class.

Method Detail

registerDataHandler

public <K,D extends DataHandler<K>> D registerDataHandler(D dataHandler)

Registers a DataHandler.

If a data handler is already registered for the unique key, the registered data handler will be returned. Use the returned data handler.

If the unique key of the data handler is non-null, the data handler is registered immediately. Else the unique key property of the data handler will be observed for changes and once it's non-null, the data handler will be registerd.

Note: Always work with the returned data handler!

Type Parameters:

K - the type of the unique key of the data handler

D - the type of the data handler

Parameters:

dataHandler - the data handler

Returns:

the provided data handler or the already registered data handler for the unique key (which is expected to have the same type), if there is any, or the observed data handler for null unique keys

unregisterDataHandler

public void unregisterDataHandler(DataHandler<?> dataHandler)

Unregisters a DataHandler.

Parameters:

dataHandler - the data handler to unregister

containsDataHandlerForUniqueKey

public <K,D extends DataHandler<K>> boolean containsDataHandlerForUniqueKey(Class<D> type,
                                                                            K uniqueKey)

Checks if there is a registered DataHandler for the provided unique key.

Type Parameters:

K - the type of the unique key of the data handler

D - the type of the data handler

Parameters:

type - the type of the data handler

uniqueKey - the unique key of the data handler

Returns:

true, if this registry contains a data handler for the provided unique key, else false

getDataHandler

public <K,D extends DataHandler<K>> D getDataHandler(Class<D> type,
                                                     K uniqueKey)

Gets the DataHandler for the provided unique key.

Type Parameters:

K - the type of the unique key of the data handler

D - the type of the data handler

Parameters:

type - the type of the data handler

uniqueKey - the unique key of the data handler

Returns:

the data handler for the specified unique key, if there is any, else null

close

public void close()

Specified by:

close in interface AutoCloseable