* java.util.Optional}, or {@code null} if the argument is null.
   *
   * @since 33.4.0 (but since 21.0 in the JRE flavor)
   */
  @SuppressWarnings("NullableOptional") // Null passthrough is reasonable for type conversions
  @IgnoreJRERequirement // Users will use this only if they're already using Optional.
  public static <T> @Nullable Optional<T> fromJavaUtil(
      java.util.@Nullable Optional<T> javaUtilOptional) {

   * java.util.Optional}, or {@code null} if the argument is null.
   *
   * @since 21.0 (but only since 33.4.0 in the Android flavor)
   */
  @SuppressWarnings("NullableOptional") // Null passthrough is reasonable for type conversions
  public static <T> @Nullable Optional<T> fromJavaUtil(
      java.util.@Nullable Optional<T> javaUtilOptional) {
    return (javaUtilOptional == null) ? null : fromNullable(javaUtilOptional.orElse(null));

            throw new SmbException("Invalid file size: " + size);
        }

        // Reasonable upper limit (1TB)
        long maxSize = 1099511627776L;
        if (size > maxSize) {
            failedValidations.incrementAndGet();
            log.warn("File size exceeds reasonable limit: {} > {}", size, maxSize);
            throw new SmbException("File size exceeds limit: " + size);
        }
    }

  @Override
  int indexOf(@Nullable Object target) {
    if (!contains(target)) {
      return -1;
    }
    // The cast is safe because of the contains check—at least for any reasonable Comparable class.
    @SuppressWarnings("unchecked")
    // requireNonNull is safe because of the contains check.
    C c = (C) requireNonNull(target);
    return (int) domain.distance(first(), c);
  }

  @Override

        @DisplayName("Should handle maximum buffer index")
        void testMaxBufferIndex() throws SMBProtocolDecodingException {
            // Given
            byte[] buffer = new byte[Integer.MAX_VALUE / 1000]; // Use reasonable size
            int bufferIndex = buffer.length - 4;
            SMBUtil.writeInt2(4, buffer, bufferIndex);

            // When
            int bytesRead = response.readBytesWireFormat(buffer, bufferIndex);

            @Override
            public void store(CrawlingInfo entity) {
                assertEquals("Test Crawl", entity.getName());
                // Don't check exact expiration time, just verify it's reasonable
                assertNotNull(entity.getExpiredTime());
                assertTrue("Expiration time should be in the future", entity.getExpiredTime().longValue() > currentTime);
            }

            @Override

                auth1.equals(auth3);
                auth2.equals(auth3);
            }
            long totalTime = System.nanoTime() - startTime;

            // Should complete in reasonable time (< 10ms for 3000 operations)
            assertTrue(totalTime < 10_000_000L, "Null/empty password comparisons taking too long: " + totalTime + " ns");
        } finally {
            auth1.close();

   * "best effort" approach is taken; if {@code str} does not conform to the assumed format, then
   * the behavior of this method is undefined but we make a reasonable effort at converting anyway.
   */
  public final String to(CaseFormat format, String str) {
    checkNotNull(format);
    checkNotNull(str);
    return (format == this) ? str : convert(format, str);
  }

## Version 1.0.2

_2013-05-11_

 * Fix: Remove use of Java 6-only APIs.
 * Fix: Properly handle exceptions from `NetworkInterface` when querying MTU.
 * Fix: Ensure MTU has a reasonable default and upper-bound.


## Version 1.0.1

_2013-05-06_

 * Correct casing of SSL in method names (`getSslSocketFactory`/`setSslSocketFactory`).


## Version 1.0.0

_2013-05-06_

        // Check that filename is written correctly (starting at offset 6)
        // The filename should be null-terminated Unicode string
        assertTrue(written > 6);

        // Verify the total bytes written is reasonable
        assertTrue(written > TEST_FILENAME.length());
    }

    @ParameterizedTest
    @CsvSource({ "4, 257", // FILE_BASIC_INFO -> 0x0101
            "5, 258", // FILE_STANDARD_INFO -> 0x0102