Package com.ibm.fhir.bulkdata.jbatch.export.fast

Class ResourcePayloadReader

  • All Implemented Interfaces:
    javax.batch.api.chunk.ItemReader
    @Dependent
public class ResourcePayloadReader
extends javax.batch.api.chunk.AbstractItemReader
    A high-performance version of the bulk-export job which doesn't support typeFilter and so can use a more efficient mechanism to page through the set of resources filtered by _lastModified. The Java Batch framework separates the reader from the writer. On the face of it, separation of concerns seems like a good idea. However, because the fetching of the data is controlled by the persistence layer and the fact that we may need to end one multi-part upload and continue feeding a new multi-part upload, the separation makes things a lot harder and less readable - there is a lack of cohesion. To address this, we handle both reading and writing in this class, leaving the ItemWriter as a minimal stub. The framework is still leveraged for checkpointing. The readItem() call simply returns an Object if there is more data to process. The ResourceExportCheckpointAlgorithm will always say we need a checkpoint, so the checkpoint will occur immediately after each read/write. The export is complete when readItem() returns null. The export assumes that the persistence layer can efficiently scan forward based on the last_updated time of a resource. It is possible that multiple resources may share the same last_updated time, so this class has to track which resources have already been processed for a given timestamp. This is fairly easy, because the persistence layer must provide the data in order of last_updated. Because the number of resources for a given timestamp is probably very small, it is more efficient to track it this way than asking the persistence layer (e.g. JDBC) to sort. This can cause performance issues, because it negates the benefit of traversing an index in order.

    • Field Detail

      • resourceType

        java.lang.Class<? extends Resource> resourceType

      • fhirResourceType

        java.lang.String fhirResourceType

      • cosBucketName

        java.lang.String cosBucketName

      • cosBucketPathPrefix

        java.lang.String cosBucketPathPrefix

      • resourcesPerObject

        long resourcesPerObject

      • stepCtx

        @Inject
javax.batch.runtime.context.StepContext stepCtx

      • jobContext

        @Inject
javax.batch.runtime.context.JobContext jobContext

    • Constructor Detail

      • ResourcePayloadReader

        public ResourcePayloadReader()
        Public constructor

    • Method Detail

      • open

        public void open​(java.io.Serializable checkpoint)
          throws java.lang.Exception
        Specified by:
        open in interface javax.batch.api.chunk.ItemReader
        Overrides:
        open in class javax.batch.api.chunk.AbstractItemReader
        Throws:
        java.lang.Exception

      • readItem

        public java.lang.Object readItem()
                          throws java.lang.Exception
        Specified by:
        readItem in interface javax.batch.api.chunk.ItemReader
        Specified by:
        readItem in class javax.batch.api.chunk.AbstractItemReader
        Throws:
        java.lang.Exception

      • processPayload

        public java.lang.Boolean processPayload​(ResourcePayload t)
        Process this payload result. Called as a lambda (callback) from the persistence layer. This method collects the payloads into a buffer and will trigger a write of that buffer to COS if we hit a certain threshold.
        Parameters:
        t -
        Returns:

      • isTxTimeExpired

        protected boolean isTxTimeExpired()
        Check to see if the current clock time exceeds the marker time we laid down to stop processing to make sure we commit before the Liberty transaction timeout limit.
        Returns:

      • checkpointInfo

        public java.io.Serializable checkpointInfo()
                                    throws java.lang.Exception
        Specified by:
        checkpointInfo in interface javax.batch.api.chunk.ItemReader
        Overrides:
        checkpointInfo in class javax.batch.api.chunk.AbstractItemReader
        Throws:
        java.lang.Exception

      • close

        public void close()
           throws java.lang.Exception
        Specified by:
        close in interface javax.batch.api.chunk.ItemReader
        Overrides:
        close in class javax.batch.api.chunk.AbstractItemReader
        Throws:
        java.lang.Exception