}

    @Test
    public void test_getNum() throws Exception {
        List<String> words = new ArrayList<>();
        words.add("word1");
        words.add("word2");
        words.add("word3");
        words.add("word4");

        PopularWordsResponse response = new PopularWordsResponse("test-index", 100, words, 20, new ArrayList<>());

        assertEquals(4, response.getNum());
    }

    @Test

    }

    @Test
    public void test_getNum() throws Exception {
        List<String> words = new ArrayList<>();
        words.add("word1");
        words.add("word2");
        words.add("word3");

        SuggestResponse response = new SuggestResponse("test-index", 100, words, 20, new ArrayList<>());

        assertEquals(3, response.getNum());
    }

    @Test

    }

    /**
     * Gets a bad word by its ID.
     * @param id The bad word ID.
     * @return Optional entity containing the bad word if found.
     */
    public OptionalEntity<BadWord> getBadWord(final String id) {
        return badWordBhv.selectByPK(id);
    }

    /**
     * Stores (inserts or updates) a bad word.
     * @param badWord The bad word to store.
     */

import jakarta.validation.constraints.Size;

/**
 * Form class for editing bad words in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing bad word entries,
 * including tracking information for optimistic locking and audit trails.
 * Bad words are terms that should be filtered or blocked in search results.
 *
 */
public class EditForm extends CreateForm {

/**
 * Form for uploading bad word files to the Fess search engine.
 * This form is used in the admin interface to upload bad word dictionary files
 * that contain words to be filtered from search results.
 */
public class UploadForm {

    /**
     * The multipart file containing bad words to be uploaded.
     * This file should contain a list of words that will be filtered from search results.
     */

/**
 * The BadWordSettings class manages the settings related to bad words.
 * It allows adding, deleting, and retrieving bad words from the settings.
 * It also supports loading default bad words from a file.
 */
public class BadWordSettings {
    private static final Logger logger = LogManager.getLogger(BadWordSettings.class);

    /** Key for bad word settings. */
    public static final String BAD_WORD_SETTINGS_KEY = "badword";

 *   <li>{@code ELEVATE_WORD_TAGS} - The key for elevate word tags.</li>
 *   <li>{@code ELEVATE_WORD_ROLES} - The key for elevate word roles.</li>
 * </ul>
 *
 * <p>Methods:</p>
 * <ul>
 *   <li>{@code get()} - Retrieves an array of elevate words from the settings.</li>
 *   <li>{@code add(ElevateWord elevateWord)} - Adds a new elevate word to the settings.</li>

                    logger.warn("Failed to generate popular words.", e);
                }

                return wordList;
            });
        } catch (final ExecutionException e) {
            logger.warn("Failed to load popular words.", e);
        }
        return Collections.emptyList();
    }

    /**
     * Clears all cached popular word lists.
     */
    public void clearCache() {

import jakarta.validation.constraints.Size;

/**
 * Form class for editing elevate word configurations in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing elevate word entries,
 * including tracking information for optimistic locking and audit trails.
 * Elevate words are used to boost specific documents in search results when certain keywords are matched.
 *
 */

Handles all indexing operations, content parsing, and word management (bad words, elevate words).

### SuggestSettings (Configuration)
Location: `src/main/java/org/codelibs/fess/suggest/settings/SuggestSettings.java`

Manages configuration stored in OpenSearch: analyzers, bad words, elevate words, timeouts.

### SuggestItem (Domain Entity)