* Resolve the location of a DFS path
     *
     * @param domain the domain for the DFS referral
     * @param root the DFS root share
     * @param path the DFS path to resolve
     * @param tf the CIFS context containing configuration and credentials
     * @return the final referral for the given DFS path
     * @throws CIFSException if an error occurs during resolution
     * @throws jcifs.smb.SmbAuthException if authentication fails
     */

   * @return an immutable set containing those elements, minus duplicates
   */
  public static <E extends Enum<E>> ImmutableSet<E> immutableEnumSet(
      E anElement, E... otherElements) {
    return ImmutableEnumSet.asImmutable(EnumSet.of(anElement, otherElements));
  }

  /**
   * Returns an immutable set instance containing the given enum elements. Internally, the returned

     *
     * @return a byte array containing the data.
     */
    byte[] getData();

    /**
     * Retrieves the data as a String.
     *
     * @return the data in String format.
     */
    String getDataAsString();

    /**
     * Sets the data for this AccessResultData instance.
     *
     * @param data the byte array containing the data to be set
     */
    void setData(byte[] data);

        // Default constructor
    }

    /**
     * Retrieves a paginated list of request headers based on the provided pager criteria.
     *
     * @param requestHeaderPager the pager containing pagination and search criteria
     * @return a list of request headers matching the specified criteria
     */
    public List<RequestHeader> getRequestHeaderList(final ReqHeaderPager requestHeaderPager) {

    /**
     * Returns list of job logs.
     * Supports filtering and pagination for job execution history.
     *
     * @param body search parameters for filtering and pagination
     * @return JSON response containing job logs list with pagination info
     */
    @Execute
    public JsonResponse<ApiResult> logs(final SearchBody body) {
        validateApi(body, messages -> {});

     * @return an OptionalEntity containing the user if found
     */
    public OptionalEntity<User> getUser(final String id) {
        return userBhv.selectByPK(id).map(u -> ComponentUtil.getAuthenticationManager().load(u));
    }

    /**
     * Retrieves a user by their username.
     *
     * @param username the username to search for
     * @return an OptionalEntity containing the user if found
     */

     *
     * @return a new DataStoreParams instance containing a copy of the current parameters
     */
    public DataStoreParams newInstance() {
        return new DataStoreParams(params);
    }

    /**
     * Adds all key-value pairs from the specified map to this parameter container.
     *
     * @param map the map containing parameters to add, must not be null
     */

     * Supports both GET and PUT requests for retrieving paginated duplicate host configurations.
     *
     * @param body search parameters for filtering and pagination
     * @return JSON response containing duplicate host settings list with pagination info
     */
    @Execute
    public JsonResponse<ApiResult> settings(final SearchBody body) {
        validateApi(body, messages -> {});

For example, it doesn't receive `datetime` objects, as those are not compatible with JSON.

So, a `datetime` object would have to be converted to a `str` containing the data in <a href="https://en.wikipedia.org/wiki/ISO_8601" class="external-link" target="_blank">ISO format</a>.

The same way, this database wouldn't receive a Pydantic model (an object with attributes), only a `dict`.

    }

    /**
     * Retrieves scheduler settings with pagination.
     *
     * @param body the search parameters for filtering and pagination
     * @return JSON response containing scheduler settings list
     */
    // GET /api/admin/scheduler
    // PUT /api/admin/scheduler
    @Execute
    public JsonResponse<ApiResult> settings(final SearchBody body) {