From a71fd72bc1b50247f2e62aff6fc5394e88b64298 Mon Sep 17 00:00:00 2001 From: BGuga Date: Sun, 12 May 2024 03:27:13 +0900 Subject: [PATCH] =?UTF-8?q?chore:=20javadocs=20=EC=84=A4=EB=AA=85=20?= =?UTF-8?q?=EB=B3=80=EA=B2=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../com/festago/upload/domain/UploadFile.java | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/backend/src/main/java/com/festago/upload/domain/UploadFile.java b/backend/src/main/java/com/festago/upload/domain/UploadFile.java index 24af9f47c..eae75de31 100644 --- a/backend/src/main/java/com/festago/upload/domain/UploadFile.java +++ b/backend/src/main/java/com/festago/upload/domain/UploadFile.java @@ -77,8 +77,9 @@ public UploadFile(long size, URI location, FileExtension extension, LocalDateTim /** * UPLOADED 상태의 파일을 ASSIGNED 상태로 변경한다.
ASSIGNED 상태의 파일은 주인이 정해졌지만, 해당 주인이 파일을 소유하고 있지 않는 상태이다.
따라서 - * ASSIGNED 상태의 파일은 같은 주인이라도 여러 개가 생길 수 있다.
이후 파일을 다른 상태로 변경하려면 renewalStatus() 또는 changeAbandoned()를 호출해야 한다. - *
파일의 주인은 정해졌지만, 해당 파일이 공유되어 사용될 수 있으므로 UPLOADED 상태의 파일만 ASSIGNED 상태로 변경할 수 있다.
+ * ASSIGNED 상태의 파일은 같은 주인이라도 여러 개가 생길 수 있다.
이후 파일을 다른 상태로 변경하려면 renewalStatus() 또는 changeAbandoned()를 호출해야 + * 한다.
+ * 파일의 주인은 정해졌지만, 해당 파일이 공유되어 사용될 수 있으므로 UPLOADED 상태의 파일만 ASSIGNED 상태로 변경할 수 있다.
* * @param ownerId 파일 주인의 식별자 * @param ownerType 파일 주인의 타입 @@ -95,8 +96,8 @@ public void changeAssigned(Long ownerId, FileOwnerType ownerType) { /** * UPLOADED 상태의 파일을 ATTACHED 상태로 변경한다.
ATTACHED 상태의 파일은 주인이 해당 파일을 소유하고 있는 상태이다.
따라서 ATTACHED 상태의 파일은 - * 주인이 가진 파일 개수를 초과할 수 없다.
이후 파일을 다른 상태로 변경하려면 renewalStatus() 또는 changeAbandoned()를 호출해야 한다.
파일의 주인은 - * 정해졌지만, 해당 파일이 공유되어 사용될 수 있으므로 UPLOADED 상태의 파일만 ATTACHED 상태로 변경할 수 있다.
+ * 주인이 가진 파일 개수를 초과할 수 없다.
이후 파일을 다른 상태로 변경하려면 renewalStatus() 또는 changeAbandoned()를 호출해야 한다.
+ * 파일의 주인은 정해졌지만, 해당 파일이 공유되어 사용될 수 있으므로 UPLOADED 상태의 파일만 ATTACHED 상태로 변경할 수 있다.
* * @param ownerId 파일 주인의 식별자 * @param ownerType 파일 주인의 타입 @@ -123,12 +124,12 @@ public void changeAbandoned() { * ASSIGNED 또는 ATTACHED 상태의 파일을 ATTACHED 또는 ABANDONED 상태로 변경한다.
하지만 사용자가 파일 등록을 여러번 시도하여 ASSIGNED 상태의 파일이 다수 * 생성될 수 있다.
따라서 최종적으로 등록된 파일만 ATTACHED 상태로 변경하고 나머지는 ABANDONED 상태로 변경해야 한다.
그렇기에 최종적으로 등록되야할 파일의 식별자 * 목록을 받은 뒤, 식별자 목록에 현재 파일의 식별자가 있고, ASSIGNED 또는 ATTACHED 상태의 파일을 PRE_ATTACHED로 변경한다.
그 뒤, PRE_ATTACHED 상태가 되지 - * 못한 파일은 사용자가 최종적으로 등록한 파일이 아니므로 ABANDONED 상태로 변경한다.
그리고 PRE_ATTACHED 상태의 파일은 ATTACHED 상태로 변경한다.
해당 파일이 - * 공유되어 사용될 수 있으므로 ownerId과 ownerType이 동일한 파일만 상태를 변경할 수 있다.
+ * 못한 파일은 사용자가 최종적으로 등록한 파일이 아니므로 ABANDONED 상태로 변경한다.
그리고 PRE_ATTACHED 상태의 파일은 ATTACHED 상태로 변경한다.
+ * 해당 파일이 공유되어 사용될 수 있으므로 ownerId과 ownerType이 동일한 파일만 상태를 변경할 수 있다.
* - * @param ownerId 파일 주인의 식별자 + * @param ownerId 파일 주인의 식별자 * @param ownerType 파일 주인의 타입 - * @param ids 최종적으로 ATTACHED 상태를 가져야 할 파일의 식별자 목록 + * @param ids 최종적으로 ATTACHED 상태를 가져야 할 파일의 식별자 목록 */ public void renewalStatus(Long ownerId, FileOwnerType ownerType, Set ids) { if (isNotOwner(ownerId, ownerType)) {