8025745: Clarify API documentation of JAXP factories

Clarifies usage of ServiceLoader in JAXP factories.

Reviewed-by: alanb, joehw, psandoz
This commit is contained in:
Daniel Fuchs 2013-10-04 19:15:10 +02:00
parent 6c9d2e5e04
commit 785483b7a9
9 changed files with 85 additions and 12 deletions

View file

@ -148,7 +148,14 @@ public abstract class SchemaFactory {
* <li>
* Use the service-provider loading facilities, defined by the
* {@link java.util.ServiceLoader} class, to attempt to locate and load an
* implementation of the service.<br>
* implementation of the service using the {@linkplain
* java.util.ServiceLoader#load(java.lang.Class) default loading mechanism}:
* the service-provider loading facility will use the {@linkplain
* java.lang.Thread#getContextClassLoader() current thread's context class loader}
* to attempt to load the service. If the context class
* loader is null, the {@linkplain
* ClassLoader#getSystemClassLoader() system class loader} will be used.
* <br>
* Each potential service provider is required to implement the method
* {@link #isSchemaLanguageSupported(String schemaLanguage)}.
* <br>