@Test
    public void test_update() {
        loadTestData();

        StopwordsItem item = stopwordsFile.get(1).get();
        item.setNewInput("updated");
        stopwordsFile.update(item);

        // Verify the item was updated
        OptionalEntity<StopwordsItem> result = stopwordsFile.get(1);
        assertTrue(result.isPresent());
        assertEquals("updated", result.get().getInput());
    }

///

That means: "the variable `items` is a `list`, and each of the items in this list is a `str`".

By doing that, your editor can provide support even while processing items from the list:

<img src="/img/python-types/image05.png">

Without types, that's almost impossible to achieve.

Notice that the variable `item` is one of the elements in the list `items`.

                        if item.raw_data is not None:
                            data_str: str | None = item.raw_data
                        elif item.data is not None:
                            if hasattr(item.data, "model_dump_json"):
                                data_str = item.data.model_dump_json()
                            else:
                                data_str = json.dumps(jsonable_encoder(item.data))
                        else:

        // Should only store one item (duplicates are filtered)
        int count = 0;
        while (true) {
            final OpenSearchUrlQueue polled = urlQueueService.poll(sessionId);
            if (polled == null) {
                break;
            }
            count++;
        }

        assertTrue(count <= 2); // At most 2 items (may be deduplicated)
        urlQueueService.delete(sessionId);

				<div class="mt-3">
					<p class="mb-1"><la:message key="labels.search_popular_word_word" /></p>
					<p>
						<c:forEach var="item" varStatus="s" items="${popularWords}">
							<la:link href="/search?q=${f:u(item)}${fe:facetQuery()}${fe:geoQuery()}"
								styleClass="btn btn-outline-secondary btn-sm me-1 mb-1">${f:h(item)}</la:link>
						</c:forEach>
					</p>
				</div>
			</c:if>
		</div>
	</div>

                                            <c:forEach var="p" varStatus="s"
                                                       items="${pager.pageNumberList}">
                                                <li
                                                        <c:if test="${p == pager.currentPageNumber}">class="page-item active"</c:if>>
                                                    <la:link

                                                       items="${labelTypePager.pageNumberList}">
                                                <li
                                                        <c:if test="${p == labelTypePager.currentPageNumber}">class="page-item active"</c:if>>
                                                    <la:link

</details>

### Check it

Open your browser at [http://127.0.0.1:8000/items/5?q=somequery](http://127.0.0.1:8000/items/5?q=somequery).

You will see the JSON response as:

```JSON
{"item_id": 5, "q": "somequery"}
```

You already created an API that:

* Receives HTTP requests in the _paths_ `/` and `/items/{item_id}`.
* Both _paths_ take `GET` operations (also known as HTTP _methods_).

### 檢查 { #check-it }

使用瀏覽器開啟 [http://127.0.0.1:8000/items/5?q=somequery](http://127.0.0.1:8000/items/5?q=somequery)。

你將會看到以下 JSON 回應：

```JSON
{"item_id": 5, "q": "somequery"}
```

你已經建立了一個具有以下功能的 API：

* 透過路徑 `/` 和 `/items/{item_id}` 接受 HTTP 請求。
* 以上兩個路徑都接受 `GET` 操作（也被稱為 HTTP _方法_）。
* 路徑 `/items/{item_id}` 有一個 `int` 型別的路徑參數 `item_id`。
* 路徑 `/items/{item_id}` 有一個可選的 `str` 查詢參數 `q`。

    //                                               Details
    //                                               -------
    /**
     * Displays the details of a role item.
     *
     * @param crudMode the CRUD mode for the operation
     * @param id the ID of the role item to display
     * @return HTML response for the details page
     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })