java.lang.Object
org.apache.jena.util.FileManagerImpl
- 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
- optional caching of models
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
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addCacheModel
(String uri, Model m) void
addLocator
(Locator loc) Add a locator to the end of the locators listvoid
addLocatorClassLoader
(ClassLoader cLoad) Deprecated.void
Deprecated.void
addLocatorFile
(String dir) Deprecated.void
Deprecated.void
addLocatorZip
(String zfn) Deprecated.clone()
static FileManager
get()
Get the global file manager.getFromCache
(String filenameOrURI) Read out of the cache - return null if not in the cacheGet the location mappingboolean
hasCachedModel
(String filenameOrURI) boolean
return whether caching is on of offloadModelInternal
(String filenameOrURI) Load a model from a file (local or remote).locators()
Return an iterator over all the handlersstatic FileManager
Create a "standard" FileManager.Apply the mapping of a filename or URIOpen a file using the locators of this FileManagerOpen a file using the locators of this FileManager but without location mappingopenNoMapOrNull
(String filenameOrURI) Open a file using the locators of this FileManager but without location mapping.readModelInternal
(Model model, String filenameOrURI) Read a file of RDF into a model.Slurp up a whole filereadWholeFileAsUTF8
(String filename) Slurp up a whole file: map filename as necessaryvoid
Remove a locatorvoid
removeCacheModel
(String uri) void
Reset the model cachestatic void
setGlobalFileManager
(FileManager 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
-
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. -
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
-
addLocator
Add a locator to the end of the locators list- Specified by:
addLocator
in interfaceFileManager
-
addLocatorFile
Deprecated.Add a file locator- Specified by:
addLocatorFile
in interfaceFileManager
-
addLocatorFile
Deprecated.Add a file locator which uses dir as its working directory- Specified by:
addLocatorFile
in interfaceFileManager
-
addLocatorClassLoader
Deprecated.Add a class loader locator- Specified by:
addLocatorClassLoader
in interfaceFileManager
-
addLocatorURL
Deprecated.Add a URL locator- Specified by:
addLocatorURL
in interfaceFileManager
-
addLocatorZip
Deprecated.Add a zip file locator- Specified by:
addLocatorZip
in interfaceFileManager
-
remove
Remove a locator- Specified by:
remove
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
-
loadModelInternal
Load a model from a file (local or remote). This operation may attempt content negotiation for http URLs.- Specified by:
loadModelInternal
in interfaceFileManager
- Parameters:
filenameOrURI
- The filename or a URI (file:, http:)- Returns:
- a new model
- Throws:
JenaException
- if there is syntax error in file.
-
readModelInternal
Read a file of RDF into a model. Guesses the syntax of the file based on filename extension, defaulting to RDF/XML.- Specified by:
readModelInternal
in interfaceFileManager
- Parameters:
model
-filenameOrURI
-- Returns:
- The model or null, if there was an error.
- Throws:
JenaException
- if there is syntax error in file.
-
open
Open a file using the locators of this FileManager- Specified by:
open
in interfaceFileManager
-
mapURI
Apply the mapping of a filename or URI- Specified by:
mapURI
in interfaceFileManager
-
readWholeFileAsUTF8
Slurp up a whole file- Specified by:
readWholeFileAsUTF8
in interfaceFileManager
-
readWholeFileAsUTF8
Slurp up a whole file: map filename as necessary- Specified by:
readWholeFileAsUTF8
in interfaceFileManager
-
openNoMap
Open a file using the locators of this FileManager but without location mapping- Specified by:
openNoMap
in interfaceFileManager
-
openNoMapOrNull
Open a file using the locators of this FileManager but without location mapping. Return null if not found- Specified by:
openNoMapOrNull
in interfaceFileManager
-