* domain, username, and password. Parameters that are {@code null}
     * will be substituted with {@code jcifs.smb.client.domain},
     * {@code jcifs.smb.client.username}, {@code jcifs.smb.client.password}
     * property values.
     *
     * @param tc
     *            context to use
     * @param domain the authentication domain
     * @param username the username to authenticate with

    double req = requests.get();
    double hit = req - misses.get();

    // Currently, this is going into /dev/null, but I'll fix that
    System.out.println("hit rate: " + hit / req);
  }

  // for proper distributions later:
  // import JSci.maths.statistics.ProbabilityDistribution;
  // int key = (int) dist.inverse(random.nextDouble());

            return null;
        }
    }

    private static int invokeProtectedInt(Object target, String name, Object... params) {
        try {
            var cls = target.getClass();
            // Build proper parameter types array, handling primitive types
            Class<?>[] paramTypes = new Class<?>[params.length];
            for (int i = 0; i < params.length; i++) {
                if (params[i] instanceof byte[]) {

### Transition Status

import java.io.Flushable;
import java.io.IOException;
import junit.framework.TestCase;
import org.jspecify.annotations.NullUnmarked;

/**
 * Unit tests for {@link Flushables}.
 *
 * <p>Checks proper flushing behavior, and ensures that IOExceptions on Flushable.flush() are not
 * propagated out from the {@link Flushables#flush} method if {@code swallowException} is true.
 *
 * @author Michael Lancaster
 */
@NullUnmarked

                    Object value = entry.getValue();

                    // Handle nested properties
                    if (key.contains(".")) {
                        // Simple nested property handling for testing
                        result = result.replace("${" + key + "}", String.valueOf(value));
                    } else if (value instanceof TestUser) {
                        // Handle TestUser object

        // Both instances should be of the same class
        assertEquals(exception1.getClass(), exception2.getClass());
    }

    @Test
    public void test_stackTrace() {
        // Test that the exception has a proper stack trace
        FessUserNotFoundException exception = new FessUserNotFoundException("testuser");

        StackTraceElement[] stackTrace = exception.getStackTrace();
        assertNotNull(stackTrace);

import org.codelibs.fess.entity.SearchRequestParams;
import org.codelibs.fess.helper.RelatedQueryHelper;
import org.codelibs.fess.mylasta.direction.FessConfig;

/**
 * A utility class for building query strings with proper escaping and parameters.
 * This class provides methods to construct search queries from various parameters,
 * handle special characters, and format the final query string for search operations.
 */

Each connection has its own lock. The connections in the pool are all in a `ConcurrentLinkedQueue`. Due to data races, iterators of this queue may return removed connections. Callers must check the connection's `noNewExchanges` property before using connections from the pool.

The connection lock is never held while doing I/O (even closing a socket) to prevent contention.

 * Manages a pool of byte buffers to reduce garbage collection overhead.
 *
 * Performance optimizations:
 * - Uses ConcurrentLinkedQueue for O(1) operations
 * - Lock-free operations for better concurrency
 * - Proper buffer validation and limits
 */
public class BufferCache {

    /**
     * Private constructor to prevent instantiation of this utility class.
     */
    private BufferCache() {