com.hp.hpl.jena.util
Class FileUtils

java.lang.Object
  extended by com.hp.hpl.jena.util.FileUtils

public class FileUtils
extends Object


Field Summary
static String encodingUTF8
          Java name for UTF-8 encoding
static String langBDB
           
static String langN3
           
static String langNTriple
           
static String langSQL
           
static String langTurtle
           
static String langXML
           
static String langXMLAbbrev
           
 
Constructor Summary
FileUtils()
           
 
Method Summary
static BufferedReader asBufferedUTF8(InputStream in)
          Create a buffered reader that uses UTF-8 encoding
static PrintWriter asPrintWriterUTF8(OutputStream out)
          Create a print writer that uses UTF-8 encoding
static Reader asUTF8(InputStream in)
          Create a reader that uses UTF-8 encoding
static Writer asUTF8(OutputStream out)
          Create a writer that uses UTF-8 encoding
static String decodeFileName(String s)
           
static String encodeFileName(String s)
          Deprecated. Broken: use toURL()
static String getBasename(String filename)
          Get the basename of a filename
static String getDirname(String filename)
          Get the directory part of a filename
static String getFilenameExt(String filename)
          Get the suffix part of a file name or a URL in file-like format.
static String getScheme(String uri)
           
static File getScratchDirectory(String prefix)
          Answer a File naming a freshly-created directory in the temporary directory.
static String getTempDirectory()
           
static String guessLang(String urlStr)
          Guess the language/type of model data If the URI of the model starts jdbc: it is assumed to be an RDB model If the URI ends .rdf, it is assumed to be RDF/XML If the URI ends .n3, it is assumed to be N3 If the URI ends .nt, it is assumed to be N-Triples If the URI ends .bdb, it is assumed to be BerkeleyDB model
static String guessLang(String name, String otherwise)
          Guess the language/type of model data.
static boolean isFile(String name)
          Check whether 'name' is possibly a file reference
static boolean isURI(String name)
          Check whether a name is an absolute URI (has a scheme name)
static BufferedReader openResourceFile(String filename)
          Answer a BufferedReader than reads from the named resource file as UTF-8, possibly throwing WrappedIOExceptions.
static InputStream openResourceFileAsStream(String filename)
          Open an resource file for reading.
static BufferedReader readerFromURL(String urlStr)
           
static String readWholeFileAsUTF8(InputStream in)
          Read a whole stream as UTF-8
static String readWholeFileAsUTF8(String filename)
          Read a whole file as UTF-8
static File tempFileName(String prefix, String suffix)
          create a temporary file that will be deleted on exit, and do something sensible with any IO exceptions - namely, throw them up wrapped in a JenaException.
static String toFilename(String filenameOrURI)
          Turn a file: URL or file name into a plain file name
static String toURL(String filename)
          Turn a plain filename into a "file:" URL
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

langXML

public static final String langXML
See Also:
Constant Field Values

langXMLAbbrev

public static final String langXMLAbbrev
See Also:
Constant Field Values

langNTriple

public static final String langNTriple
See Also:
Constant Field Values

langN3

public static final String langN3
See Also:
Constant Field Values

langTurtle

public static final String langTurtle
See Also:
Constant Field Values

langBDB

public static final String langBDB
See Also:
Constant Field Values

langSQL

public static final String langSQL
See Also:
Constant Field Values

encodingUTF8

public static final String encodingUTF8
Java name for UTF-8 encoding

See Also:
Constant Field Values
Constructor Detail

FileUtils

public FileUtils()
Method Detail

asUTF8

public static Reader asUTF8(InputStream in)
Create a reader that uses UTF-8 encoding


asBufferedUTF8

public static BufferedReader asBufferedUTF8(InputStream in)
Create a buffered reader that uses UTF-8 encoding


asUTF8

public static Writer asUTF8(OutputStream out)
Create a writer that uses UTF-8 encoding


asPrintWriterUTF8

public static PrintWriter asPrintWriterUTF8(OutputStream out)
Create a print writer that uses UTF-8 encoding


guessLang

public static String guessLang(String name,
                               String otherwise)
Guess the language/type of model data. Updated by Chris, hived off the model-suffix part to FileUtils as part of unifying it with similar code in FileGraph.

Parameters:
name - URL to base the guess on
otherwise - Default guess
Returns:
String Guessed syntax - or the default supplied

guessLang

public static String guessLang(String urlStr)
Guess the language/type of model data

Parameters:
urlStr - URL to base the guess on
Returns:
String Guessed syntax - default is RDF/XML

toFilename

public static String toFilename(String filenameOrURI)
Turn a file: URL or file name into a plain file name


decodeFileName

public static String decodeFileName(String s)

toURL

public static String toURL(String filename)
Turn a plain filename into a "file:" URL


encodeFileName

@Deprecated
public static String encodeFileName(String s)
Deprecated. Broken: use toURL()


isFile

public static boolean isFile(String name)
Check whether 'name' is possibly a file reference

Parameters:
name -
Returns:
boolean False if clearly not a filename.

isURI

public static boolean isURI(String name)
Check whether a name is an absolute URI (has a scheme name)

Parameters:
name -
Returns:
boolean True if there is a scheme name

getScheme

public static String getScheme(String uri)

getDirname

public static String getDirname(String filename)
Get the directory part of a filename

Parameters:
filename -
Returns:
Directory name

getBasename

public static String getBasename(String filename)
Get the basename of a filename

Parameters:
filename -
Returns:
Base filename.

getFilenameExt

public static String getFilenameExt(String filename)
Get the suffix part of a file name or a URL in file-like format.


tempFileName

public static File tempFileName(String prefix,
                                String suffix)
create a temporary file that will be deleted on exit, and do something sensible with any IO exceptions - namely, throw them up wrapped in a JenaException.

Parameters:
prefix - the prefix for File.createTempFile
suffix - the suffix for File.createTempFile
Returns:
the temporary File

getScratchDirectory

public static File getScratchDirectory(String prefix)
Answer a File naming a freshly-created directory in the temporary directory. This directory should be deleted on exit. TODO handle threading issues, mkdir failure, and better cleanup

Parameters:
prefix - the prefix for the directory name
Returns:
a File naming the new directory

getTempDirectory

public static String getTempDirectory()

openResourceFile

public static BufferedReader openResourceFile(String filename)
Answer a BufferedReader than reads from the named resource file as UTF-8, possibly throwing WrappedIOExceptions.


openResourceFileAsStream

public static InputStream openResourceFileAsStream(String filename)
                                            throws FileNotFoundException
Open an resource file for reading.

Throws:
FileNotFoundException

readerFromURL

public static BufferedReader readerFromURL(String urlStr)

readWholeFileAsUTF8

public static String readWholeFileAsUTF8(String filename)
                                  throws IOException
Read a whole file as UTF-8

Parameters:
filename -
Returns:
String
Throws:
IOException

readWholeFileAsUTF8

public static String readWholeFileAsUTF8(InputStream in)
                                  throws IOException
Read a whole stream as UTF-8

Parameters:
in - InputStream to be read
Returns:
String
Throws:
IOException


Copyright ? 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Hewlett-Packard Development Company, LP