Summary

Deprecate com.sun.nio.file.SensitivityWatchEventModifier in the jdk.unsupported module.

Problem

This enum is only used by the polling implementation of java.nio.file.WatchService WatchService. The polling WatchService is used only on macOS and likely to be removed in a future release when a version based on the native file event notification facility becomes available.

Solution

Deprecate com.sun.nio.file.SensitivityWatchEventModifier. This will notify any users and provide an opportunity for them to cease use of this API.

Specification

        --- a/src/jdk.unsupported/share/classes/com/sun/nio/file/SensitivityWatchEventModifier.java
        +++ b/src/jdk.unsupported/share/classes/com/sun/nio/file/SensitivityWatchEventModifier.java
@@ -30,13 +30,22 @@

 /**
  * Defines the <em>sensitivity levels</em> when registering objects with a
  * watch service implementation that polls the file system.
  *
+ * @deprecated
+ * The sensitivity levels were historically used by polling-based
+ * {@link java.nio.file.WatchService WatchService} implementations to configure
+ * the polling interval. They are are no longer used. The {@code WatchService}
+ * implementations in the JDK ignore these {@link java.nio.file.WatchEvent
+ * WatchEvent} modifiers if they are specified when registering a directory
+ * to be watched.
+ *
  * @since 1.7
  */

+@Deprecated(since="21", forRemoval = true)