// Java 21 Sequenced Collections support
SequencedCollection<String> sequenced = CollectionsUtil.newLinkedHashSet();
String first = CollectionsUtil.getFirst(sequenced);
String last = CollectionsUtil.getLast(sequenced);
SequencedCollection<String> reversed = CollectionsUtil.reversed(sequenced);

// Specialized collections
LruHashMap<String, Object> lruCache = new LruHashMap<>(100); // LRU cache with max 100 entries

     * @return an Optional containing the path to the built artifact if available,
     *         or empty if the artifact hasn't been built yet
     */
    @Nonnull
    Optional<Path> getPath(@Nonnull Project project);

    /**
     * Returns an immutable collection of attached artifacts for the given project.
     * Attached artifacts are secondary artifacts produced during the build (e.g., sources jar,

        int requestedState = isDirectory() ? 
            Smb2LeaseState.SMB2_LEASE_READ_HANDLE :
            Smb2LeaseState.SMB2_LEASE_FULL;
            
        leaseKey = leaseManager.requestLease(getPath(), requestedState);
        
        // Add lease context to create request
        if (createRequest != null) {
            createRequest.addLeaseContext(leaseKey, requestedState, 

   * @return the last element of {@code iterator}
   * @since 3.0
   */
  @ParametricNullness
  public static <T extends @Nullable Object> T getLast(
      Iterator<? extends T> iterator, @ParametricNullness T defaultValue) {
    return iterator.hasNext() ? getLast(iterator) : defaultValue;
  }

  /**
   * Calls {@code next()} on {@code iterator}, either {@code numberToAdvance} times or until {@code

    private final int size;

    ComplementRanges(ImmutableList<Range<C>> ranges) {
      this.ranges = ranges;
      this.positiveBoundedBelow = ranges.get(0).hasLowerBound();
      this.positiveBoundedAbove = Iterables.getLast(ranges).hasUpperBound();

      int size = ranges.size() - 1;
      if (positiveBoundedBelow) {
        size++;
      }
      if (positiveBoundedAbove) {
        size++;
      }

     * @return the last element, or null if the collection is empty
     * @since Java 21
     */
    public static <E> E getLast(final SequencedCollection<E> collection) {
        return collection.isEmpty() ? null : collection.getLast();
    }

    /**
     * Adds an element to the beginning of a sequenced collection.
     *
     * @param <E> the element type

                                    cookie.getName(), encoded.length(), cookie.getMaxAge(), cookie.getPath(), cookie.getDomain(),
                                    cookie.getSecure(), cookie.isHttpOnly(), fessConfig.getCookieSearchParameterSameSite());
                        }
                    });

 *
 * ```java
 * String attack = "http://example.com/static/images/../../../../../etc/passwd";
 * System.out.println(new URL(attack).getPath());
 * System.out.println(new URI(attack).getPath());
 * System.out.println(HttpUrl.parse(attack).encodedPath());
 * ```
 *
 * By canonicalizing the input paths, they are complicit in directory traversal attacks. Code that

        String url, type;
        int n;

        try (SmbFileInputStream in = new SmbFileInputStream(file); ServletOutputStream out = resp.getOutputStream()) {
            url = file.getPath();

            resp.setContentType("text/plain");

            n = url.lastIndexOf('.');
            if (n > 0 && (type = url.substring(n + 1)) != null && type.length() > 1 && type.length() < 6) {

    // Perform normal tree connection
    super.connect();
    
    // Register for witness notifications for this share
    if (session.isWitnessEnabled()) {
        String shareName = getPath();  // e.g., "\\server\share"
        session.registerForWitnessNotifications(shareName);
    }
}
```

### 5.3 File Handle Integration
```java
// In SmbFile.java
@Override