}

    /**
     * Send a 429 Too Many Requests response.
     * @param response the HTTP response
     * @param retryAfterSeconds the Retry-After header value
     * @throws IOException if an I/O error occurs
     */
    protected void sendRateLimitResponse(final HttpServletResponse response, final int retryAfterSeconds) throws IOException {

    /**
     * The base docs CSS to embed in the HTML
     */
    @InputFile
    @PathSensitive(PathSensitivity.NONE)
    public abstract RegularFileProperty getBaseCssFile();

    /**
     * Key-value pairs that are replaced in the generated HTML.
     *
     * This uses Ant style replacement tokens.
     */
    @Input
    public abstract MapProperty<String, String> getReplacementTokens();

    @Inject

            .withIndex()
            .all {
                val ktParamType = ktFunction.valueParameters[it.index].typeReference!!
                it.value.isLikelyEquivalentTo(ktParamType) || (isVarargs && it.value.componentType?.isLikelyEquivalentTo(ktParamType) == true)
            }
    }
}


private

# ADR-0008 - Use NullAway for null checking

## Status

- ACCEPTED on 2025-08-06

## Context

Our codebase uses `null` extensively to represent an absence of value or optionality of the argument.
We utilize nullness annotations in Java code and somewhat rely on IDE warnings to guide us.
However, the Java code we have is not fully annotated, which causes several consequences:
* IDE warnings can be misleading

    @Test
    public void test_execute_withInvalidQuery() {
        QueryContext context = new QueryContext("test", false);
        Query invalidQuery = new TermQuery(new Term("field", "value"));
        float boost = 1.0f;

        try {
            fuzzyQueryCommand.execute(context, invalidQuery, boost);
            fail("Should throw InvalidQueryException");
        } catch (InvalidQueryException e) {

        assertEquals("Email should have exactly one @ character", 1, supportEmail.split("@", -1).length - 1);

        // Specific value check
        assertEquals("******@****.***", supportEmail);
        assertEquals("******@****.***", techEmail);
    }

    @Test
    public void test_emailTypoFix_supportEmail() throws Exception {

        RenderDataUtil.register(data, "labelTypeItems", labelTypeService.getLabelTypeList(labelTypePager)); // page navi

        // restore from pager
        copyBeanToBean(labelTypePager, form, op -> op.include("name", "value"));
    }

    // ===================================================================================
    //                                                                        Edit Execute

    public void test_ingest_nullIngestFactory() {
        ComponentUtil.register(null, "ingestFactory");
        indexUpdater.init();

        final Map<String, Object> doc = new HashMap<>();
        doc.put("test", "value");
        final AccessResult<String> accessResult = new TestAccessResult();

        final Map<String, Object> result = indexUpdater.ingest(accessResult, doc);

        assertSame(doc, result);
    }

    }

    /**
     * Adds a boost value to the document for search relevance scoring.
     * The boost value affects how highly the document will rank in search results.
     *
     * @param map the document data map to add the boost value to
     * @param documentBoost the boost value to apply to the document
     */

        chatApiManager.sendSseEvent(writer, "test", Map.of("key", "value"));

        final String output = stringWriter.toString();
        assertTrue(output.contains("event: test"));
        assertTrue(output.contains("data:"));
        assertTrue(output.contains("\"key\":\"value\""));
    }

    @Test
    public void test_sendSseEvent_session() {