Reciprocal Evidence Implementations

When evidence is inserted, modified or removed a hook point is invoked, that by default triggers the reciprocal evidence handler functionality. This new evidence hook point is called the GlobalEvidenceHook and can be found in the curam.core.sl.infrastructure.impl package. The GlobalEvidenceHook Interface allows custom processing to occur after evidence operations have completed.

GlobalEvidenceHook Interface

The GlobalEvidenceHook interface contains the following methods:

postInsertEvidence is invoked after evidence is inserted and accepts two parameters:

• caseKey - the identifier of the case that the evidence belongs to
• evKey - the identifier and type of the evidence

postModifyEvidence is invoked after evidence is modified and accepts two parameters:

• caseKey - the identifier of the case that the evidence belongs to
• evKey - the identifier and type of the evidence

postRemoveEvidence is invoked after evidence is removed and accepts two parameters:

• caseKey - the identifier of the case that the evidence belongs to
• evKey - the identifier and type of the evidence

postDiscardPendingUpdate is invoked after a pending update of evidence is discarded and accepts two parameters:

• caseKey - the identifier of the case that the evidence belongs to
• evKey - the identifier and type of the evidence

postDiscardPendingRemove is invoked after a pending remove of evidence is discarded and accepts two parameters:

• caseKey - the identifier of the case that the evidence belongs to
• evKey - the identifier and type of the evidence

Reciprocal Evidence Handler

The default implementation for the GlobalEvidenceHook invokes the reciprocal evidence handler functionality. The reciprocal evidence handler is responsible for all common reciprocal evidence processing. It locates reciprocal evidence and if found performs the same changes on it that were performed on the original evidence. If the reciprocal evidence is not found, and the original evidence was inserted, then it will insert the corresponding reciprocal evidence. As the reciprocal evidence handler is core to the reciprocal evidence processing it cannot be customized directly, but can be customized by way of the GlobalEvidenceHook, if necessary.

Reciprocal Evidence Conversion Interface

The ReciprocalEvidenceConversion interface is responsible for reciprocal and original evidence comparison, participant retrieval and for creating new and modified reciprocal evidence from original evidence. In order to make custom evidence reciprocal, a ReciprocalEvidenceConversion interface implementation must be provided. While the handler is not aware of the internal evidence structure, the conversion interface implementation is, as a result this is where the main customization point lies. The ReciprocalEvidenceConversion interface can be found in the curam.core.sl.infrastructure.impl package and contains the following methods:

• Object getReciprocal(final Object original, final long targetCaseID) - Creates reciprocal evidence details from the original evidence details
• Object getUpdatedReciprocal(final Object original, final Object unmodifiedReciprocal) - Creates modified reciprocal evidence details from the original evidence details and from un-modified reciprocal evidence details
• long getPrimaryParticipant(final Object originalEvidence) - Retrieves the primary participant (concern role ID) from the original evidence. Note that the primary participant on the original evidence is the related participant on the reciprocal evidence
• long getRelatedParticipant(final Object originalEvidence) - Retrieves related participant (concern role ID) from the original evidence. Note that the related participant on the original evidence is the primary participant on the reciprocal evidence
• boolean matchEvidenceDetails(final Object evidenceDetails1, final Object evidenceDetails2) - Checks evidence details for a match. Implementation of this method determines if two evidence details passed in are considered as a match.

The following section demonstrates how to implement reciprocal evidence.