import org.lastaflute.web.response.JsonResponse;
import org.lastaflute.web.response.StreamResponse;

import jakarta.annotation.Resource;

/**
 * API action for CRUD and file operations on dictionary protected words (protwords).
 */
public class ApiAdminDictProtwordsAction extends FessApiAdminAction {

    /**
     * Default constructor.
     */
    public ApiAdminDictProtwordsAction() {
        super();
    }

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

 * the number of total, document, and query words.
 */
public class SuggestBody extends SuggestForm {
    /**
     * Constructs a new suggest body.
     */
    public SuggestBody() {
        // do nothing
    }

    /** The total number of words in the suggest index. */
    public Long totalWordsNum;

    /** The number of words from documents. */
    public Long documentWordsNum;

            newOutputs = outputs;
        }
    }

    /**
     * Gets the new input words.
     *
     * @return The new input words.
     */
    public String[] getNewInputs() {
        return newInputs;
    }

    /**
     * Sets the new input words.
     *
     * @param newInputs The new input words.
     */
    public void setNewInputs(final String[] newInputs) {
        this.newInputs = newInputs;

  }

  abstract String normalizeWord(String word);

  String normalizeFirstWord(String word) {
    return normalizeWord(word);
  }

  private static String firstCharOnlyToUpper(String word) {
    return word.isEmpty()
        ? word
        : Ascii.toUpperCase(word.charAt(0)) + Ascii.toLowerCase(word.substring(1));
  }

import org.lastaflute.web.validation.theme.conversion.ValidateTypeFailure;

/**
 * Form class for editing protected words dictionary entries in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing protected words entries.
 * Protected words are terms that should not be stemmed or modified during text analysis.
 *
 */
public class EditForm extends CreateForm {

    /**

import org.lastaflute.web.validation.Required;

/**
 * The download form for stop words dictionary.
 * This form is used for downloading stop words dictionary files from the admin interface.
 *
 */
public class DownloadForm {

    /**
     * Dictionary ID for identifying the stop words dictionary to download.
     */
    @Required
    public String dictId;

    /**
     * Default constructor.

    /** The label type IDs associated with this elevate word entry */
    public String[] labelTypeIds;

    /** The CRUD operation mode for form processing */
    @ValidateTypeFailure
    public Integer crudMode;

    /** The word that should trigger document elevation in search results */
    @Required
    public String suggestWord;

    /** The reading/pronunciation of the suggest word for language analysis */
    public String reading;

            newOutput = output;
        }
    }

    /**
     * Gets the new input word.
     *
     * @return The new input word.
     */
    public String getNewInput() {
        return newInput;
    }

    /**
     * Sets the new input word.
     *
     * @param newInput The new input word.
     */
    public void setNewInput(final String newInput) {
        this.newInput = newInput;
    }