java.lang.Object
org.apache.jena.riot.adapters.AdapterFileManager
- All Implemented Interfaces:
FileManager
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
- readWholeFileAsUTF8
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:
-
Field Summary
Fields inherited from interface org.apache.jena.util.FileManager
filePathSeparator, logAllLookups, PATH_DELIMITER
-
Constructor Summary
ConstructorsConstructorDescriptionAdapterFileManager
(StreamManager streamManager) AdapterFileManager
(StreamManager streamManager, LocationMapper mapper) Create a FileManger using a RIOT StreamManager and RIOT LocationMapper -
Method Summary
Modifier and TypeMethodDescriptionvoid
addCacheModel
(String uri, Model m) void
addLocator
(Locator oldloc) Add a locator to the end of the locators listvoid
addLocatorClassLoader
(ClassLoader cLoad) Add a class loader locatorvoid
Add a file locatorvoid
addLocatorFile
(String dir) Add a file locator which uses dir as its working directoryvoid
void
void
void
addLocatorZip
(String zfn) Add a zip file locatorclone()
static AdapterFileManager
get()
Get the global file manager.getFromCache
(String filenameOrURI) Read out of the cache - return null if not in the cacheGet the location mappingReturn the associate stream managerboolean
hasCachedModel
(String filenameOrURI) boolean
return whether caching is on of offDeprecated.Deprecated.loadModelInternal
(String filenameOrURI) locators()
Return an iterator over all the handlersstatic AdapterFileManager
Create a "standard" FileManager.Apply the mapping of a filename or URIOpen a file using the locators of this FileManager Throws RiotNotFoundException if not found.Open a file using the locators of this FileManager but without location mapping.openNoMapOrNull
(String filenameOrURI) Open a file using the locators of this FileManager without location mapping.Deprecated.Deprecated.readModelInternal
(Model model, String filenameOrURI) Deprecated.readWholeFileAsUTF8
(String filename) Deprecated.UseIO.readWholeFileAsUTF8(String)
void
Remove a locatorvoid
removeCacheModel
(String uri) void
Reset the model cachestatic 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 createdvoid
setLocationMapper
(LocationMapper mapper) Set the location mappingvoid
setModelCaching
(boolean state) Change the state of model cache : does not clear the cacheMethods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.apache.jena.util.FileManager
loadModel, readModel
-
Constructor Details
-
AdapterFileManager
-
AdapterFileManager
Create a FileManger using a RIOT StreamManager and RIOT LocationMapper
-
-
Method Details
-
get
Get the global file manager.- Returns:
- the global file manager
-
setGlobalFileManager
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
- Specified by:
clone
in interfaceFileManager
-
makeGlobal
Create a "standard" FileManager. -
getStreamManager
Return the associate stream manager -
setLocationMapper
Set the location mapping- Specified by:
setLocationMapper
in interfaceFileManager
-
getLocationMapper
Get the location mapping- Specified by:
getLocationMapper
in interfaceFileManager
-
locators
Return an iterator over all the handlers- Specified by:
locators
in interfaceFileManager
-
remove
Remove a locator- Specified by:
remove
in interfaceFileManager
-
addLocator
Add a locator to the end of the locators list- Specified by:
addLocator
in interfaceFileManager
-
addLocatorFile
public void addLocatorFile()Add a file locator- Specified by:
addLocatorFile
in interfaceFileManager
-
addLocatorFile
Add a file locator which uses dir as its working directory- Specified by:
addLocatorFile
in interfaceFileManager
-
addLocatorClassLoader
Add a class loader locator- Specified by:
addLocatorClassLoader
in interfaceFileManager
-
addLocatorURL
public void addLocatorURL()- Specified by:
addLocatorURL
in interfaceFileManager
-
addLocatorHTTP
public void addLocatorHTTP() -
addLocatorFTP
public void addLocatorFTP() -
addLocatorZip
Add a zip file locator- Specified by:
addLocatorZip
in interfaceFileManager
-
resetCache
public void resetCache()Reset the model cache- Specified by:
resetCache
in interfaceFileManager
-
setModelCaching
public void setModelCaching(boolean state) Change the state of model cache : does not clear the cache- Specified by:
setModelCaching
in interfaceFileManager
-
isCachingModels
public boolean isCachingModels()return whether caching is on of off- Specified by:
isCachingModels
in interfaceFileManager
-
getFromCache
Read out of the cache - return null if not in the cache- Specified by:
getFromCache
in interfaceFileManager
-
hasCachedModel
- Specified by:
hasCachedModel
in interfaceFileManager
-
addCacheModel
- Specified by:
addCacheModel
in interfaceFileManager
-
removeCacheModel
- Specified by:
removeCacheModel
in interfaceFileManager
-
open
Open a file using the locators of this FileManager Throws RiotNotFoundException if not found.- Specified by:
open
in interfaceFileManager
-
mapURI
Apply the mapping of a filename or URI- Specified by:
mapURI
in interfaceFileManager
-
openNoMap
Open a file using the locators of this FileManager but without location mapping. Throws RiotNotFoundException if not found.- Specified by:
openNoMap
in interfaceFileManager
-
openNoMapOrNull
Open a file using the locators of this FileManager without location mapping. Return null if not found- Specified by:
openNoMapOrNull
in interfaceFileManager
-
loadModelInternal
- Specified by:
loadModelInternal
in interfaceFileManager
-
loadModel
Deprecated.Load a model from a file (local or remote). URI is the base for reading the model.- Specified by:
loadModel
in interfaceFileManager
- Parameters:
filenameOrURI
- The filename or a URI (file:, http:)rdfSyntax
- RDF Serialization syntax.- Returns:
- a new model
- Throws:
JenaException
- if there is syntax error in file.
-
loadModel
Deprecated.Load a model from a file (local or remote).- Specified by:
loadModel
in interfaceFileManager
- Parameters:
filenameOrURI
- The filename or a URI (file:, http:)baseURI
- Base URI for loading the RDF model.rdfSyntax
- RDF Serialization syntax.- Returns:
- a new model
- Throws:
JenaException
- if there is syntax error in file.
-
readModelInternal
- Specified by:
readModelInternal
in interfaceFileManager
-
readModel
Deprecated.Read a file of RDF into a model.- Specified by:
readModel
in interfaceFileManager
- Parameters:
model
-filenameOrURI
-rdfSyntax
- RDF Serialization syntax.- Returns:
- The model or null, if there was an error.
- Throws:
JenaException
- if there is syntax error in file.
-
readModel
@Deprecated public Model readModel(Model model, String filenameOrURI, String baseURI, String syntax) Deprecated.Read a file of RDF into a model.- Specified by:
readModel
in interfaceFileManager
- Parameters:
model
-filenameOrURI
-baseURI
-syntax
-- Returns:
- The model
- Throws:
JenaException
- if there is syntax error in file.
-
readWholeFileAsUTF8
Deprecated.UseIO.readWholeFileAsUTF8(InputStream)
- Specified by:
readWholeFileAsUTF8
in interfaceFileManager
-
readWholeFileAsUTF8
Deprecated.UseIO.readWholeFileAsUTF8(String)
- Specified by:
readWholeFileAsUTF8
in interfaceFileManager
-
IO.readWholeFileAsUTF8(InputStream)