在此之前，只支持使用单个示例的关键字 `example`。OpenAPI 3.1.0 仍然支持它，但它已被弃用，并不属于 JSON Schema 标准。因此，建议你把 `example` 迁移到 `examples`。🤓

你可以在本页末尾阅读更多内容。

///

## `Field` 的附加参数 { #field-additional-arguments }

在 Pydantic 模型中使用 `Field()` 时，你也可以声明额外的 `examples`：

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

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

    /**
     * Creates text fragments from highlight fields for URL fragment navigation.
     *
     * @param fields the highlight fields
     * @return array of text fragments
     */
    public TextFragment[] createTextFragmentsByHighlight(final HighlightField[] fields) {
        final List<TextFragment> list = new ArrayList<>();
        for (final HighlightField field : fields) {

                    ComponentUtil.getFessConfig().getSystemProperty("rag.llm.name", "ollama"));

            final Map<String, String[]> fields = parseFieldFilters(request);
            final String[] extraQueries = parseExtraQueries(request);
            final ChatResult result;
            if (fields.isEmpty() && extraQueries.length == 0) {
                result = ComponentUtil.getChatClient().chat(sessionId, message, userId);

    }

    /**
     * Builds the query for suggestions.
     * @param q The query string.
     * @param fields The fields to search in.
     * @return The QueryBuilder instance.
     */
    public QueryBuilder buildQuery(final String q, final List<String> fields) {
        try {
            final QueryBuilder queryBuilder;
            if (Strings.isNullOrEmpty(q)) {

            }));
            return list;
        });
    }

    /**
     * Updates a specific field in a document.
     *
     * @param index the index name
     * @param id    the document ID
     * @param field the field name to update
     * @param value the new field value
     * @return true if the update was successful, false otherwise

        assertEquals("", queryLog.getQueryString());
        assertEquals("", queryLog.getFilterQueryString());
    }

    @Test
    public void test_complexQuery() throws Exception {
        String query = "field1:value1 AND field2:value2";
        String filterQuery = "category:electronics";
        QueryLog queryLog = new QueryLog(query, filterQuery);

        assertEquals(query, queryLog.getQueryString());

type Record struct {
	columnNames  []string
	csvRecord    []string
	nameIndexMap map[string]int64
}

// Get - gets the value for a column name. CSV fields do not have any
// defined type (other than the default string). So this function
// always returns fields using sql.FromBytes so that the type
// specified/implied by the query can be used, or can be automatically
// converted based on the query.

        // Then
        assertNotNull(dfsRootEnum, "The MsrpcDfsRootEnum object should not be null.");
        // The server name is stored in a protected field without a public getter, so we cannot directly test it.
        // We can test the public fields that are set.
        assertEquals(200, dfsRootEnum.level, "The level should be initialized to 200.");
        assertNotNull(dfsRootEnum.info, "The info struct should not be null.");

        Field field = response.getClass().getDeclaredField("converter");
        field.setAccessible(true);
        return field.getInt(response);
    }

    private void setConverter(NetShareEnumResponse response, int value) throws Exception {
        Field field = response.getClass().getDeclaredField("converter");
        field.setAccessible(true);
        field.setInt(response, value);
    }

 * </p>
 *
 * <pre>
 * for (PropertyDesc propertyDesc : beanDesc.getPropertyDescs()) {
 *     propertyDesc.getValue(foo); // Retrieve the value of Foo's property
 * }
 *
 * for (FieldDesc fieldDesc : beanDesc.getFieldDescs()) {
 *     fieldDesc.getFieldValue(foo); // Retrieve the value of Foo's field
 * }
 *