*       ImmutableMap.get} returns {@code @Nullable E} because the method can return {@code null}
 *       even on an {@code ImmutableMap<K, @NonNull String>}.
 * </ul>
 *
 * <p>Consumers of this annotation include:
 *
 * <ul>
 *   <li>NullAway, which <a
 *       href="https://github.com/google/guava/issues/6126#issuecomment-1204399671">treats it
 *       identically to {@code Nullable}</a> as of version 0.9.9.

     *
     * @param searchEngineClient the search engine client to use for retrieval
     * @param id the document ID to retrieve
     * @param fields the fields to include in the response (null for all fields)
     * @return the document as a map of field names to values, or null if not found
     */

    private FileTree sources;
    /**
     * Directories to include notices from
     */
    private List<File> licensesDirs = new ArrayList<File>();

    public NoticeTask() {
        setDescription("Create a notice file from dependencies");
        // Default licenses directory is ${projectDir}/licenses (if it exists)

若你所在的國家限制部分網址，這會很有用。

### 停用自動產生的文件 { #disable-the-automatic-docs }

第一步是停用自動文件，因為預設會使用預設的 CDN。

要停用它們，建立 `FastAPI` 應用時把相關 URL 設為 `None`：

{* ../../docs_src/custom_docs_ui/tutorial001_py310.py hl[8] *}

### 加入自訂文件 { #include-the-custom-docs }

現在你可以為自訂文件建立「路徑操作（path operation）」。

你可以重用 FastAPI 的內部函式來建立文件的 HTML 頁面，並傳入所需參數：

* `openapi_url`：文件 HTML 頁面用來取得你 API 的 OpenAPI schema 的 URL。可使用屬性 `app.openapi_url`。
* `title`：你的 API 標題。

import static org.codelibs.core.beans.util.CopyOptionsUtil.converter;
import static org.codelibs.core.beans.util.CopyOptionsUtil.exclude;
import static org.codelibs.core.beans.util.CopyOptionsUtil.excludeNull;
import static org.codelibs.core.beans.util.CopyOptionsUtil.excludeWhitespace;
import static org.codelibs.core.beans.util.CopyOptionsUtil.include;
import static org.codelibs.core.beans.util.CopyOptionsUtil.prefix;

import jakarta.validation.constraints.Size;

/**
 * Form class for editing request header configurations in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing request header entries,
 * including tracking information for optimistic locking and audit trails.
 * Request headers are used to customize HTTP requests sent during web crawling operations.
 *

import jakarta.validation.constraints.Size;

/**
 * Form class for editing elevate word configurations in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing elevate word entries,
 * including tracking information for optimistic locking and audit trails.

 * <ul>
 * <li>os.name: The operating system name</li>
 * <li>os.arch: The operating system architecture</li>
 * <li>os.version: The operating system version</li>
 * </ul>
 * <p>
 * Supported OS families include:
 * <ul>
 * <li>windows: All Windows variants</li>
 * <li>win9x: Windows 95, 98, ME, CE</li>
 * <li>winnt: Windows NT variants</li>
 * <li>unix: Unix-like systems (including Linux)</li>

        assertNull(ex.getCause(), "No cause expected from default constructor");
        assertTrue(ex instanceof SmbException, "Should be an SmbException");

        // toString should include the class name and the message
        String ts = ex.toString();
        assertTrue(ts.contains("SmbUnsupportedOperationException"), "toString should contain class name");

            // When
            Type2Message parsedMessage = new Type2Message(rawMessage);

            // Then
            assertNotNull(parsedMessage);
            // The flags might include NTLMSSP_NEGOTIATE_TARGET_INFO if target info is set
            assertTrue((parsedMessage.getFlags() & Type2Message.NTLMSSP_NEGOTIATE_TARGET_INFO) != 0);