Java Programming Tutorials

Java programming tutorials with many code examples!

Java Properties store


How to store Java Properties? Properties class has methods to store/save to different outputs – OutputStream, Writer or even XML file. Here’s an example of


java.util.Properties class has a few methods that allow to save properties (key-value pairs) in a format suitable for further load using Properties.load() methods. The methods to save properties are:

  • void save(OutputStream out, String comments)
    This one is Deprecated. so we won’t describe it – use below methods instead.
  • void store(OutputStream out, String comments)
    Writes property list into OutputStream and precedes with comments (see below example and it become clear ;-) )
  • void store(Writer writer, String comments)
    Writes property list into Writer and precedes with comments (as the above method, but using Writer).

Here’s an example of in action:


import java.nio.file.Files;
import java.nio.file.Path;
import java.util.Properties;

public class PropertiesStore {

    public static void main(String[] args) throws IOException {
        Properties config = createAppProperties();


        Path configFile = saveToFile(config);


    private static Properties createAppProperties() {
        Properties config = new Properties();
        config.setProperty("minThreads", "5");
        config.setProperty("maxThreads", "40");
        return config;

    private static void displayFile(Path path) throws IOException {
        System.out.printf("%nContents of %s:%n", path.toString());

    private static void printToSystemOutput(Properties config) throws IOException {, "Writing to System.out:");

    private static Path saveToFile(Properties config) throws IOException {
        Path file = Files.createTempFile("app-config", ".properties");
        // To use store(Writer) change to Files.newBufferedWriter(file)
        try (OutputStream stream = Files.newOutputStream(file)) {
  , "Writing to a file using OutputStream:");
        return file;

In the example we’ve used a few features from Java 7 and Java 8java.Path, Files, try-with-resources, and forEach to which we pass static method as parameter.

And here is the result of running the above code:

#Writing to System.out:
#Sat Sep 05 10:25:24 CEST 2015

Contents of /tmp/
#Writing to a file using OutputStream:
#Sat Sep 05 10:25:24 CEST 2015

Note that the properties have not been written in the same order they were added into the Properties object. Another thing is that the timestamp is added automatically – at wasn’t in the comments.

Was it helpful? Share!