online.help.name.reqheader=reqheader
# Online help key for synonym dictionary.
online.help.name.dict.synonym=synonym
# Online help key for dictionary.
online.help.name.dict=dict
# Online help key for Kuromoji dictionary.
online.help.name.dict.kuromoji=kuromoji
# Online help key for protected words dictionary.
online.help.name.dict.protwords=protwords
# Online help key for stopwords dictionary.
online.help.name.dict.stopwords=stopwords

* scratch the surface: tocar los conceptos básicos
* string: string
* bug: bug
* docs: documentación (do not translate to "documentos")
* cheat sheet: cheat sheet (do not translate to "chuleta")
* key (as in key-value pair, dictionary key): clave
* array (as in JSON array): array
* API key: API key (do not translate to "clave API")
* 100% test coverage: cobertura de tests del 100%
* back and forth: de un lado a otro

    /** The number of records per page. */
    private int pageSize;

    /** The current page number. */
    private int currentPageNumber;

    /** The ID of the stopwords dictionary. */
    public String id;

    /**
     * Clears the pager's state to its default values.
     */
    public void clear() {
        allRecordCount = 0;
        allPageCount = 0;
        existPrePage = false;

import org.apache.commons.lang3.StringUtils;
import org.codelibs.core.collection.ArrayUtil;
import org.codelibs.core.lang.StringUtil;
import org.codelibs.fess.dict.DictionaryItem;

/**
 * Represents an item in a synonym dictionary.
 * This class stores a set of input words and their corresponding output synonyms.
 * It also tracks updated values for the item.
 */
public class SynonymItem extends DictionaryItem {
    /** The original input words. */

 * governing permissions and limitations under the License.
 */
package org.codelibs.fess.dict.kuromoji;

import java.util.Objects;

import org.codelibs.fess.dict.DictionaryItem;

/**
 * An item in a Kuromoji dictionary.
 */
public class KuromojiItem extends DictionaryItem {
    private final String token;

    private final String segmentation;

    private final String reading;

    private final String pos;

                },
                "x-aperture-labs-portal": "blue"
            }
        }
    }
}
```

### Custom OpenAPI *path operation* schema { #custom-openapi-path-operation-schema }

The dictionary in `openapi_extra` will be deeply merged with the automatically generated OpenAPI schema for the *path operation*.

So, you could add additional data to the automatically generated schema.

        assertEquals("/error/system.jsp", FessHtmlPath.path_Error_SystemJsp.getRoutingPath());
    }

    @Test
    public void test_dictPaths() throws Exception {
        // Test dictionary paths structure
        assertEquals("/admin/dict/admin_dict.jsp", FessHtmlPath.path_AdminDict_AdminDictJsp.getRoutingPath());
        assertEquals("/admin/dict/kuromoji/admin_dict_kuromoji.jsp",

├── ldap/                      # LDAP integration
├── filter/                    # Servlet filters
├── validation/                # Custom validators
├── dict/                      # Dictionary management
└── ds/                        # Data store connectors

src/main/resources/
├── fess_config.properties     # Main configuration
├── app.xml, fess.xml          # DI configuration

For example, you could want to **return a dictionary** or a database object, but **declare it as a Pydantic model**. This way the Pydantic model would do all the data documentation, validation, etc. for the object that you returned (e.g. a dictionary or database object).

但更重要的是：

* 它會將輸出資料限制並過濾為回傳型別中定義的內容。
    * 這對安全性特別重要，下面會再看到更多細節。

## `response_model` 參數 { #response-model-parameter }

有些情況下，你需要或想要回傳的資料與你宣告的型別不完全相同。

例如，你可能想要回傳一個 dictionary 或資料庫物件，但把回應宣告為一個 Pydantic 模型。這樣 Pydantic 模型就會替你回傳的物件（例如 dictionary 或資料庫物件）處理所有的資料文件、驗證等。

如果你加了回傳型別註解，工具與編輯器會（正確地）抱怨你的函式回傳的型別（例如 dict）與你宣告的（例如 Pydantic 模型）不同。

在這些情況下，你可以使用「路徑操作裝飾器」參數 `response_model`，而不是函式的回傳型別。

你可以在任何「路徑操作」上使用 `response_model` 參數：