From 09785d5e6c8ae5cb202448e16bde46a487595bcf Mon Sep 17 00:00:00 2001
From: mjkhan21 <mjkhan21@xit.co.kr>
Date: Mon, 15 May 2023 13:16:53 +0900
Subject: [PATCH] =?UTF-8?q?javadoc=20=EB=B3=B4=EC=99=84=20=EC=88=98?=
 =?UTF-8?q?=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../cokr/xit/base/code/dao/CodeMapper.java    | 105 ++++++++---
 .../xit/base/code/service/CodeService.java    |  47 +++--
 .../xit/base/code/service/bean/CodeBean.java  |  47 +++--
 .../code/service/bean/CodeServiceBean.java    |  15 ++
 .../xit/base/code/web/CodeController.java     | 165 ++++++++----------
 5 files changed, 248 insertions(+), 131 deletions(-)

diff --git a/src/main/java/cokr/xit/base/code/dao/CodeMapper.java b/src/main/java/cokr/xit/base/code/dao/CodeMapper.java
index 94c89b9..1009746 100644
--- a/src/main/java/cokr/xit/base/code/dao/CodeMapper.java
+++ b/src/main/java/cokr/xit/base/code/dao/CodeMapper.java
@@ -18,15 +18,24 @@ import cokr.xit.foundation.data.DataObject;
  */
 @Mapper("codeMapper")
 public interface CodeMapper extends AbstractMapper {
-	/**코드 분류 목록을 조회한다.
-	 * @param pageNum 반환할 코드 분류 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 코드 분류의 갯수
+	/**코드 분류 목록을 조회한다.<br />
+	 * {@link cokr.xit.base.code.service.CodeService#getCategoryList(CodeQuery)} 참고
+	 * @param req 코드 분류 목록 조회 조건
 	 * @return 코드 분류 목록
 	 */
 	List<DataObject> getCategoryList(CodeQuery req);
 
+	/**지정하는 아이디의 코드 분류 정보를 반환한다.
+	 * @param categoryID 코드 분류 아이디
+	 * @return 코드 분류 정보
+	 */
+	default DataObject getCategoryInfo(String categoryID) {
+		List<DataObject> list = getCategoryList(new CodeQuery().setCategoryIDs(categoryID));
+		return !list.isEmpty() ? list.get(0) : null;
+	}
+
 	/**지정하는 아이디의 코드 분류들을 가져온다.
-	 * @param categoryIDs 코드 분류 아이디
+	 * @param req 조회 조건
 	 * @return 코드 분류
 	 */
 	List<CodeCategory> getCategories(CodeQuery req);
@@ -44,7 +53,7 @@ public interface CodeMapper extends AbstractMapper {
 		return !categories.isEmpty() ? categories.get(0) : null;
 	}
 	/**코드 분류를 등록한다.
-	 * @param category 코드 분류
+	 * @param params 파라미터
 	 * @return 등록 여부
 	 * <ul><li>등록이 됐으면 true</li>
 	 *     <li>그렇지 않으면 false</li>
@@ -67,14 +76,15 @@ public interface CodeMapper extends AbstractMapper {
 		return insertCategory(params);
 	}
 
+	/**코드 분류를 수정한다.
+	 * @param params 파라미터
+	 * @return 저장된 정보수
+	 */
 	int updateCategory(Map<String, ?> params);
 
 	/**코드 분류를 수정한다.
 	 * @param category 코드 분류
-	 * @return 수정 여부
-	 * <ul><li>수정이 됐으면 true</li>
-	 *     <li>그렇지 않으면 false</li>
-	 * </ul>
+	 * @return 저장된 정보수
 	 */
 	default int update(CodeCategory category) {
 		DataObject params = params()
@@ -84,6 +94,11 @@ public interface CodeMapper extends AbstractMapper {
 		return updateCategory(params);
 	}
 
+	/**지정하는 아이디의 코드 분류들을 제거한다.<br />
+	 * 제거되는 코드 분류에 속하는 코드 그룹, 공통코드도 같이 제거한다.
+	 * @param params 파라미터
+	 * @return 저장된 정보수
+	 */
 	int removeCategories(Map<String, ?> params);
 
 	/**지정하는 아이디의 코드 분류들을 제거한다.<br />
@@ -98,16 +113,30 @@ public interface CodeMapper extends AbstractMapper {
 		return removeCategories(params().set("categoryIDs", categoryIDs));
 	}
 
-	/**코드 그룹 목록을 조회한다.
-	 * @param pageNum 반환할 코드 그룹 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 코드 그룹의 갯수
-	 * @return
+	/**코드 그룹 목록을 조회한다.<br />
+	 * {@link cokr.xit.base.code.service.CodeService#getGroupList(CodeQuery)} 참고
+	 * @param req 코드 그룹 조회 조건
+	 * @return 코드 그룹 목록
 	 */
 	List<DataObject> getGroupList(CodeQuery req);
 
-	/**지정하는 아이디의 코드 그룹들을 가져온다.
-	 * @param groupIDs 코드 그룹 아이디
-	 * @return 코드 그룹
+	/**지정하는 코드 분류의 코드 그룹 정보를 반환한다.
+	 * @param categoryID 코드 분류 아이디
+	 * @param groupID 코드 그룹 아이디
+	 * @return 코드 그룹 정보
+	 */
+	default DataObject getGroupInfo(String categoryID, String groupID) {
+		CodeQuery req = new CodeQuery();
+		if (!isEmpty(categoryID))
+			req.setCategoryIDs(categoryID);
+
+		List<DataObject> list = getGroupList(req.setGroupIDs(groupID));
+		return !list.isEmpty() ? list.get(0) : null;
+	}
+
+	/**코드 그룹 목록을 조회한다.
+	 * @param req 코드 그룹 목록 조회 조건
+	 * @return 코드 그룹 목록
 	 */
 	List<CodeGroup> getGroups(CodeQuery req);
 
@@ -179,18 +208,27 @@ public interface CodeMapper extends AbstractMapper {
 		return removeGroups(null, groupIDs);
 	}
 
-	/**지정하는 그룹의 공통코드 목록을 반환한다.
-	 * @param groupID 코드 그룹 아이디
-	 * @param pageNum 반환할 공통코드 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 공통코드의 갯수
+	/**지정하는 그룹의 공통코드 목록을 반환한다.<br />
+	 * {@link cokr.xit.base.code.service.CodeService#getCodeList(CodeQuery)} 참고
+	 * @param req 공통코드 조회 조건
 	 * @return 공통코드 목록
 	 */
 	List<DataObject> getCodeList(CodeQuery req);
 
+	/**지정하는 코드 그룹의 코드 정보를 반환한다.
+	 * @param groupID 코드 그룹 아이디
+	 * @param code 코드
+	 * @return 코드 정보
+	 */
+	default DataObject getCodeInfo(String groupID, String code) {
+		CodeQuery req = new CodeQuery().setGroupIDs(groupID).setCodes(code);
+		List<DataObject> list = getCodeList(req);
+		return !list.isEmpty() ? list.get(0) : null;
+	}
+
 	/**지정하는 그룹, 코드의 공통코드들을 반환한다.<br />
 	 * 공통코드를 지정하지 않으면 코드 그룹의 모든 공통코드를 반환한다.
-	 * @param groupID 코드 그룹 아이디
-	 * @param codes 공통코드
+	 * @param req 조회 조건
 	 * @return 공통코드
 	 */
 	List<CommonCode> getCodes(CodeQuery req);
@@ -215,6 +253,10 @@ public interface CodeMapper extends AbstractMapper {
 		return !codes.isEmpty() ? codes.get(0) : null;
 	}
 
+	/**공통코드를 등록한다.
+	 * @param params 파라미터
+	 * @return 저장된 정보수
+	 */
 	int insertCode(Map<String, ?> params);
 
 	/**공통코드를 등록한다.
@@ -231,6 +273,10 @@ public interface CodeMapper extends AbstractMapper {
 		return insertCode(params);
 	}
 
+	/**공통코드를 수정한다.
+	 * @param params 파라미터
+	 * @return 저장된 정보수
+	 */
 	int updateCode(Map<String, ?> params);
 
 	/**공통코드를 수정한다.
@@ -248,6 +294,10 @@ public interface CodeMapper extends AbstractMapper {
 		return updateCode(params);
 	}
 
+	/**지정하는 코드 그룹의 공통코드들의 정렬 순서를 전달받은 순서대로 저장한다.
+	 * @param params 파라미터
+	 * @return 저장된 정보수
+	 */
 	int reorderCodes(Map<String, ?> params);
 
 	/**지정하는 코드 그룹의 공통코드들의 정렬 순서를 전달받은 순서대로 저장한다.
@@ -260,8 +310,19 @@ public interface CodeMapper extends AbstractMapper {
 		return reorderCodes(params().set("groupID", groupID).set("codes", codes));
 	}
 
+	/**지정하는 코드 그룹의 코드들을 제거한다.<br />
+	 * 코드를 지정하지 않으면 해당 그룹의 모든 공통코드들을 제거한다.
+	 * @param params 파라미터
+	 * @return 저장된 정보수
+	 */
 	int removeCodes(Map<String, ?> params);
 
+	/**지정하는 코드 그룹의 코드들을 제거한다.<br />
+	 * 코드를 지정하지 않으면 해당 그룹의 모든 공통코드들을 제거한다.
+	 * @param groupIDs 코드 그룹 아이디
+	 * @param codes 코드
+	 * @return 저장된 정보수
+	 */
 	default int removeCodes(String[] groupIDs, String[] codes) {
 		DataObject params = params()
 			.set("groupIDs", ifEmpty(groupIDs, () -> null))
diff --git a/src/main/java/cokr/xit/base/code/service/CodeService.java b/src/main/java/cokr/xit/base/code/service/CodeService.java
index e45c953..4bb5a83 100644
--- a/src/main/java/cokr/xit/base/code/service/CodeService.java
+++ b/src/main/java/cokr/xit/base/code/service/CodeService.java
@@ -9,15 +9,15 @@ import cokr.xit.base.code.CommonCode;
 import cokr.xit.foundation.data.DataObject;
 
 /**공통코드 서비스를 제공한다.
- * <ul><li>{@link #getCategoryList(int, int) 코드 분류 목록 조회}</li>
+ * <ul><li>{@link #getCategoryList(CodeQuery) 코드 분류 목록 조회}</li>
  *     <li>{@link #create(CodeCategory) 코드 분류 등록}</li>
  *     <li>{@link #update(CodeCategory) 코드 분류 수정}</li>
  *     <li>{@link #removeCategories(String...) 코드 분류 제거}</li>
- *     <li>{@link #getGroupList(int, int) 코드 그룹 목록 조회}</li>
+ *     <li>{@link #getGroupList(CodeQuery) 코드 그룹 목록 조회}</li>
  *     <li>{@link #create(CodeGroup) 코드 그룹 등록}</li>
  *     <li>{@link #update(CodeGroup) 코드 그룹 수정}</li>
  *     <li>{@link #removeGroups(String...) 코드 그룹 제거}</li>
- *     <li>{@link #getCodeList(String, int, int) 공통코드 목록 조회}</li>
+ *     <li>{@link #getCodeList(CodeQuery) 공통코드 목록 조회}</li>
  *     <li>{@link #getCodesOf(String...) 그룹별 공통코드 가져오기}</li>
  *     <li>{@link #create(CommonCode) 공통코드 등록}</li>
  *     <li>{@link #update(CommonCode) 공통코드 수정}</li>
@@ -27,12 +27,20 @@ import cokr.xit.foundation.data.DataObject;
  */
 public interface CodeService {
 	/**코드 분류 목록을 조회한다.
-	 * @param pageNum 반환할 코드 분류 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 코드 분류의 갯수
+	 * @param req 코드 분류 목록 조회 조건
+	 * <ul><li>pageNum: 페이지 번호</li>
+	 *     <li>fetchSize: 페이지 목록 건수</li>
+	 * </ul>
 	 * @return 코드 분류 목록
 	 */
 	List<DataObject> getCategoryList(CodeQuery req);
 
+	/**지정하는 아이디의 코드 분류 정보를 반환한다.
+	 * @param categoryID 코드 분류 아이디
+	 * @return 코드 분류 정보
+	 */
+	DataObject getCategoryInfo(String categoryID);
+
 	/**지정하는 아이디의 코드 분류들을 가져온다.
 	 * @param categoryIDs 코드 분류 아이디
 	 * @return 코드 분류
@@ -71,12 +79,22 @@ public interface CodeService {
 	int removeCategories(String... categoryIDs);
 
 	/**코드 그룹 목록을 조회한다.
-	 * @param pageNum 반환할 코드 그룹 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 코드 그룹의 갯수
+	 * @param req 코드 그룹 목록 조회 조건
+	 * <ul><li>categoryIDs: 코드 분류 목록</li>
+	 *     <li>pageNum: 페이지 번호</li>
+	 *     <li>fetchSize: 페이지 목록 건수</li>
+	 * </ul>
 	 * @return 코드 그룹 목록
 	 */
 	List<DataObject> getGroupList(CodeQuery req);
 
+	/**지정하는 코드 분류의 코드 그룹 정보를 반환한다.
+	 * @param categoryID 코드 분류 아이디
+	 * @param groupID 코드 그룹 아이디
+	 * @return 코드 그룹 정보
+	 */
+	DataObject getGroupInfo(String categoryID, String groupID);
+
 	/**지정하는 아이디의 코드 그룹들을 가져온다.
 	 * @param groupIDs 코드 그룹 아이디
 	 * @return 코드 그룹
@@ -115,13 +133,22 @@ public interface CodeService {
 	int removeGroups(String... groupIDs);
 
 	/**지정하는 그룹의 공통코드 목록을 반환한다.
-	 * @param groupID 코드 그룹 아이디
-	 * @param pageNum 반환할 공통코드 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 공통코드의 갯수
+	 * @param req 공통코드 조회 조건
+	 * <ul><li>groupIDs: 코드 그룹 아이디</li>
+	 *     <li>pageNum: 페이지 번호</li>
+	 *     <li>fetchSize: 페이지 목록 건수</li>
+	 * </ul>
 	 * @return 공통코드 목록
 	 */
 	List<DataObject> getCodeList(CodeQuery req);
 
+	/**지정하는 코드 그룹의 코드 정보를 반환한다.
+	 * @param groupID 코드 그룹 아이디
+	 * @param code 코드
+	 * @return 코드 정보
+	 */
+	DataObject getCodeInfo(String groupID, String code);
+
 	/**지정하는 그룹, 코드의 공통코드들을 반환한다.<br />
 	 * 공통코드를 지정하지 않으면 코드 그룹의 모든 공통코드를 반환한다.
 	 * @param groupID 코드 그룹 아이디
diff --git a/src/main/java/cokr/xit/base/code/service/bean/CodeBean.java b/src/main/java/cokr/xit/base/code/service/bean/CodeBean.java
index a630380..52f89bb 100644
--- a/src/main/java/cokr/xit/base/code/service/bean/CodeBean.java
+++ b/src/main/java/cokr/xit/base/code/service/bean/CodeBean.java
@@ -23,15 +23,23 @@ public class CodeBean extends AbstractComponent {
 	@Resource(name = "codeMapper")
 	private CodeMapper codeMapper;
 
-	/**코드 분류 목록을 조회한다.
-	 * @param pageNum 반환할 코드 분류 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 코드 분류의 갯수
+	/**코드 분류 목록을 조회한다.<br />
+	 * {@link cokr.xit.base.code.service.CodeService#getCategoryList(CodeQuery)} 참고
+	 * @param req 코드 분류 목록 조회 조건
 	 * @return 코드 분류 목록
 	 */
 	public List<DataObject> getCategoryList(CodeQuery req) {
 		return codeMapper.getCategoryList(req.setOrderBy("CTGR_ID"));
 	}
 
+	/**지정하는 아이디의 코드 분류 정보를 반환한다.
+	 * @param categoryID 코드 분류 아이디
+	 * @return 코드 분류 정보
+	 */
+	public DataObject getCategoryInfo(String categoryID) {
+		return codeMapper.getCategoryInfo(categoryID);
+	}
+
 	/**지정하는 아이디의 코드 분류들을 가져온다.
 	 * @param categoryIDs 코드 분류 아이디
 	 * @return 코드 분류
@@ -84,15 +92,24 @@ public class CodeBean extends AbstractComponent {
 		return codeMapper.removeCategories(categoryIDs);
 	}
 
-	/**코드 그룹 목록을 조회한다.
-	 * @param pageNum 반환할 코드 그룹 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 코드 그룹의 갯수
-	 * @return
+	/**코드 그룹 목록을 조회한다.<br />
+	 * {@link cokr.xit.base.code.service.CodeService#getGroupList(CodeQuery)} 참고
+	 * @param req 코드 그룹 목록 조회 조건
+	 * @return 코드 그룹 목록
 	 */
 	public List<DataObject> getGroupList(CodeQuery req) {
 		return codeMapper.getGroupList(req.setOrderBy("GRP_ID"));
 	}
 
+	/**지정하는 코드 분류의 코드 그룹 정보를 반환한다.
+	 * @param categoryID 코드 분류 아이디
+	 * @param groupID 코드 그룹 아이디
+	 * @return 코드 그룹 정보
+	 */
+	public DataObject getGroupInfo(String categoryID, String groupID) {
+		return codeMapper.getGroupInfo(categoryID, groupID);
+	}
+
 	/**지정하는 아이디의 코드 그룹들을 가져온다.
 	 * @param groupIDs 코드 그룹 아이디
 	 * @return 코드 그룹
@@ -145,16 +162,24 @@ public class CodeBean extends AbstractComponent {
 		return codeMapper.removeGroups(groupIDs);
 	}
 
-	/**지정하는 그룹의 공통코드 목록을 반환한다.
-	 * @param groupID 코드 그룹 아이디
-	 * @param pageNum 반환할 공통코드 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 공통코드의 갯수
+	/**지정하는 그룹의 공통코드 목록을 반환한다.<br />
+	 * {@link cokr.xit.base.code.service.CodeService#getCodeList(CodeQuery)}
+	 * @param req 공통코드 조회 조건
 	 * @return 공통코드 목록
 	 */
 	public List<DataObject> getCodeList(CodeQuery req) {
 		return codeMapper.getCodeList(req.setOrderBy("GRP_ID, SRT_ORD, CODE"));
 	}
 
+	/**지정하는 코드 그룹의 코드 정보를 반환한다.
+	 * @param groupID 코드 그룹 아이디
+	 * @param code 코드
+	 * @return 코드 정보
+	 */
+	public DataObject getCodeInfo(String groupID, String code) {
+		return codeMapper.getCodeInfo(groupID, code);
+	}
+
 	/**지정하는 그룹, 코드의 공통코드들을 반환한다.<br />
 	 * 공통코드를 지정하지 않으면 코드 그룹의 모든 공통코드를 반환한다.
 	 * @param groupID 코드 그룹 아이디
diff --git a/src/main/java/cokr/xit/base/code/service/bean/CodeServiceBean.java b/src/main/java/cokr/xit/base/code/service/bean/CodeServiceBean.java
index fc66142..4874b27 100644
--- a/src/main/java/cokr/xit/base/code/service/bean/CodeServiceBean.java
+++ b/src/main/java/cokr/xit/base/code/service/bean/CodeServiceBean.java
@@ -29,6 +29,11 @@ public class CodeServiceBean extends AbstractServiceBean implements CodeService
 		return codeBean.getCategoryList(req);
 	}
 
+	@Override
+	public DataObject getCategoryInfo(String categoryID) {
+		return codeBean.getCategoryInfo(categoryID);
+	}
+
 	@Override
 	public List<CodeCategory> getCategories(String... categoryIDs) {
 		return codeBean.getCategories(categoryIDs);
@@ -59,6 +64,11 @@ public class CodeServiceBean extends AbstractServiceBean implements CodeService
 		return codeBean.getGroupList(req);
 	}
 
+	@Override
+	public DataObject getGroupInfo(String categoryID, String groupID) {
+		return codeBean.getGroupInfo(categoryID, groupID);
+	}
+
 	@Override
 	public List<CodeGroup> getGroups(String... groupIDs) {
 		return codeBean.getGroups(groupIDs);
@@ -89,6 +99,11 @@ public class CodeServiceBean extends AbstractServiceBean implements CodeService
 		return codeBean.getCodeList(req);
 	}
 
+	@Override
+	public DataObject getCodeInfo(String groupID, String code) {
+		return codeBean.getCodeInfo(groupID, code);
+	}
+
 	@Override
 	public List<CommonCode> getCodes(String groupID, String... codes) {
 		return codeBean.getCodes(groupID, codes);
diff --git a/src/main/java/cokr/xit/base/code/web/CodeController.java b/src/main/java/cokr/xit/base/code/web/CodeController.java
index 65af05f..2cc5195 100644
--- a/src/main/java/cokr/xit/base/code/web/CodeController.java
+++ b/src/main/java/cokr/xit/base/code/web/CodeController.java
@@ -1,7 +1,5 @@
 package cokr.xit.base.code.web;
 
-import java.util.List;
-
 import javax.annotation.Resource;
 
 import org.springframework.web.bind.annotation.PostMapping;
@@ -13,7 +11,6 @@ import cokr.xit.base.code.CodeGroup;
 import cokr.xit.base.code.CommonCode;
 import cokr.xit.base.code.service.CodeQuery;
 import cokr.xit.base.code.service.CodeService;
-import cokr.xit.foundation.data.DataObject;
 import cokr.xit.foundation.web.AbstractController;
 
 /**공통코드 서비스 웹 컨트롤러.<br />
@@ -25,15 +22,8 @@ public class CodeController extends AbstractController {
 	@Resource(name="codeService")
 	private CodeService codeService;
 
-	/**공통코드 서비스를 반환한다.
-	 * @return 공통코드 서비스
-	 */
-	protected CodeService codeService() {
-		return codeService;
-	}
-
-	/**공통코드 관리 메인화면(code/code-main)을 연다.
-	 * @return ModelAndView
+	/**공통코드 관리 메인화면을 연다.
+	 * @return base/code/code-main
 	 */
 	@RequestMapping(name="공통코드 메인", value="/main.do")
 	public ModelAndView main() {
@@ -42,12 +32,15 @@ public class CodeController extends AbstractController {
 		return mav.addObject("groupList", toJson(mav.getModel().remove("groupList")));
 	}
 
-	/**코드 분류 목록을 조회한다.
-	 * @param pageNum 페이지 번호
-	 * @param fetchSize 한 번에 가져올 코드 분류의 갯수
-	 * @return 코드 분류 목록
-	 * <pre><code>{
-	 *     "categoryList": [...]
+	/**코드 분류 목록을 조회한다.<br />
+	 * {@link CodeService#getCategoryList(CodeQuery)} 참고
+	 * @param req 코드 분류 목록 조회 조건
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "categoryList": [코드 분류 목록]
+	 *     "categoryStart": 코드 분류 목록 시작 인덱스
+	 *     "categoryFetch": 한 번에 가져오는 코드 분류 목록 수
+	 *     "categoryTotal": 조회 결과 찾은 전체 코드 분류 수
 	 * }</code></pre>
 	 */
 	@RequestMapping(name="코드 분류 목록", value="/category/list.do")
@@ -62,8 +55,8 @@ public class CodeController extends AbstractController {
 
 	/**코드 분류 정보를 조회한다.
 	 * @param categoryID 카테고리 아이디
-	 * @return 코드 분류 정보
-	 * <pre><code>{
+	 * @return base/code/category-info
+	 * <pre><code> {
 	 *     "categoryInfo": [...]
 	 * }</code></pre>
 	 */
@@ -71,18 +64,16 @@ public class CodeController extends AbstractController {
 	public ModelAndView getCategoryInfo(String categoryID) {
 		ModelAndView mav = new ModelAndView("base/code/category-info");
 		if (!isEmpty(categoryID)) {
-			List<DataObject> list = codeService.getCategoryList(new CodeQuery().setCategoryIDs(categoryID));
-			if (!list.isEmpty())
-				mav.addObject("categoryInfo", list.get(0));
+			mav.addObject("categoryInfo", codeService.getCategoryInfo(categoryID));
 		}
 		return mav;
 	}
 
 	/**코드 분류를 등록한다.
 	 * @param category 코드 분류
-	 * @return 등록 여부
-	 * <pre><code>{
-	 *     "saved": true || false
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="코드 분류 등록", value="/category/create.do")
@@ -93,9 +84,9 @@ public class CodeController extends AbstractController {
 
 	/**코드 분류를 수정한다.
 	 * @param category 코드 분류
-	 * @return 수정 여부
-	 * <pre><code>{
-	 *     "saved": true || false
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="코드 분류 수정", value="/category/update.do")
@@ -107,10 +98,10 @@ public class CodeController extends AbstractController {
 	/**지정하는 아이디의 코드 분류들을 제거한다.<br />
 	 * 제거되는 코드 분류에 속하는 코드 그룹, 공통코드도 같이 제거한다.
 	 * @param categoryIDs 코드 분류 아이디
-	 * @return 저장된 정보수
-	 * <pre><code>{
-	 *     "affected": 1,
-	 *     "saved": true || false
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "affected": 저장된 정보수,
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="코드 분류 삭제", value="/category/remove.do")
@@ -121,12 +112,15 @@ public class CodeController extends AbstractController {
 			.addObject("saved", affected > 0);
 	}
 
-	/**코드 그룹 목록을 조회한다.
-	 * @param pageNum 반환할 코드 그룹 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 코드 그룹의 갯수
-	 * @return 코드 그룹 목록
-	 * <pre><code>{
-	 *     "groupList": [...]
+	/**코드 그룹 목록을 조회한다.<br />
+	 * {@link CodeService#getGroupList(CodeQuery)} 참고
+	 * @param req 코드 그룹 목록 조회 조건
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "groupList": [코드 그룹 목록],
+	 *     "groupStart": 코드 그룹 시작 인덱스,
+	 *     "groupFetchTotal": 한 번에 가져오는 코드 그룹 목록 수,
+	 *     "groupTotal": 조회 결과 찾은 전체 코드 그룹 수
 	 * }</code></pre>
 	 */
 	@RequestMapping(name="코드 그룹 목록", value="/group/list.do")
@@ -141,27 +135,25 @@ public class CodeController extends AbstractController {
 
 	/**코드 그룹 정보를 조회한다.
 	 * @param groupID 그룹 아이디
-	 * @return 코드 그룹 정보
-	 * <pre><code>{
+	 * @return base/code/group-info
+	 * <pre><code> {
 	 *     "groupInfo": {...}
 	 * }</code></pre>
 	 */
-	@RequestMapping(name="코드 그룹 목록", value="/group/info.do")
+	@RequestMapping(name="코드 그룹 정보", value="/group/info.do")
 	public ModelAndView getGroupInfo(String groupID) {
 		ModelAndView mav = new ModelAndView("base/code/group-info");
 		if (!isEmpty(groupID)) {
-			List<DataObject> list = codeService.getCodeList(new CodeQuery().setGroupIDs(groupID));
-			if (!list.isEmpty())
-				mav.addObject("groupInfo", list.get(0));
+			mav.addObject("groupInfo", codeService.getGroupInfo(null, groupID));
 		}
 		return mav;
 	}
 
 	/**코드 그룹을 등록한다.
 	 * @param group 코드 그룹
-	 * @return 등록 여부
-	 * <pre><code>{
-	 *     "saved": true || false
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="코드 그룹 등록", value="/group/create.do")
@@ -172,9 +164,9 @@ public class CodeController extends AbstractController {
 
 	/**코드 그룹을 수정한다.
 	 * @param group 코드 그룹
-	 * @return 수정 여부
-	 * <pre><code>{
-	 *     "saved": true || false
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="코드 그룹 수정", value="/group/update.do")
@@ -186,10 +178,10 @@ public class CodeController extends AbstractController {
 	/**지정하는 아이디의 코드 그룹들을 제거한다.<br />
 	 * 제거되는 코드 그룹에 속하는 공통코드도 같이 제거한다.
 	 * @param groupIDs 코드 그룹 아이디
-	 * @return 저장된 정보수
-	 * <pre><code>{
-	 *     "affected": 1,
-	 *     "saved": true || false
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "affected": 저장된 정보수,
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="코드 그룹 제거", value="/group/remove.do")
@@ -203,10 +195,10 @@ public class CodeController extends AbstractController {
 	/**지정하는 코드 그룹 아이디의 공통코드들을 가져와 그룹 아이디별로 분류하여 반환한다.<br />
 	 * 코드 그룹 아이디를 지정하지 않으면 모든 공통코드를 반환한다.
 	 * @param groupIDs 코드 그룹 아이디
-	 * @return 그룹별 공통코드
-	 * <pre><code>{
-	 *     "코드그룹0": [...], // 그룹0의 공통코드 목록
-	 *     "코드그룹1": [...], // 그룹1의 공통코드 목록
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "코드그룹0": [그룹0의 공통코드 목록],
+	 *     "코드그룹1": [그룹1의 공통코드 목록],
 	 *     ...
 	 * }</code></pre>
 	 */
@@ -216,17 +208,16 @@ public class CodeController extends AbstractController {
 			.addAllObjects(codeService.getCodesOf(groupIDs));
 	}
 
-	/**지정하는 그룹의 공통코드 목록을 반환한다.
-	 * @param groupID 코드 그룹 아이디
-	 * @param pageNum 반환할 공통코드 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 공통코드의 갯수
-	 * @return 공통코드 목록
-	 * <pre><code>{
+	/**지정하는 그룹의 공통코드 목록을 반환한다.<br />
+	 * {@link CodeService#getCodeList(CodeQuery)} 참고
+	 * @param req 공통코드 조회 조건
+	 * @return jsonView
+	 * <pre><code> {
 	 *     "groupID": "코드그룹0",
-	 *     "codeList": [...], // 그룹0의 공통코드 목록
-	 *     "codeStart": 0, // 공통코드 시작 위치
-	 *     "codeFetch": 10, // 한 번에 반환하는 공통코드 갯수
-	 *     "codeTotal": 50, // 조회 결과 공통코드 전체 갯수
+	 *     "codeList": [그룹0의 공통코드 목록],
+	 *     "codeStart": 공통코드 시작 인덱스,
+	 *     "codeFetch": 한 번에 반환하는 공통코드 갯수,
+	 *     "codeTotal": 조회 결과 공통코드 전체 갯수
 	 * }</code></pre>
 	 */
 	@RequestMapping(name="그룹별 코드 목록", value="/list.do")
@@ -242,8 +233,8 @@ public class CodeController extends AbstractController {
 	/**지정하는 그룹의 공통코드 정보를 반환한다.
 	 * @param groupID 코드 그룹 아이디
 	 * @param code 코드
-	 * @return 공통코드 정보
-	 * <pre><code>{
+	 * @return base/code/code-info
+	 * <pre><code> {
 	 *     "codeInfo": {...}
 	 * }</code></pre>
 	 */
@@ -251,18 +242,16 @@ public class CodeController extends AbstractController {
 	public ModelAndView getCodeInfo(String groupID, String code) {
 		ModelAndView mav = new ModelAndView("base/code/code-info");
 		if (!isEmpty(groupID) && !isEmpty(code)) {
-			List<DataObject> list = codeService.getCodeList(new CodeQuery().setGroupIDs(groupID).setCodes(code));
-			if (!list.isEmpty())
-				mav.addObject("codeInfo", list.get(0));
+			mav.addObject("codeInfo", codeService.getCodeInfo(groupID, code));
 		}
 		return mav;
 	}
 
 	/**공통코드를 등록한다.
 	 * @param commonCode 공통코드
-	 * @return 등록 여부
-	 * <pre><code>{
-	 *     "saved": true || false
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="코드 등록", value="/create.do")
@@ -273,9 +262,9 @@ public class CodeController extends AbstractController {
 
 	/**공통코드를 수정한다.
 	 * @param commonCode 공통코드
-	 * @return 수정 여부
-	 * <pre><code>{
-	 *     "saved": true || false
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="코드 수정", value="/update.do")
@@ -287,10 +276,10 @@ public class CodeController extends AbstractController {
 	/**지정하는 코드 그룹의 공통코드들의 정렬 순서를 전달받은 순서대로 저장한다.
 	 * @param groupID 코드 그룹 아이디
 	 * @param codes 공통코드
-	 * @return 저장된 정보수
-	 * <pre><code>{
-	 *     "affected": 저장된 정보수,
-	 *     "saved": true || false
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "affected": 저장된 정보 수,
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="코드 순서", value="/reorder.do")
@@ -305,10 +294,10 @@ public class CodeController extends AbstractController {
 	 * 코드를 지정하지 않으면 해당 그룹의 모든 공통코드들을 제거한다.
 	 * @param groupID 코드 그룹 아이디
 	 * @param codes 코드
-	 * @return 저장된 정보수
-	 * <pre><code>{
-	 *     "affected": 저장된 정보수,
-	 *     "saved": true || false
+	 * @return jsonView
+	 * <pre><code> {
+	 *     "affected": 저장된 정보 수,
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="코드 제거", value="/remove.do")