ファイルは Cloud Storage バケットに保存されます。このバケット内のファイルは、ローカル ハードディスク上のファイル システムや Firebase Realtime Database 内のデータと同様の階層構造で表されます。アプリからファイルにアクセスするには、そのファイルへの参照を作成します。作成した参照を使うと、データのアップロードやダウンロード、メタデータの取得や更新、ファイルの削除などを行うことができます。参照は特定のファイルまたは階層内の上位ノードをポイントします。
Firebase Realtime Database を使用したことがある場合は、これらのパスになじみがあると思いますが、ファイルデータの格納場所は Realtime Database ではなく Cloud Storage になります。
参照を作成する
ファイルのアップロード、ダウンロード、削除や、ファイルのメタデータの取得、更新を行うには、参照を作成します。参照はクラウド内のファイルへのポインタと考えることができます。参照は軽量なので、必要なだけいくつでも作成でき、複数のオペレーションで再利用することもできます。
Firebase アプリの storage
サービスから参照を作成するには、GetReferenceFromUrl()
メソッドを呼び出して gs://<your-cloud-storage-bucket>
という URL 形式で渡します。この URL は Firebase コンソールの [Storage] セクションで確認できます。
// Get a reference to the storage service, using the default Firebase App Storage* storage = Storage::GetInstance(app); // Create a Cloud Storage reference from our storage service StorageReference storage_ref = storage->GetReferenceFromUrl("gs://<your-cloud-storage-bucket>");
既存の参照で child
メソッドを使用することにより、ツリーの下位('images/space.jpg'
など)への参照を作成できます。
// Create a child reference // images_ref now points to "images" StorageReference images_ref = storage_ref.Child("images"); // Child references can also take paths delimited by '/' // space_ref now points to "images/space.jpg" // images_ref still points to "images" StorageReference space_ref = storage_ref.Child("images/space.jpg"); // This is equivalent to creating the full reference StorageReference space_ref = storage.GetReferenceFromUrl("gs://<your-cloud-storage-bucket>/images/space.jpg");
参照を使って階層内を移動する
Parent
メソッドや Root
メソッドを使用して、ファイル階層を上に移動することもできます。Parent
は 1 つ上のレベルに移動し、Root
は最上位に移動します。
// Parent allows us to move to the parent of a reference // images_ref now points to 'images' StorageReference images_ref = space_ref.Parent(); // Root allows us to move all the way back to the top of our bucket // root_ref now points to the root StorageReference root_ref = space_ref.Root();
Child
、Parent
、Root
を複数つなげて参照を返すことができます。例外は Root
の Parent
で、これは無効な StorageReference
になります。
// References can be chained together multiple times // earth_ref points to "images/earth.jpg" StorageReference earth_ref = space_ref.Parent().Child("earth.jpg"); // null_ref is null, since the parent of root is an invalid StorageReference StorageReference null_ref = space_ref.Root().Parent();
参照メソッド
full_path
、name
、bucket
メソッドを使用して参照を調べ、参照がポイントしているファイルの詳細を知ることができます。これらのメソッドは、ファイルの完全なパス、名前、バケットを取得します。
// Reference's path is: "images/space.jpg" // This is analogous to a file path on disk space_ref.full_path(); // Reference's name is the last segment of the full path: "space.jpg" // This is analogous to the file name space_ref.name(); // Reference's bucket is the name of the Cloud Storage bucket where files are stored space_ref.bucket();
参照の制約事項
参照のパスと名前には、有効な Unicode 文字を任意の順序で含めることができますが、次のような一定の制約があります。
- UTF-8 でエンコードする場合は、reference.fullPath の全体の長さを 1~1,024 バイトにする必要があります。
- 改行またはラインフィード文字は使用できません。
#
、[
、]
、*
、?
は使用しないでください。これらの文字は、Firebase Realtime Database や gsutil などの他のツールではうまく機能しません。
例
Storage* storage = Storage::GetInstance(app); // Points to the root reference StorageReference storage_ref = storage->GetReferenceFromUrl("gs://<your-bucket-name>"); // Points to "images" StorageReference images_ref = storage_ref.Child("images"); // Points to "images/space.jpg" // Note that you can use variables to create child values std::string filename = "space.jpg"; StorageReference space_ref = images_ref.Child(filename); // File path is "images/space.jpg" std::string path = space_ref.full_path() // File name is "space.jpg" std::string name = space_ref.name() // Points to "images" StorageReference images_ref = space_ref.Parent();
次のステップ
次に、Cloud Storage にファイルをアップロードする方法を学習しましょう。