Android에서 파일 메타데이터 사용

Cloud Storage 참조로 파일을 업로드한 후 파일 메타데이터를 가져오거나 업데이트할 수 있습니다. 예를 들어 콘텐츠 유형을 확인 또는 업데이트할 수 있습니다. 또한 추가 파일 메타데이터로 맞춤 키/값 쌍을 저장할 수 있습니다.

파일 메타데이터 가져오기

파일 메타데이터는 name, size, contentType(통칭 MIME 형식) 등의 일반적인 속성뿐 아니라 contentDisposition, timeCreated 등의 비일반적 속성을 포함합니다. getMetadata() 메소드를 사용하여 Cloud Storage 참조에서 이 메타데이터를 검색할 수 있습니다.

// Create a storage reference from our app
StorageReference storageRef = storage.getReference();

// Get reference to the file
StorageReference forestRef = storageRef.child("images/forest.jpg");

forestRef.getMetadata().addOnSuccessListener(new OnSuccessListener<StorageMetadata>() {
    @Override
    public void onSuccess(StorageMetadata storageMetadata) {
        // Metadata now contains the metadata for 'images/forest.jpg'
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(@NonNull Exception exception) {
        // Uh-oh, an error occurred!
    }
});

파일 메타데이터 업데이트

업로드가 완료된 후 언제든지 updateMetadata() 메소드를 사용하여 파일 메타데이터를 업데이트할 수 있습니다. 업데이트할 수 있는 속성이 무엇인지는 전체 목록을 참조하세요. 메타데이터에 지정된 속성만 업데이트되며 나머지 속성은 그대로 유지됩니다.

// Create a storage reference from our app
StorageReference storageRef = storage.getReference();

// Get reference to the file
StorageReference forestRef = storageRef.child("images/forest.jpg");

// Create file metadata including the content type
StorageMetadata metadata = new StorageMetadata.Builder()
        .setContentType("image/jpg")
        .setCustomMetadata("myCustomProperty", "myValue")
        .build();

// Update metadata properties
forestRef.updateMetadata(metadata)
        .addOnSuccessListener(new OnSuccessListener<StorageMetadata>() {
            @Override
            public void onSuccess(StorageMetadata storageMetadata) {
                // Updated metadata is in storageMetadata
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception exception) {
                // Uh-oh, an error occurred!
            }
        });

null을 전달하여 쓰기 가능한 메타데이터 속성을 삭제할 수 있습니다.

// Create file metadata with property to delete
StorageMetadata metadata = new StorageMetadata.Builder()
        .setContentType(null)
        .build();

// Delete the metadata property
forestRef.updateMetadata(metadata)
        .addOnSuccessListener(new OnSuccessListener<StorageMetadata>() {
            @Override
            public void onSuccess(StorageMetadata storageMetadata) {
                // metadata.contentType should be null
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception exception) {
                // Uh-oh, an error occurred!
            }
        });

오류 처리

메타데이터를 가져오거나 업데이트할 때 오류가 발생하는 데에는 파일이 없거나 파일에 대한 액세스 권한이 없는 경우 등 다양한 이유가 있습니다. 오류의 자세한 내용은 문서의 오류 처리 섹션을 참조하세요.

맞춤 메타데이터

setCustomMetadata() 메소드를 사용하여 맞춤 메타데이터를 지정할 수 있습니다. 이 메소드는 StorageMetadata.Builder 클래스에 있습니다.

StorageMetadata metadata = new StorageMetadata.Builder()
        .setCustomMetadata("location", "Yosemite, CA, USA")
        .setCustomMetadata("activity", "Hiking")
        .build();

맞춤 메타데이터에 각 파일의 앱별 데이터를 저장할 수 있지만 이러한 유형의 데이터를 저장하고 동기화할 때는 Firebase 실시간 데이터베이스 같은 데이터베이스를 사용하는 것이 좋습니다.

파일 메타데이터 속성

파일 메타데이터 속성의 전체 목록은 다음과 같습니다.

속성 getter 유형 setter 존재
getBucket String 아니요
getGeneration String 아니요
getMetadataGeneration String 아니요
getPath String 아니요
getName String 아니요
getSizeBytes long 아니요
getCreationTimeMillis long 아니요
getUpdatedTimeMillis long 아니요
getMd5Hash String 아니요
getCacheControl String
getContentDisposition String
getContentEncoding String
getContentLanguage String
getContentType String
getCustomMetadata String
getCustomMetadataKeys Set<String> 아니요

파일 업로드, 다운로드, 업데이트도 중요하지만 파일을 지우는 것도 가능해야 합니다. Cloud Storage에서 파일을 삭제하는 방법을 알아보겠습니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.