}

    @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

     * @param words the list of popular words
     * @param total the total number of words
     * @param items the list of suggested items
     */
    public PopularWordsResponse(final String index, final long tookMs, final List<String> words, final long total,
            final List<SuggestItem> items) {
        this.index = index;
        this.tookMs = tookMs;
        this.words = words;
        num = words.size();

                final String[] words = SuggestUtil.parseQuery(queryString, field);
                if (words.length == 0) {
                    continue;
                }

                final String[][] readings = new String[words.length][];
                for (int j = 0; j < words.length; j++) {
                    words[j] = normalizer.normalize(words[j], field, "");

import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;

import io.restassured.RestAssured;
import io.restassured.path.json.JsonPath;

/**
 * Integration tests for the Suggest Words API (/api/v1/suggest-words)
 */
@Tag("it")
public class SuggestWordsApiTests extends ITBase {

    @BeforeAll
    protected static void initAll() {
        RestAssured.baseURI = getFessUrl();
        settingTestToken();

                parser.parseSearchWords(words, null, fields, null, null, 1, defaultReadingConverter, defaultNormalizer, analyzer, null);

        assertNotNull(item);
        assertEquals("test", item.getText());
    }

    @Test
    public void test_parseSearchWords_withPartialReadings() throws Exception {
        String[] words = new String[] { "word1", "word2", "word3" };
        // Only provide readings for first word

 *   <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>

/**
 * 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";

    /**
     * Gets a specific protected words item by ID.
     * @param dictId the dictionary ID
     * @param id the item ID
     * @return the protected words item if found
     */
    public OptionalEntity<ProtwordsItem> getProtwordsItem(final String dictId, final long id) {
        return getProtwordsFile(dictId).map(file -> file.get(id).get());
    }

    /**
     * Stores a protected words item (insert or update).

/**
 * Form for uploading protected words files to the Fess search engine.
 * Protected words are terms that should not be stemmed or modified during text analysis.
 * This form is used in the admin interface to upload custom protected words dictionary files.
 */
public class UploadForm {

    /**
     * The dictionary ID that identifies which protected words dictionary configuration to update.