javadoc 보완 수정

src/main/java/cokr/xit/base/file/FileInfo.java

@@ -71,7 +71,7 @@ public class FileInfo {
 		}
 
 		/**관계 정보의 키를 설정한다.
-		 * @param infoType 관계 정보의 키를
+		 * @param infoKey 관계 정보의 키를
 		 * @return 현재 Relation
 		 */
 		public Relation setInfoKey(String infoKey) {
@@ -87,7 +87,7 @@ public class FileInfo {
 		}
 
 		/**관계 정보의 하위 유형을 설정한다.
-		 * @param infoType 관계 정보의 하위 유형
+		 * @param subType 관계 정보의 하위 유형
 		 * @return 현재 Relation
 		 */
 		public Relation setSubType(String subType) {

src/main/java/cokr/xit/base/file/dao/FileMapper.java

@@ -50,12 +50,8 @@ import cokr.xit.foundation.data.DataObject;
 @Mapper("fileMapper")
 public interface FileMapper extends AbstractMapper {
 	/**주어진 관계 정보의 파일 정보 목록을 반환한다.<br />
-	 * 관계 정보 키가 없으면 관계 정보 유형의 모든 파일 정보 목록을 반환한다.
+	 * {@link cokr.xit.base.file.service.FileService#getFileList(FileQuery)} 참고
 	 * @param req 조회 조건
-	 * <pre><code> {
-	 *     "infoType": 관계 정보 유형
-	 *     "infoKeys": 관계 정보 키
-	 * }</code></pre>
 	 * @return 파일 정보 목록
 	 */
 	List<DataObject> getFileList(FileQuery req);

src/main/java/cokr/xit/base/file/service/FileService.java

@@ -7,7 +7,7 @@ import cokr.xit.base.file.FileInfo;
 import cokr.xit.foundation.data.DataObject;
 
 /**파일 정보 서비스를 제공한다.
- * <ul><li>{@link #getFileList(String, String...) 파일 정보 목록 조회}</li>
+ * <ul><li>{@link #getFileList(FileQuery) 파일 정보 목록 조회}</li>
  *     <li>{@link #getFilesOf(String, String...) 파일 정보 가져오기}</li>
  *     <li>{@link #create(List) 파일 등록}</li>
  *     <li>{@link #reorder(String...) 파일 순서 변경}</li>
@@ -21,10 +21,11 @@ public interface FileService {
 	/**주어진 관계 정보의 파일 정보 목록을 반환한다.<br />
 	 * 관계 정보 키가 없으면 관계 정보 유형의 모든 파일 정보 목록을 반환한다.
 	 * @param req 조회 조건
-	 * <pre><code> {
+	 * <ul><li>infoType: 관계 정보 유형</li>
-	 *     "infoType": 관계 정보 유형
+	 *     <li>infoKeys: 관계 정보 키</li>
-	 *     "infoKeys": 관계 정보 키
+	 *     <li>pageNum: 페이지 시작 번호</li>
-	 * }</code></pre>
+	 *     <li>fetchSize: 페이지 목록 건수</li>
+	 * </ul>
 	 * @return 파일 정보 목록
 	 */
 	List<DataObject> getFileList(FileQuery req);

src/main/java/cokr/xit/base/file/service/bean/FileBean.java

@@ -54,12 +54,8 @@ public class FileBean extends AbstractComponent {
 	private FileMapper fileMapper;
 
 	/**주어진 관계 정보의 파일 정보 목록을 반환한다.<br />
-	 * 관계 정보 키가 없으면 관계 정보 유형의 모든 파일 정보 목록을 반환한다.
+	 * {@link cokr.xit.base.file.service.FileService#getFileList(FileQuery)} 참고
 	 * @param req 조회 조건
-	 * <pre><code> {
-	 *     "infoType": 관계 정보 유형
-	 *     "infoKeys": 관계 정보 키
-	 * }</code></pre>
 	 * @return 파일 정보 목록
 	 */
 	public List<DataObject> getFileList(FileQuery req) {

src/main/java/cokr/xit/base/file/web/FileController.java

@@ -31,12 +31,15 @@ public class FileController extends AbstractController {
 	}
 
 	/**주어진 관계 정보의 파일 정보 목록을 반환한다.<br />
-	 * 관계 정보 키가 없으면 관계 정보 유형의 모든 파일 정보 목록을 반환한다.
+	 * {@link FileService#getFileList(FileQuery)} 참고
-	 * @param infoType 관계 정보 유형
+	 * @param req 조회 조건
-	 * @param infoKeys 관계 정보 키
+	 * @return 파일 정보 목록
-	 * @return ModelAndView
+	 * @return jsonView
-	 * <pre><code>{
+	 * <pre><code> {
-	 *     "fileList": [...]
+	 *     "fileList": [파일 목록]
+	 *     "fileStart": 페이지 목록 시작 인덱스
+	 *     "fileFetch": 페이지 목록 건수
+	 *     "fileTotal": 조회 결과 찾은 전체 파일 목록 수
 	 * }</code></pre>
 	 */
 	@RequestMapping(name="파일목록 조회", value="/list.do")
@@ -53,10 +56,10 @@ public class FileController extends AbstractController {
 	 * @param infoKey 관계 정보 키
 	 * @param infoKey 하위 정보 유형
 	 * @param uploads 업로드 파일
-	 * @return ModelAndView
+	 * @return jsonView
 	 * <pre><code>{
 	 *     "affected": 등록된 파일 수,
-	 *     "saved": true || false
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="파일 등록", value="/create.do")
@@ -93,7 +96,7 @@ public class FileController extends AbstractController {
 	 * @return jsonView
 	 * <pre><code>{
 	 *     "affected": 저장된 정보수,
-	 *     "saved": true || false
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="순서 변경", value="/reorder.do")
@@ -109,7 +112,7 @@ public class FileController extends AbstractController {
 	 * @return jsonView
 	 * <pre><code>{
 	 *     "affected": 저장된 정보수,
-	 *     "saved": true || false
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="파일 제거", value="/remove.do")
@@ -127,7 +130,7 @@ public class FileController extends AbstractController {
 	 * @return jsonView
 	 * <pre><code>{
 	 *     "affected": 저장된 정보수,
-	 *     "saved": true || false
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="관련파일 제거", value="/removeLinked.do")
@@ -143,7 +146,7 @@ public class FileController extends AbstractController {
 	 * @return jsonView
 	 * <pre><code>{
 	 *     "affected": 저장된 정보수,
-	 *     "saved": true || false
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="파일 삭제", value="/delete.do")
@@ -161,7 +164,7 @@ public class FileController extends AbstractController {
 	 * @return jsonView
 	 * <pre><code>{
 	 *     "affected": 저장된 정보수,
-	 *     "saved": true || false
+	 *     "saved": 저장됐으면 true, 그렇지 않으면 false
 	 * }</code></pre>
 	 */
 	@PostMapping(name="관련파일 삭제", value="/deleteOf.do")