Package com.unblu.sdk.core.configuration

Interface UnbluDownloadHandler

public interface UnbluDownloadHandler
Handler for downloads. The download handler has to deal with the entire download process, requesting the file, handling storage permissions, storing the file at some location and so on.

  • Method Details

    • createExternalStorageDownloadHandler

      static UnbluDownloadHandler createExternalStorageDownloadHandler(android.app.Application application)
      Creates a default implementation of UnbluDownloadHandler that stores downloaded files in the public downloads directory.
      Parameters:
      application - The application instance
      Returns:
      The default implementation using SharedPreferences

    • createPreviewDownloadHandler

      static UnbluDownloadHandler createPreviewDownloadHandler(android.app.Application application)
      Creates a default implementation of UnbluDownloadHandler that handles file downloads by opening a preview instead of saving it to storage.
      Parameters:
      application - The application instance, used to access context-related resources.
      Returns:
      A new instance of PreviewDownloadHandler, which implements UnbluDownloadHandler and opens a preview of the downloaded content.

    • onDownloadStart

      void onDownloadStart(com.unblu.sdk.core.internal.utils.IApplicationStateProvider applicationStateProvider, String requestedUrl, String userAgent, String contentDisposition, String mimeType, long contentLength, String cookies)
      Triggered whenever a download is started. Except for the cookies, this matches the DownloadListener of WebView.

      If you need the MIME type and content disposition but they're missing, you can use an additional HEAD request to retrieve them from the server.

      Parameters:
      applicationStateProvider - The applicationStateProvider to check for the active activity
      requestedUrl - The full URL to the content that should be downloaded
      userAgent - The user agent for the download
      contentDisposition - The Content-Disposition HTTP header, if present
      mimeType - The MIME type of the content, as reported by the server
      cookies - The cookies used inside the WebView that are relevant for this request. For example, you may need to add cookies to the request to gain access to the file.
      contentLength - The Content-Length HTTP header

    • onDownloadStart

      default void onDownloadStart(com.unblu.sdk.core.internal.utils.IApplicationStateProvider applicationStateProvider, String requestedUrl, String userAgent, String contentDisposition, String mimeType, long contentLength, String cookies, String oAuthToken)
      Triggered whenever a download is started. Except for the cookies, this matches the DownloadListener of WebViews. Use this method if you set an OAuth token in the current UnbluClientConfiguration.

      If you need the MIME type and content disposition but they're missing, you can use an additional HEAD request to retrieve them from the server.

      Parameters:
      applicationStateProvider - The applicationStateProvider to check for the active activity
      requestedUrl - The full URL to the content that should be downloaded
      userAgent - the user agent to be used for the download.
      contentDisposition - Content-disposition http header, if present.
      mimeType - The mimeType of the content reported by the server.
      cookies - The cookies used inside the WebView which are relevant for this request. They may have to be added to the request to have access to the file.
      contentLength - Content-Length
      oAuthToken - optional oAuthToken,

    • onWebViewInitialize

      default void onWebViewInitialize()
      Called whenever the webView is initialized. This happens during the initialization of the SDK.
      The method can be used to do some initial setup, for example, to listen to the Android https://developer.android.com/reference/android/app/DownloadManager[`DownloadManager`^].

    • onWebViewDestroy

      default void onWebViewDestroy()
      Called whenever the webView is destroyed. This happens when the SDK is deinitialized.
      The method can be used to do some cleanup, for example of listeners on the Android https://developer.android.com/reference/android/app/DownloadManager[`DownloadManager`^].