/** The role service for managing role settings. */
    @Resource
    private RoleService roleService;

    /**
     * Retrieves role settings with pagination.
     *
     * @param body the search parameters for filtering and pagination
     * @return JSON response containing role settings list
     */
    // GET /api/admin/role/settings
    // PUT /api/admin/role/settings
    @Execute

        <span class="sponsor-badge">sponsor</span>
        <img class="sponsor-image" src="/img/sponsors/railway-banner.png" />
      </a>
    </div>
    <div class="item">
      <a title="SerpApi: Web Search API" style="display: block; position: relative;" href="https://serpapi.com/?utm_source=fastapi_website" target="_blank">
        <span class="sponsor-badge">sponsor</span>

    /** The user service for managing user settings. */
    @Resource
    private UserService userService;

    /**
     * Retrieves user settings with pagination.
     *
     * @param body the search parameters for filtering and pagination
     * @return JSON response containing user settings list
     */
    // GET /api/admin/user/settings
    // PUT /api/admin/user/settings
    @Execute

    static String getMessageByCode(final int errcode) {
        /* Note there's a signedness error here because 0xC0000000 based values are
         * negative so it with NT_STATUS_SUCCESS (0) the binary search will not be
         * performed properly. The effect is that the code at index 1 is never found
         * (NT_STATUS_UNSUCCESSFUL). So here we factor out NT_STATUS_SUCCESS
         * as a special case (which it is).
         */

        final Map<String, Object> metaDataMap = responseData.getMetaDataMap();
        metaDataMap.put("author", "John Doe");
        metaDataMap.put("keywords", new String[] { "java", "search" });

        assertNotNull(responseData.getMetaDataMap());
        assertEquals(2, responseData.getMetaDataMap().size());
        assertEquals("John Doe", responseData.getMetaDataMap().get("author"));
    }

    // ===================================================================================
    //                                                                      Search Execute
    //                                                                      ==============
    /**
     * Handles document redirection requests.

        chatApiManager.sendSseEvent(writer, "phase", Map.of("phase", "search", "status", "start", "message", "Searching documents"));

        final String output = stringWriter.toString();
        assertTrue(output.contains("event: phase"));
        assertTrue(output.contains("\"phase\":\"search\""));
        assertTrue(output.contains("\"status\":\"start\""));

  - navigation.instant.prefetch
  - navigation.instant.progress
  - navigation.path
  - navigation.tabs
  - navigation.tabs.sticky
  - navigation.top
  - navigation.tracking
  - search.highlight
  - search.share
  - search.suggest
  - toc.follow
  icon:
    repo: fontawesome/brands/github-alt
  logo: img/icon-white.svg
  favicon: img/favicon.png
  language: en
repo_name: fastapi/fastapi

/// tip

FastAPI has an [official extension for VS Code](https://marketplace.visualstudio.com/items?itemName=FastAPILabs.fastapi-vscode) (and Cursor), which provides a lot of features, including a path operation explorer, path operation search, CodeLens navigation in tests (jump to definition from tests), and FastAPI Cloud deployment and logs, all from your editor.

///

## Advanced User Guide { #advanced-user-guide }

    // ===================================================================================
    // Hook
    // ======

    // ===================================================================================
    // Search Execute
    // ==============

    /**
     * Displays the profile index page.
     *
     * @return the HTML response
     */
    @Execute
    public HtmlResponse index() {
        return asIndexHtml();