}

        public static void resetInstanceCount() {
            instanceCount = 0;
        }
    }

    /**
     * Closeable test component for testing AutoCloseable resource handling
     */
    public static class CloseableTestComponent implements AutoCloseable {
        private static AtomicInteger instanceCounter = new AtomicInteger(0);

import java.lang.reflect.WildcardType;
import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Set;

import org.codelibs.core.collection.CollectionsUtil;

/**
 * Utility class for handling generics in Java.
 *
 * @author koichik
 */
public abstract class GenericsUtil {

    /**
     * Do not instantiate.
     */
    protected GenericsUtil() {
    }

    /**

                params.put(p.getFirst(), p.getSecond());
            });
            return params;
        }).get();
    }

    /**
     * Converts a number to its string representation, handling null values.
     *
     * @param value The number to convert
     * @return String representation of the number, or empty string if null
     */
    private String toNumberString(final Number value) {

import org.opensearch.index.query.QueryBuilders;

import com.fasterxml.jackson.databind.ObjectMapper;

import jakarta.servlet.http.Cookie;
import jakarta.servlet.http.HttpServletRequest;

/**
 * Helper class for handling search operations in Fess.
 *
 * This class provides comprehensive search functionality including document search,
 * scroll search, and bulk operations. It handles search request parameter processing,

        DomUtils.insertContentElement(root, "inceptionYear", "2023");

        String xmlOutput = DomUtils.toXml(doc);

        // Verify text content handling
        assertTrue(xmlOutput.contains("<name>Test Project Name</name>"), "Should contain name with text content");
        assertTrue(

                setCreateDisposition(req, flags);
                req.setShareAccess(sharing);
                req.setFileAttributes(attrs);

                // Add SMB3 features support with error handling for compatibility
                SmbSessionImpl session = h.getSession();

                // Enable lease support if available, with fallback for compatibility
                boolean leasesAdded = false;

            assertNotNull(packageExecution);
            assertEquals("package", packageExecution.child("phase").orElse(null).textContent());
        }
    }

    @Nested
    @DisplayName("Downgrade Handling")
    class DowngradeHandlingTests {

        @Test
        @DisplayName("should fail with error when attempting downgrade from 4.1.0 to 4.0.0")
        void shouldFailWhenAttemptingDowngrade() throws Exception {

    // only use by reread()
    @TempDir
    Path projectRoot;

    /**
     * Provides file system configurations for testing both Windows and Unix path behaviors.
     * This allows us to test cross-platform path handling on any development machine.
     */
    static Stream<Arguments> fileSystemConfigurations() {
        return Stream.of(
                Arguments.of("Unix", Configuration.unix(), "/"),

  /** Constructor for use by subclasses. */
  protected Converter() {
    this(true);
  }

  /** Constructor used only by {@code LegacyConverter} to suspend automatic null-handling. */
  Converter(boolean handleNullAutomatically) {
    this.handleNullAutomatically = handleNullAutomatically;
  }

  // SPI methods (what subclasses must implement)

  /**

                    }
                }
            }
        }

        return pluginsNeedingUpgrade;
    }

    /**
     * Gets the plugin key (groupId:artifactId) for a plugin, handling default groupId.
     */
    private String getPluginKey(Plugin plugin) {
        String groupId = plugin.getGroupId();
        String artifactId = plugin.getArtifactId();