- [Urgent Upgrade Notes](#urgent-upgrade-notes)
    - [(No, really, you MUST read this before you upgrade)](#no-really-you-must-read-this-before-you-upgrade)
  - [Changes by Kind](#changes-by-kind-16)
    - [Deprecation](#deprecation)
    - [API Change](#api-change-5)
    - [Feature](#feature-14)

        if (asInterface == null) {
          throw formatIllegalArgumentException("No such interface: '%s'", scope);
        }
        return Inet6Address.getByAddress(
            v6Address.getHostAddress(), v6Address.getAddress(), asInterface);
      } catch (SocketException | UnknownHostException e) {
        throw new IllegalArgumentException("No such interface: " + scope, e);
      }
    } catch (UnknownHostException e) {

    public boolean isPartialResults() {
        return partialResults;
    }

    /**
     * Gets the facet response containing aggregated facet information.
     *
     * @return The facet response, or null if no facets were requested
     */
    public FacetResponse getFacetResponse() {
        return facetResponse;
    }

    /**
     * Creates a new SearchResultBuilder for constructing SearchResult instances.

        try {
            scriptExecutor.shutdown();
            fail("Expected NullPointerException");
        } catch (NullPointerException e) {
            // Expected behavior when no listener is set
        }
    }

    public void test_addShutdownListener_replacesExisting() {
        // Add first listener
        TestShutdownListener listener1 = new TestShutdownListener();

    checkFromStringCase("192.0.2.2:83", -1, "192.0.2.2", 83, true);
    checkFromStringCase("[2001::2]:85", -1, "2001::2", 85, true);
    checkFromStringCase("goo.gl:65535", 65536, "goo.gl", 65535, true);
    // No port, bad default.
    checkFromStringCase("google.com", -1, "google.com", -1, false);
    checkFromStringCase("192.0.2.1", 65536, "192.0.2.1", -1, false);
    checkFromStringCase("[2001::1]", -1, "2001::1", -1, false);

    checkFromStringCase("192.0.2.2:83", -1, "192.0.2.2", 83, true);
    checkFromStringCase("[2001::2]:85", -1, "2001::2", 85, true);
    checkFromStringCase("goo.gl:65535", 65536, "goo.gl", 65535, true);
    // No port, bad default.
    checkFromStringCase("google.com", -1, "google.com", -1, false);
    checkFromStringCase("192.0.2.1", 65536, "192.0.2.1", -1, false);
    checkFromStringCase("[2001::1]", -1, "2001::1", -1, false);

          </excludePackageNames>
          <!-- Ignore some tags that are found in Java 11 sources but not recognized... under -source 8, I think it was? I can no longer reproduce the failure. -->
          <tags>
            <tag>
              <name>apiNote</name>
              <placement>X</placement>
            </tag>
            <tag>

                    "NullPointerException should be from null ASN1 object.");
        }
    }

    /**
     * Test constructor with a valid token that contains no authorization entries.
     *
     * @throws IOException if ASN.1 encoding fails.
     * @throws PACDecodingException if PAC decoding fails.
     */
    @Test

        assertTrue(endLatch.await(30, TimeUnit.SECONDS), "All threads should complete");
        executor.shutdown();

        // Then - All operations should succeed
        assertTrue(exceptions.isEmpty(), "No exceptions should occur");
        assertEquals(threadCount * opsPerThread, successCount.get(), "All operations should succeed");
    }

    /**
     * Test that buffer cache handles allocation when cache is full.

     */
    @Nonnull
    Map<PathType, List<Path>> getDispatchedPaths();

    /**
     * {@return all dependencies associated with their paths}
     * Some dependencies may be associated with a null value if there is no path available.
     */
    @Nonnull
    Map<Dependency, Path> getDependencies();

    /**
     * Returns the Java module name of the dependency at the given path.