public interface

DataProvider

com.pspdfkit.document.providers.DataProvider
Known Indirect Subclasses

Class Overview

A data provider is allows PSPDFKit to load a PDF document for any custom source (e.g. cloud providers, files, in-memory, data providers, etc.).

Classes implementing this interface need to implement all methods correctly to allow PSPDFKit loading documents. Furthermore, if classes with this interface are meant to be used with PdfActivity, they must also implement Parcelable. If you plan to use the DataProvider only for PdfFragment parcelation code is not necessary.

All callbacks will be called on a background thread.

Summary

Constants
int FILE_SIZE_UNKNOWN Constant value that can be return in getSize() to signal an error during retrieval of the actual file size.
Fields
public static final byte[] NO_DATA_AVAILABLE Constant value that can be returned in read(long, long) to signal an error while reading.
Public Methods
abstract long getSize()
Return the actual file size of the PDF document which is provided by this data provider.
abstract String getTitle()
Displayable document title to be used if PDF document does not contain metadata.
abstract String getUid()
Unique document identifier used in all caching processes in PSPDFKit.
abstract byte[] read(long size, long offset)
Called by PSPDFKit to read data from the document.
abstract void release()
Called when the provided document is being closed.

Constants

public static final int FILE_SIZE_UNKNOWN

Constant value that can be return in getSize() to signal an error during retrieval of the actual file size.

See Also
Constant Value: -1 (0xffffffff)

Fields

public static final byte[] NO_DATA_AVAILABLE

Constant value that can be returned in read(long, long) to signal an error while reading.

See Also

Public Methods

public abstract long getSize ()

Return the actual file size of the PDF document which is provided by this data provider. If the data provider can't determine the correct file size (e.g. in case of an error) this method has to return FILE_SIZE_UNKNOWN.

Returns
  • Returns size of PDF document data in bytes, or FILE_SIZE_UNKNOWN in case of an error.

public abstract String getTitle ()

Displayable document title to be used if PDF document does not contain metadata. For example, for file-based providers this should return the filename. `.pdf` extensions will be stripped automatically.

Returns
  • Fallback document title if PDF document does not contain the required metadata. May be null.

public abstract String getUid ()

Unique document identifier used in all caching processes in PSPDFKit. Must be equal or shorter than 50 chars. This method must be implemented for caching to work properly.

Returns
  • Unique identifier of the provided document. Implementations may not return null or an exception will be thrown.

public abstract byte[] read (long size, long offset)

Called by PSPDFKit to read data from the document. The returned byte array can be reused in subsequent calls to prevent excessive allocations.

Parameters
size Size of the data chunk to be read in bytes.
offset Offset from start of document of the data chunk to be read in bytes.
Returns
  • Byte array with document data of the exact same size or larger size than size parameter. Implementations may not return null or loading will fail. Instead, when experiencing a read error, implementations may return NO_DATA_AVAILABLE to safely stop reading.

public abstract void release ()

Called when the provided document is being closed. Implementations are expected to release all resources (like closing of all streams and freeing of allocations).