import org.opensearch.search.aggregations.bucket.filter.Filter;
import org.opensearch.search.aggregations.bucket.terms.Terms;

import com.google.common.io.BaseEncoding;

/**
 * Response object for faceted search results containing query counts and field facets.
 * This class processes OpenSearch aggregations to provide structured facet information
 * for search result filtering and navigation.
 */

But if you have a bunch of dataclasses laying around, this is a nice trick to use them to power a web API using FastAPI. 🤓

///

## Dataclasses in `response_model` { #dataclasses-in-response-model }

You can also use `dataclasses` in the `response_model` parameter:

{* ../../docs_src/dataclasses/tutorial002.py hl[1,7:13,19] *}

The dataclass will be automatically converted to a Pydantic dataclass.

    @Override
    public Logger getLogger() {
        return logger;
    }

    /**
     * Gets the appropriate extractor for the given response data.
     * Selects an extractor based on the MIME type or falls back to the Tika extractor.
     *
     * @param responseData the response data containing the document to extract
     * @return the extractor instance for processing the document

# Background Tasks - `BackgroundTasks`

You can declare a parameter in a *path operation function* or dependency function with the type `BackgroundTasks`, and then you can use it to schedule the execution of background tasks after the response is sent.

You can import it directly from `fastapi`:

```python
from fastapi import BackgroundTasks
```

 * **RealConnection** is the socket and streams of an HTTP/1 or HTTP/2 connection. These are created on demand to fulfill HTTP requests. They may be reused for many HTTP request/response exchanges. Their lifetime is typically shorter than a connection pool.

 * **Exchange** carries a single HTTP request/response pair.

                PingResponse response = new PingResponse(createMockHealthResponse("test-cluster", ClusterHealthStatus.RED)) {
                    @Override
                    public int getStatus() {
                        // RED status should return non-zero status
                        return 2;
                    }
                };
                return response;
            }
        };

 5. It sends the HTTP request and reads the response.

If there's a problem with the connection, OkHttp will select another route and try again. This allows OkHttp to recover when a subset of a server's addresses are unreachable. It's also useful when a pooled connection is stale or if the attempted TLS version is unsupported.

            logger.warn("Failed to process {}", id, e);
        }
        return false;
    }

    /**
     * Processes thumbnail generation with a response data consumer.
     * @param id The document ID.
     * @param consumer The consumer function to process response data.
     * @return True if processing was successful, false otherwise.
     */

        @DisplayName("readDirect over SMB2 returns bytes read and uses current offset")
        void readDirectSmb2Happy() throws Exception {
            SmbFileInputStream in = newStream();

            // Arrange SMB2 response to return 3 bytes
            Smb2ReadResponse smb2Resp = mock(Smb2ReadResponse.class);
            when(smb2Resp.getDataLength()).thenReturn(3);

        failureCounts.remove(handle.getDirectoryPath());
    }

    /**
     * Process change notification response
     *
     * @param handle notification handle
     * @param outputBuffer response buffer containing FILE_NOTIFY_INFORMATION structures
     */
    public void processChangeNotification(ChangeNotificationHandle handle, byte[] outputBuffer) {