[java] Add JSpecify nullable annotations to exception classes (#16026)

* Add JSpecify nullable annotations to exception classes

* fix dependencies on jspecify

* add dependency jspecify to build bazel

---------

Co-authored-by: Diego Molina <diemol@users.noreply.github.com>

Author: iampopovich

java/src/org/openqa/selenium/InvalidCookieDomainException.java

@@ -17,23 +17,27 @@
 
 package org.openqa.selenium;
 
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
+
 /**
  * Thrown when attempting to add a cookie under a different domain than the current URL.
  *
  * @see org.openqa.selenium.WebDriver.Options#addCookie(Cookie)
  */
+@NullMarked
 public class InvalidCookieDomainException extends WebDriverException {
   public InvalidCookieDomainException() {}
 
-  public InvalidCookieDomainException(String message) {
+  public InvalidCookieDomainException(@Nullable String message) {
     super(message);
   }
 
-  public InvalidCookieDomainException(Throwable cause) {
+  public InvalidCookieDomainException(@Nullable Throwable cause) {
     super(cause);
   }
 
-  public InvalidCookieDomainException(String message, Throwable cause) {
+  public InvalidCookieDomainException(@Nullable String message, @Nullable Throwable cause) {
     super(message, cause);
   }
 }

java/src/org/openqa/selenium/UnableToSetCookieException.java

@@ -17,23 +17,27 @@
 
 package org.openqa.selenium;
 
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
+
 /**
  * Thrown when a driver fails to set a cookie.
  *
  * @see org.openqa.selenium.WebDriver.Options#addCookie(Cookie)
  */
+@NullMarked
 public class UnableToSetCookieException extends WebDriverException {
   public UnableToSetCookieException() {}
 
-  public UnableToSetCookieException(String message) {
+  public UnableToSetCookieException(@Nullable String message) {
     super(message);
   }
 
-  public UnableToSetCookieException(Throwable cause) {
+  public UnableToSetCookieException(@Nullable Throwable cause) {
     super(cause);
   }
 
-  public UnableToSetCookieException(String message, Throwable cause) {
+  public UnableToSetCookieException(@Nullable String message, @Nullable Throwable cause) {
     super(message, cause);
   }
 }

java/src/org/openqa/selenium/devtools/DevToolsException.java

@@ -17,19 +17,22 @@
 
 package org.openqa.selenium.devtools;
 
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
 import org.openqa.selenium.WebDriverException;
 
+@NullMarked
 public class DevToolsException extends WebDriverException {
 
-  public DevToolsException(Throwable cause) {
+  public DevToolsException(@Nullable Throwable cause) {
     this(cause.getMessage(), cause);
   }
 
-  public DevToolsException(String message) {
+  public DevToolsException(@Nullable String message) {
     this(message, null);
   }
 
-  public DevToolsException(String message, Throwable cause) {
+  public DevToolsException(@Nullable String message, @Nullable Throwable cause) {
     super(message, cause);
     addInfo(WebDriverException.DRIVER_INFO, "DevTools Connection");
   }

java/src/org/openqa/selenium/json/BUILD.bazel

@@ -14,5 +14,6 @@ java_export(
     ],
     deps = [
         "//java/src/org/openqa/selenium:core",
+        "@maven//:org_jspecify_jspecify",
     ],
 )

java/src/org/openqa/selenium/json/JsonException.java

@@ -17,19 +17,22 @@
 
 package org.openqa.selenium.json;
 
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
 import org.openqa.selenium.WebDriverException;
 
+@NullMarked
 public class JsonException extends WebDriverException {
 
-  public JsonException(String message) {
+  public JsonException(@Nullable String message) {
     super(message);
   }
 
-  public JsonException(Throwable cause) {
+  public JsonException(@Nullable Throwable cause) {
     super(cause);
   }
 
-  public JsonException(String message, Throwable cause) {
+  public JsonException(@Nullable String message, @Nullable Throwable cause) {
     super(message, cause);
   }
 }

java/src/org/openqa/selenium/remote/ScreenshotException.java

@@ -17,19 +17,22 @@
 
 package org.openqa.selenium.remote;
 
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
 import org.openqa.selenium.WebDriverException;
 
+@NullMarked
 public class ScreenshotException extends WebDriverException {
 
-  public ScreenshotException(String message) {
+  public ScreenshotException(@Nullable String message) {
     super(message);
   }
 
-  public ScreenshotException(Throwable cause) {
+  public ScreenshotException(@Nullable Throwable cause) {
     super(cause);
   }
 
-  public ScreenshotException(String message, Throwable cause) {
+  public ScreenshotException(@Nullable String message, @Nullable Throwable cause) {
     super(message, cause);
   }
 }