Java.util.ResourceBundle.getBundle() Method



The java.util.ResourceBundle.getBundle(String baseName,ResourceBundle.Control control) method returns a resource bundle using the specified base name, the default locale and the specified control.


Following is the declaration for java.util.ResourceBundle.getBundle() method

public static final ResourceBundle getBundle(String baseName,ResourceBundle.Control control)


  • baseName -- the base name of the resource bundle, a fully qualified class name

  • control -- the control which gives information for the resource bundle loading process

Return Value

This method returns a resource bundle for the given base name and the default locale


  • NullPointerException -- if baseName or control is null

  • MissingResourceException -- if no resource bundle for the specified base name can be found

  • IllegalArgumentException -- if the given control doesn't perform properly (e.g., control.getCandidateLocales returns null.) Note that validation of control is performed as needed.


The following example shows the usage of java.util.ResourceBundle.getBundle() method.

package com.tutorialspoint;

import java.util.ResourceBundle;
import java.util.ResourceBundle.Control;

public class ResourceBundleDemo {

   public static void main(String[] args) {

   // create a new ResourceBundle.Control with default format
   ResourceBundle.Control rbc =

   // create a new ResourceBundle with default locale and a Control
   ResourceBundle bundle =
   ResourceBundle.getBundle("hello", rbc);

   // print the text assigned to key "hello"
   System.out.println("" + bundle.getString("hello"));


Assuming we have a resource file available in your CLASSPATH, with the following content. This file will be used as an input for our example program:

hello=Hello World!

Let us compile and run the above program, this will produce the following result:

Hello World!