*/
package jcifs.internal.witness;

/**
 * Represents a witness heartbeat response as defined in MS-SWN specification.
 * Contains the result of a witness heartbeat request.
 */
public class WitnessHeartbeatResponse {
    /**
     * Creates a new witness heartbeat response.
     */
    public WitnessHeartbeatResponse() {
        // Default constructor
    }

 */
package jcifs.internal.witness;

/**
 * Represents a witness registration response as defined in MS-SWN specification.
 * Contains the result of a witness registration request.
 */
public class WitnessRegisterResponse {
    /**
     * Creates a new witness register response.
     */
    public WitnessRegisterResponse() {
        // Default constructor
    }

        try {
            SearchResponse response = client.prepareSearch(index)
                    .setQuery(queryBuilder)
                    .setSize(500)
                    .setScroll(settings.getScrollTimeout())
                    .execute()
                    .actionGet(settings.getSearchTimeout());
            String scrollId = response.getScrollId();
            try {

            final CommonServerMessageBlock response) {
        if (log.isTraceEnabled()) {
            log.trace("Signing with seq " + this.signSequence);
        }

        ((ServerMessageBlock) request).setSignSeq(this.signSequence);
        if (response != null) {
            ((ServerMessageBlock) response).setSignSeq(this.signSequence + 1);
        }

        try {

    }

    /**
     * Helper method to mock the response of an HttpURLConnection.
     */
    private void mockResponse(int code, String message, Map<String, List<String>> headers, InputStream errorStream) throws IOException {
        mockResponse(this.mockConnection, code, message, headers, errorStream);
    }

    /**
     * Helper method to mock the response of a specific HttpURLConnection instance.
     */

    private static final int SMB2_HEADER_LENGTH = 64;

    /**
     * Build a minimal SMB2 header for a response.
     */
    private static byte[] buildSmb2Header() {
        byte[] header = Arrays.copyOf(SMBUtil.SMB2_HEADER, SMBUtil.SMB2_HEADER.length);
        // Mark as server->client response for realism
        SMBUtil.writeInt4(0x00000001, header, 16); // Flags
        // Command SMB2_CREATE (0x0005)

In this case, you could want to document how that external API *should* look like. What *path operation* it should have, what body it should expect, what response it should return, etc.

## An app with callbacks { #an-app-with-callbacks }

Let's see all this with an example.

Imagine you develop an app that allows creating invoices.

    }

    @Test
    public void test_assistantFactory() {
        final LlmMessage message = LlmMessage.assistant("Assistant response");
        assertEquals(LlmMessage.ROLE_ASSISTANT, message.getRole());
        assertEquals("Assistant response", message.getContent());
    }

    @Test
    public void test_settersAndGetters() {
        final LlmMessage message = new LlmMessage();

{* ../../docs_src/header_param_models/tutorial002_an_py310.py hl[10] *}

If a client tries to send some **extra headers**, they will receive an **error** response.

For example, if the client tries to send a `tool` header with a value of `plumbus`, they will receive an **error** response telling them that the header parameter `tool` is not allowed:

```json
{
    "detail": [
        {
            "type": "extra_forbidden",

    @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