¶ 권한그룹관리 기능
권한그룹관리 기능은 시스템별 권한그룹 정보를 등록, 조회, 수정, 삭제하기 위해 사용한다. 권한그룹코드, 권한그룹명, 권한그룹유형, 정렬순서, 사용여부를 관리하며 권한설정관리와 사용자권한관리의 기준값으로 사용된다.
¶ 관련화면 및 수행메뉴얼
¶ 권한그룹 목록조회
| Action URL | Controller method | QueryID |
|---|---|---|
조회 /ias/role/roleList.do |
RolePageController.roleList |
selectRoleList, selectRoleCnt |
조회 /api/v1/role/list |
RoleApiController.getRoleList |
selectRoleList, selectRoleCnt |
등록화면 /ias/role/roleRegist.do |
RolePageController.roleRegist |
N/A |
상세이동 /ias/role/roleDetail.do?roleCd={roleCd}&sysCd={sysCd} |
RolePageController.roleDetail |
selectRoleById |
수정이동 /ias/role/roleModify.do?roleCd={roleCd}&sysCd={sysCd} |
RolePageController.roleModify |
selectRoleById |
권한그룹 목록은 시스템별 역할 트리를 재귀 조회해 표시한다. 검색조건은 시스템, 권한그룹명 또는 권한그룹코드, 권한그룹유형, 사용여부를 사용한다.
조회 : 시스템, 권한그룹명 또는 권한그룹코드, 권한그룹유형, 사용여부를 입력한 뒤 조회 버튼을 클릭한다.
초기화 : 검색조건을 초기 상태로 되돌린다.
등록 : 등록 버튼을 클릭하여 권한그룹 등록 화면으로 이동한다.
상세 : 목록의 상세 버튼을 클릭하여 권한그룹 상세조회 화면으로 이동한다.
수정 : 목록의 수정 버튼을 클릭하여 권한그룹 수정 화면으로 이동한다.
삭제 : 목록의 삭제 버튼을 클릭하여 권한그룹을 삭제한다.
¶ 권한그룹 상세조회
| Action URL | Controller method | QueryID |
|---|---|---|
상세조회 /ias/role/roleDetail.do?roleCd={roleCd}&sysCd={sysCd} |
RolePageController.roleDetail |
selectRoleById |
상세조회 /api/v1/role/{roleCd}?sysCd={sysCd} |
RoleApiController.getRole |
selectRoleById |
수정이동 /ias/role/roleModify.do?roleCd={roleCd}&sysCd={sysCd} |
RolePageController.roleModify |
selectRoleById |
권한그룹 상세조회 화면은 시스템별 권한그룹 단건 정보를 보여준다. 권한그룹유형, 정렬순서, 사용여부와 등록·수정 정보를 함께 확인할 수 있다.
목록 : 권한그룹 목록조회 화면으로 이동한다.
수정 : 권한그룹 수정 화면으로 이동한다.
¶ 권한그룹 등록
| Action URL | Controller method | QueryID |
|---|---|---|
등록화면 /ias/role/roleRegist.do |
RolePageController.roleRegist |
N/A |
저장 /api/v1/role |
RoleApiController.createRole |
insertRole |
권한그룹 등록 화면에서는 시스템, 권한그룹유형, 권한그룹코드, 권한그룹명, 순서, 사용여부, 설명을 입력해 저장한다.
- 시스템코드는 필수다.
- 권한그룹유형은 필수다.
- 권한그룹코드는 필수이며 최대 100자다.
- 권한그룹명은 필수이며 최대 100자다.
- 순서는 필수이며 숫자만 입력한다.
- 사용여부는
Y,N만 허용한다. - 같은 시스템에 동일한 권한그룹코드가 이미 존재하면 등록할 수 없다.
목록 : 권한그룹 목록조회 화면으로 이동한다.
저장 : 입력한 권한그룹 정보를 저장한다.
¶ 권한그룹 수정
| Action URL | Controller method | QueryID |
|---|---|---|
수정화면 /ias/role/roleModify.do?roleCd={roleCd}&sysCd={sysCd} |
RolePageController.roleModify |
selectRoleById |
수정 /api/v1/role/{roleCd}?sysCd={sysCd} |
RoleApiController.updateRole |
updateRole |
권한그룹 수정 화면에서는 기존 권한그룹 정보를 조회한 뒤 수정 저장한다. 시스템과 권한그룹유형은 수정 화면에서 변경하지 않는다.
- 존재하지 않는 권한그룹은 수정할 수 없다.
- 권한그룹명은 필수다.
- 순서는 숫자만 입력한다.
- 사용여부는
Y,N만 허용한다.
목록 : 권한그룹 목록조회 화면으로 이동한다.
저장 : 수정한 권한그룹 정보를 저장한다.
¶ 권한그룹 삭제
| Action URL | Controller method | QueryID |
|---|---|---|
삭제 /api/v1/role/{roleCd}?sysCd={sysCd} |
RoleApiController.deleteRole |
deleteUserRoleMappings, deleteSysRoleAuthrtMappings, deleteMenuRoleAuthrtMappings, deleteRole |
권한그룹 삭제는 목록조회 화면에서 수행한다. 삭제 시 사용자권한 매핑, 시스템 권한 매핑, 메뉴 권한 매핑을 먼저 정리한 뒤 권한그룹을 삭제한다.
- 존재하지 않는 권한그룹은 삭제할 수 없다.
선택 : 목록 화면의 삭제 버튼을 클릭한다.
삭제 : 삭제 확인 후 관련 매핑과 권한그룹 정보를 삭제한다.
¶ 관련 리소스
¶ 클래스
| 유형 | 대상소스명 | 비고 |
|---|---|---|
| Controller | src/main/java/allforland/ias/role/web/RolePageController.java |
권한그룹관리 화면 요청을 처리하는 컨트롤러 클래스 |
| API Controller | src/main/java/allforland/ias/role/web/RoleApiController.java |
권한그룹관리 API 요청을 처리하는 컨트롤러 클래스 |
| Service | src/main/java/allforland/ias/role/service/RoleService.java |
권한그룹관리 서비스 인터페이스 |
| ServiceImpl | src/main/java/allforland/ias/role/service/impl/RoleServiceImpl.java |
권한그룹관리 서비스 구현 클래스 |
| Mapper | src/main/java/allforland/ias/role/mapper/RoleMapper.java |
권한그룹관리 데이터 처리 Mapper 인터페이스 |
| VO | src/main/java/allforland/ias/role/vo/RoleVO.java |
권한그룹관리 VO 클래스 |
| DTO | src/main/java/allforland/ias/role/web/dto/RoleRequestDTO.java |
권한그룹 등록/수정 요청 DTO 클래스 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/role/roleList.jsp |
권한그룹 목록조회 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/role/roleDetail.jsp |
권한그룹 상세조회 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/role/roleRegist.jsp |
권한그룹 등록 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/role/roleModify.jsp |
권한그룹 수정 페이지 |
| Query XML | src/main/resources/mapper/role/RoleMapper.xml |
권한그룹 조회 및 저장 Query XML |
| SQL | docker/postgres/init/01-schema.sql |
권한그룹 관련 테이블 생성을 위한 스키마 SQL |
| SQL | docker/postgres/init/02-data.sql |
권한그룹 기본데이터 적재 SQL |
¶ 클래스 다이어그램
¶ 테이블
| 테이블명 | 테이블명(영문) | 비고 |
|---|---|---|
| 권한 그룹 | afias.role |
시스템별 권한그룹 기준정보를 관리하는 테이블 |