{{htmlmetatags>
metatag-description=(심플웍스, SimpleWorks, 유틸리티, FileUtil)
metatag-og:description=(심플웍스, SimpleWorks, 유틸리티, FileUtil)
}}

====== FileUtil ======

===== 공통 =====
^  메서드  ^  매개변수  ^  리턴  ^  비고  ^
| getFileExt | file 파일/경로 | 확장자 | 확장자 추출 |
| getFileIcon | file 파일/경로 | 아이콘 | 아이콘 이미지 ((지원\\ - 이미지: jpg, jpeg, png, gif, bmp\\ - 문서: doc, docx, xls, xlsx, ppt, pptx, hwp, hwpx, pdf, txt\\ - 압축: zip, gz, tgz)) |
| getFileSize | file 파일/경로 | 용량 | 파일 용량 (Bytes) |
| toFileSizeUnit | size 용량 | 용량\\ (자동 단위 표기) | 파일 용량 단위 변환\\ (Bytes → 자동/수동) |
| ::: | size 용량\\ unit 단위 ((대/소문자 구분 없음))\\ - TB 또는 T\\ - GB 또는 G\\ - MB 또는 M\\ - KB 또는 K | 용량\\ (수동 단위 표기) | ::: |
| readTxt | file 파일/경로 | 텍스트 데이터 | 파일 읽기 (*.txt) |
| writeTxt | file 파일/경로\\ data 텍스트 데이터 | 파일/경로 | 파일 쓰기 (*.txt) |
| readCsv | file 파일/경로 | arr 배열 | 파일 읽기 (*.csv) |
| writeCsv | file 파일/경로\\ arr 배열 | 파일/경로 | 파일 쓰기 (*.csv) |
| readBinary | file 파일/경로 | 바이너리 데이터 | 바이너리 읽기 |
| writeBinary | data 바이너리 데이터 | 파일/경로 | 바이너리 쓰기 |

===== Java =====
^  메서드  ^  매개변수  ^  리턴  ^  비고  ^
| isFile | file 파일/경로 | true / false | 파일 존재 여부 |
| deleteFile | file 파일/경로 | true / false | 파일 삭제 ((TOCTOU 경쟁 조건)) |
| copyFile | src_file 원본 파일/경로\\ tgt_file 대상 파일/경로 | true / false | 파일 복사\\ (기존 파일 존재 시 덮어쓰기) |
| moveFile | src_file 원본 파일/경로\\ tgt_file 대상 파일/경로 | true / false | 파일 이동 ((원본 파일 복사 후 삭제))\\ (기존 파일 존재 시 덮어쓰기) |
| isFolder | file 폴더/경로 | true / false | 폴더 존재 여부 |
| deleteFolder | folder 폴더/경로 | true / false | 폴더 삭제 ((TOCTOU 경쟁 조건)) |
| copyFolder | src_folder 원본 폴더/경로\\ tgt_folder 대상 폴더/경로 | true / false | 폴더 복사\\ (기존 폴더 존재 시 덮어쓰기) |
| moveFolder | src_folder 원본 폴더/경로\\ tgt_folder 대상 폴더/경로 | true / false | 폴더 이동 ((원본 폴더 복사 후 삭제))\\ (기존 폴더 존재 시 덮어쓰기) |
| createFolder | folder 폴더/경로 | true / false | 폴더 생성\\ (기존 폴더 존재 시 미생성) |
| compress | folder 폴더/경로 | 압축 파일/경로\\ (zip) | 압축 ((FIXME 이름 중복 정책)) |
| ::: | folder 폴더/경로\\ opt 옵션 ((대/소문자 구분 없음))\\ - zip\\ - gz\\ - tgz | 압축 파일/경로\\ (zip / gz / tgz) | ::: |
| uncompress | file 파일/경로 | 해제 폴더/경로 | 해제 ((FIXME 이름 중복 정책)) |
| upload | FIXME ((FIXME\\ - 폴더 경로\\ - 용량 제한\\ - 확장자 제한)) | JSON | 업로드 ((썸네일 생성)) ((확장자\\ - 허용: jpg|jpeg|png|gif|bmp|doc|docx|xls|xlsx|ppt|pptx|hwp|hwpx|pdf|txt|zip|gz|tgz\\ - 차단: asp|aspx|jsp|java|class|php|cgi|perl|py|pyc|pyo|js|vbs|bat|sh|exe|msi|apk)) |
| download | file 파일/경로 | 다운로드 | 다운로드 |
| ::: | file 파일/경로\\ nm 다운로드명 | ::: | ::: |
| thumb | file 파일/경로 | 이미지 | 썸네일 이미지 |

==== upload ====
<sxh; gutter: true; title: success;>
{
	"status": "success",
	"result": {
		"data" : [
			{
				"path": "/upload/20250101",
				"uuid_nm": "A4122C5DB0E84F97A6F21547CF67B8D2.jpg",
				"file_nm": "sample.jpg",
				"file_ext": "jpg",
				"file_size": 1024,
				"img_width": 800,
				"img_height": 600
			}
		]
	}
}
</sxh>

<sxh; gutter: true; title: error;>
{
	"status": "error",
	"message": "Upload Size Limit"
}

</sxh>

<sxh; gutter: true; title: fail;>
{
	"status": "fail"
}
</sxh>

{{tag>"심플웍스" "SimpleWorks"}}