Package com.inet.report.cache.store

Class CachedOutput

java.lang.Object
com.inet.report.cache.store.CachedOutput
All Implemented Interfaces:
DocumentOutput, Comparable<CachedOutput>
public class CachedOutput extends Object implements DocumentOutput, Comparable<CachedOutput>
Implementation of DocumentOutput that saves in the report cache.
Since:
16.2

  • Constructor Details

    • CachedOutput

      public CachedOutput(ReportCacheKey key, ReportGenerator engine)
      Create a new instance.
      Parameters:
      key - the report key
      engine - the related Engine
      Since:
      16.2

  • Method Details

    • getPageCount

      public int getPageCount()
      Get the current count of pages.
      Specified by:
      getPageCount in interface DocumentOutput
      Returns:
      the page count

    • clear

      public void clear()
      Reset this output in the initial state. So getPageCount() == 0 and getFontCount() == 0.
      Specified by:
      clear in interface DocumentOutput

    • getPageData

      public byte[] getPageData(int idx) throws ArrayIndexOutOfBoundsException
      Get the binary data of a page/chunk.
      Specified by:
      getPageData in interface DocumentOutput
      Parameters:
      idx - the index, starts with 1
      Returns:
      the data, never null
      Throws:
      ArrayIndexOutOfBoundsException - if index is out of range

    • getGroupTree

      public byte[] getGroupTree()
      Get the data of the group tree.
      Specified by:
      getGroupTree in interface DocumentOutput
      Returns:
      Can be null, if not set.

    • addPage

      public void addPage(byte[] page) throws IllegalStateException
      Add a page/chunk. Increment DocumentOutput.getPageCount()
      Specified by:
      addPage in interface DocumentOutput
      Parameters:
      page - the binary data, never null
      Throws:
      IllegalStateException - if this output is finish or stopped.

    • setPageData

      public void setPageData(byte[] page, int idx) throws IllegalStateException
      Override/patched an existing page/chunk.
      Specified by:
      setPageData in interface DocumentOutput
      Parameters:
      page - die binary data, never null
      idx - the index, starts with 1
      Throws:
      IllegalStateException - if this output is finish or stopped.

    • setGroupTree

      public void setGroupTree(byte[] data) throws IllegalStateException
      Set the group tree. After this call this output is finish and any try to change this object should throw an exception. This call does not change DocumentOutput.getPageCount().
      Specified by:
      setGroupTree in interface DocumentOutput
      Parameters:
      data - the binary data, never null, but can be an empty array
      Throws:
      IllegalStateException - if this output is finish or stopped.

    • setErrorData

      public void setErrorData(byte[] error) throws IllegalStateException
      Set error data. After this call this output is finish and any try to change this object should throw an exception.
      Specified by:
      setErrorData in interface DocumentOutput
      Parameters:
      error - serialized Exception
      Throws:
      IllegalStateException - if this output is finish or stopped.

    • stop

      public void stop(String cause)
      The rendering was stopped. This is called from Engine.stop(). After this call any try to change this object should throw an exception.
      Specified by:
      stop in interface DocumentOutput
      Parameters:
      cause - an optional message

    • addFontData

      public void addFontData(byte[] fontData) throws IllegalStateException
      Add the data for an embedded font. Increment DocumentOutput.getFontCount(). This method is only used from the Java/C# output format.
      Specified by:
      addFontData in interface DocumentOutput
      Parameters:
      fontData - binary data in the current protocol format.
      Throws:
      IllegalStateException - if this output is finish or stopped.

    • setFontData

      public void setFontData(byte[] fontData, int idx) throws IllegalStateException
      Override the font data with a new version.
      Specified by:
      setFontData in interface DocumentOutput
      Parameters:
      fontData - binary data in the current protocol format.
      idx - the index, starts with 0
      Throws:
      IllegalStateException - if this output is finish or stopped.

    • getFontData

      public byte[] getFontData(int idx) throws ArrayIndexOutOfBoundsException
      Get the font data from the given index.
      Specified by:
      getFontData in interface DocumentOutput
      Parameters:
      idx - the index, starts with 0
      Returns:
      the font data, never null
      Throws:
      ArrayIndexOutOfBoundsException - if index is out of range

    • getFontCount

      public int getFontCount()
      Get the count of added fonts.
      Specified by:
      getFontCount in interface DocumentOutput
      Returns:
      the font count

    • setPageLimitExceeded

      public void setPageLimitExceeded()
      Set that a PageLimitException exception occur.
      Specified by:
      setPageLimitExceeded in interface DocumentOutput

    • isPageLimitExceeded

      public boolean isPageLimitExceeded()
      Check if the rendering of the report ran into a page limit. This means does not all possible pages exist.
      Specified by:
      isPageLimitExceeded in interface DocumentOutput
      Returns:
      true, if PageLimitException was occur

    • setUsingTotalPage

      public void setUsingTotalPage()
      Set that a total page is used in the report.
      Specified by:
      setUsingTotalPage in interface DocumentOutput

    • getKey

      public ReportCacheKey getKey()
      Get the key of this DocumentOutput.
      Returns:
      the key
      Since:
      16.3

    • getEngine

      public ReportGenerator getEngine()
      Get the Engine/EngineBundle that produce the data for this output.
      Returns:
      the engine
      Since:
      16.2

    • compareTo

      public int compareTo(CachedOutput o)
      Specified by:
      compareTo in interface Comparable<CachedOutput>