ace-front-end 1.0.0

package/ace-app-bolts-ui/src/api/orgService/user.ts

@@ -0,0 +1,1187 @@
+import type {IAceAxios} from "../../http/IAceAxios";
+import {createApiWithCache} from "../apiCache";
+import type {Page} from "../../models/Page";
+import {
+    type ProfileSettings,
+    type AddUserToGroupsCommand,
+    type BatchDisableUserCommand,
+    type BatchEnableUserCommand,
+    type BatchEnableUserIpBindCommand, type BatchSetMaxSessionsCommand,
+    type BatchUpdateUserAttributeCommand,
+    type BatchUpdateUserClassifiedLevelCommand,
+    type BatchUpdateUserDepartmentCommand,
+    type BatchUpdateUserExpireDateCommand,
+    type CreateUserCommand,
+    type DeleteUserCommand,
+    type DeleteUserFromGroupsCommand,
+    type GrantRolesToUserCommand,
+    type ResetPasswordCommand,
+    type RevokeRolesFromUserCommand,
+    type UpdatePasswordCommand,
+    type UpdateUserCommand, type UpdateUserProfileCommand,
+    type User, type UserReference, type UpdateUserRolesCommand, type UpdateUserGroupsCommand
+} from "../../models/orgService/User";
+import type {
+    GrantRoleToUsersCommand,
+    MergedRole,
+    ProjectedRole,
+    RevokeRoleFromUsersCommand,
+} from "../../models/orgService/Role";
+import type {
+    AddUsersToGroupCommand,
+    DeleteUsersFromGroupCommand,
+    ProjectedGroup,
+} from "../../models/orgService/Group";
+import type {QuerySpecification} from "../../models/expr/querySpecification";
+import type {AceAxiosRequestConfig} from "../../http/types";
+
+export type PagedResType = Page<User>;
+
+/**
+ * 用于指示查询结果集中包含用户的哪些属性
+ */
+export const FromUserSelect = {
+    /**
+     * 包含用户基本、部门基本、部门树属性
+     */
+    BDBAT: "com.csicit.ace.api.organization.dto.FromUserSelect$BDBAT",
+    /**
+     * 包含用户基本、扩展属性、部门基本、部门扩展属性
+     */
+    BADBA: "com.csicit.ace.api.organization.dto.FromUserSelect$BADBA",
+    /**
+     * 包含用户基本、扩展、部门基本属性
+     */
+    BADB: "com.csicit.ace.api.organization.dto.FromUserSelect$BADB",
+    /**
+     * 包含用户引用字段（极少字段）
+     */
+    R: "com.csicit.ace.api.organization.dto.FromUserSelect$R",
+    /**
+     * 包含用户基本属性
+     */
+    B: "com.csicit.ace.api.organization.dto.FromUserSelect$B",
+    /**
+     * 包含部门的用户DTO
+     */
+    BDB: "com.csicit.ace.api.organization.dto.FromUserSelect$BDB",
+    /**
+     * 携带了部门、扩展属性
+     */
+    BADBT: "com.csicit.ace.api.organization.dto.FromUserSelect$BADBT",
+    /**
+     * 携带了部门和部门树属性
+     */
+    BDBT: "com.csicit.ace.api.organization.dto.FromUserSelect$BDBT",
+    /**
+     * 包含了扩展属性
+     */
+    BA: "com.csicit.ace.api.organization.dto.FromUserSelect$BA",
+    /**
+     * 包含了部门和部门扩展属性
+     */
+    BDBA: "com.csicit.ace.api.organization.dto.FromUserSelect$BDBA",
+    /**
+     * 包含了扩展属性、部门属性、部门扩展属性和部门树属性
+     */
+    BADBAT: "com.csicit.ace.api.organization.dto.FromUserSelect$BADBAT",
+} as const;
+
+export type TypeFromUserSelect = (typeof FromUserSelect)[keyof typeof FromUserSelect];
+
+function useUserApiInternal(axios: IAceAxios) {
+    const baseUrl = "/ace-app-service/users";
+    return {
+        /**
+         * 获取用户总数量
+         * @param config 请求配置参数
+         */
+        getTotalCount(config?: AceAxiosRequestConfig) {
+            return axios.get<number>(`${baseUrl}/count`, undefined, config);
+        },
+        /**
+         * 获取当前登录用户信息
+         * @param config 请求配置参数
+         */
+        getAuthenticatedUser(config?: AceAxiosRequestConfig) {
+            return axios.get<User>(`${baseUrl}/authenticated`, undefined, config);
+        },
+        /**
+         * 获取指定ID的用户
+         * @param userId
+         * @param config 请求配置参数
+         */
+        getById(userId: string, config?: AceAxiosRequestConfig) {
+            return axios.get<User>(`${baseUrl}/by-id/${userId}`, undefined, config);
+        },
+        /**
+         * 获取指定用户名的用户
+         * @param realmName 用户域名
+         * @param username
+         * @param config 请求配置参数
+         */
+        getByUserName(realmName: string, username: string, config?: AceAxiosRequestConfig) {
+            return axios.get<User>(`${baseUrl}/by-username/${realmName}/${username}`, undefined, config);
+        },
+        /**
+         * 获取指定id用户的角色集合(直接授予的角色，非有效角色集合)
+         * @param userId 用户Id
+         * @param config 请求配置参数
+         */
+        getByUserRoles(userId: string, config?: AceAxiosRequestConfig) {
+            return axios.get<ProjectedRole>(`${baseUrl}/roles/${userId}`, undefined, config);
+        },
+        /**
+         * 获取用户加入的用户组
+         * @param userId 用户Id
+         * @param appName 应用名
+         * @param category 用户组的业务类别
+         * @param config 请求配置参数
+         */
+        getUserGroups(userId: string, appName: string, category?: string, config?: AceAxiosRequestConfig) {
+            if (category) {
+                return axios.get<ProjectedGroup[]>(`${baseUrl}/groups/${userId}/${appName}/${category}`, undefined, config);
+            }
+            return axios.get<ProjectedGroup[]>(`${baseUrl}/groups/${userId}/${appName}`, undefined, config);
+        },
+        /**
+         * 获取当前登录用户加入的用户组
+         * @param config 请求配置参数
+         */
+        getMyGroups(config?: AceAxiosRequestConfig) {
+            return axios.get<ProjectedGroup[]>(`${baseUrl}/my-groups`, undefined, config);
+        },
+        /**
+         * 将用户加入用户组
+         * @param groupId
+         * @param users
+         * @param config 请求配置参数
+         */
+        setUsersToGroup(groupId: string, users: string[], config?: AceAxiosRequestConfig) {
+            return axios.post(
+                `${baseUrl}/group`,
+                {
+                    id: groupId,
+                    users: users,
+                },
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 将用户移出用户组
+         * @param groupId
+         * @param users
+         * @param config 请求配置参数
+         */
+        removeUsersFromGroup(groupId: string, users: string[], config?: AceAxiosRequestConfig) {
+            return axios.delete(
+                `${baseUrl}/group`,
+                {
+                    id: groupId,
+                    users: users,
+                },
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 设置用户组成员
+         * @param groupId
+         * @param users
+         * @param config 请求配置参数
+         */
+        setGroupMembers(groupId: string, users: string[], config?: AceAxiosRequestConfig) {
+            return axios.post(
+                `${baseUrl}/group-members`,
+                {
+                    id: groupId,
+                    users: users,
+                },
+                undefined,
+                config,
+            );
+        },
+
+        /**
+         * 分页获取指定用户域下所有用户
+         * @param recycled true表示获取已回收用户，false表示获取正常用户
+         * @param realmId 用户域id
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param page 页码
+         * @param size 每页数据量
+         * @param sort 查询排序，单字段排序例如："name,desc"，多字段排序需要使用数组：["name,asc", "birthday,desc"]
+         * @param config 请求配置参数
+         */
+        getAllPaged(
+            recycled: boolean,
+            realmId: string,
+            resultClazz: TypeFromUserSelect,
+            page: number,
+            size: number,
+            sort?: string[] | string,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.get<PagedResType>(
+                `${baseUrl}/all/paged/${recycled}/${realmId}/${resultClazz}`,
+                {
+                    page,
+                    size,
+                    sort,
+                },
+                config,
+            );
+        },
+        /**
+         * 递归分页获取指定部门下所有用户
+         * @param deptId 部门id
+         * @param recycled true表示获取已回收用户，false表示获取正常用户
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param page 页码
+         * @param size 每页数据量
+         * @param sort 查询排序，单字段排序例如："name,desc"，多字段排序需要使用数组：["name,asc", "birthday,desc"]
+         * @param config 请求配置参数
+         */
+        getByDeptIncludeSubPaged(
+            deptId: string,
+            recycled: boolean,
+            resultClazz: TypeFromUserSelect,
+            page: number,
+            size: number,
+            sort?: string | string[],
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.get<PagedResType>(
+                `${baseUrl}/by-dept-recursively/paged/${deptId}/${recycled}/${resultClazz}`,
+                {
+                    page,
+                    size,
+                    sort,
+                },
+                config,
+            );
+        },
+        /**
+         * 分页获取指定的多个部门下的直属用户
+         * @param deptIds 部门id集合
+         * @param recycled true表示获取已回收用户，false表示获取正常用户
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param page 页码
+         * @param size 每页数据量
+         * @param sort 查询排序，单字段排序例如："name,desc"，多字段排序需要使用数组：["name,asc", "birthday,desc"]
+         * @param config 请求配置参数
+         */
+        getByDepartmentsPaged(
+            deptIds: string[],
+            recycled: boolean,
+            resultClazz: TypeFromUserSelect,
+            page: number,
+            size: number,
+            sort?: string | string[],
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<PagedResType>(
+                `${baseUrl}/by-depts/paged/${recycled}/${resultClazz}`,
+                deptIds,
+                {
+                    page,
+                    size,
+                    sort,
+                },
+                config,
+            );
+        },
+        /**
+         * 获取指定用户域下所有用户
+         * @param recycled
+         * @param realmId
+         * @param resultClazz
+         * @param config 请求配置参数
+         */
+        getAll(
+            recycled: boolean,
+            realmId: string,
+            resultClazz: TypeFromUserSelect,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.get<User[]>(
+                `${baseUrl}/all/paged/${recycled}/${realmId}/${resultClazz}`,
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 递归获取指定部门下的用户
+         * @param deptId
+         * @param recycled true表示获取已回收用户，false表示获取正常用户
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param config 请求配置参数
+         */
+        getByDepartmentIncludeSub(
+            deptId: string,
+            recycled: boolean,
+            resultClazz: TypeFromUserSelect,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.get<User[]>(
+                `${baseUrl}/by-dept-recursively/paged/${deptId}/${recycled}/${resultClazz}`,
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 获取指定多个部门下的所有直属用户
+         * @param deptIds 部门id集合
+         * @param recycled true表示获取已回收用户，false表示获取正常用户
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param config 请求配置参数
+         */
+        getByDepartments(
+            deptIds: string[],
+            recycled: boolean,
+            resultClazz: TypeFromUserSelect,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<User[]>(
+                `${baseUrl}/by-depts/${recycled}/${resultClazz}`,
+                deptIds,
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 分页递归获取指定用户组下所有未回收用户
+         * @param groupId 用户id
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param page 页码
+         * @param size 每页数据量
+         * @param config 请求配置参数
+         * @param sort 查询排序，单字段排序例如："name,desc"，多字段排序需要使用数组：["name,asc", "birthday,desc"]
+         */
+        getByGroupIncludeSubPaged(
+            groupId: string,
+            resultClazz: TypeFromUserSelect,
+            page: number,
+            size: number,
+            sort?: string | string[],
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.get<PagedResType>(
+                `${baseUrl}/by-group-recursively/paged/${groupId}/${resultClazz}`,
+                {
+                    page,
+                    size,
+                    sort,
+                },
+                config,
+            );
+        },
+        /**
+         * 递归获取指定用户组下所有未回收用户
+         * @param groupId 用户id
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param config 请求配置参数
+         */
+        getByGroupIncludeSub(
+            groupId: string,
+            resultClazz: TypeFromUserSelect,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.get<User[]>(
+                `${baseUrl}/by-group-recursively/${groupId}/${resultClazz}`,
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 获取多个指定用户组下的直属用户
+         * @param groupIds 用户组id集合
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param config 请求配置参数
+         */
+        getByGroups(
+            groupIds: string[],
+            resultClazz: TypeFromUserSelect,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<User[]>(
+                `${baseUrl}/by-groups/${resultClazz}`,
+                groupIds,
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 模糊查找指定名称的用户，匹配用户的用户名，全名和拼音名
+         * @param name 要匹配的名称
+         * @param recycled true表示获取已回收用户，false表示获取正常用户
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param page 页码
+         * @param size 每页数据量
+         * @param realmId 用户域名
+         * @param deptId 部门id
+         * @param sort 查询排序，单字段排序例如："name,desc"，多字段排序需要使用数组：["name,asc", "birthday,desc"]
+         * @param config 请求配置参数
+         */
+        getByName(
+            name: string,
+            recycled: boolean,
+            resultClazz: TypeFromUserSelect,
+            page: number,
+            size: number,
+            realmId: string,
+            deptId?: string,
+            sort?: string | string[],
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.get<PagedResType>(
+                `${baseUrl}/by-name/${name}/${realmId}/${recycled}/${resultClazz}`,
+                {
+                    page,
+                    size,
+                    sort,
+                    deptId,
+                },
+                config,
+            );
+        },
+        /**
+         * 获取指定id列表的用户集合
+         * @param ids 用户id集合
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param config 请求配置参数
+         */
+        getByIdList(
+            ids: string[],
+            resultClazz: TypeFromUserSelect,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<User[]>(`${baseUrl}/by-ids/${resultClazz}`, ids, undefined, config);
+        },
+        /**
+         * 获取指定用户的最终合并角色集
+         * @param userId 用户id
+         * @param resourceScope 资源域
+         * @param config 请求配置参数
+         */
+        getMergedRoles(userId: string, resourceScope?: string, config?: AceAxiosRequestConfig) {
+            return axios.get<MergedRole[]>(`${baseUrl}/merged-roles/${userId}`, {resourceScope}, config);
+        },
+        /**
+         * 切换当前会话资源域
+         * @param scope 资源域
+         * @param config
+         */
+        switchResourceScope(scope: string, config?: AceAxiosRequestConfig) {
+            return axios.put<void>(`/ace-app-service/resource-scopes/current`, scope, undefined, config);
+        },
+        /**
+         * 获取当前登录用户的最终合并角色集
+         * @param userId 用户id
+         * @param config 请求配置参数
+         */
+        getMyMergedRoles(config?: AceAxiosRequestConfig) {
+            return axios.get<MergedRole[]>(`${baseUrl}/my-merged-roles`, undefined, config);
+        },
+        /**
+         * 获取指定用户的直接授予的角色集
+         * @param userId 用户id
+         * @param appName 应用名
+         * @param roleCategory 业务类别
+         * @param config 请求配置参数
+         */
+        getRoles(userId: string, appName: string, roleCategory?: string, config?: AceAxiosRequestConfig) {
+            if (roleCategory) {
+                return axios.get<MergedRole[]>(`${baseUrl}/roles/${userId}/${appName}/${roleCategory}`,
+                    undefined, config);
+            } else {
+                return axios.get<MergedRole[]>(`${baseUrl}/roles/${userId}/${appName}`,
+                    undefined, config);
+            }
+        },
+        /**
+         * 获取拥有指定最终合并角色的用户集合
+         * @param roleId 指定的角色
+         * @param realmId 用户域ID
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param config 请求配置参数
+         */
+        getUserWhoHasMergedRole(
+            roleId: string,
+            realmId: string,
+            resultClazz: TypeFromUserSelect,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.get<User[]>(
+                `${baseUrl}/merged-role-users/${roleId}/${realmId}/${resultClazz}`,
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 获取拥有指定最终合并角色的用户集合
+         * @param appName 指定的角色所属的应用名
+         * @param roleName 指定的角色名称
+         * @param realmId 用户域Id
+         * @param resultClazz 表示返回的结果集中需要包含哪些属性，参见{@link FromUserSelect}
+         * @param config 请求配置参数
+         */
+        getUserWhoHasMergedRoleByName(
+            appName: string,
+            roleName: string,
+            realmId: string,
+            resultClazz: TypeFromUserSelect,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.get<User[]>(
+                `${baseUrl}/merged-role-users/${appName}/${roleName}/${realmId}/${resultClazz}`,
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 根据自定义查询条件和排序规则查找用户，分页返回用户所有属性
+         * @param specification 过滤条件和排序规则，参见{@link QuerySpecification}
+         * @param page 页码
+         * @param size 每页数据量
+         * @param config 请求配置参数
+         */
+        queryUsersWithAllPaged(
+            specification: QuerySpecification,
+            page: number,
+            size: number,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<Page<User>>(
+                `${baseUrl}/query-fet-all/paged`,
+                specification,
+                {
+                    page,
+                    size,
+                },
+                config,
+            );
+        },
+        /**
+         * 根据自定义查询条件和排序规则查找用户，分页返回用户基本属性和所属部门
+         * @param specification 过滤条件和排序规则，参见{@link QuerySpecification}
+         * @param page 页码
+         * @param size 每页数据量
+         * @param config 请求配置参数
+         */
+        queryUsersWithDeptPaged(
+            specification: QuerySpecification,
+            page: number,
+            size: number,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<Page<User>>(
+                `${baseUrl}/query-fet-dept/paged`,
+                specification,
+                {
+                    page,
+                    size,
+                },
+                config,
+            );
+        },
+        /**
+         * 无需管理员权限，查询用户
+         * @param specification 筛选条件
+         * @param page 页码
+         * @param size 每页数据量
+         * @param config 请求配置参数
+         */
+        queryUserRefsPaged(
+            specification: QuerySpecification,
+            page: number,
+            size: number,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<Page<UserReference>>(
+                `${baseUrl}/query-ref-all/paged`,
+                specification,
+                {
+                    page,
+                    size,
+                },
+                config,
+            );
+        },
+
+        /**
+         * 无需管理员权限，查询用户
+         * @param specification 查询条件
+         * @param config 请求配置参数
+         */
+        queryUserRefs(
+            specification: QuerySpecification,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<UserReference[]>(
+                `${baseUrl}/query-ref-all`,
+                specification,
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 根据自定义查询条件和排序规则查找用户，分页返回用户基本属性和扩展属性
+         * @param specification 过滤条件和排序规则，参见{@link QuerySpecification}
+         * @param page 页码
+         * @param size 每页数据量
+         * @param config 请求配置参数
+         */
+        queryUsersWithAttrPaged(
+            specification: QuerySpecification,
+            page: number,
+            size: number,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<Page<User>>(
+                `${baseUrl}/query-fet-attr/paged`,
+                specification,
+                {
+                    page,
+                    size,
+                },
+                config,
+            );
+        },
+        /**
+         * 根据自定义查询条件和排序规则查找用户，分页返回用户基本属性
+         * @param specification 过滤条件和排序规则，参见{@link QuerySpecification}
+         * @param page 页码
+         * @param size 每页数据量
+         * @param config 请求配置参数
+         */
+        queryUsersPaged(
+            specification: QuerySpecification,
+            page: number,
+            size: number,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<Page<User>>(
+                `${baseUrl}/query/paged`,
+                specification,
+                {
+                    page,
+                    size,
+                },
+                config,
+            );
+        },
+
+        /**
+         * 根据自定义查询条件和排序规则查找用户，返回用户所有属性
+         * @param specification 过滤条件和排序规则，参见{@link QuerySpecification}
+         * @param config 请求配置参数
+         */
+        queryUsersWithAll(
+            specification: QuerySpecification,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<User[]>(`${baseUrl}/query-fet-all`, specification, undefined, config);
+        },
+        /**
+         * 根据自定义查询条件和排序规则查找用户，返回用户基本属性和所属部门
+         * @param specification 过滤条件和排序规则，参见{@link QuerySpecification}
+         * @param config 请求配置参数
+         */
+        queryUsersWithDept(
+            specification: QuerySpecification,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<User[]>(
+                `${baseUrl}/query-fet-dept`,
+                specification,
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 根据自定义查询条件和排序规则查找用户，返回用户基本属性和扩展属性
+         * @param specification 过滤条件和排序规则，参见{@link QuerySpecification}
+         * @param config 请求配置参数
+         */
+        queryUsersWithAttr(
+            specification: QuerySpecification,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.post<User[]>(
+                `${baseUrl}/query-fet-attr`,
+                specification,
+                undefined,
+                config,
+            );
+        },
+        /**
+         * 根据自定义查询条件和排序规则查找用户，只返回用户基本属性
+         * @param specification 过滤条件和排序规则，参见{@link QuerySpecification}
+         * @param config 请求配置参数
+         */
+        queryUsers(specification: QuerySpecification, config?: AceAxiosRequestConfig) {
+            return axios.post<User[]>(`${baseUrl}/query`, specification, undefined, config);
+        },
+        /**
+         * 获取被直接授予指定角色的用户集合
+         * @param roleId 指定角色id
+         * @param realmId 用户域id
+         * @param name 按照姓名、拼音名、用户名或手机号过滤
+         * @param config 请求配置参数
+         */
+        getByRole(roleId: string, realmId: string, name?: string, config?: AceAxiosRequestConfig) {
+            if (!name) {
+                return axios.get<User[]>(`${baseUrl}/by-role/${roleId}/${realmId}`, undefined, config);
+            } else {
+                return axios.get<User[]>(`${baseUrl}/by-role/${roleId}/${realmId}/${name}`, undefined, config);
+            }
+        },
+        /**
+         * 创建用户
+         * @param command
+         * @param config 请求配置参数
+         */
+        create(command: CreateUserCommand, config?: AceAxiosRequestConfig) {
+            return axios.post<User>(`${baseUrl}`, command, undefined, {
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 更新用户
+         * @param command
+         * @param config 请求配置参数
+         */
+        update(command: UpdateUserCommand, config?: AceAxiosRequestConfig) {
+            return axios.put<User>(`${baseUrl}`, command, undefined, {
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 更新用户个人资料
+         * @param command
+         * @param config 请求配置参数
+         */
+        updateOwnProfile(command: UpdateUserProfileCommand, config?: AceAxiosRequestConfig) {
+            return axios.put<User>(`${baseUrl}/profile`, command, undefined, {
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 删除用户
+         * @param commands
+         * @param config 请求配置参数
+         */
+        delete(commands: DeleteUserCommand[], config?: AceAxiosRequestConfig) {
+            return axios.delete<void>(`${baseUrl}`, commands, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 回收用户
+         * @param ids 要回收的用户id集合
+         * @param config 请求配置参数
+         */
+        recycle(ids: string[], config?: AceAxiosRequestConfig) {
+            return axios.put<void>(`${baseUrl}/recycle`, ids, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 恢复已回收的用户为正常状态
+         * @param ids 要恢复的用户id集合
+         * @param config 请求配置参数
+         */
+        recover(ids: string[], config?: AceAxiosRequestConfig) {
+            return axios.put<void>(`${baseUrl}/recover`, ids, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 用户更新个人密码
+         * @param command
+         * @param config 请求配置参数
+         */
+        updatePassword(command: UpdatePasswordCommand, config?: AceAxiosRequestConfig) {
+            return axios.put<void>(`${baseUrl}/update-psw`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 管理员重置用户密码
+         * @param command
+         * @param config 请求配置参数
+         */
+        resetPassword(command: ResetPasswordCommand[], config?: AceAxiosRequestConfig) {
+            return axios.put<void>(`${baseUrl}/reset-psw`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 批量启用用户
+         * @param command
+         * @param config 请求配置参数
+         */
+        batchEnable(command: BatchEnableUserCommand, config?: AceAxiosRequestConfig) {
+            return axios.put<void>(`${baseUrl}/batch-enable`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 批量禁用用户
+         * @param command
+         * @param config 请求配置参数
+         */
+        batchDisable(command: BatchDisableUserCommand, config?: AceAxiosRequestConfig) {
+            return axios.put<void>(`${baseUrl}/batch-disable`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 批量启用IP绑定
+         * @param command
+         * @param config 请求配置参数
+         */
+        batchEnableIpBind(command: BatchEnableUserIpBindCommand, config?: AceAxiosRequestConfig) {
+            return axios.put<void>(`${baseUrl}/batch-enable-ip-bind`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 批量修改用户所属部门
+         * @param command
+         * @param config 请求配置参数
+         */
+        batchUpdateUserDept(
+            command: BatchUpdateUserDepartmentCommand,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.put<void>(`${baseUrl}/batch-update-dept`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 批量修改用户扩展属性
+         * @param command
+         * @param config 请求配置参数
+         */
+        batchUpdateUserAttribute(
+            command: BatchUpdateUserAttributeCommand,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.put<void>(`${baseUrl}/batch-update-attr`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 批量修改用户密级
+         * @param command
+         * @param config 请求配置参数
+         */
+        batchUpdateUserClassifiedLevel(
+            command: BatchUpdateUserClassifiedLevelCommand,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.put<void>(`${baseUrl}/batch-update-classified-level`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 批量修改用户账户过期时间
+         * @param command
+         * @param config 请求配置参数
+         */
+        batchUpdateUserExpireDate(
+            command: BatchUpdateUserExpireDateCommand,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.put<void>(`${baseUrl}/batch-update-expire-date`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 批量设置最大会话数
+         * @param command
+         * @param config 请求配置参数
+         */
+        batchSetMaxSessions(
+            command: BatchSetMaxSessionsCommand,
+            config?: AceAxiosRequestConfig,
+        ) {
+            return axios.put<void>(`${baseUrl}/batch-set-max-sessions`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 将多个角色授予单个用户
+         * @param command
+         * @param config 请求配置参数
+         */
+        grantRolesToUser(command: GrantRolesToUserCommand, config?: AceAxiosRequestConfig) {
+            return axios.post<void>(`${baseUrl}/roles`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 撤销授予指定用户的多个角色
+         * @param command
+         * @param config 请求配置参数
+         */
+        revokeRolesFromUser(command: RevokeRolesFromUserCommand, config?: AceAxiosRequestConfig) {
+            return axios.delete<void>(`${baseUrl}/roles`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+
+        /**
+         * 授予/撤销指定用户的多个角色
+         * @param command
+         * @param config 请求配置参数
+         */
+        updateUserRoles(command: UpdateUserRolesCommand, config?: AceAxiosRequestConfig) {
+            return axios.put<void>(`${baseUrl}/roles`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+
+        /**
+         * 将单个角色授予多个用户
+         * @param command
+         * @param config 请求配置参数
+         */
+        grantRoleToUsers(command: GrantRoleToUsersCommand, config?: AceAxiosRequestConfig) {
+            return axios.post<void>(`${baseUrl}/role`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 撤销授予多个用户的单个角色
+         * @param command
+         * @param config 请求配置参数
+         */
+        revokeRoleFromUsers(command: RevokeRoleFromUsersCommand, config?: AceAxiosRequestConfig) {
+            return axios.delete<void>(`${baseUrl}/role`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 将单个用户添加到指定多个组中
+         * @param command
+         * @param config 请求配置参数
+         */
+        addUserToGroups(command: AddUserToGroupsCommand, config?: AceAxiosRequestConfig) {
+            return axios.post<void>(`${baseUrl}/groups`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 将单个用户从指定的多个组中移除
+         * @param command
+         * @param config 请求配置参数
+         */
+        deleteUserFromGroups(command: DeleteUserFromGroupsCommand, config?: AceAxiosRequestConfig) {
+            return axios.delete<void>(`${baseUrl}/groups`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 修改用户所属的用户组
+         * @param command 命令
+         * @param config 请求配置参数
+         */
+        updateUserGroups(command: UpdateUserGroupsCommand, config?: AceAxiosRequestConfig) {
+            return axios.put<void>(`${baseUrl}/groups`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),})
+        },
+        /**
+         * 将多个用户添加到指定的组中
+         * @param command
+         * @param config 请求配置参数
+         */
+        addUsersToGroup(command: AddUsersToGroupCommand, config?: AceAxiosRequestConfig) {
+            return axios.post<void>(`${baseUrl}/group`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 将多个用户从指定的组中移除
+         * @param command
+         * @param config 请求配置参数
+         */
+        deleteUsersFromGroup(command: DeleteUsersFromGroupCommand, config?: AceAxiosRequestConfig) {
+            return axios.delete<void>(`${baseUrl}/group`, command, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            });
+        },
+        /**
+         * 获取指定用户最后修改密码时间
+         * @param config 请求配置参数
+         * @param uid
+         */
+        getLatestPasswordModifiedTime(uid: string, config?: AceAxiosRequestConfig) {
+            return axios.get<string>(`${baseUrl}/psw-modified-time/${uid}`, undefined, config);
+        },
+        /**
+         * 获取用户资料配置项
+         * @param config 配置项
+         */
+        getProfileSettings(config?: AceAxiosRequestConfig) {
+            return axios.get<ProfileSettings>(`${baseUrl}/profile/settings`, undefined, config)
+        },
+        /**
+         * 设置为常用用户
+         * @param userId 用户id
+         * @param config 请求配置参数
+         */
+        bookmarkUser(userId: string, config?: AceAxiosRequestConfig) {
+            return axios.post<void>(`${baseUrl}/bookmarks/${userId}`, undefined, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            })
+        },
+        /**
+         * 取消常用用户
+         * @param userId 用户id
+         * @param config 请求配置参数
+         */
+        unbookmarkUser(userId: string, config?: AceAxiosRequestConfig) {
+            return axios.delete<void>(`${baseUrl}/bookmarks/${userId}`, undefined, undefined, {
+                popValidationErrorNotification: true,
+                showSuccessMessage: true,
+                ...(
+                    config || {}
+                ),
+            })
+        },
+        /**
+         * 获取常用用户列表
+         * @param specification 自定义过滤条件
+         * @param config 请求配置参数
+         */
+        getBookmarkedUsers(specification?: QuerySpecification, config?: AceAxiosRequestConfig) {
+            return axios.post<UserReference[]>(`${baseUrl}/bookmarks`, specification, undefined, config)
+        },
+        /**
+         * 检查是否被设置为常用用户
+         * @param userId 用户id
+         * @param config 请求配置参数
+         */
+        checkBookmarked(userId: string, config?: AceAxiosRequestConfig) {
+            return axios.get<boolean>(`${baseUrl}/bookmarks/${userId}`, undefined, config)
+        }
+    };
+}
+
+/**
+ * 用户管理API
+ * @param axios axios对象
+ */
+export function useUserApi(axios?: IAceAxios) {
+    return createApiWithCache(useUserApiInternal, axios);
+}
+
+export type UserApiType = ReturnType<typeof useUserApiInternal>;