src/share/classes/java/util/ServiceLoader.java

Print this page
rev 7727 : 8020539: Clean up doclint problems in java.util package, part 2
Summary: Clean up doclint errors and warnings in classes in java.util
Reviewed-by: darcy,chegar
Contributed-by: Brian Burkhalter <brian.burkhalter@oracle.com>

*** 66,81 **** * provider classes must have a zero-argument constructor so that they can be * instantiated during loading. * * <p><a name="format"> A service provider is identified by placing a * <i>provider-configuration file</i> in the resource directory ! * <tt>META-INF/services</tt>. The file's name is the fully-qualified <a * href="../lang/ClassLoader.html#name">binary name</a> of the service's type. * The file contains a list of fully-qualified binary names of concrete * provider classes, one per line. Space and tab characters surrounding each * name, as well as blank lines, are ignored. The comment character is ! * <tt>'#'</tt> (<tt>'&#92;u0023'</tt>, <font size="-1">NUMBER SIGN</font>); on * each line all characters following the first comment character are ignored. * The file must be encoded in UTF-8. * * <p> If a particular concrete provider class is named in more than one * configuration file, or is named in the same configuration file more than --- 66,82 ---- * provider classes must have a zero-argument constructor so that they can be * instantiated during loading. * * <p><a name="format"> A service provider is identified by placing a * <i>provider-configuration file</i> in the resource directory ! * <tt>META-INF/services</tt>.</a> The file's name is the fully-qualified <a * href="../lang/ClassLoader.html#name">binary name</a> of the service's type. * The file contains a list of fully-qualified binary names of concrete * provider classes, one per line. Space and tab characters surrounding each * name, as well as blank lines, are ignored. The comment character is ! * <tt>'#'</tt> (<tt>'&#92;u0023'</tt>, ! * <font style="font-size:smaller;">NUMBER SIGN</font>); on * each line all characters following the first comment character are ignored. * The file must be encoded in UTF-8. * * <p> If a particular concrete provider class is named in more than one * configuration file, or is named in the same configuration file more than
*** 482,491 **** --- 483,494 ---- /** * Creates a new service loader for the given service type and class * loader. * + * @param <S> the class of the service type + * * @param service * The interface or abstract class representing the service * * @param loader * The class loader to be used to load provider-configuration files
*** 515,524 **** --- 518,529 ---- * * <blockquote><pre> * ServiceLoader.load(<i>service</i>, * Thread.currentThread().getContextClassLoader())</pre></blockquote> * + * @param <S> the class of the service type + * * @param service * The interface or abstract class representing the service * * @return A new service loader */
*** 544,553 **** --- 549,560 ---- * <p> This method is intended for use when only installed providers are * desired. The resulting service will only find and load providers that * have been installed into the current Java virtual machine; providers on * the application's class path will be ignored. * + * @param <S> the class of the service type + * * @param service * The interface or abstract class representing the service * * @return A new service loader */