*/
  fun newBuilder(link: String): Builder? =
    try {
      Builder().parse(this, link)
    } catch (_: IllegalArgumentException) {
      null
    }

  override fun equals(other: Any?): Boolean = other is HttpUrl && other.url == url

  override fun hashCode(): Int = url.hashCode()

  override fun toString(): String = url

  /**

   */
  protected ListIterator<E> standardListIterator(int start) {
    return Lists.listIteratorImpl(this, start);
  }

  /**
   * A sensible default implementation of {@link #subList(int, int)}. If you override any other
   * methods, you may wish to override {@link #subList(int, int)} to forward to this implementation.
   *
   * @since 7.0
   */
  protected List<E> standardSubList(int fromIndex, int toIndex) {

And you can also declare numeric validations:

* `gt`: `g`reater `t`han
* `ge`: `g`reater than or `e`qual
* `lt`: `l`ess `t`han
* `le`: `l`ess than or `e`qual

/// info

`Query`, `Path`, and other classes you will see later are subclasses of a common `Param` class.

All of them share the same parameters for additional validation and metadata you have seen.

///

/// note | Technical Details

            return null;
        } catch (IllegalAccessException e) {
            // Cannot access field due to security restrictions
            return null;
        } catch (Exception e) {
            // Other errors, return null instead of throwing
            return null;
        }
    }

    void getSmbTree_happy() {
        when(session.getSmbTree(anyString(), anyString())).thenReturn(tree);

        String share = "share";
        String svc = "A:"; // service string example (e.g., DISK, IPC, or other)
        SmbTree result = session.getSmbTree(share, svc);

        assertSame(tree, result);

        ArgumentCaptor<String> shareCap = ArgumentCaptor.forClass(String.class);

            QueryBuilder result = newQueryProcessor.execute(context, query, 1.0f);
            assertNotNull(result);
        } finally {
            // Reset to the original queryProcessor for other tests
            ComponentUtil.register(originalProcessor, "queryProcessor");
        }
    }

            } catch (Exception e) {
                log.warn("Error creating SmbFile from cache for {}: {}", fileInfo.getName(), e.getMessage());
                // For testing purposes, continue processing other files
                // In a real scenario, you might want to handle this differently
            }
        }

        return files;
    }

    /**
     * Update directory cache with new listing

        SecurityBlob a = new SecurityBlob(new byte[] { 1 });

        // Act & Assert
        assertFalse(a.equals(null), "equals(null) should be false");
        assertFalse(a.equals("not a blob"), "equals(other type) should be false");
    }

    // Ensures clone() returns a deep copy; mutations are independent across instances
    @Test
    @DisplayName("clone: returns deep copy and independent state")

        resetHandlerState();
    }

    /**
     * Resets the static state of the Handler class using reflection.
     * This is crucial for ensuring that tests are isolated from each other.
     */
    private void resetHandlerState() throws Exception {
        // Reset the static factory field
        Field factoryField = Handler.class.getDeclaredField("factory");
        factoryField.setAccessible(true);

         * using DefaultRepositoryLayout requires us to enforce usage of the artifact's base version. This
         * transformation however contradicts the other use case of precisely obeying the repository's layout. The below
         * flag tries to detect which use case applies to make both plugins happy.
         */