Server - Methods to Be Implemented

The facade operation calls the evidence service layer implementation.

// ______________________________________________________________
/**
 * Reads an Asset evidence record.
 *
 * @param key Identifies the evidence record to read.
 *
 * @return The details of the evidence record.
 */
public ReadAssetEvidenceDetails readAssetEvidence(
  EvidenceCaseKey key)
    throws AppException, InformationalException {

  // Asset evidence manipulation object
  Asset evidenceObj = AssetFactory.newInstance();

  // return object
  ReadAssetEvidenceDetails readEvidenceDetails =
    new ReadAssetEvidenceDetails();

  // read the Asset record and populate the return details
  readEvidenceDetails = evidenceObj.readAssetEvidence(key);  

  return readEvidenceDetails;

}

This service layer operation calls the Evidence Controller infrastructure function for reading evidence.

// ______________________________________________________________
/**
 * Reads an Asset record.
 *
 * @param key contains ID of record to read.
 *
 * @return Asset evidence details read.
 */
public ReadAssetEvidenceDetails readAssetEvidence(
  EvidenceCaseKey key)
    throws AppException, InformationalException {

  // EvidenceController business object
  EvidenceControllerInterface evidenceControllerObj =
    (EvidenceControllerInterface)
      EvidenceControllerFactory.newInstance();

  EIEvidenceKey eiEvidenceKey = new EIEvidenceKey();
  eiEvidenceKey.evidenceID = key.evidenceKey.evidenceID;
  eiEvidenceKey.evidenceType = CASEEVIDENCE.ASSET;

  // Retrieve the evidence details
  EIEvidenceReadDtls eiEvidenceReadDtls =
    evidenceControllerObj.readEvidence(eiEvidenceKey);

  // Retrieve the evidence descriptor details
  EvidenceDescriptor evidenceDescriptorObj =
    EvidenceDescriptorFactory.newInstance();

  EvidenceDescriptorKey evidenceDescriptorKey = 
    new EvidenceDescriptorKey();
  evidenceDescriptorKey.evidenceDescriptorID =
    eiEvidenceReadDtls.descriptor.evidenceDescriptorID;

  EvidenceDescriptorDtls evidenceDescriptorDtls =
    evidenceDescriptorObj.read(evidenceDescriptorKey);

  //
  // Return the evidence
  //

  ReadAssetEvidenceDetails readEvidenceDetails =
    new ReadAssetEvidenceDetails();
  readEvidenceDetails.descriptor
    .assign(evidenceDescriptorDtls);

  readEvidenceDetails.descriptor.approvalRequestStatus =
    eiEvidenceReadDtls.descriptor.approvalRequestStatus;
  readEvidenceDetails.descriptor.updatedBy =
    eiEvidenceReadDtls.descriptor.updatedBy;
  readEvidenceDetails.descriptor.updatedDateTime =
    eiEvidenceReadDtls.descriptor.updatedDateTime;

  // assign the evidence to the return object
  readEvidenceDetails.dtls.assign(
    (AssetDtls)(eiEvidenceReadDtls.evidenceObject));

  return readEvidenceDetails;
}