Filesystem Module.

파일시스템 API는 단말의 파일시스템 상의 몇몇 특정 위치에 대응되는 가상 루트들의 집합을 추상화하여 나타냅니다. 파일시스템 API는 가상 루트와 가상 루트 하위의 계층구조를 각기 개별적인 가상 파일시스템으로 노출하며 단말의 파일시스템 상의 다른 부분은 접근을 제한합니다. 각 가상 루트에는 이름이 부여되어 있으며 가상 파일시스템 상의 각 파일과 디렉토리는 다음과 같은 형식의 절대경로 형식으로 지정됩니다. <root name>/<path>. <root name>은 가상 루트의 이름이고 <path>는 루트에 대한 파일과 디렉토리의 상대적인 경로입니다. 가상 루트의 종류에는 다음과 같은 것들이 있습니다.
• images: 이미지 파일들의 위치
• videos: 동영상 파일들의 위치
• music: 음악 파일들의 위치
• documents: 문서들의 위치
• downloads: 내려 받은 파일들의 위치
• wgt-package: 위젯 패키지의 위치 (읽기 전용)
• wgt-private: 위젯 전용의 저장 공간
• wgt-private-tmp: 위젯 전용의 휘발성 저장 공간
• removable: 교체 가능한 저장공간의 위치 (※ iOS에서는 removable을 지원하지 않습니다.)

위에서 나열한 가상 루트로부터의 특정한 경로에 접근하려면 filesystem.resolve 함수를 호출하여 파일 핸들을 반환 받아야 합니다.
파일 핸들은 파일과 디렉토리 모두에 대응되며 파일 핸들의 isFile 속성이 true이면 파일이고 isDirectory 속성이 true이면 디렉토리입니다. 파일을 열고 FileStream 핸들을 이용해 파일을 읽고 쓸 수 있습니다. 디렉토리는 그 하위에 있는 파일들과 디렉토리들을 나열할 수 있습니다.
경로 분리자로는 ‘/’ 문자가 사용되며 현재 디렉토리를 지칭하는 ‘.’과 상위 디렉토리를 지칭하는 ‘..’ 표현은 지원되지 않습니다. 경로를 구성하는 모든 문자는 UTF-8로 인코딩되어야 합니다.

http://wacapps.net/api/filesystem 피쳐 혹은 이 피쳐의 하위 피쳐들이 요청되면 FileSystemManager 인터페이스의 인스턴스가 deviceapis. filesystem 으로 전역 네임 스페이스에 생성됩니다.
※ Appspresso는 파일을 직접 편집하지 않고도 피쳐를 선언할 수 있는 그래픽 편집기를 제공합니다. 그래픽 편집기를 이용한 피쳐 선언 방법은 Getting Started를 참고하십시오.

다음은 위젯의 config.xml 파일을 통해 이 API의 피쳐들을 선언하기 위한 URI의 목록입니다.
http://wacapps.net/api/filesystem
이 모듈의 모든 기능 사용 가능.
http://wacapps.net/api/filesystem.read
copyTo(), moveTo(), createDirectory(), createFile(), deleteDirectory(), deleteFile(), 그리고 "w", "a" mode의 openStream을 제외한 모든 기능 사용
http://wacapps.net/api/filesystem.write
readAsText(), "r" mode의 openStream을 제외한 모든 기능 사용