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

8336679: Add @implSpec for the default implementations in Process.waitFor()

Browse source 
Reviewed-by: bpb, jlu, liach
This commit is contained in:
Naoto Sato 2024-07-24 16:48:34 +00:00
parent 04e8cb8641
commit 4ea4d7c684
1 changed files with 14 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

22
src/java.base/share/classes/java/lang/Process.java
View file

@ -442,10 +442,13 @@ public abstract class Process {
* terminated and the timeout value is less than, or equal to, zero, then * terminated and the timeout value is less than, or equal to, zero, then
* this method returns immediately with the value {@code false}. * this method returns immediately with the value {@code false}.
* *
* <p>The default implementation of this method polls the {@code exitValue} * @implSpec
* to check if the process has terminated. Concrete implementations of this * The default implementation of this method polls the {@code exitValue}
* class are strongly encouraged to override this method with a more * to check if the process has terminated.
* efficient implementation. *
* @implNote
* Concrete implementations of this class are strongly encouraged to
* override this method with a more efficient implementation.
* *
* @param timeout the maximum time to wait * @param timeout the maximum time to wait
* @param unit the time unit of the {@code timeout} argument * @param unit the time unit of the {@code timeout} argument
@ -486,10 +489,13 @@ public abstract class Process {
* terminated and the duration is not positive, then * terminated and the duration is not positive, then
* this method returns immediately with the value {@code false}. * this method returns immediately with the value {@code false}.
* *
* <p>The default implementation of this method polls the {@code exitValue} * @implSpec
* to check if the process has terminated. Concrete implementations of this * The default implementation of this method polls the {@code exitValue}
* class are strongly encouraged to override this method with a more * to check if the process has terminated.
* efficient implementation. *
* @implNote
* Concrete implementations of this class are strongly encouraged to
* override this method with a more efficient implementation.
* *
* @param duration the maximum duration to wait; if not positive, * @param duration the maximum duration to wait; if not positive,
* this method returns immediately. * this method returns immediately.