*
     * @param dictId the dictionary ID
     * @param form the upload form containing the dictionary file
     * @return JSON response with result status
     */
    // PUT /api/admin/dict/synonym/upload/{dictId}
    @Execute
    public JsonResponse<ApiResult> put$upload(final String dictId, final UploadForm form) {
        form.dictId = dictId;
        validateApi(form, messages -> {});

De toda forma, nós podemos declarar o esquema esperado para o corpo da requisição.

### Tipo de conteúdo do OpenAPI personalizado { #custom-openapi-content-type }

The spec also states that the `username` and `password` must be sent as form data (so, no JSON here).

### `scope` { #scope }

The spec also says that the client can send another form field "`scope`".

The form field name is `scope` (in singular), but it is actually a long string with "scopes" separated by spaces.

Each "scope" is just a string (without spaces).

import jakarta.validation.constraints.Min;
import jakarta.validation.constraints.Size;

/**
 * The create form for Scheduler.
 *
 */
public class CreateForm {

    /**
     * Creates a new CreateForm instance.
     */
    public CreateForm() {
    }

    /**
     * The CRUD mode for the form.
     */
    @ValidateTypeFailure
    public Integer crudMode;

    /**

     *
     * @param form the upload form containing the request file
     * @return action response with the search results or error page
     */
    @Execute
    @Secured({ ROLE })
    public ActionResponse upload(final UploadForm form) {
        validate(form, messages -> {}, () -> asListHtml(null));
        verifyTokenKeep(() -> asListHtml(this::saveToken));

    /**
     * Displays the not found error page.
     *
     * @param form the error form containing error information
     * @return HTML response for the not found error page
     */
    @Execute
    public HtmlResponse index(final ErrorForm form) {
        return asHtml(virtualHost(path_Error_NotFoundJsp));
    }

 */
package org.codelibs.fess.app.web.admin.wizard;

/**
 * Form class for the admin wizard index page.
 * This form handles the initial setup and configuration
 * in the administrative wizard interface.
 */
public class IndexForm {

    /**
     * Default constructor for index form.
     * Creates a new instance with default values.
     */
    public IndexForm() {

     * @param dictId the dictionary ID
     * @param form the upload form containing the dictionary file
     * @return JSON response with result status
     */
    // PUT /api/admin/dict/stemmerOverride/upload/{dictId}
    @Execute
    public JsonResponse<ApiResult> put$upload(final String dictId, final UploadForm form) {
        form.dictId = dictId;
        validateApi(form, messages -> {});

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

import jakarta.validation.constraints.Size;

/**
 * Form class for editing crawling information in the admin interface.
 * This form handles the editing of crawling session data, which tracks
 * the status and metadata of web crawling operations.
 *
 */
public class EditForm {

    /**

     */
    @Execute
    public JsonResponse<ApiResult> get$index() {
        final EditBody form = new EditBody();
        AdminGeneralAction.updateForm(fessConfig, form);
        form.ldapAdminSecurityCredentials = null;
        return asJson(new ApiConfigResponse().setting(form).status(Status.OK).result());
    }

    // PUT /api/admin/general
    /**
     * Updates the general system settings.