diff --git a/src/main/java/cokr/xit/base/user/dao/UserMapper.java b/src/main/java/cokr/xit/base/user/dao/UserMapper.java
index 5458279..2454b96 100644
--- a/src/main/java/cokr/xit/base/user/dao/UserMapper.java
+++ b/src/main/java/cokr/xit/base/user/dao/UserMapper.java
@@ -16,15 +16,21 @@ import cokr.xit.foundation.data.DataObject;
@Mapper("userMapper")
public interface UserMapper extends AbstractMapper {
/**주어진 조건에 따라 사용자 목록을 조회하여 반환한다.
+ * {@link cokr.xit.base.user.service.UserService#getUserList(UserQuery)} 참고
* @param req 사용자 조회 요청
- *
by는 조건필드 - *
{
- * "userIDs":사용자 아이디 배열,
- * "lock": 잠금 여부(true || false)
- * }
- * @param userIDs 사용자 아이디
* @return 저장된 정보수
*/
int lockUsers(Map{
- * "userIDs": 사용자 아이디 배열,
- * "status": 사용자 상태(A, P, D)
- * }
* @return 저장된 정보수
*/
int setStatus(Mapby는 조건필드 - *
{
- * "userList": [...], // 사용자 목록
- * "userStart": 0, // 사용자 목록 시작 인덱스
- * "userFetch": 10, // 한 번에 가져오는 사용자 목록 수
- * "userTotal": // 조회 결과 찾은 전체 사용자 수
+ * {
+ * "userList": [사용자 목록]
+ * "userStart": 사용자 목록 시작 인덱스
+ * "userFetch": 한 번에 가져오는 사용자 목록 수
+ * "userTotal": 조회 결과 찾은 전체 사용자 수
* }
*/
@RequestMapping(name="사용자 조회", value="/list.do")
@@ -54,7 +54,11 @@ public class UserController extends AbstractController {
}
/**사용자 선택을 위한 화면을 연다.
- * @return "base/user/select-user"
+ * @param multiple 여러 사용자 선택 여부
+ * - 여러 사용자를 선택하려면 true
+ * - 그렇지 않으면 false
+ *
+ * @return base/user/select-user
*/
@RequestMapping(name="사용자 선택", value="/select.do")
public ModelAndView select(boolean multiple) {
@@ -66,9 +70,9 @@ public class UserController extends AbstractController {
/**지정한 사용자 아이디가 사용 중인지 반환한다.
* @param userID 사용자 아이디
- * @return
- * {
- * "duplicate": true || false // 사용 중이면 true, 그렇지 않으면 false
+ * @return jsonView
+ * {
+ * "duplicate": 사용 중이면 true, 그렇지 않으면 false
* }
*/
@RequestMapping(name="중복 확인", value="/duplicate.do")
@@ -80,19 +84,15 @@ public class UserController extends AbstractController {
/**지정한 아이디의 사용자 정보를 반환한다.
* @param userID 사용자 아이디
- * @return jsonView
+ * @return base/user/user-info 또는 jsonView
* {
- * "userInfo": 사용자 정보(map)
+ * "userInfo": 사용자 정보
* }
*/
@RequestMapping(name="사용자 정보 조회", value="/info.do")
public ModelAndView getInfo(String userID) {
if (!isEmpty(userID)) {
- UserQuery req = new UserQuery()
- .setBy("userID")
- .setTerm(userID);
- List userList = userService.getUserList(req);
- DataObject userInfo = !userList.isEmpty() ? userList.get(0) : null;
+ DataObject userInfo = userService.getUserInfo(userID);
boolean json = jsonResponse();
return new ModelAndView(json ? "jsonView" : "base/user/user-info")
.addObject("userInfo", json ? userInfo : toJson(userInfo));
@@ -103,9 +103,9 @@ public class UserController extends AbstractController {
/**사용자를 등록한다.
* @param user 사용자 정보
- * @return
- * {
- * "saved": true || false // 저장되었으면 true, 그렇지 않으면 false
+ * @return jsonView
+ * {
+ * "saved": 등록되었으면 true, 그렇지 않으면 false
* }
*/
@PostMapping(name="사용자 등록", value="/create.do")
@@ -117,9 +117,9 @@ public class UserController extends AbstractController {
/**사용자 정보를 수정한다.
* @param user 사용자 정보
- * @return
- * {
- * "saved": true || false // 저장되었으면 true, 그렇지 않으면 false
+ * @return jsonView
+ * {
+ * "saved": 수정되었으면 true, 그렇지 않으면 false
* }
*/
@PostMapping(name="사용자 수정", value="/update.do")
@@ -132,10 +132,10 @@ public class UserController extends AbstractController {
/**사용자 비밀번호를 변경한다.
* @param userID 사용자 아이디
* @param password 비밀번호
- * @return
- * {
- * "affected": 1, // 저장된 정보수
- * "saved": true || false // 저장되었으면 true, 그렇지 않으면 false
+ * @return jsonView
+ * {
+ * "affected": 저장된 정보수,
+ * "saved": 저장되었으면 true, 그렇지 않으면 false
* }
*/
@PostMapping(name="비밀번호 변경", value="/changePassword.do")
@@ -148,10 +148,10 @@ public class UserController extends AbstractController {
/**사용자 가입신청을 승인한다.
* @param userIDs 사용자 아이디
- * @return
- * {
- * "affected": 1, // 저장된 정보수
- * "saved": true || false // 저장되었으면 true, 그렇지 않으면 false
+ * @return jsonView
+ * {
+ * "affected": 저장된 정보수
+ * "saved": 저장되었으면 true, 그렇지 않으면 false
* }
*/
@PostMapping(name="사용자 가입 승인", value="/approve.do")
@@ -163,12 +163,15 @@ public class UserController extends AbstractController {
}
/**사용자 잠금이나 잠금해제를 수행한다.
- * @param lock 잠금 여부(잠그면 true, 잠금을 해제하면 false)
+ * @param lock 잠금 여부
+ * - 잠금이면 true
+ * - 잠금을 해제하면 false
+ *
* @param userIDs 사용자 아이디
- * @return
- * {
- * "affected": 1, // 저장된 정보수
- * "saved": true || false // 저장되었으면 true, 그렇지 않으면 false
+ * @return jsonView
+ * {
+ * "affected": 저장된 정보수
+ * "saved": 저장되었으면 true, 그렇지 않으면 false
* }
*/
@PostMapping(name="사용자 잠김/잠김해제", value="/unlock.do")
@@ -181,10 +184,10 @@ public class UserController extends AbstractController {
/**지정한 사용자를 제거한다.
* @param userIDs 사용자 아이디
- * @return
- * {
- * "affected": 1, // 저장된 정보수
- * "saved": true || false // 저장되었으면 true, 그렇지 않으면 false
+ * @return jsonView
+ * {
+ * "affected": 저장된 정보수
+ * "saved": 저장되었으면 true, 그렇지 않으면 false
* }
*/
@PostMapping(name="사용자 제거", value="/remove.do")