Package eu.europa.esig.dss.service.http.commons

Class FileCacheDataLoader

java.lang.Object
eu.europa.esig.dss.service.http.commons.FileCacheDataLoader
All Implemented Interfaces:
DataLoader, DSSFileLoader, Serializable
public class FileCacheDataLoader
extends Object
implements DataLoader, DSSFileLoader
This class provides some caching features to handle the resources. The default cache folder is set to java.io.tmpdir. The urls of the resources is transformed to the file name by replacing the special characters by _
See Also:
Serialized Form

  • Constructor Details

  • Method Details

    • getDataLoader

      public DataLoader getDataLoader()

    • setDataLoader

      public void setDataLoader​(DataLoader dataLoader)

    • setFileCacheDirectory

      public void setFileCacheDirectory​(File fileCacheDirectory)
      This method allows to set the file cache directory. If the cache folder does not exists then it's created.
      Parameters:
      fileCacheDirectory - File pointing the cache folder to be used.

    • setCacheExpirationTime

      public void setCacheExpirationTime​(long cacheExpirationTimeInMilliseconds)
      Sets the expiration time for the cached files in milliseconds. If more time has passed from the cache file's last modified time, then a fresh copy is downloaded and cached, otherwise a cached copy is used. If the expiration time is not set, then the cache does not expire.
      Parameters:
      cacheExpirationTimeInMilliseconds -

    • setResourceLoader

      public void setResourceLoader​(ResourceLoader resourceLoader)

    • addToBeLoaded

      public void addToBeLoaded​(String url)
      This methods allows to indicate if the resource must be obtained. If this method has been invoked then only the provided URL will be processed.
      Parameters:
      url - to be processed

    • addToBeIgnored

      public void addToBeIgnored​(String urlString)
      This methods allows to indicate which resources must be ignored. It is useful in a test environment where some of fake sources a not available. It prevents to wait for the timeout.
      Parameters:
      urlString - to be ignored. It can be the original URL or the cache file name

    • get

      public byte[] get​(String url, boolean refresh) throws DSSException
      Description copied from interface: DataLoader
      Execute a HTTP GET operation with indication concerning the mandatory nature of the operation.
      Specified by:
      get in interface DataLoader
      Parameters:
      url - to access
      refresh - if true indicates that the cached data should be refreshed
      Returns:
      byte array of obtained data or null
      Throws:
      DSSException - in case of DataLoader error

    • get

      public byte[] get​(String url) throws DSSException
      Description copied from interface: DataLoader
      Execute a HTTP GET operation.
      Specified by:
      get in interface DataLoader
      Parameters:
      url - the url to access
      Returns:
      byte array of obtained data or null
      Throws:
      DSSException - in case of DataLoader error

    • getDocument

      public DSSDocument getDocument​(String url)
      Description copied from interface: DSSFileLoader
      Returns DSSDocument from the provided url
      Specified by:
      getDocument in interface DSSFileLoader
      Parameters:
      url - String url of the document to obtain
      Returns:
      DSSDocument retrieved document

    • remove

      public boolean remove​(String url)
      Description copied from interface: DSSFileLoader
      Removes the file from FileSystem with the given url
      Specified by:
      remove in interface DSSFileLoader
      Parameters:
      url - String url of the remote file location (the same what was used on file saving)
      Returns:
      TRUE when file was successfully deleted, FALSE otherwise

    • isNetworkProtocol

      protected boolean isNetworkProtocol​(String urlString)

    • createFile

      public File createFile​(String urlString, byte[] bytes)
      Allows to add a given array of byte as a cache file representing by the urlString.
      Parameters:
      urlString - the URL to add to the cache
      bytes - the content of the cache file

    • loadFileFromCache

      public byte[] loadFileFromCache​(String urlString) throws DSSException
      Allows to load the file for a given file name from the cache folder.
      Returns:
      the content of the file or null if the file does not exist
      Throws:
      DSSException - in case if the file does not exist in the cache

    • post

      public byte[] post​(String urlString, byte[] content) throws DSSException
      Description copied from interface: DataLoader
      Executes a HTTP POST operation
      Specified by:
      post in interface DataLoader
      Parameters:
      urlString - to access
      content - the content to post
      Returns:
      byte array of obtained data
      Throws:
      DSSException - in case of DataLoader error

    • get

      public DataLoader.DataAndUrl get​(List<String> urlStrings)
      Description copied from interface: DataLoader
      Execute a HTTP GET operation. This method is used when many URls are available to access the same resource. The operation stops after the first successful download.
      Specified by:
      get in interface DataLoader
      Parameters:
      urlStrings - List of Strings representing the URLs to be used in sequential way to obtain the data.
      Returns:
      DataAndUrl representing the array of obtained data and used url, or null

    • setContentType

      public void setContentType​(String contentType)
      Description copied from interface: DataLoader
      This allows to set the content type. Example: Content-Type "application/ocsp-request"
      Specified by:
      setContentType in interface DataLoader
      Parameters:
      contentType - to set the Content-Type