38  *
  39  */
  40 
  41 package sun.util.resources;
  42 
  43 import java.util.Map;
  44 import java.util.LinkedHashMap;
  45 import java.util.LinkedHashSet;
  46 import java.util.MissingResourceException;
  47 import java.util.Objects;
  48 import java.util.Set;
  49 
  50 /**
  51  * Subclass of <code>ResourceBundle</code> with special
  52  * functionality for time zone names. The additional functionality:
  53  * <ul>
  54  * <li>Preserves the order of entries in the <code>getContents</code>
  55  *     array for the enumeration returned by <code>getKeys</code>.
  56  * <li>Inserts the time zone ID (the key of the bundle entries) into
  57  *     the string arrays returned by <code>handleGetObject</code>.
  58  * <ul>
  59  * All <code>TimeZoneNames</code> resource bundles must extend this
  60  * class and implement the <code>getContents</code> method.
  61  */
  62 public abstract class TimeZoneNamesBundle extends OpenListResourceBundle {
  63 
  64     /**
  65      * Maps time zone IDs to locale-specific names.
  66      * The value returned is an array of five strings:
  67      * <ul>
  68      * <li>The time zone ID (same as the key, not localized).
  69      * <li>The long name of the time zone in standard time (localized).
  70      * <li>The short name of the time zone in standard time (localized).
  71      * <li>The long name of the time zone in daylight savings time (localized).
  72      * <li>The short name of the time zone in daylight savings time (localized).
  73      * <li>The long name of the time zone in generic form (localized).
  74      * <li>The short name of the time zone in generic form (localized).
  75      * </ul>
  76      * The localized names come from the subclasses's
  77      * <code>getContents</code> implementations, while the time zone
  78      * ID is inserted into the returned array by this method.

  38  *
  39  */
  40 
  41 package sun.util.resources;
  42 
  43 import java.util.Map;
  44 import java.util.LinkedHashMap;
  45 import java.util.LinkedHashSet;
  46 import java.util.MissingResourceException;
  47 import java.util.Objects;
  48 import java.util.Set;
  49 
  50 /**
  51  * Subclass of <code>ResourceBundle</code> with special
  52  * functionality for time zone names. The additional functionality:
  53  * <ul>
  54  * <li>Preserves the order of entries in the <code>getContents</code>
  55  *     array for the enumeration returned by <code>getKeys</code>.
  56  * <li>Inserts the time zone ID (the key of the bundle entries) into
  57  *     the string arrays returned by <code>handleGetObject</code>.
  58  * </ul>
  59  * All <code>TimeZoneNames</code> resource bundles must extend this
  60  * class and implement the <code>getContents</code> method.
  61  */
  62 public abstract class TimeZoneNamesBundle extends OpenListResourceBundle {
  63 
  64     /**
  65      * Maps time zone IDs to locale-specific names.
  66      * The value returned is an array of five strings:
  67      * <ul>
  68      * <li>The time zone ID (same as the key, not localized).
  69      * <li>The long name of the time zone in standard time (localized).
  70      * <li>The short name of the time zone in standard time (localized).
  71      * <li>The long name of the time zone in daylight savings time (localized).
  72      * <li>The short name of the time zone in daylight savings time (localized).
  73      * <li>The long name of the time zone in generic form (localized).
  74      * <li>The short name of the time zone in generic form (localized).
  75      * </ul>
  76      * The localized names come from the subclasses's
  77      * <code>getContents</code> implementations, while the time zone
  78      * ID is inserted into the returned array by this method.