# 본문 - 필드 { #body-fields }

`Query`, `Path`와 `Body`를 사용해 *경로 처리 함수* 매개변수 내에서 추가적인 검증이나 메타데이터를 선언한 것처럼 Pydantic의 `Field`를 사용하여 모델 내에서 검증과 메타데이터를 선언할 수 있습니다.

## `Field` 임포트 { #import-field }

먼저 이를 임포트해야 합니다:

{* ../../docs_src/body_fields/tutorial001_an_py310.py hl[4] *}

/// warning | 경고

`Field`는 다른 것들처럼 (`Query`, `Path`, `Body` 등) `fastapi`에서가 아닌 `pydantic`에서 바로 임포트 되는 점에 주의하세요.

///

## 모델 어트리뷰트 선언 { #declare-model-attributes }

        List<String> readings = Arrays.asList("reading1", "reading2");
        List<String> fields = Arrays.asList("field1", "field2", "field3");
        List<String> tags = Arrays.asList("tag1", "tag2");
        List<String> roles = Arrays.asList("role1", "role2", "role3");

        elevateWord = new ElevateWord(word, boost, readings, fields, tags, roles);
        SuggestItem suggestItem = elevateWord.toSuggestItem();

        SuggestItem item1 = createItemWithFields("text", "field1", "field2");
        SuggestItem item2 = createItemWithFields("text", "field2", "field3");

        SuggestItem merged = SuggestItemMerger.merge(item1, item2);

        String[] fields = merged.getFields();
        Set<String> fieldSet = new HashSet<>(Arrays.asList(fields));

        assertEquals(3, fieldSet.size());

        String[] fields = { "field" };

        SuggestItem item = new SuggestItem(text, readings, fields, 1L, 1L, 1.0f, new String[] { "tag" }, new String[] { "role" },
                new String[] { "en" }, SuggestItem.Kind.QUERY);

        Map<String, Object> source = SuggestItemSerializer.toSource(item);

        // Verify all expected fields are present

        item.setReadings(newReadings);
        assertArrayEquals(newReadings, item.getReadings());

        // Test fields
        String[] fields = { "field1", "field2" };
        item.setFields(fields);
        assertArrayEquals(fields, item.getFields());

        // Test tags
        String[] tags = { "tag1", "tag2" };
        item.setTags(tags);

// JSON utilities with proper escaping
String escaped = JsonUtil.escape("Hello \"World\" with special chars");
String unescaped = JsonUtil.unescape(escaped);

// Text tokenization
Tokenizer tokenizer = new Tokenizer("field1,field2,field3", ",");
while (tokenizer.hasMoreTokens()) {
    String token = tokenizer.nextToken();
    // Process each token
}

// Decimal formatting

# Body - 欄位 { #body-fields }

就像你可以在「路徑操作函式 (path operation function)」的參數中用 `Query`、`Path` 和 `Body` 宣告額外的驗證與中繼資料一樣，你也可以在 Pydantic 模型中使用 Pydantic 的 `Field` 來宣告驗證與中繼資料。

## 匯入 `Field` { #import-field }

首先，你需要匯入它：

{* ../../docs_src/body_fields/tutorial001_an_py310.py hl[4] *}


/// warning

請注意，`Field` 是直接從 `pydantic` 匯入的，不像其他（如 `Query`、`Path`、`Body` 等）是從 `fastapi` 匯入。

///

## 宣告模型屬性 { #declare-model-attributes }

# Body - Alanlar { #body-fields }

`Query`, `Path` ve `Body` ile *path operation function* parametrelerinde ek doğrulama ve metadata tanımlayabildiğiniz gibi, Pydantic modellerinin içinde de Pydantic'in `Field`'ını kullanarak doğrulama ve metadata tanımlayabilirsiniz.

## `Field`'ı import edin { #import-field }

Önce import etmeniz gerekir:

{* ../../docs_src/body_fields/tutorial001_an_py310.py hl[4] *}

/// warning | Uyarı

        BooleanQuery.Builder boolQueryBuilder = new BooleanQuery.Builder();
        TermQuery termQuery1 = new TermQuery(new Term("field1", "value1"));
        TermQuery termQuery2 = new TermQuery(new Term("field2", "value2"));
        TermQuery termQuery3 = new TermQuery(new Term("field3", "value3"));

        boolQueryBuilder.add(termQuery1, BooleanClause.Occur.MUST);

        FacetInfo facetInfo = searchRequestParams.createFacetInfo(request);
        assertNotNull(facetInfo);
        assertEquals(2, facetInfo.field.length);
        assertEquals("field1", facetInfo.field[0]);
        assertEquals("field2", facetInfo.field[1]);
        assertEquals(2, facetInfo.query.length);
        assertEquals("query1", facetInfo.query[0]);
        assertEquals("query2", facetInfo.query[1]);