}

    /**
     * Uploads a file to the storage system.
     *
     * @param form the item form containing file and path information
     * @return HTML response redirecting to the storage list after upload
     */
    @Execute
    @Secured({ ROLE })
    public HtmlResponse upload(final ItemForm form) {
        validate(form, messages -> {}, () -> asListHtml(form.path));

    }

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

    /** The key of the message: Uploaded a synonym file. */
    public static final String SUCCESS_upload_synonym_file = "{success.upload_synonym_file}";

    /** The key of the message: Uploaded a protwords file. */
    public static final String SUCCESS_upload_protwords_file = "{success.upload_protwords_file}";

    /** The key of the message: Uploaded a stopwords file. */

    }

    // PUT /api/admin/badword/upload
    /**
     * Uploads bad words from a CSV file.
     *
     * @param body the upload form containing the CSV file
     * @return JSON response with result status
     */
    @Execute
    public JsonResponse<ApiResult> put$upload(final UploadForm body) {
        validateApi(body, messages -> {});

    }

    /**
     * Uploads stemmer override dictionary file.
     *
     * @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) {

    //                                                Upload
    //                                               -------
    /**
     * Display the upload page for stemmer override dictionary file.
     * Shows the current file path and provides upload interface.
     *
     * @param dictId The dictionary ID to upload to
     * @return HTML response for the upload page
     */
    @Execute
    @Secured({ ROLE })

{* ../../docs_src/request_files/tutorial001_03_an_py310.py hl[9,15] *}

## Завантаження кількох файлів { #multiple-file-uploads }

Можна завантажувати кілька файлів одночасно.

Вони будуть пов’язані з одним і тим самим «form field», який передається у вигляді «form data».

///

## 可選的檔案上傳 { #optional-file-upload }

可透過一般型別註解並將預設值設為 `None` 使檔案成為可選：

{* ../../docs_src/request_files/tutorial001_02_an_py310.py hl[9,17] *}

## `UploadFile` 搭配額外中繼資料 { #uploadfile-with-additional-metadata }

你也可以在 `UploadFile` 上搭配 `File()`，例如用來設定額外的中繼資料：

{* ../../docs_src/request_files/tutorial001_03_an_py310.py hl[9,15] *}

## 多檔案上傳 { #multiple-file-uploads }

可以同時上傳多個檔案。

        return redirect(getClass());
    }

    /**
     * Uploads and imports elevate words from a CSV file.
     *
     * @param form upload form containing the CSV file
     * @return redirect response to the main elevate word page
     */
    @Execute
    @Secured({ ROLE })
    public HtmlResponse upload(final UploadForm form) {
        validate(form, messages -> {}, this::asUploadHtml);

{* ../../docs_src/request_files/tutorial001_03_an_py310.py hl[9,15] *}

## Téléverser plusieurs fichiers { #multiple-file-uploads }

Il est possible de téléverser plusieurs fichiers en même temps.

Ils seraient associés au même « champ de formulaire » envoyé en « données de formulaire ».