Class AdapterFileManager

java.lang.Object
org.apache.jena.riot.adapters.AdapterFileManager
All Implemented Interfaces:
org.apache.jena.util.FileManager

public class AdapterFileManager extends Object implements org.apache.jena.util.FileManager
Adapter that provides FileManager for RIOT by translating the operations. FileManager A FileManager provides access to named file-like resources by opening InputStreams to things in the filing system, by URL (http: and file:) and found by the classloader. It can also load RDF data from such a system resource into an existing model or create a new (Memory-based) model. There is a global FileManager which provide uniform access to system resources: applications may also create specialised FileManagers. A FileManager contains a list of location functions to try: the global FileManger has one LocatorFile, one LocatorClassLoader and one LocatorURL Main operations:
  • loadModel, readModel : URI to model
  • open, openNoMap : URI to input stream
  • mapURI : map URI to another by LocationMapper
Utilities:
  • readWholeFileAsUTF8
A FileManager works in conjunction with a LocationMapper. A LocationMapper is a set of alternative locations for system resources and a set of alternative prefix locations. For example, a local copy of a common RDF dataset may be used whenever the usual URL is used by the application. The LocatorFile also supports the idea of "current directory".
See Also:
  • Constructor Details

    • AdapterFileManager

      public AdapterFileManager(StreamManager streamManager)
    • AdapterFileManager

      public AdapterFileManager(StreamManager streamManager, LocationMapper mapper)
      Create a FileManger using a RIOT StreamManager and RIOT LocationMapper
  • Method Details

    • get

      public static AdapterFileManager get()
      Get the global file manager.
      Returns:
      the global file manager
    • setGlobalFileManager

      public static void setGlobalFileManager(AdapterFileManager globalFileManager)
      Set the global file manager (as returned by get()) If called before any call to get(), then the usual default filemanager is not created
      Parameters:
      globalFileManager -
    • clone

      public org.apache.jena.util.FileManager clone()
      Specified by:
      clone in interface org.apache.jena.util.FileManager
    • makeGlobal

      public static AdapterFileManager makeGlobal()
      Create a "standard" FileManager.
    • getStreamManager

      public StreamManager getStreamManager()
      Return the associate stream manager
    • setLocationMapper

      public void setLocationMapper(org.apache.jena.util.LocationMapper mapper)
      Set the location mapping
      Specified by:
      setLocationMapper in interface org.apache.jena.util.FileManager
    • getLocationMapper

      public org.apache.jena.util.LocationMapper getLocationMapper()
      Get the location mapping
      Specified by:
      getLocationMapper in interface org.apache.jena.util.FileManager
    • locators

      public Iterator<org.apache.jena.util.Locator> locators()
      Return an iterator over all the handlers
      Specified by:
      locators in interface org.apache.jena.util.FileManager
    • remove

      public void remove(org.apache.jena.util.Locator loc)
      Remove a locator
      Specified by:
      remove in interface org.apache.jena.util.FileManager
    • addLocator

      public void addLocator(org.apache.jena.util.Locator oldloc)
      Add a locator to the end of the locators list
      Specified by:
      addLocator in interface org.apache.jena.util.FileManager
    • addLocatorFile

      public void addLocatorFile()
      Add a file locator
      Specified by:
      addLocatorFile in interface org.apache.jena.util.FileManager
    • addLocatorFile

      public void addLocatorFile(String dir)
      Add a file locator which uses dir as its working directory
      Specified by:
      addLocatorFile in interface org.apache.jena.util.FileManager
    • addLocatorClassLoader

      public void addLocatorClassLoader(ClassLoader cLoad)
      Add a class loader locator
      Specified by:
      addLocatorClassLoader in interface org.apache.jena.util.FileManager
    • addLocatorURL

      public void addLocatorURL()
      Specified by:
      addLocatorURL in interface org.apache.jena.util.FileManager
    • addLocatorHTTP

      public void addLocatorHTTP()
    • addLocatorFTP

      public void addLocatorFTP()
    • addLocatorZip

      public void addLocatorZip(String zfn)
      Add a zip file locator
      Specified by:
      addLocatorZip in interface org.apache.jena.util.FileManager
    • resetCache

      public void resetCache()
      Reset the model cache
      Specified by:
      resetCache in interface org.apache.jena.util.FileManager
    • setModelCaching

      public void setModelCaching(boolean state)
      Change the state of model cache : does not clear the cache
      Specified by:
      setModelCaching in interface org.apache.jena.util.FileManager
    • isCachingModels

      public boolean isCachingModels()
      return whether caching is on of off
      Specified by:
      isCachingModels in interface org.apache.jena.util.FileManager
    • getFromCache

      public org.apache.jena.rdf.model.Model getFromCache(String filenameOrURI)
      Read out of the cache - return null if not in the cache
      Specified by:
      getFromCache in interface org.apache.jena.util.FileManager
    • hasCachedModel

      public boolean hasCachedModel(String filenameOrURI)
      Specified by:
      hasCachedModel in interface org.apache.jena.util.FileManager
    • addCacheModel

      public void addCacheModel(String uri, org.apache.jena.rdf.model.Model m)
      Specified by:
      addCacheModel in interface org.apache.jena.util.FileManager
    • removeCacheModel

      public void removeCacheModel(String uri)
      Specified by:
      removeCacheModel in interface org.apache.jena.util.FileManager
    • open

      public InputStream open(String filenameOrURI)
      Open a file using the locators of this FileManager Throws RiotNotFoundException if not found.
      Specified by:
      open in interface org.apache.jena.util.FileManager
    • mapURI

      public String mapURI(String filenameOrURI)
      Apply the mapping of a filename or URI
      Specified by:
      mapURI in interface org.apache.jena.util.FileManager
    • openNoMap

      public InputStream openNoMap(String filenameOrURI)
      Open a file using the locators of this FileManager but without location mapping. Throws RiotNotFoundException if not found.
      Specified by:
      openNoMap in interface org.apache.jena.util.FileManager
    • openNoMapOrNull

      public org.apache.jena.util.TypedStream openNoMapOrNull(String filenameOrURI)
      Open a file using the locators of this FileManager without location mapping. Return null if not found
      Specified by:
      openNoMapOrNull in interface org.apache.jena.util.FileManager
    • loadModelInternal

      public org.apache.jena.rdf.model.Model loadModelInternal(String filenameOrURI)
      Specified by:
      loadModelInternal in interface org.apache.jena.util.FileManager
    • readModelInternal

      public org.apache.jena.rdf.model.Model readModelInternal(org.apache.jena.rdf.model.Model model, String filenameOrURI)
      Specified by:
      readModelInternal in interface org.apache.jena.util.FileManager
    • readWholeFileAsUTF8

      @Deprecated(forRemoval=true) public String readWholeFileAsUTF8(InputStream in)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Use IO.readWholeFileAsUTF8(InputStream)
      Specified by:
      readWholeFileAsUTF8 in interface org.apache.jena.util.FileManager
    • readWholeFileAsUTF8

      @Deprecated(forRemoval=true) public String readWholeFileAsUTF8(String filename)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Use IO.readWholeFileAsUTF8(String)
      Specified by:
      readWholeFileAsUTF8 in interface org.apache.jena.util.FileManager