309

I have a unit test that needs to work with XML file located in src/test/resources/abc.xml. What is the easiest way just to get the content of the file into String?

8
  • 3
    also, stackoverflow.com/questions/1656797/… Oct 8, 2010 at 14:12
  • 2
    @Nikita, was going to vote to close despite my answer, but those questions don't mention getResourceAsStream() which I believe is the right approach for the OP's question.
    – Kirk Woll
    Oct 8, 2010 at 14:17
  • 1
    @kirk, getResourceAsStream caches the file in the classloader. That is unnecessary. Oct 8, 2010 at 16:13
  • @Thorbjørn, where is your reference for that? In any case, it certainly is convenient and portable which may in fact be necessary.
    – Kirk Woll
    Oct 8, 2010 at 17:12
  • 3
    This question shouldn't be closed. The "duplicates" provided don't answer how to read a resource file, but files in general. The problem is how to reference that resource file
    – GabrielBB
    Jan 15, 2020 at 0:20

12 Answers 12

288

Finally I found a neat solution, thanks to Apache Commons:

package com.example;
import org.apache.commons.io.IOUtils;
public class FooTest {
  @Test 
  public void shouldWork() throws Exception {
    String xml = IOUtils.toString(
      this.getClass().getResourceAsStream("abc.xml"),
      "UTF-8"
    );
  }
}

Works perfectly. File src/test/resources/com/example/abc.xml is loaded (I'm using Maven).

If you replace "abc.xml" with, say, "/foo/test.xml", this resource will be loaded: src/test/resources/foo/test.xml

You can also use Cactoos:

package com.example;
import org.cactoos.io.ResourceOf;
import org.cactoos.io.TextOf;
public class FooTest {
  @Test 
  public void shouldWork() throws Exception {
    String xml = new TextOf(
      new ResourceOf("/com/example/abc.xml") // absolute path always!
    ).asString();
  }
}
19
  • 11
    Can do this as simply without external library dependency.
    – Glen Best
    Nov 5, 2012 at 6:35
  • 8
    @yegor256 since it's a unit test closing resources is particularly important. "Unit" tests should be fast and self contained, leaving resources open, potentially for the duration of the test run, means at best your tests run slower, and at worst fail in difficult-to-diagnose ways.
    – dimo414
    May 27, 2014 at 7:24
  • 4
    Just as compact, but with proper closing of the input stream: IOUtils.toString(this.getClass().getResource("foo.xml"), "UTF-8"). Mar 5, 2015 at 17:53
  • 6
    Hey @yegor256, isn't IOUtils.toString static method? How would you solve it now, according to your well known static dislike? Feb 15, 2016 at 22:20
  • 3
    This only works if the file is located in the same package. What if they are not in the same package
    – Tiina
    Sep 22, 2016 at 8:17
171

Right to the point :

ClassLoader classLoader = getClass().getClassLoader();
File file = new File(classLoader.getResource("file/test.xml").getFile());
6
  • 2
    Works for me when using junit test and want to setup test by loading xls file into byte[] form.
    – Mubasher
    Mar 14, 2016 at 10:29
  • 10
    OP asks "What is the easiest way just to get the content of the file into String?" This answer would be even better if it directly answered that.
    – A.Wan
    Feb 23, 2018 at 23:51
  • 2
    getClass().getClassLoader().getResource("test.xml");
    – Belun
    Apr 26, 2018 at 4:53
  • 3
    File file = new File(getClass().getResource("/responses/example.json").getFile()); Seems to work just fine too, without getClassLoader().
    – Astrus
    Nov 26, 2018 at 13:29
  • 1
    This won't work if your method is static. Nov 14, 2020 at 17:06
100

Assume UTF8 encoding in file - if not, just leave out the "UTF8" argument & will use the default charset for the underlying operating system in each case.

Quick way in JSE 6 - Simple & no 3rd party library!

import java.io.File;
public class FooTest {
  @Test public void readXMLToString() throws Exception {
        java.net.URL url = MyClass.class.getResource("test/resources/abc.xml");
        //Z means: "The end of the input but for the final terminator, if any"
        String xml = new java.util.Scanner(new File(url.toURI()),"UTF8").useDelimiter("\\Z").next();
  }
}

Quick way in JSE 7

public class FooTest {
  @Test public void readXMLToString() throws Exception {
        java.net.URL url = MyClass.class.getResource("test/resources/abc.xml");
        java.nio.file.Path resPath = java.nio.file.Paths.get(url.toURI());
        String xml = new String(java.nio.file.Files.readAllBytes(resPath), "UTF8"); 
  }

Quick way since Java 9

new String(getClass().getClassLoader().getResourceAsStream(resourceName).readAllBytes());

Neither intended for enormous files though.

11
  • 1
    the 2nd example doesn't work, readAllBytes doesn't seem to accept URL... the closest I got to make it work is String xml = new String(java.nio.file.Files.readAllBytes(Paths.get(url.toURI())), "UTF8");
    – Eran Medan
    Jun 13, 2013 at 20:06
  • It does work - needs an argument of type Path. That's why I called it resPath. :)
    – Glen Best
    Jun 15, 2013 at 0:36
  • 2
    The above reads the file contents directly into a string in memory. So, for example, if you have 4GB of memory, then a file of somewhere between 1-4GB probably classifies as "enormous" because it will consume a very significant proportation of memory resources (page swapping to disk, aside). For large files, better to stream - read in chunks, not all at once.
    – Glen Best
    Nov 6, 2013 at 3:19
  • 2
    java7 version is perfect, tip: use StandardCharsets.UTF_8 to avoid the unsupportedEncodingException
    – pdem
    Feb 2, 2016 at 16:01
  • 1
    Can you explain why you're using MyClass rather than for example FoTest and when you want to use which class?
    – phant0m
    Aug 3, 2016 at 15:12
16

First make sure that abc.xml is being copied to your output directory. Then you should use getResourceAsStream():

InputStream inputStream = 
    Thread.currentThread().getContextClassLoader().getResourceAsStream("test/resources/abc.xml");

Once you have the InputStream, you just need to convert it into a string. This resource spells it out: http://www.kodejava.org/examples/266.html. However, I'll excerpt the relevent code:

public String convertStreamToString(InputStream is) throws IOException {
    if (is != null) {
        Writer writer = new StringWriter();

        char[] buffer = new char[1024];
        try {
            Reader reader = new BufferedReader(
                    new InputStreamReader(is, "UTF-8"));
            int n;
            while ((n = reader.read(buffer)) != -1) {
                writer.write(buffer, 0, n);
            }
        } finally {
            is.close();
        }
        return writer.toString();
    } else {        
        return "";
    }
}
5
  • 3
    What is your output directory?
    – yegor256
    Oct 8, 2010 at 14:42
  • @Vincenzo, usually "classes" though perhaps "bin". i.e. wherever you are compiling your classes to. Most IDEs already copy resource files such as xml files to that directory so you should probably take a quick peak and see if it's already there.
    – Kirk Woll
    Oct 8, 2010 at 14:47
  • Looks like too much code in your case. I would better use some apache.commons.io.* class for file reading, and java.lang.Class.getResource(). What do you think?
    – yegor256
    Oct 11, 2010 at 11:39
  • A nice way to test it would be if you write the test cases in a ".properties" file with testKey = value and then you can load the InputStream directly. Example: Properties properties = new Properties(); properties.load(inputStream); String testCase = properties.getProperty("testKey");
    – Benny Code
    Mar 26, 2014 at 17:13
  • 2
    How to make that abc.xml be copied to output directory? @KirkWoll
    – Jeff Tian
    Dec 22, 2017 at 8:05
14

With the use of Google Guava:

import com.google.common.base.Charsets;
import com.google.common.io.Resources;

public String readResource(final String fileName, Charset charset) throws Exception {
        try {
            return Resources.toString(Resources.getResource(fileName), charset);
        } catch (IOException e) {
            throw new IllegalArgumentException(e);
        }
}

Example:

String fixture = this.readResource("filename.txt", Charsets.UTF_8)
0
7

You can try doing:

String myResource = IOUtils.toString(this.getClass().getResourceAsStream("yourfile.xml")).replace("\n","");
4
  • 3
    Why are you stripping new lines?
    – zudduz
    May 19, 2016 at 19:02
  • 3
    @zudduz i'm sorry i don't remember, this was 2 years ago May 20, 2016 at 13:53
  • 2
    IOUtils.toString toString(stream) is also deprecated. A Charsets needed to be passed in IOUtils.toString toString(stream, Charsets.UTF_8) (import com.google.common.base.Charsets;)
    – rjdkolb
    Apr 10, 2017 at 5:53
  • Actually to avoid deprecation, it should be : String myResource = IOUtils.toString(this.getClass().getResourceAsStream("yourfile.xml"), StandardCharsets.UTF_8).replace("\n","");
    – rjdkolb
    May 5, 2021 at 14:45
3

OK, for JAVA 8, after a lot of debugging I found that there's a difference between

URL tenantPathURI = getClass().getResource("/test_directory/test_file.zip");

and

URL tenantPathURI = getClass().getResource("test_directory/test_file.zip");

Yes, the / at the beginning of the path without it I was getting null!

and the test_directory is under the test directory.

3

Simplest, using Apache Commons IO:

IOUtils.resourceToString("/foo/text.txt", StandardCharsets.UTF_8);
2

Here's what i used to get the text files with text. I used commons' IOUtils and guava's Resources.

public static String getString(String path) throws IOException {
    try (InputStream stream = Resources.getResource(path).openStream()) {
        return IOUtils.toString(stream);
    }
}
1

You can use a Junit Rule to create this temporary folder for your test:

@Rule public TemporaryFolder temporaryFolder = new TemporaryFolder();
File file = temporaryFolder.newFile(".src/test/resources/abc.xml");
2
  • @JohannesRabauer It accesses the file that OP asked for, on every test run. Feb 22, 2023 at 13:07
  • 1
    in every run of the test, a new temporary folder is created. In this folder a new file "...abc.xml" is created. This means with your code the already existing file in "src/test/resources/abc.xml" is not accessed but a different file is created. Feb 23, 2023 at 14:25
1

Using Commons.IO, this method works from EITHER a instance method or a static method:

public static String loadTestFile(String fileName) {
    File file = FileUtils.getFile("src", "test", "resources", fileName);
    try {
        return FileUtils.readFileToString(file, StandardCharsets.UTF_8);
    } catch (IOException e) {
        log.error("Error loading test file: " + fileName, e);
        return StringUtils.EMPTY;
    }
}
0

If you're using okio in your project:

val text = FileSystem.RESOURCES.source("abc.xml".toPath()
  .buffer()
  .readString()

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.