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 한 번에 반환할 코드 분류의 갯수 + /**코드 분류 목록을 조회한다.
+ * {@link cokr.xit.base.code.service.CodeService#getCategoryList(CodeQuery)} 참고 + * @param req 코드 분류 목록 조회 조건 * @return 코드 분류 목록 */ List getCategoryList(CodeQuery req); + /**지정하는 아이디의 코드 분류 정보를 반환한다. + * @param categoryID 코드 분류 아이디 + * @return 코드 분류 정보 + */ + default DataObject getCategoryInfo(String categoryID) { + List list = getCategoryList(new CodeQuery().setCategoryIDs(categoryID)); + return !list.isEmpty() ? list.get(0) : null; + } + /**지정하는 아이디의 코드 분류들을 가져온다. - * @param categoryIDs 코드 분류 아이디 + * @param req 조회 조건 * @return 코드 분류 */ List getCategories(CodeQuery req); @@ -44,7 +53,7 @@ public interface CodeMapper extends AbstractMapper { return !categories.isEmpty() ? categories.get(0) : null; } /**코드 분류를 등록한다. - * @param category 코드 분류 + * @param params 파라미터 * @return 등록 여부 *
  • 등록이 됐으면 true
    • *
  • 그렇지 않으면 false
    • @@ -67,14 +76,15 @@ public interface CodeMapper extends AbstractMapper { return insertCategory(params); } + /**코드 분류를 수정한다. + * @param params 파라미터 + * @return 저장된 정보수 + */ int updateCategory(Map params); /**코드 분류를 수정한다. * @param category 코드 분류 - * @return 수정 여부 - *
    • 수정이 됐으면 true
      • - *
    • 그렇지 않으면 false
      • - *
    + * @return 저장된 정보수 */ default int update(CodeCategory category) { DataObject params = params() @@ -84,6 +94,11 @@ public interface CodeMapper extends AbstractMapper { return updateCategory(params); } + /**지정하는 아이디의 코드 분류들을 제거한다.
    + * 제거되는 코드 분류에 속하는 코드 그룹, 공통코드도 같이 제거한다. + * @param params 파라미터 + * @return 저장된 정보수 + */ int removeCategories(Map params); /**지정하는 아이디의 코드 분류들을 제거한다.
    @@ -98,16 +113,30 @@ public interface CodeMapper extends AbstractMapper { return removeCategories(params().set("categoryIDs", categoryIDs)); } - /**코드 그룹 목록을 조회한다. - * @param pageNum 반환할 코드 그룹 목록의 페이지 번호 - * @param fetchSize 한 번에 반환할 코드 그룹의 갯수 - * @return + /**코드 그룹 목록을 조회한다.
    + * {@link cokr.xit.base.code.service.CodeService#getGroupList(CodeQuery)} 참고 + * @param req 코드 그룹 조회 조건 + * @return 코드 그룹 목록 */ List 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 list = getGroupList(req.setGroupIDs(groupID)); + return !list.isEmpty() ? list.get(0) : null; + } + + /**코드 그룹 목록을 조회한다. + * @param req 코드 그룹 목록 조회 조건 + * @return 코드 그룹 목록 */ List getGroups(CodeQuery req); @@ -179,18 +208,27 @@ public interface CodeMapper extends AbstractMapper { return removeGroups(null, groupIDs); } - /**지정하는 그룹의 공통코드 목록을 반환한다. - * @param groupID 코드 그룹 아이디 - * @param pageNum 반환할 공통코드 목록의 페이지 번호 - * @param fetchSize 한 번에 반환할 공통코드의 갯수 + /**지정하는 그룹의 공통코드 목록을 반환한다.
    + * {@link cokr.xit.base.code.service.CodeService#getCodeList(CodeQuery)} 참고 + * @param req 공통코드 조회 조건 * @return 공통코드 목록 */ List getCodeList(CodeQuery req); + /**지정하는 코드 그룹의 코드 정보를 반환한다. + * @param groupID 코드 그룹 아이디 + * @param code 코드 + * @return 코드 정보 + */ + default DataObject getCodeInfo(String groupID, String code) { + CodeQuery req = new CodeQuery().setGroupIDs(groupID).setCodes(code); + List list = getCodeList(req); + return !list.isEmpty() ? list.get(0) : null; + } + /**지정하는 그룹, 코드의 공통코드들을 반환한다.
    * 공통코드를 지정하지 않으면 코드 그룹의 모든 공통코드를 반환한다. - * @param groupID 코드 그룹 아이디 - * @param codes 공통코드 + * @param req 조회 조건 * @return 공통코드 */ List 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 params); /**공통코드를 등록한다. @@ -231,6 +273,10 @@ public interface CodeMapper extends AbstractMapper { return insertCode(params); } + /**공통코드를 수정한다. + * @param params 파라미터 + * @return 저장된 정보수 + */ int updateCode(Map params); /**공통코드를 수정한다. @@ -248,6 +294,10 @@ public interface CodeMapper extends AbstractMapper { return updateCode(params); } + /**지정하는 코드 그룹의 공통코드들의 정렬 순서를 전달받은 순서대로 저장한다. + * @param params 파라미터 + * @return 저장된 정보수 + */ int reorderCodes(Map params); /**지정하는 코드 그룹의 공통코드들의 정렬 순서를 전달받은 순서대로 저장한다. @@ -260,8 +310,19 @@ public interface CodeMapper extends AbstractMapper { return reorderCodes(params().set("groupID", groupID).set("codes", codes)); } + /**지정하는 코드 그룹의 코드들을 제거한다.
    + * 코드를 지정하지 않으면 해당 그룹의 모든 공통코드들을 제거한다. + * @param params 파라미터 + * @return 저장된 정보수 + */ int removeCodes(Map params); + /**지정하는 코드 그룹의 코드들을 제거한다.
    + * 코드를 지정하지 않으면 해당 그룹의 모든 공통코드들을 제거한다. + * @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; /**공통코드 서비스를 제공한다. - *
    • {@link #getCategoryList(int, int) 코드 분류 목록 조회}
      • + *
      • {@link #getCategoryList(CodeQuery) 코드 분류 목록 조회}
        • *
      • {@link #create(CodeCategory) 코드 분류 등록}
        • *
      • {@link #update(CodeCategory) 코드 분류 수정}
        • *
      • {@link #removeCategories(String...) 코드 분류 제거}
        • - *
      • {@link #getGroupList(int, int) 코드 그룹 목록 조회}
        • + *
      • {@link #getGroupList(CodeQuery) 코드 그룹 목록 조회}
        • *
      • {@link #create(CodeGroup) 코드 그룹 등록}
        • *
      • {@link #update(CodeGroup) 코드 그룹 수정}
        • *
      • {@link #removeGroups(String...) 코드 그룹 제거}
        • - *
      • {@link #getCodeList(String, int, int) 공통코드 목록 조회}
        • + *
      • {@link #getCodeList(CodeQuery) 공통코드 목록 조회}
        • *
      • {@link #getCodesOf(String...) 그룹별 공통코드 가져오기}
        • *
      • {@link #create(CommonCode) 공통코드 등록}
        • *
      • {@link #update(CommonCode) 공통코드 수정}
        • @@ -27,12 +27,20 @@ import cokr.xit.foundation.data.DataObject; */ public interface CodeService { /**코드 분류 목록을 조회한다. - * @param pageNum 반환할 코드 분류 목록의 페이지 번호 - * @param fetchSize 한 번에 반환할 코드 분류의 갯수 + * @param req 코드 분류 목록 조회 조건 + *
        • pageNum: 페이지 번호
          • + *
        • fetchSize: 페이지 목록 건수
          • + *
        * @return 코드 분류 목록 */ List 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 코드 그룹 목록 조회 조건 + *
        • categoryIDs: 코드 분류 목록
          • + *
        • pageNum: 페이지 번호
          • + *
        • fetchSize: 페이지 목록 건수
          • + *
        * @return 코드 그룹 목록 */ List 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 공통코드 조회 조건 + *
        • groupIDs: 코드 그룹 아이디
          • + *
        • pageNum: 페이지 번호
          • + *
        • fetchSize: 페이지 목록 건수
          • + *
        * @return 공통코드 목록 */ List getCodeList(CodeQuery req); + /**지정하는 코드 그룹의 코드 정보를 반환한다. + * @param groupID 코드 그룹 아이디 + * @param code 코드 + * @return 코드 정보 + */ + DataObject getCodeInfo(String groupID, String code); + /**지정하는 그룹, 코드의 공통코드들을 반환한다.
        * 공통코드를 지정하지 않으면 코드 그룹의 모든 공통코드를 반환한다. * @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 한 번에 반환할 코드 분류의 갯수 + /**코드 분류 목록을 조회한다.
        + * {@link cokr.xit.base.code.service.CodeService#getCategoryList(CodeQuery)} 참고 + * @param req 코드 분류 목록 조회 조건 * @return 코드 분류 목록 */ public List 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 + /**코드 그룹 목록을 조회한다.
        + * {@link cokr.xit.base.code.service.CodeService#getGroupList(CodeQuery)} 참고 + * @param req 코드 그룹 목록 조회 조건 + * @return 코드 그룹 목록 */ public List 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 한 번에 반환할 공통코드의 갯수 + /**지정하는 그룹의 공통코드 목록을 반환한다.
        + * {@link cokr.xit.base.code.service.CodeService#getCodeList(CodeQuery)} + * @param req 공통코드 조회 조건 * @return 공통코드 목록 */ public List 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); + } + /**지정하는 그룹, 코드의 공통코드들을 반환한다.
        * 공통코드를 지정하지 않으면 코드 그룹의 모든 공통코드를 반환한다. * @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 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 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 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; /**공통코드 서비스 웹 컨트롤러.
        @@ -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 코드 분류 목록 - * 
        {
-	 *     "categoryList": [...]
+	/**코드 분류 목록을 조회한다.
        
+	 * {@link CodeService#getCategoryList(CodeQuery)} 참고
+	 * @param req 코드 분류 목록 조회 조건
+	 * @return jsonView
+	 * 
         {
+	 *     "categoryList": [코드 분류 목록]
+	 *     "categoryStart": 코드 분류 목록 시작 인덱스
+	 *     "categoryFetch": 한 번에 가져오는 코드 분류 목록 수
+	 *     "categoryTotal": 조회 결과 찾은 전체 코드 분류 수
 	 * }
        
 	 */
 	@RequestMapping(name="코드 분류 목록", value="/category/list.do")
@@ -62,8 +55,8 @@ public class CodeController extends AbstractController {
 
 	/**코드 분류 정보를 조회한다.
 	 * @param categoryID 카테고리 아이디
-	 * @return 코드 분류 정보
-	 * 
        {
+	 * @return base/code/category-info
+	 * 
         {
 	 *     "categoryInfo": [...]
 	 * }
        
 	 */
@@ -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 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 등록 여부
-	 * 
        {
-	 *     "saved": true || false
+	 * @return jsonView
+	 * 
         {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }
        
 	 */
 	@PostMapping(name="코드 분류 등록", value="/category/create.do")
@@ -93,9 +84,9 @@ public class CodeController extends AbstractController {
 
 	/**코드 분류를 수정한다.
 	 * @param category 코드 분류
-	 * @return 수정 여부
-	 * 
        {
-	 *     "saved": true || false
+	 * @return jsonView
+	 * 
         {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }
        
 	 */
 	@PostMapping(name="코드 분류 수정", value="/category/update.do")
@@ -107,10 +98,10 @@ public class CodeController extends AbstractController {
 	/**지정하는 아이디의 코드 분류들을 제거한다.
        
 	 * 제거되는 코드 분류에 속하는 코드 그룹, 공통코드도 같이 제거한다.
 	 * @param categoryIDs 코드 분류 아이디
-	 * @return 저장된 정보수
-	 * 
        {
-	 *     "affected": 1,
-	 *     "saved": true || false
+	 * @return jsonView
+	 * 
         {
+	 *     "affected": 저장된 정보수,
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }
        
 	 */
 	@PostMapping(name="코드 분류 삭제", value="/category/remove.do")
@@ -121,12 +112,15 @@ public class CodeController extends AbstractController {
 			.addObject("saved", affected > 0);
 	}
 
-	/**코드 그룹 목록을 조회한다.
-	 * @param pageNum 반환할 코드 그룹 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 코드 그룹의 갯수
-	 * @return 코드 그룹 목록
-	 * 
        {
-	 *     "groupList": [...]
+	/**코드 그룹 목록을 조회한다.
        
+	 * {@link CodeService#getGroupList(CodeQuery)} 참고
+	 * @param req 코드 그룹 목록 조회 조건
+	 * @return jsonView
+	 * 
         {
+	 *     "groupList": [코드 그룹 목록],
+	 *     "groupStart": 코드 그룹 시작 인덱스,
+	 *     "groupFetchTotal": 한 번에 가져오는 코드 그룹 목록 수,
+	 *     "groupTotal": 조회 결과 찾은 전체 코드 그룹 수
 	 * }
        
 	 */
 	@RequestMapping(name="코드 그룹 목록", value="/group/list.do")
@@ -141,27 +135,25 @@ public class CodeController extends AbstractController {
 
 	/**코드 그룹 정보를 조회한다.
 	 * @param groupID 그룹 아이디
-	 * @return 코드 그룹 정보
-	 * 
        {
+	 * @return base/code/group-info
+	 * 
         {
 	 *     "groupInfo": {...}
 	 * }
        
 	 */
-	@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 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 등록 여부
-	 * 
        {
-	 *     "saved": true || false
+	 * @return jsonView
+	 * 
         {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }
        
 	 */
 	@PostMapping(name="코드 그룹 등록", value="/group/create.do")
@@ -172,9 +164,9 @@ public class CodeController extends AbstractController {
 
 	/**코드 그룹을 수정한다.
 	 * @param group 코드 그룹
-	 * @return 수정 여부
-	 * 
        {
-	 *     "saved": true || false
+	 * @return jsonView
+	 * 
         {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }
        
 	 */
 	@PostMapping(name="코드 그룹 수정", value="/group/update.do")
@@ -186,10 +178,10 @@ public class CodeController extends AbstractController {
 	/**지정하는 아이디의 코드 그룹들을 제거한다.
        
 	 * 제거되는 코드 그룹에 속하는 공통코드도 같이 제거한다.
 	 * @param groupIDs 코드 그룹 아이디
-	 * @return 저장된 정보수
-	 * 
        {
-	 *     "affected": 1,
-	 *     "saved": true || false
+	 * @return jsonView
+	 * 
         {
+	 *     "affected": 저장된 정보수,
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }
        
 	 */
 	@PostMapping(name="코드 그룹 제거", value="/group/remove.do")
@@ -203,10 +195,10 @@ public class CodeController extends AbstractController {
 	/**지정하는 코드 그룹 아이디의 공통코드들을 가져와 그룹 아이디별로 분류하여 반환한다.
        
 	 * 코드 그룹 아이디를 지정하지 않으면 모든 공통코드를 반환한다.
 	 * @param groupIDs 코드 그룹 아이디
-	 * @return 그룹별 공통코드
-	 * 
        {
-	 *     "코드그룹0": [...], // 그룹0의 공통코드 목록
-	 *     "코드그룹1": [...], // 그룹1의 공통코드 목록
+	 * @return jsonView
+	 * 
         {
+	 *     "코드그룹0": [그룹0의 공통코드 목록],
+	 *     "코드그룹1": [그룹1의 공통코드 목록],
 	 *     ...
 	 * }
        
 	 */
@@ -216,17 +208,16 @@ public class CodeController extends AbstractController {
 			.addAllObjects(codeService.getCodesOf(groupIDs));
 	}
 
-	/**지정하는 그룹의 공통코드 목록을 반환한다.
-	 * @param groupID 코드 그룹 아이디
-	 * @param pageNum 반환할 공통코드 목록의 페이지 번호
-	 * @param fetchSize 한 번에 반환할 공통코드의 갯수
-	 * @return 공통코드 목록
-	 * 
        {
+	/**지정하는 그룹의 공통코드 목록을 반환한다.
        
+	 * {@link CodeService#getCodeList(CodeQuery)} 참고
+	 * @param req 공통코드 조회 조건
+	 * @return jsonView
+	 * 
         {
 	 *     "groupID": "코드그룹0",
-	 *     "codeList": [...], // 그룹0의 공통코드 목록
-	 *     "codeStart": 0, // 공통코드 시작 위치
-	 *     "codeFetch": 10, // 한 번에 반환하는 공통코드 갯수
-	 *     "codeTotal": 50, // 조회 결과 공통코드 전체 갯수
+	 *     "codeList": [그룹0의 공통코드 목록],
+	 *     "codeStart": 공통코드 시작 인덱스,
+	 *     "codeFetch": 한 번에 반환하는 공통코드 갯수,
+	 *     "codeTotal": 조회 결과 공통코드 전체 갯수
 	 * }
        
 	 */
 	@RequestMapping(name="그룹별 코드 목록", value="/list.do")
@@ -242,8 +233,8 @@ public class CodeController extends AbstractController {
 	/**지정하는 그룹의 공통코드 정보를 반환한다.
 	 * @param groupID 코드 그룹 아이디
 	 * @param code 코드
-	 * @return 공통코드 정보
-	 * 
        {
+	 * @return base/code/code-info
+	 * 
         {
 	 *     "codeInfo": {...}
 	 * }
        
 	 */
@@ -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 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 등록 여부
-	 * 
        {
-	 *     "saved": true || false
+	 * @return jsonView
+	 * 
         {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }
        
 	 */
 	@PostMapping(name="코드 등록", value="/create.do")
@@ -273,9 +262,9 @@ public class CodeController extends AbstractController {
 
 	/**공통코드를 수정한다.
 	 * @param commonCode 공통코드
-	 * @return 수정 여부
-	 * 
        {
-	 *     "saved": true || false
+	 * @return jsonView
+	 * 
         {
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }
        
 	 */
 	@PostMapping(name="코드 수정", value="/update.do")
@@ -287,10 +276,10 @@ public class CodeController extends AbstractController {
 	/**지정하는 코드 그룹의 공통코드들의 정렬 순서를 전달받은 순서대로 저장한다.
 	 * @param groupID 코드 그룹 아이디
 	 * @param codes 공통코드
-	 * @return 저장된 정보수
-	 * 
        {
-	 *     "affected": 저장된 정보수,
-	 *     "saved": true || false
+	 * @return jsonView
+	 * 
         {
+	 *     "affected": 저장된 정보 수,
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }
        
 	 */
 	@PostMapping(name="코드 순서", value="/reorder.do")
@@ -305,10 +294,10 @@ public class CodeController extends AbstractController {
 	 * 코드를 지정하지 않으면 해당 그룹의 모든 공통코드들을 제거한다.
 	 * @param groupID 코드 그룹 아이디
 	 * @param codes 코드
-	 * @return 저장된 정보수
-	 * 
        {
-	 *     "affected": 저장된 정보수,
-	 *     "saved": true || false
+	 * @return jsonView
+	 * 
         {
+	 *     "affected": 저장된 정보 수,
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }
        
 	 */
 	@PostMapping(name="코드 제거", value="/remove.do")