archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 06:45:07 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8310815: Clarify the name of the main class, services and provider classes in module descriptor

Browse source 
8314449: Clarify the name of the declaring class of StackTraceElement

Reviewed-by: alanb
This commit is contained in:
Mandy Chung 2023-08-18 17:10:39 +00:00
parent aecbb1b5c3
commit 50a2ce01f4
2 changed files with 21 additions and 22 deletions
Download patch file Download diff file Expand all files Collapse all files

23
src/java.base/share/classes/java/lang/module/ModuleDescriptor.java
View file

@ -847,26 +847,25 @@ public class ModuleDescriptor
}
/**
* Returns the fully qualified class name of the service type.
*
* @return The fully qualified class name of the service type
* {@return the {@linkplain ClassLoader##binary-name binary name} of the service type}
*/
public String service() { return service; }
/**
* Returns the list of the fully qualified class names of the providers
* or provider factories.
* Returns the list of the {@linkplain ClassLoader##binary-name binary names}
* of the providers or provider factories.
*
* @return A non-empty and unmodifiable list of the fully qualified class
* names of the providers or provider factories
* @return A non-empty and unmodifiable list of the {@linkplain ClassLoader##binary-name
* binary names} of the providers or provider factories
*/
public List<String> providers() { return providers; }
/**
* Compares this {@code Provides} to another.
*
* <p> Two {@code Provides} objects are compared by comparing the fully
* qualified class name of the service type lexicographically. Where the
* <p> Two {@code Provides} objects are compared by comparing the
* {@linkplain ClassLoader##binary-name binary name}
* of the service type lexicographically. Where the
* class names are equal then the list of the provider class names are
* compared by comparing the corresponding elements of both lists
* lexicographically and in sequence. Where the lists differ in size,
@ -1446,8 +1445,8 @@ public class ModuleDescriptor
* <p> If this module is an automatic module then the set of service
* dependences is empty. </p>
*
* @return A possibly-empty unmodifiable set of the fully qualified class
* names of the service types used
* @return A possibly-empty unmodifiable set of the {@linkplain ClassLoader##binary-name
* binary names} of the service types used
*/
public Set<String> uses() {
return uses;
@ -1510,7 +1509,7 @@ public class ModuleDescriptor
/**
* <p> Returns the module main class. </p>
*
* @return The fully qualified class name of the module's main class
* @return The {@linkplain ClassLoader##binary-name binary name} of the module's main class
*/
public Optional<String> mainClass() {
return Optional.ofNullable(mainClass);