BackendBench
Coffee

Unravel โ€บ Java concepts โ€บ I/O and files

I/O and data

Properties files, Locale and resource bundles

Properties loads key=value text files into a map.

๐Ÿ”Ž Unravel this examplePrerequisites (1)

Learn these first

Files and I/O

At a glance

Mental model

Properties is a settings notebook with one setting per line.

What happens, in order
  1. 1Properties p = new Properties(); p.load(in); then p.getProperty("timeout", "30") with a default valueValues are always strings; convert them yourself.
  2. 2ResourceBundle.getBundle("messages", Locale.GERMAN).getString("welcome") reads messages_de.properties, falling back to messages.properties
  3. 3MessageFormat.format("Hello {0}, you have {1} new messages", name, n) fills numbered placeholders, and handles plural choices with a pattern
  4. 4A Locale controls number and date formatting (1.234,56 vs 1,234.56), sorting order and case rules
Remember
Watch out
Forgetting that every value is a StringRelying on the default Locale for output that is parsed againOpening the properties file with the wrong class loader or path
Example (highlighted lines explain it)
import java.io.*;import java.util.*;public class Config {  static Properties load(String path) throws IOException {    Properties p = new Properties();    try (Reader r = new FileReader(path, java.nio.charset.StandardCharsets.UTF_8)) { p.load(r); }    return p;  }  static int timeout(Properties p) { return Integer.parseInt(p.getProperty("timeout", "30")); }  static String greet(String name) { return ResourceBundle.getBundle("messages", Locale.GERMAN).getString("hello") + " " + name; }}
  1. line 4 uses Properties, the core of Properties files, Locale and resource bundles
  2. line 5 uses Properties, the core of Properties files, Locale and resource bundles
  3. line 9 uses Properties, the core of Properties files, Locale and resource bundles
  4. line 10 uses ResourceBundle, the core of Properties files, Locale and resource bundles
Read the full explanation (about 1 min)

Properties loads key=value text files into a map. Locale and ResourceBundle pick language-specific texts, number formats and date formats for the user's region.

A mental model

Properties is a settings notebook with one setting per line. A ResourceBundle is a set of phrasebooks (English, German, French) and the Locale is the page marker telling the program which one to open.

How it works

Properties p = new Properties(); p.load(in); then p.getProperty("timeout", "30") with a default value. Values are always strings; convert them yourself.

ResourceBundle.getBundle("messages", Locale.GERMAN).getString("welcome") reads messages_de.properties, falling back to messages.properties.

MessageFormat.format("Hello {0}, you have {1} new messages", name, n) fills numbered placeholders, and handles plural choices with a pattern.

A Locale controls number and date formatting (1.234,56 vs 1,234.56), sorting order and case rules.

Going deeper

.properties files were read as ISO-8859-1 before Java 9; since then UTF-8 is the default for resource bundles. Load a plain Properties through a Reader with an explicit charset.

Always pass a Locale to formatting for machine-readable output (Locale.ROOT or Locale.US); the default locale makes tests pass on your laptop and fail on the CI server.

Spring Boot replaces most hand-written Properties code with @ConfigurationProperties, but plain Properties still appears in JDBC, Kafka and many older libraries.

Under the hood

Properties extends Hashtable<Object,Object>, so it is synchronized and accepts non-String values, which is a design wart. ResourceBundle.getBundle caches bundles per class loader and walks a fallback chain of candidate names.

Common mistakes

  • Forgetting that every value is a String.
  • Relying on the default Locale for output that is parsed again.
  • Opening the properties file with the wrong class loader or path.

How Unravel recognises it

When you paste code, Unravel looks for these signs of properties files, locale and resource bundles. Spotting them yourself is a good habit when you read unfamiliar code:

Part of a learning path

Related concepts

Spring configuration propertiesSpringFormatting text and numbersJava languageSystem, Runtime and environmentJava language

Frequently asked questions

What is Properties files, Locale and resource bundles?

Properties loads key=value text files into a map. Locale and ResourceBundle pick language-specific texts, number formats and date formats for the user's region.

What are the most common mistakes with Properties files, Locale and resource bundles?

Forgetting that every value is a String. Relying on the default Locale for output that is parsed again. Opening the properties file with the wrong class loader or path.

How can I see Properties files, Locale and resource bundles in real code?

Paste your own Java into Unravel and it will point out where properties files, locale and resource bundles appears, explain how it works at the detail level you choose, and draw the flow of the code around it.