Cloud Storage 참조로 파일을 업로드한 후 콘텐츠 유형 등 파일 메타데이터를 가져오거나 업데이트할 수 있습니다. 또한 추가 파일 메타데이터로 커스텀 키-값 쌍을 저장할 수 있습니다.
파일 메타데이터 가져오기
파일 메타데이터는 name
, size
, content_type
(통칭 MIME 형식) 등의 일반적인 속성뿐 아니라 content_disposition
, time_created
등의 비일반적 속성도 포함합니다. GetMetadata
메서드를 사용하여 Cloud Storage 참조에서 이러한 메타데이터를 가져올 수 있습니다.
// Create reference to the file whose metadata we want to retrieve StorageReference forest_ref = storage_ref.Child("images/forest.jpg"); // Get metadata properties Futurefuture = forest_ref.GetMetadata(); // Wait for Future to complete... if (future.Error() != firebase::storage::kErrorNone) { // Uh-oh, an error occurred! } else { // We can now retrieve the metadata for 'images/forest.jpg' Metadata* metadata = future.Result(); }
파일 메타데이터 업데이트
파일 업로드가 완료된 후 언제든지 UpdateMetadata
메서드를 사용하여 파일 메타데이터를 업데이트할 수 있습니다. 업데이트할 수 있는 속성의 종류는 전체 목록을 참조하세요. 메타데이터에 지정된 속성만 업데이트되며 나머지 속성은
그대로 유지됩니다.
// Create reference to the file whose metadata we want to change firebase::storage::StorageReference forest_ref = storage_ref.child("images/forest.jpg"); // Create file metadata to update Metadata new_metadata; newMetadata.set_cache_control("public,max-age=300"); newMetadata.set_content_type("image/jpeg"); // Update metadata properties Futurefuture = forest_ref.UpdateMetadata(new_metadata); // Wait for Future to complete... if (future.Error() != firebase::storage::kErrorNone) { // Uh-oh, an error occurred! } else { // We can now retrieve the updated metadata for 'images/forest.jpg' Metadata* metadata = future.Result(); }
쓰기 가능한 메타데이터 속성에 빈 문자열을 전달하여 삭제할 수 있습니다.
// Create file metadata with property to delete StorageMetadata new_metadata; new_metadata.set_content_type(""); // Delete the metadata property Futurefuture = forest_ref.UpdateMetadata(new_metadata); // Wait for Future to complete... if (future.Error() != 0) { // Uh-oh, an error occurred! } else { // metadata.content_type() should be an empty string Metadata* metadata = future.Result(); }
오류 처리
메타데이터를 가져오거나 업데이트할 때 오류가 발생하는 데에는 파일이 없거나 파일에 대한 액세스 권한이 없는 경우 등 다양한 이유가 있습니다. 오류에 대한 자세한 내용은 문서의 오류 처리 섹션을 참조하세요.
커스텀 메타데이터
커스텀 메타데이터를 std::string
속성이 포함된 std::map
로 지정할 수 있습니다.
std::map<std::string, std::string="">* custom_metadata = metadata.custom_metadata(); custom_metadata->insert(std::make_pair("location", "Yosemite, CA, USA"); custom_metadata->insert(std::make_pair("activity", "Hiking"); std::string,>
커스텀 메타데이터에 각 파일의 앱별 데이터를 저장할 수 있지만, 이러한 유형의 데이터를 저장하고 동기화할 때는 Firebase 실시간 데이터베이스 같은 데이터베이스를 사용하는 것이 좋습니다.
파일 메타데이터 속성
파일 메타데이터 속성의 전체 목록은 다음과 같습니다.
속성 | 유형 | 쓰기 가능 |
---|---|---|
bucket |
const char* | 아니요 |
generation |
const char* | 아니요 |
metageneration |
const char* | 아니요 |
full_path |
const char* | 아니요 |
name |
const char* | 아니요 |
size |
int64_t | 아니요 |
time_created |
int64_t | 아니요 |
updated |
int64_t | 아니요 |
cache_control |
const char* | 예 |
content_disposition |
const char* | 예 |
content_encoding |
const char* | 예 |
content_language |
const char* | 예 |
content_type |
const char* | 예 |
download_urls |
std::vector<std::string> | 아니요 |
custom_metadata |
std::map<std::string, std::string> | 예 |
다음 단계
파일 업로드, 다운로드, 업데이트도 중요하지만 파일을 지우는 것도 가능해야 합니다. Cloud Storage에서 파일을 삭제하는 방법을 알아보세요.