Package org.apache.batchee.spi

Interface DataRepresentationService

  • All Superinterfaces:
    BatchService
    All Known Implementing Classes:
    DefaultDataRepresentationService
    public interface DataRepresentationService
extends BatchService
    This SPI takes Data Objects from a JBatch artifact and transfers it into something which can be stored in a Blob in the Database (byte[] in Java). The Objects in question can be parameters passed to a job (jobProperties) or Checkpoint objects from an execution. This service of course also has to implement the other way around. It needs to be able to also read all the things stored in the database and transfer it back to Java objects. In the old days we simply used Java Serialisation to get this byte[]. But this has an obvious downside when it comes to migration, update scenarios and ease of use.

    • Method Detail

      • toInternalRepresentation

        <T> byte[] toInternalRepresentation​(T dataObject)
        Convert the given dataObject into something which can be stored in a BLOB in the database.
        Type Parameters:
        T -
        Parameters:
        dataObject - the object to store or null if no data is to be stored
        Returns:
        the internal representation of the dataObject

      • toJavaRepresentation

        <T> T toJavaRepresentation​(byte[] internalRepresentation)
        Convert the internal representation stored in the PersistenceManagerService to the Java objects needed by the batch artifacts.
        Type Parameters:
        T -
        Parameters:
        internalRepresentation - the String representation which we store in the databas
        Returns:
        the dataObject