|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
ObjectTestData
public class TestData
----------------------------- NOTE -----------------------------
This class contains a modified version of the geotools TestData
class.
----------------------------------------------------------------
Provides access to test-data
directories associated with JUnit tests.
We have chosen "test-data
" to follow the javadoc "doc-files
" convention
of ensuring that data directories don't look anything like normal java packages.
Example:
class MyClass { public void example() { Image testImage = new ImageIcon(TestData.url(this, "test.png")).getImage(); Reader reader = TestData.openReader(this, "script.xml"); // ... do some process reader.close(); } }Where the directory structure goes as bellow:
MyClass.java
test-data/test.png
test-data/script.xml
By convention you should try and locate test-data
near the JUnit test
cases that uses it. If you need an access to shared test data, import the
org.geotools.TestData
class from the sample-module
instead
of this one.
Field Summary | |
---|---|
static String |
EXTENSIVE_TEST_KEY
The system property key for more extensive test suite. |
static String |
INTERACTIVE_TEST_KEY
The system property key for interactive tests. |
Constructor Summary | |
---|---|
protected |
TestData()
Do not allow instantiation of this class, except for extending it. |
Method Summary | |
---|---|
protected static void |
deleteOnExit(File file)
Requests that the file or directory denoted by the specified pathname be deleted when the virtual machine terminates. |
protected static void |
deleteOnExit(File file,
boolean force)
Requests that the file or directory denoted by the specified pathname be deleted when the virtual machine terminates. |
static File |
file(Object caller,
String path)
Access to getResource(caller, path) as a non-null
File . |
static URL |
getResource(Object caller,
String name)
Locates named test-data resource for caller. |
static boolean |
isExtensiveTest()
Returns true if "test.extensive" system property is set to
true . |
static boolean |
isInteractiveTest()
Returns true if "test.interactive" system property is set to true . |
static ReadableByteChannel |
openChannel(Object caller,
String name)
Provides a channel for named test data. |
static LineNumberReader |
openReader(Object caller,
String name)
Provides a BufferedReader for named test data. |
static InputStream |
openStream(Object caller,
String name)
Provides a non-null InputStream for named test data. |
void |
run()
Deletes all temporary files. |
static File |
temp(Object caller,
String name)
Creates a temporary file with the given name. |
static File |
temp(Object caller,
String name,
boolean delOnExit)
Creates a temporary file with the given name. |
static void |
unzipFile(Object caller,
String name)
Unzip a file in the test-data directory. |
static URL |
url(Object caller,
String path)
Access to getResource(caller, path) as a non-null
URL . |
Methods inherited from class Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final String EXTENSIVE_TEST_KEY
isExtensiveTest()
method. Some
test suites will perform more extensive test coverage if this property is set to
true
. The value for this property is typically defined on the command line as a
-D"test.extensive"=true
option at Java or Maven starting time.
public static final String INTERACTIVE_TEST_KEY
isInteractiveTest()
method. Some
test suites will show windows with maps and other artifacts related to testing
if this property is set to true
.
The value for this property is typically defined on the command line as a
-D"test.interactive"=true
option at Java or Maven starting time.
Constructor Detail |
---|
protected TestData()
Method Detail |
---|
public static boolean isExtensiveTest()
true
if "test.extensive" system property is set to
true
. Test suites should check this value before to perform lengthly tests.
public static boolean isInteractiveTest()
true
if "test.interactive" system property is set to true
.
Test suites should check this value before showing any kind of graphical window to the user.
public static URL getResource(Object caller, String name)
url
(caller, name)
method instead if the resource should always
exists.
caller
- Calling class or object used to locate test-data
.name
- resource name in test-data
directory.
null
if the named test-data could not be found.url(java.lang.Object, java.lang.String)
public static URL url(Object caller, String path) throws FileNotFoundException
getResource(caller, path)
as a non-null
URL
. At the difference of getResource
, this method throws an exception if
the resource is not found. This provides a more explicit explanation about the failure
reason than the infamous NullPointerException
.
caller
- Calling class or object used to locate test-data
.path
- Path to file in test-data
.
test-data
resource.
FileNotFoundException
- if the resource is not found.public static File file(Object caller, String path) throws IOException
getResource(caller, path)
as a non-null
File
. You can access the test-data
directory with:
TestData.file(MyClass.class, null);
caller
- Calling class or object used to locate test-data
.path
- Path to file in test-data
.
test-data
resource.
FileNotFoundException
- if the file is not found.
IOException
- if the resource can't be fetched for an other reason.public static File temp(Object caller, String name, boolean delOnExit) throws IOException
test-data
directory.
caller
- Calling class or object used to locate test-data
.name
- A base name for the temporary file.delOnExit
- if true, delete the temporary file on exit.
test-data
directory.
IOException
- if the file can't be created.public static File temp(Object caller, String name) throws IOException
test-data
directory and will be deleted on exit.
caller
- Calling class or object used to locate test-data
.name
- A base name for the temporary file.
test-data
directory.
IOException
- if the file can't be created.public static InputStream openStream(Object caller, String name) throws IOException
InputStream
for named test data.
It is the caller responsability to close this stream after usage.
caller
- Calling class or object used to locate test-data
.name
- of test data to load.
FileNotFoundException
- if the resource is not found.
IOException
- if an error occurs during an input operation.public static LineNumberReader openReader(Object caller, String name) throws IOException
BufferedReader
for named test data. The buffered reader is provided as
an LineNumberReader
instance, which is useful for displaying line numbers where
error occur. It is the caller responsability to close this reader after usage.
caller
- The class of the object associated with named data.name
- of test data to load.
FileNotFoundException
- if the resource is not found.
IOException
- if an error occurs during an input operation.public static ReadableByteChannel openChannel(Object caller, String name) throws IOException
caller
- The class of the object associated with named data.name
- of test data to load.
FileNotFoundException
- if the resource is not found.
IOException
- if an error occurs during an input operation.public static void unzipFile(Object caller, String name) throws IOException
test-data
directory. The zip file content is inflated in place,
i.e. inflated files are written in the same test-data
directory. If a file to be
inflated already exists in the test-data
directory, then the existing file is left
untouched and the corresponding ZIP entry is silently skipped. This approach avoid the
overhead of inflating the same files many time if this unzipFile
method is invoked
before every tests.
Inflated files will be automatically deleted on exit
if and only if they have been modified. Callers don't need to worry about cleanup,
because the files are inflated in the target/.../test-data
directory, which
is not versionned by SVN and is cleaned by Maven on mvn clean
execution.
caller
- The class of the object associated with named data.name
- The file name to unzip in place.
FileNotFoundException
- if the specified zip file is not found.
IOException
- if an error occurs during an input or output operation.protected static void deleteOnExit(File file)
protected static void deleteOnExit(File file, boolean force)
file
- The file to delete.force
- If true
, delete the file in all cases. If false
,
delete the file if and only if it has been modified. The default value
if true
.public void run()
run
in interface Runnable
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |