*
     * @param id the unique identifier of the request header
     * @return an OptionalEntity containing the request header if found, empty otherwise
     */
    public OptionalEntity<RequestHeader> getRequestHeader(final String id) {
        return requestHeaderBhv.selectByPK(id);
    }

    /**
     * Stores a request header configuration to the database.

        // Test constructor with null message
        SsoProcessException exception = new SsoProcessException((String) null);

        assertNull(exception.getMessage());
        assertNull(exception.getCause());
    }

    @Test
    public void test_constructor_withNullCause() {
        // Test constructor with null cause
        String message = "SSO provider communication failure";

     * This ID corresponds to a specific stopwords dictionary instance in the system.
     */
    @Required
    public String dictId;

    /**
     * The multipart file containing the stopwords to be uploaded.
     * This file should contain a list of words that should be filtered out during indexing.
     */
    @Required
    public MultipartFormFile stopwordsFile;

    /**
     * Default constructor for UploadForm.

For applications still sending queries to GSA endpoints, Fess provides a configuration option:

**Enable GSA API**

Add to `system.properties`:
```properties
web.api.gsa=true
```

     */
    @Required
    @Size(max = 1000)
    public String id;

    /**
     * The username of the user who last updated this request header configuration.
     * Used for audit trail purposes to track who made changes.
     */
    @Size(max = 1000)
    public String updatedBy;

    /**
     * The timestamp when this request header configuration was last updated.

     * @param timestamp The last modified timestamp of the file.
     */
    public StemmerOverrideFile(final String id, final String path, final Date timestamp) {
        super(id, path, timestamp);
    }

    @Override
    public String getType() {
        return STEMMER_OVERRIDE;
    }

    @Override
    public String getPath() {
        return path;
    }

    @Override

                .execute()) {
            final Map<String, Object> contentMap = response.getContent(OpenSearchCurl.jsonParser());
            @SuppressWarnings("unchecked")
            final List<Map<String, Object>> fileList = (List<Map<String, Object>>) contentMap.get("file");
            return fileList.stream().map(fileMap -> {
                try {
                    final String path = fileMap.get("path").toString();

        // Track specific call arguments
        List<String> createdIndices = new ArrayList<>();
        List<String> deletedIndices = new ArrayList<>();
        List<String[]> reindexPairs = new ArrayList<>();
        List<String[]> addMappingCalls = new ArrayList<>();
        List<String[]> createAliasCalls = new ArrayList<>();
        List<String[]> insertBulkDataCalls = new ArrayList<>();

     *
     * @param chunk the text chunk from the LLM response
     * @param done true if this is the final chunk
     */
    void onChunk(String chunk, boolean done);

    /**
     * Called when an error occurs during streaming.
     *
     * @param error the error that occurred
     */
    default void onError(final Throwable error) {
        // Default implementation does nothing
    }

        CharMappingItem item = new CharMappingItem(1L, new String[] { "a" }, "output");
        item.setNewInputs(new String[] { "p", "q", "r" });

        String[] returnedInputs = item.getNewInputs();

        // Modifying returned array should not affect original
        returnedInputs[0] = "modified";

        // Get again and verify not modified
        String[] inputs2 = item.getNewInputs();