[java] create special driver exception for referencing documentation

Author: titusfortner

java/src/org/openqa/selenium/manager/SeleniumManager.java

@@ -170,7 +170,7 @@ private synchronized File getBinary() {
         }
         binary.setExecutable(true);
       } catch (Exception e) {
-        throw new WebDriverException("Unable to obtain Selenium Manager", e);
+        throw new WebDriverException("Unable to obtain Selenium Manager Binary", e);
       }
     }
     return binary;

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

@@ -0,0 +1,43 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+package org.openqa.selenium.remote;
+
+import org.openqa.selenium.Capabilities;
+import org.openqa.selenium.WebDriverException;
+import org.openqa.selenium.remote.service.DriverService;
+
+/**
+ * Thrown by {@link org.openqa.selenium.remote.service.DriverFinder#getPath(DriverService, Capabilities)}.
+ */
+public class NoSuchDriverException extends WebDriverException {
+
+  private static final String SUPPORT_URL = BASE_SUPPORT_URL + "/driver_location/";
+
+  public NoSuchDriverException(String reason) {
+    super(reason);
+  }
+
+  public NoSuchDriverException(String reason, Throwable cause) {
+    super(reason, cause);
+  }
+
+  @Override
+  public String getSupportUrl() {
+    return SUPPORT_URL;
+  }
+}

java/src/org/openqa/selenium/remote/service/DriverFinder.java

@@ -6,6 +6,7 @@
 import org.openqa.selenium.internal.Require;
 import org.openqa.selenium.manager.SeleniumManager;
 import org.openqa.selenium.os.ExecutableFinder;
+import org.openqa.selenium.remote.NoSuchDriverException;
 
 public class DriverFinder {
 
@@ -25,24 +26,22 @@ public static String getPath(DriverService service, Capabilities options) {
       try {
         exePath = SeleniumManager.getInstance().getDriverPath(options);
       } catch (Exception e) {
-        LOG.warning(
-            String.format(
-                "Unable to obtain %s using Selenium Manager: %s",
-                service.getDriverName(), e.getMessage()));
+        throw new NoSuchDriverException(String.format(
+          "Unable to obtain: %s", options), e);
       }
     }
 
-    String validPath =
-        Require.state("The path to the driver executable", exePath)
-            .nonNull(
-                "Unable to locate the %s executable; for more information on how to install"
-                    + " drivers, see"
-                    + " https://www.selenium.dev/documentation/webdriver/getting_started/install_drivers/",
-                service.getDriverName());
-
-    File exe = new File(validPath);
-    Require.state("The driver executable", exe).isFile();
-    Require.stateCondition(exe.canExecute(), "It must be an executable file: %s", exe);
-    return validPath;
+    String message = "";
+    if (exePath == null) {
+      message = String.format("Unable to locate or obtain %s", service.getDriverName());
+    } else if (!new File(exePath).exists()) {
+      message = String.format("%s located at %s, but invalid", service.getDriverName(), exePath);
+    } else if (!new File(exePath).canExecute()) {
+      message = String.format("%s located at %s, cannot be executed", service.getDriverName(), exePath);
+    } else {
+      return exePath;
+    }
+
+    throw new NoSuchDriverException(message);
   }
 }