{* ../../docs_src/schema_extra_example/tutorial002_py310.py hl[2,8:11] *}

## JSON Schema 中的 `examples` - OpenAPI { #examples-in-json-schema-openapi }

在以下任意场景中使用：

- `Path()`
- `Query()`
- `Header()`
- `Cookie()`
- `Body()`
- `Form()`
- `File()`

你也可以声明一组 `examples`，这些带有附加信息的示例将被添加到它们在 OpenAPI 中的 JSON Schema 里。

### 带有 `examples` 的 `Body` { #body-with-examples }

    description: str | None
    value: Any | None
    externalValue: AnyUrl | None

    __pydantic_config__ = {"extra": "allow"}  # type: ignore[misc]


class ParameterInType(Enum):
    query = "query"
    header = "header"
    path = "path"
    cookie = "cookie"


class Encoding(BaseModelWithConfig):
    contentType: str | None = None
    headers: dict[str, Union["Header", Reference]] | None = None

`File` ist eine Klasse, die direkt von `Form` erbt.

Aber erinnern Sie sich, dass, wenn Sie `Query`, `Path`, `File` und andere von `fastapi` importieren, diese tatsächlich Funktionen sind, welche spezielle Klassen zurückgeben.

///

/// tip | Tipp

Um Dateibodys zu deklarieren, müssen Sie `File` verwenden, da diese Parameter sonst als Query-Parameter oder Body (JSON)-Parameter interpretiert werden würden.

///

import jcifs.Decodable;

/**
 * Base interface for File System Control Code (FSCC) file system information structures.
 * Provides common functionality for various SMB2/SMB3 file system information classes
 * used in query file system information operations, with constants for information levels.
 *
 * @author mbechler
 */
public interface FileSystemInformation extends Decodable {

    /**
     * SMB information allocation constant.

## Define parámetros `File` y `Form` { #define-file-and-form-parameters }

Crea parámetros de archivo y formulario de la misma manera que lo harías para `Body` o `Query`:

{* ../../docs_src/request_forms_and_files/tutorial001_an_py310.py hl[10:12] *}

Los archivos y campos de formulario se subirán como form data y recibirás los archivos y campos de formulario.

        $(document).on('input', '.filter-search-input', function() {
            var query = $(this).val().toLowerCase();
            $(this).closest('.filter-dropdown-menu').find('.filter-check-item').each(function() {
                var label = $(this).find('.filter-check-label').text().toLowerCase();
                $(this).toggle(label.indexOf(query) !== -1);
            });
        });

        // Filter clear group handler

<%@page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%>
<%-- query did not match any document --%>
<div id="result" class="row">
	<div class="col-md-8">
		<div class="text-center py-4">
			<p class="mb-3"><i class="fa fa-search fa-3x text-muted" aria-hidden="true"></i></p>
			<p class="mb-2"><la:message key="labels.did_not_match" arg0="${displayQuery}" /></p>
			<p class="text-muted"><la:message key="labels.did_not_match_suggestion" /></p>

 */
public class ErrorForm {

    /** Map of form fields and their validation error messages */
    public Map<String, String[]> fields = new HashMap<>();

    /** Search query parameter that caused the error */
    public String q;

    /** URL parameter associated with the error */
    public String url;

    /** Number of results parameter */
    public String num;

    }

    /**
     * LSA query information policy message.
     */
    public static class LsarQueryInformationPolicy extends DcerpcMessage {

        @Override
        public int getOpnum() {
            return 0x07;
        }

        /** Return value from the RPC call. */
        public int retval;
        /** Policy handle for the query. */
        public rpc.policy_handle handle;

 */
package org.codelibs.fess.app.web.api.admin.relatedquery;

import org.codelibs.fess.app.web.api.admin.BaseSearchBody;

/**
 * Search request body for related query administration API.
 */
public class SearchBody extends BaseSearchBody {

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