< prev index next >

src/java.base/share/classes/java/util/spi/ResourceBundleControlProvider.java

Print this page
rev 16532 : [mq]: 8172365

*** 1,7 **** /* ! * Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this --- 1,7 ---- /* ! * Copyright (c) 2012, 2017, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this
*** 33,55 **** * href="../ResourceBundle.html#default_behavior">default resource bundle loading * behavior</a> of the {@code ResourceBundle.getBundle} factory methods that take * no {@link java.util.ResourceBundle.Control} instance can be modified with {@code * ResourceBundleControlProvider} implementations. * * @author Masayoshi Okutsu * @since 1.8 * @see ResourceBundle#getBundle(String, java.util.Locale, ClassLoader, ResourceBundle.Control) * ResourceBundle.getBundle ! * @see java.util.ServiceLoader#loadInstalled(Class) ! * @deprecated There is no longer any mechanism to install a custom ! * {@code ResourceBundleControlProvider} implementation defined ! * by the platform class loader or its ancestor. The recommended ! * way to use a custom {@code Control} implementation to load resource bundle ! * is to use {@link java.util.ResourceBundle#getBundle(String, Control)} ! * or other factory methods that take custom {@link java.util.ResourceBundle.Control}. */ - @Deprecated(since="9", forRemoval=true) public interface ResourceBundleControlProvider { /** * Returns a {@code ResourceBundle.Control} instance that is used * to handle resource bundle loading for the given {@code * baseName}. This method must return {@code null} if the given --- 33,55 ---- * href="../ResourceBundle.html#default_behavior">default resource bundle loading * behavior</a> of the {@code ResourceBundle.getBundle} factory methods that take * no {@link java.util.ResourceBundle.Control} instance can be modified with {@code * ResourceBundleControlProvider} implementations. * + * <p>Provider implementations are loaded from the application's class path + * using {@link java.util.ServiceLoader} at the first invocation of the + * {@code ResourceBundle.getBundle} factory method that takes no + * {@link java.util.ResourceBundle.Control} instance. + * + * <p>All {@code ResourceBundleControlProvider}s are ignored in named modules. + * * @author Masayoshi Okutsu * @since 1.8 * @see ResourceBundle#getBundle(String, java.util.Locale, ClassLoader, ResourceBundle.Control) * ResourceBundle.getBundle ! * @see java.util.ServiceLoader#load(Class) */ public interface ResourceBundleControlProvider { /** * Returns a {@code ResourceBundle.Control} instance that is used * to handle resource bundle loading for the given {@code * baseName}. This method must return {@code null} if the given
< prev index next >