Class TestData

Object
TestData
All Implemented Interfaces:
Runnable
Direct Known Subclasses:
TestData

public class TestData extends Object implements Runnable
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 TestData class from the sample-module instead of this one.

Since:
2.4
Author:
James McGill, Simone Giannecchiin, Martin Desruisseaux
  • Field Details

    • EXTENSIVE_TEST_KEY

      public static final String EXTENSIVE_TEST_KEY
      The system property key for more extensive test suite. The value for this key is returned by the 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"org.geotools.test.extensive"=true option at Java or Maven starting time.
      See Also:
    • INTERACTIVE_TEST_KEY

      public static final String INTERACTIVE_TEST_KEY
      The system property key for interactive tests. The value for this key is returned by the 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"org.geotools.test.interactive"=true option at Java or Maven starting time.
      See Also:
  • Constructor Details

    • TestData

      protected TestData()
      Do not allow instantiation of this class, except for extending it.
  • Method Details

    • isBaseJavaPlatform

      public static boolean isBaseJavaPlatform()
      Returns true if the running Java virtual machine is 1.5. This is the lowest Java version currently supported by Geotools. This version will increase in future Geotools version.

      This method was used for some broken JUnit tests that were know to run on JSE 1.4 but not on JSE 1.6 for example.

      Returns:
      true if we are running on the target Java platform.
    • isMediaLibAvailable

      public static boolean isMediaLibAvailable()
      Returns true if JAI MediaLib acceleration is available.

      This method is used to disable some checks in unit tests that fail when JAI is run in pure java mode.

      Returns:
      true if JAI medialib are available.
    • isExtensiveTest

      public static boolean isExtensiveTest()
      Returns true if "org.geotools.test.extensive" system property is set to true. Test suites should check this value before to perform lengthly tests.
      Returns:
      true if extensive tests are enabled.
    • isInteractiveTest

      public static boolean isInteractiveTest()
      Returns true if "org.geotools.test.interactive" system property is set to true. Test suites should check this value before showing any kind of graphical window to the user.
      Returns:
      true if interactive tests are enabled.
    • getResource

      public static URL getResource(Object caller, String name)
      Locates named test-data resource for caller. Note: Consider using the url(caller, name) method instead if the resource should always exists.
      Parameters:
      caller - Calling class or object used to locate test-data.
      name - resource name in test-data directory.
      Returns:
      URL or null if the named test-data could not be found.
      See Also:
    • url

      public static URL url(Object caller, String path) throws FileNotFoundException
      Access to 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.
      Parameters:
      caller - Calling class or object used to locate test-data.
      path - Path to file in test-data.
      Returns:
      The URL to the test-data resource.
      Throws:
      FileNotFoundException - if the resource is not found.
      Since:
      2.2
    • file

      public static File file(Object caller, String path) throws FileNotFoundException, IOException
      Access to getResource(caller, path) as a non-null File. You can access the test-data directory with:
       TestData.file(MyClass.class, null);
       
      Parameters:
      caller - Calling class or object used to locate test-data.
      path - Path to file in test-data.
      Returns:
      The file to the test-data resource.
      Throws:
      FileNotFoundException - if the file is not found.
      IOException - if the resource can't be fetched for an other reason.
    • temp

      public static File temp(Object caller, String name) throws IOException
      Creates a temporary file with the given name. The file will be created in the test-data directory and will be deleted on exit.
      Parameters:
      caller - Calling class or object used to locate test-data.
      name - A base name for the temporary file.
      Returns:
      The temporary file in the test-data directory.
      Throws:
      IOException - if the file can't be created.
    • openStream

      public static InputStream openStream(Object caller, String name) throws FileNotFoundException, IOException
      Provides a non-null InputStream for named test data. It is the caller responsability to close this stream after usage.
      Parameters:
      caller - Calling class or object used to locate test-data.
      name - of test data to load.
      Returns:
      The input stream.
      Throws:
      FileNotFoundException - if the resource is not found.
      IOException - if an error occurs during an input operation.
      Since:
      2.2
    • openReader

      public static LineNumberReader openReader(Object caller, String name) throws FileNotFoundException, IOException
      Provides a 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.
      Parameters:
      caller - The class of the object associated with named data.
      name - of test data to load.
      Returns:
      The buffered reader.
      Throws:
      FileNotFoundException - if the resource is not found.
      IOException - if an error occurs during an input operation.
      Since:
      2.2
    • openChannel

      public static ReadableByteChannel openChannel(Object caller, String name) throws FileNotFoundException, IOException
      Provides a channel for named test data. It is the caller responsability to close this chanel after usage.
      Parameters:
      caller - The class of the object associated with named data.
      name - of test data to load.
      Returns:
      The chanel.
      Throws:
      FileNotFoundException - if the resource is not found.
      IOException - if an error occurs during an input operation.
      Since:
      2.2
    • unzipFile

      public static void unzipFile(Object caller, String name) throws FileNotFoundException, IOException
      Unzip a file in the 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.

      Parameters:
      caller - The class of the object associated with named data.
      name - The file name to unzip in place.
      Throws:
      FileNotFoundException - if the specified zip file is not found.
      IOException - if an error occurs during an input or output operation.
      Since:
      2.2
    • unzip

      public static void unzip(File file, File target) throws IOException
      Unzips the give source file in the target directory
      Throws:
      IOException
    • deleteOnExit

      protected static void deleteOnExit(File file)
      Requests that the file or directory denoted by the specified pathname be deleted when the virtual machine terminates.
      Parameters:
      file - The file to delete on exit.
    • deleteOnExit

      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. This method can optionnaly delete the file only if it has been modified, thus giving a chance for test suites to copy their resources only once.
      Parameters:
      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.
      Since:
      2.4
    • run

      public void run()
      Deletes all temporary files. This method is invoked automatically at shutdown time and should not be invoked directly. It is public only as an implementation side effect.
      Specified by:
      run in interface Runnable