*
 * @author higa
 */
public abstract class ZipFileUtil {

    private static final Logger logger = Logger.getLogger(ZipFileUtil.class);

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

    /**
     * Creates and returns a <code>ZipFile</code> for reading the specified Zip file.
     *
     * @param file

     *
     * @return the actual port number
     */
    public int getPort() {
        return ((ServerConnector) server.getConnectors()[0]).getLocalPort();
    }

    protected static File createDocRoot(final int count) {
        try {
            final File tempDir = File.createTempFile("crawlerDocRoot", "");
            tempDir.delete();
            tempDir.mkdirs();

        // Reset MID to a known starting point for deterministic behavior
        setField(transport, "mid", new AtomicLong());
    }

    // Utility: reflectively set a private/protected field (searches up the hierarchy)
    private static void setField(Object target, String name, Object value) {
        try {
            Field f = findField(target.getClass(), name);
            f.setAccessible(true);

    private FacetQueryView facetQueryView;
    private TestFacetInfo testFacetInfo;
    private TestFileTypeHelper testFileTypeHelper;
    private TestFessConfig testFessConfig;

    @Override
    protected void setUp(TestInfo testInfo) throws Exception {
        super.setUp(testInfo);
        facetQueryView = new FacetQueryView();
        testFacetInfo = new TestFacetInfo();
        testFileTypeHelper = new TestFileTypeHelper();

    private QueryFieldConfig queryFieldConfig;

    @Override
    protected void setUp(TestInfo testInfo) throws Exception {
        super.setUp(testInfo);

        FessConfig fessConfig = createTestFessConfig();
        ComponentUtil.setFessConfig(fessConfig);

        queryFieldConfig = new QueryFieldConfig();
    }

    @Override
    protected void tearDown(TestInfo testInfo) throws Exception {

    public void setNotifications(List<WitnessNotificationResponse> notifications) {
        this.notifications = notifications != null ? new ArrayList<>(notifications) : new ArrayList<>();
    }

    @Override
    protected void encodeWitnessParameters(NdrBuffer buf) throws NdrException {
        // Encode input parameters for WitnessAsyncNotify

        // Context handle (20 bytes)
        if (contextHandle != null) {

@app.post("/items/")
async def create_item(item: Item, project_id: Annotated[int, Query()]): ...
```

instead of this:

```python
# DO NOT DO THIS
class Item(BaseModel):
    name: str = ...
    description: str | None = None
    price: float = Field(..., gt=0)


app = FastAPI()


@app.post("/items/")
async def create_item(item: Item, project_id: Annotated[int, Query(...)]): ...
```

    // unlike the above this indirection defeats the trivial cycle detection and causes a SOE
    orig.setFuture(
        new ForwardingListenableFuture<Object>() {
          @Override
          protected ListenableFuture<Object> delegate() {
            return orig;
          }
        });
    assertThat(orig.toString())
        .contains("Exception thrown from implementation: class java.lang.StackOverflowError");

    /**
     * Creates an edit body from a duplicate host entity for API responses.
     *
     * @param entity the duplicate host entity to convert
     * @return edit body containing the entity data
     */
    protected EditBody createEditBody(final DuplicateHost entity) {
        final EditBody body = new EditBody();
        copyBeanToBean(entity, body, copyOp -> {
            copyOp.excludeNull();
        });
        return body;

     *
     * @param messages the FessMessages object to add the error to
     * @param errorKey the error key identifying the type of password validation error
     */
    protected void addPasswordValidationError(final FessMessages messages, final String errorKey) {
        switch (errorKey) {
        case "errors.password_length":