Java Input Output. This tutorial explains how to read and write files via Java.

1. Java I/O (Input / Output) for files

1.1. Overview

Java provides the java.nio.file API to read and write files. The InputStream class is the superclass of all classes representing an input stream of bytes.

1.2. Reading a file in Java

To read a text file you can use the Files.readAllBytes method. The usage of this method is demonstrated in the following listing.

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;

// somewhere in your code

String content = Files.readString(Path.of("resources", "work", "input.xml"));

To read a text file line by line into a List of type String structure you can use the Files.readAllLines method.

List<String> lines = Files.readAllLines(Paths.get(fileName));

Files.readAllLines uses UTF-8 character encoding. It also ensures that file is closed after all bytes are read or in case an exception occurred.

1.3. Reading and filtering line by line

The Files.lines method allows read a file line by line, offering a stream. This stream can be filtered and mapped. Files.lines does not close the file once its content is read, therefore it should be wrapped inside a try-with-resource statement.

In the following example unnecessary whitespace at the end of each line is removed and empty lines are filterer.

//read all lines and remove whitespace (trim)
//filter empty lines
//and print result to System.out

Files.lines(new File("input.txt").toPath())
    .map(s -> s.trim())
 .filter(s -> !s.isEmpty())
 .forEach(System.out::println);

The next example demonstrates how to filter out lines based on a certain regular expression.

Files.lines(new File("input.txt").toPath())
    .map(s -> s.trim())
 .filter(s -> !s.matches("yourregularexpression"))
 .forEach(System.out::println);

The next example extracts a line starting with "Bundle-Version:" from a file called MANIFEST.MF located in the META-INF folder. It removes the prefix and removes all leading and trailing whitespace.

package com.vogella.eclipse.ide.first;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.Optional;
import java.util.stream.Stream;

public class ReadMANIFESTFile {
    public static void main(String[] args) throws IOException {
        String versionString = readStreamOfLinesUsingFiles();
        System.out.println(versionString);
    }

    private static String readStreamOfLinesUsingFiles() throws IOException {
        Stream<String> lines = Files.lines(Paths.get("META-INF", "MANIFEST.MF"));
        Optional<String> versionString = lines.filter(s -> s.contains("Bundle-Version:")).map(e-> e.substring(15).trim()).findFirst();

        lines.close();
        if (versionString.isPresent())
        {
            return versionString.get();
        }
        return "";
    }
}

1.4. Writing a file in Java

To write a file you can use the following method:

Files.write(stateFile.toPath(), content.getBytes(StandardCharsets.UTF_8), StandardOpenOption.CREATE);

1.5. List all files and sub-directories using Files.list()

You can access files relative to the current execution directory of your Java program. To access the current directory in which your Java program is running, you can use the following statement.

// writes all files of the current directory
Files.list(Paths.get(".")).forEach(System.out::println);

1.6. How to identify the current directory

String currentDir = System.getProperty("user.dir");

2. Exercise: Reading and writing files

Create a new Java project called com.vogella.java.files. Create the following FilesUtil.java class.

package com.vogella.java.files;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.nio.file.StandardOpenOption;
import java.util.List;

public class FilesUtil {
    public static String readTextFile(String fileName) throws IOException {
        String content = new String(Files.readAllBytes(Paths.get(fileName)));
        return content;
    }

    public static List<String> readTextFileByLines(String fileName) throws IOException {
        List<String> lines = Files.readAllLines(Paths.get(fileName));
        return lines;
    }

    public static void writeToTextFile(String fileName, String content) throws IOException {
        Files.write(Paths.get(fileName), content.getBytes(), StandardOpenOption.CREATE);
    }

}

To test these methods, create a text file called file.txt with some content in your project folder. Create the following Main class and run it.

package com.vogella.java.files;

import java.io.IOException;
import java.nio.file.Path;
import java.nio.file.Paths;

public class Main {
  public static void main(String[] args) throws IOException {
    String input = FilesUtil.readTextFile("file.txt");
    System.out.println(input);
    FilesUtil.writeToTextFile("copy.txt", input);

    System.out.println(FilesUtil.readTextFile("copy.txt"));

    FilesUtil.readTextFileByLines("file.txt");
    Path path = Paths.get("file.txt");
  }
}

3. Example: Recursively listing all files of a diretory

Java 8 provides a nice stream to process all files in a tree.

Files.walk(Paths.get(path))
     .filter(Files::isRegularFile)
     .forEach(System.out::println);

4. Example: Deleting a directory with all subdirectories and files

To delete a directory and all its content.

String stringPath="...yourPath...";
Path path = new File(stringPath).toPath();
Files.walk(path)
    .sorted(Comparator.reverseOrder())
    .map(Path::toFile)
.forEach(File::delete);

5. Reading resources out of your project / jar

You can read resources from your project or your jar file via the .getClass().getResourceAsStream() method chain from any object.

6. Links and Literature

Nothing listed.

If you need more assistance we offer Online Training and Onsite training as well as consulting