Menggunakan metadata file dengan Cloud Storage untuk C++

Setelah mengupload file ke referensi Cloud Storage, Anda juga dapat mengambil dan memperbarui metadata file, misalnya untuk memperbarui jenis konten. File juga dapat menyimpan key-value pair kustom dengan metadata file tambahan.

Mengambil Metadata File

Metadata file berisi properti umum, seperti name, size, dan content_type (sering disebut jenis MIME), serta beberapa properti yang jarang digunakan, seperti content_disposition dan time_created. Metadata ini dapat diambil dari referensi Cloud Storage menggunakan metode GetMetadata.

// Create reference to the file whose metadata we want to retrieve
StorageReference forest_ref = storage_ref.Child("images/forest.jpg");

// Get metadata properties
Future future = 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();
}

Memperbarui Metadata File

Anda dapat memperbarui metadata file kapan saja setelah file selesai diupload menggunakan metode UpdateMetadata. Lihat daftar lengkap untuk mengetahui informasi lebih lanjut mengenai properti yang dapat diperbarui. Hanya properti yang ditetapkan dalam metadata yang akan diupdate, sedangkan yang lainnya tidak berubah.

// 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
Future future = 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();
}

Anda dapat menghapus properti metadata yang dapat ditulis dengan meneruskan string kosong:

// Create file metadata with property to delete
StorageMetadata new_metadata;
new_metadata.set_content_type("");

// Delete the metadata property
Future future = 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();
}

Menangani Error

Ada sejumlah alasan terjadinya error saat mengambil atau memperbarui metadata, termasuk tidak adanya file atau pengguna tidak memiliki izin untuk mengakses file yang diinginkan. Informasi lebih lanjut mengenai error bisa dilihat di bagian Menangani Error pada dokumentasi.

Metadata Kustom

Anda dapat menentukan metadata kustom sebagai std::map yang berisi properti std::string.

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");

Anda dapat menyimpan data khusus aplikasi untuk setiap file di metadata kustom, tetapi sebaiknya Anda menggunakan database (seperti Firebase Realtime Database) untuk menyimpan dan menyinkronkan jenis data seperti ini.

Properti Metadata File

Daftar lengkap properti metadata pada file tercantum di bawah ini:

Properti	Jenis	Dapat Ditulis
`bucket`	const char*	TIDAK
`generation`	const char*	TIDAK
`metageneration`	const char*	TIDAK
`full_path`	const char*	TIDAK
`name`	const char*	TIDAK
`size`	int64_t	TIDAK
`time_created`	int64_t	TIDAK
`updated`	int64_t	TIDAK
`cache_control`	const char*	YA
`content_disposition`	const char*	YA
`content_encoding`	const char*	YA
`content_language`	const char*	YA
`content_type`	const char*	YA
`download_urls`	std::vector<std::string>	TIDAK
`custom_metadata`	std::map<std::string, std::string>	YA

Langkah Berikutnya

Mengupload, mendownload, dan memperbarui file itu penting, tetapi kita juga harus bisa menghapusnya. Mari pelajari cara menghapus file dari Cloud Storage.