org.protempa.dest.deid

Class DeidentifiedQueryResultsHandler

java.lang.Object

org.protempa.dest.AbstractQueryResultsHandler

org.protempa.dest.deid.DeidentifiedQueryResultsHandler

All Implemented Interfaces:

AutoCloseable, QueryResultsHandler

public final class DeidentifiedQueryResultsHandler
extends AbstractQueryResultsHandler

Implements de-identification. Encrypts keyIds and offsets dates and times.

Author:

Andrew Post

Method Summary

Modifier and Type	Method and Description
void	cancel() Requests cancellation of whatever this object is currently doing.
void	close() Called by Protempa after #handleFinish() to clean up any resources used by the handler.
void	finish() Called by Protempa as soon as all query results have been retrieved from the data source.
String	getId() Gets the query result handler's identifier string for logging and internal purposes.
void	handleQueryResult(String keyId, List<Proposition> propositions, Map<Proposition,List<Proposition>> forwardDerivations, Map<Proposition,List<Proposition>> backwardDerivations, Map<UniqueId,Proposition> references) Handles a single query result, which is the list of propositions associated with the given key.
void	start(Collection<PropositionDefinition> cache) Called by Protempa prior to the first invocation of QueryResultsHandler.handleQueryResult(java.lang.String, java.util.List, java.util.Map, java.util.Map, java.util.Map).
void	validate() Validates this query results handler's specification.

Methods inherited from class org.protempa.dest.AbstractQueryResultsHandler

getDisplayName

Methods inherited from class java.lang.Object

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

Method Detail

getId

public String getId()

Description copied from interface: QueryResultsHandler

Gets the query result handler's identifier string for logging and internal purposes.

Specified by:

getId in interface QueryResultsHandler

Overrides:

getId in class AbstractQueryResultsHandler

Returns:

a string.

validate

public void validate()
              throws QueryResultsHandlerValidationFailedException

Description copied from interface: QueryResultsHandler

Validates this query results handler's specification.

Specified by:

validate in interface QueryResultsHandler

Overrides:

validate in class AbstractQueryResultsHandler

Throws:

QueryResultsHandlerValidationFailedException - if validation failed.

start

public void start(Collection<PropositionDefinition> cache)
           throws QueryResultsHandlerProcessingException

Description copied from interface: QueryResultsHandler

Called by Protempa prior to the first invocation of QueryResultsHandler.handleQueryResult(java.lang.String, java.util.List, java.util.Map, java.util.Map, java.util.Map). Implementers of this method may perform arbitrary processing related to the output of the handler, such as printing out headers of a file or extracting metadata for the handler's output.

Specified by:

start in interface QueryResultsHandler

Overrides:

start in class AbstractQueryResultsHandler

Parameters:

cache - a cache of all of the proposition definitions that were queried.

Throws:

QueryResultsHandlerProcessingException - if any exceptions occur at a lower level.

handleQueryResult

public void handleQueryResult(String keyId,
                              List<Proposition> propositions,
                              Map<Proposition,List<Proposition>> forwardDerivations,
                              Map<Proposition,List<Proposition>> backwardDerivations,
                              Map<UniqueId,Proposition> references)
                       throws QueryResultsHandlerProcessingException

Description copied from interface: QueryResultsHandler

Handles a single query result, which is the list of propositions associated with the given key.

Parameters:

keyId - the identifying key id for the result

propositions - the proposition results for the given key as a newly created List.

Throws:

QueryResultsHandlerProcessingException

finish

public void finish()
            throws QueryResultsHandlerProcessingException

Description copied from interface: QueryResultsHandler

Called by Protempa as soon as all query results have been retrieved from the data source. Will not be called if a previous step failed.

Specified by:

finish in interface QueryResultsHandler

Overrides:

finish in class AbstractQueryResultsHandler

Throws:

QueryResultsHandlerProcessingException - if any exceptions occur at a lower level

close

public void close()
           throws QueryResultsHandlerCloseException

Description copied from interface: QueryResultsHandler

Called by Protempa after #handleFinish() to clean up any resources used by the handler. It is called always, even if a previous step failed.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface QueryResultsHandler

Overrides:

close in class AbstractQueryResultsHandler

Throws:

QueryResultsHandlerCloseException - if any exceptions occur at a lower level

cancel

public void cancel()

Description copied from interface: QueryResultsHandler

Requests cancellation of whatever this object is currently doing. If QueryResultsHandler.finish() has not been called yet, it will be skipped. If QueryResultsHandler.close() has not been called yet, it will be called, and it must finish cleaning up all resources associated with this query results handler.

Specified by:

cancel in interface QueryResultsHandler

Overrides:

cancel in class AbstractQueryResultsHandler