* attempting to read beyond the end of a file.
 *
 * @author mbechler
 */
public class SmbEndOfFileException extends SmbException {

    /**
     *
     */
    private static final long serialVersionUID = 298752101881244000L;

    /**
     * Constructs an end-of-file exception.
     */
    public SmbEndOfFileException() {
        super("Unexpectedly reached end of file");
    }

@app.post("/items/", summary="Create an item")
async def create_item(item: Item) -> Item:
    """
    Create an item with all the information:

    - **name**: each item must have a name
    - **description**: a long description
    - **price**: required
    - **tax**: if the item doesn't have tax, you can omit this
    - **tags**: a set of unique tag strings for this item
    \f
    :param item: User input.
    """

The JSON Schemas of your models will be part of your OpenAPI generated schema, and will be shown in the interactive API docs:

<img src="/img/tutorial/body/image01.png">

And will also be used in the API docs inside each *path operation* that needs them:

<img src="/img/tutorial/body/image02.png">

## Editor support { #editor-support }

This protects against accidental overwrites or deletes of objects, allows previous versions to be retrieved.

When you DELETE an object, all versions remain in the bucket and MinIO adds a delete marker, as shown below:

![delete](https://raw.githubusercontent.com/minio/minio/master/docs/bucket/versioning/versioning_DELETE_versionEnabled.png)

    public String[] query;

    /** Maximum number of facet values to return */
    public Integer size;

    /** Minimum document count required for a facet value to be included */
    public Long minDocCount;

    /** Sort order for facet values (e.g., "count.desc", "term.asc") */
    public String sort;

    /** Value to use for documents that don't have the facet field */
    public String missing;

import org.opensearch.action.admin.cluster.health.ClusterHealthResponse;
import org.opensearch.cluster.health.ClusterHealthStatus;
import org.opensearch.common.xcontent.XContentType;

/**
 * Response entity for ping operations.
 */
public class PingResponse {
    private static final String CLUSTER_NAME = "cluster_name";
    private static final String STATUS = "status";
    private static final String TIMED_OUT = "timed_out";

    private static final AtomicInteger keyGenerator = new AtomicInteger(2000);
    private static final AtomicLong addressCounter = new AtomicLong(0x10000000L);
    private static final Map<ByteBuffer, Long> bufferAddresses = new ConcurrentHashMap<>();

    // DiSNI objects - would be actual DiSNI types in real implementation
    private final Object endpoint; // RdmaActiveEndpoint

        String[][] readings = { { "reading1" } };
        String[] fields = { "field1" };
        String[] tags = { "tag1" };
        String[] roles = { "role1" };
        String[] languages = { "en" };
        long docFreq = 10L;
        long queryFreq = 5L;
        float userBoost = 1.5f;

        SuggestItem item =
                new SuggestItem(text, readings, fields, docFreq, queryFreq, userBoost, tags, roles, languages, SuggestItem.Kind.DOCUMENT);

例如，你可以在 Swagger UI 中停用語法醒目提示（syntax highlighting）。

不更動設定時，語法醒目提示預設為啟用：

<img src="/img/tutorial/extending-openapi/image02.png">

但你可以將 `syntaxHighlight` 設為 `False` 來停用它：

{* ../../docs_src/configure_swagger_ui/tutorial001_py310.py hl[3] *}

...然後 Swagger UI 就不會再顯示語法醒目提示：

<img src="/img/tutorial/extending-openapi/image03.png">

## 更換主題 { #change-the-theme }

同樣地，你可以用鍵 `"syntaxHighlight.theme"` 設定語法醒目提示主題（注意中間有一個點）：

            processMethod.setAccessible(true);

            try {
                Integer result = (Integer) processMethod.invoke(null, options);
                // Any result is acceptable as long as no unexpected exception
                assertNotNull(result);
            } catch (Exception e) {
                // Expected behavior when components are not fully initialized