org.universAAL.ri.api.manager.server.persistence

Class PersistenceDerby

java.lang.Object

org.universAAL.ri.api.manager.server.persistence.PersistenceDerby

All Implemented Interfaces:

Persistence

public class PersistenceDerby
extends Object
implements Persistence

An implementation of the Persistence interface using Apache Derby SQL Database.

Author:

alfiva

Constructor Summary

Constructors

Constructor and Description
PersistenceDerby()

Method Summary

Modifier and Type	Method and Description
boolean	checkUser(String id) Check if a user is already persisted with an associated password pair.
boolean	checkUserPWD(String id, String pwd) Method that checks the proper authentication of a persisted user-password pair.
void	init(RemoteAPI remoteAPI, ModuleContext context) Sets up the underlying database, creating any tables if not present before, and performing any mainenance operations.
void	removeOlderThan(Long millis) Maintenance method that removes all stored data from all tables that was introduced more than @param millis ago.
void	removeRegister(String id) Eliminate all persisted info (node registration, subscribers and callees) of a remote node
void	restore() Restore in the R-API implementation (and consequently in the MW) all the persisted information (registration, subscribers and callees) for all nodes.
void	storeCallee(String id, String profile) Persist a request to have a service callee for a node
void	storeRegister(String id, String remote, String v) Persist a request to have a registration of a remote node
void	storeSubscriber(String id, String pattern) Persist a request to have a context subscriber for a node
void	storeUserPWD(String id, String pwd) Store a new user-password pair for later authentication.

Methods inherited from class java.lang.Object

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

Constructor Detail

PersistenceDerby

public PersistenceDerby()

Method Detail

init

public void init(RemoteAPI remoteAPI,
                 ModuleContext context)

Description copied from interface: Persistence

Sets up the underlying database, creating any tables if not present before, and performing any mainenance operations.

Specified by:

init in interface Persistence

Parameters:

remoteAPI - The Remote API instance being used in the manager

context - Module Context of universAAL

storeRegister

public void storeRegister(String id,
                          String remote,
                          String v)

Description copied from interface: Persistence

Persist a request to have a registration of a remote node

Specified by:

storeRegister in interface Persistence

Parameters:

id - The id used to uniquely identify the remote node

remote - The remote access information for a remote node

v - The version of client invoking the API. Descriptive only. Can be null.

storeSubscriber

public void storeSubscriber(String id,
                            String pattern)

Description copied from interface: Persistence

Persist a request to have a context subscriber for a node

Specified by:

storeSubscriber in interface Persistence

Parameters:

id - The id used to uniquely identify the remote node

pattern - The serialized ContextEventPattern sent by the remote node in the request

storeCallee

public void storeCallee(String id,
                        String profile)

Description copied from interface: Persistence

Persist a request to have a service callee for a node

Specified by:

storeCallee in interface Persistence

Parameters:

id - The id used to uniquely identify the remote node

profile - The serialized ServiceProfile sent by the remote node in the request

removeRegister

public void removeRegister(String id)

Description copied from interface: Persistence

Eliminate all persisted info (node registration, subscribers and callees) of a remote node

Specified by:

removeRegister in interface Persistence

Parameters:

id - The id used to uniquely identify the remote node

restore

public void restore()

Description copied from interface: Persistence

Restore in the R-API implementation (and consequently in the MW) all the persisted information (registration, subscribers and callees) for all nodes.

Specified by:

restore in interface Persistence

removeOlderThan

public void removeOlderThan(Long millis)

Maintenance method that removes all stored data from all tables that was introduced more than @param millis ago. Removal is not accurate to the millisecond, it rounds to the day.

Parameters:

millis - Minimum age, in milliseconds, at which the data will be removed (data older than this will be removed)

storeUserPWD

public void storeUserPWD(String id,
                         String pwd)

Description copied from interface: Persistence

Store a new user-password pair for later authentication. There is no "change" method for this, so any change will require manual modification of the persistence.

Specified by:

storeUserPWD in interface Persistence

Parameters:

id - User

pwd - Password

checkUserPWD

public boolean checkUserPWD(String id,
                            String pwd)

Description copied from interface: Persistence

Method that checks the proper authentication of a persisted user-password pair.

Specified by:

checkUserPWD in interface Persistence

Parameters:

id - User

pwd - Password

Returns:

true if pwd matches the initially stored value and no errors occured

checkUser

public boolean checkUser(String id)

Description copied from interface: Persistence

Check if a user is already persisted with an associated password pair.

Specified by:

checkUser in interface Persistence

Parameters:

id - to check

Returns:

true if there is already a user-password pair persisted.