Class AbstractDocumentDataProvider<S extends Source,SH extends PageSegmentHandle>

java.lang.Object
com.levigo.jadice.web.demo.common.server.dataprovider.AbstractDocumentDataProvider<S,SH>
All Implemented Interfaces:
DocumentDataProvider<S,SH>
Direct Known Subclasses:
ClassPathWithAnnoDocumentDataProvider, ClassPathWithRenderControlsDocumentDataProvider, CompositeDocumentDataProvider, ServerBasedDnDDataProvider

public abstract class AbstractDocumentDataProvider<S extends Source,SH extends PageSegmentHandle> extends Object implements DocumentDataProvider<S,SH>
  • Constructor Details

    • AbstractDocumentDataProvider

      public AbstractDocumentDataProvider()
  • Method Details

    • read

      public final void read(com.levigo.jadice.document.read.Reader reader, S source) throws com.levigo.jadice.document.JadiceException, IOException
      Description copied from interface: DocumentDataProvider
      Reads a part of the document to load. This will be used to initially load the document when a client initiates displaying a document. Please note, that the read method will be called only once during a server-side document read lifecycle. Subsequent reads will trigger the recover method, not a read.
      Specified by:
      read in interface DocumentDataProvider<S extends Source,SH extends PageSegmentHandle>
      Parameters:
      reader - The Reader to load the document.
      source - The Source to read the document from, including a unique identifier.
      Throws:
      com.levigo.jadice.document.JadiceException - Any rendering exceptions reported by the Jadice core.
      IOException - Other exceptions while reading the document.
    • recover

      public final void recover(com.levigo.jadice.document.read.Reader reader, SH sourceHandle) throws com.levigo.jadice.document.JadiceException, RecoverFailedException
      Description copied from interface: DocumentDataProvider
      Partially recovers a Document identified by the given PageSegmentHandle. Sometimes, client applications may request Document instances that have either been removed from cache, garbage-collected due to long inactivity or in consequence of a server switch. This method will be used for subsequent document reads.
      Specified by:
      recover in interface DocumentDataProvider<S extends Source,SH extends PageSegmentHandle>
      Parameters:
      reader - The Reader to load the Document with
      sourceHandle - The information specifying which Document to recover
      Throws:
      com.levigo.jadice.document.JadiceException - Any rendering exceptions reported by the Jadice core.
      RecoverFailedException - Thrown if the document cannot be recovered.
    • doRecover

      protected abstract void doRecover(com.levigo.jadice.document.read.Reader read, SH sourceHandle) throws com.levigo.jadice.document.JadiceException, IOException
      Throws:
      com.levigo.jadice.document.JadiceException
      IOException
    • doRead

      protected abstract void doRead(com.levigo.jadice.document.read.Reader read, S source) throws com.levigo.jadice.document.JadiceException, IOException
      Throws:
      com.levigo.jadice.document.JadiceException
      IOException