[loc-en-dev] getLocaleKeywordKeys/getLocaleKeywordValue

[Naoto Sato]

Looks like there are still a couple of occurrences of the term "Unicode 
locale".

Thanks,
Naoto

Yoshito Umaoka wrote:
> In the API review conference call on Tuesday, we agreed that the term 
> "LocaleKeywordXXX" and "Unicode Locale Identifier" might not be 
> appropriate.  I'm going to update the name of these APIs:
> 
> Locale#getLocaleKeywordValue -> getLDMLType
> Locale#getLocaleKeywordKeys -> getLDMLKeys
> Builder#setLocaleKeyword -> setLDMLKeyword
> 
> I'll also add a static definition for LDML extension letter as 
> LDML_EXTENSION_KEY ('u')
> 
> I attached the new  JavaDoc comments and API signature at the end of 
> this message.  If you have any problems with the new names, please 
> respond to the ML.
> 
> -Yoshito
> 
>    /**
>     * <span style="background-color: #00ccff; font-weight: bold">New
>     * API</span> Returns the LDML keyword type value associated with
>     * the specified LDML key for this locale.  LDML keywords are specified
>     * by the 'u' extension and consist of key/type pairs.  The key must be
>     * two alphanumeric characters in length, or an IllegalArgumentException
>     * is thrown.
>     * @param key the LDML key
>     * @return the value ('type') associated with the key, or null if the
>     * locale does not define a value for the key.
>     * @throws IllegalArgumentException if the key is not valid.
>     * @since 1.7
>     */
>    public String getLDMLType(String key)
> 
>    /**
>     * <span style="background-color: #00ccff; font-weight: bold">New 
> API</span>
>     * Returns the set of keys for LDML keywords defined by this locale, or
>     * null if this locale has no locale extension.  The returned set is
>     * immutable.
>     * @return The set of the LDML keys, or null
>     * @since 1.7
>     */
>    public Set<String> getLDMLKeys()
>        /**
>         * <span style="background-color: #00ccff; font-weight: bold">New 
> API</span>
>         * Sets the Unicode locale type for the given key.  If the
>         * type is the empty string, the locale key is removed.
>         * Well-formed keys are strings of two alphanumeric characters. 
> Well-formed
>         * types are strings of three to eight alphanumeric characters.
>         * <p>
>         * <b>Note</b>:Setting the 'u' extension replaces all LDML
>         * keywords with those defined in the extension.
>         * @param key the key
>         * @param type the Unicode locale type
>         * @return this builder
>         * @throws IllegalArgumentException if <code>key</code> or 
> <code>type</code>
>         * is ill-formed
>         * @see #setExtension(char, String)
>         * @since 1.7
>         */
>        public Builder setLDMLKeyword(String key, String type)
> 
>    /**
>     * <span style="background-color: #00ccff; font-weight: bold">New 
> API</span>
>     * The key for LDML extension.
>     * @see #getExtension(char)
>     * @see Builder#setExtension(char, String)
>     * @since 1.7
>     */
>    static public final char LDML_EXTENSION_KEY = 'u';
> 


-- 
Naoto Sato