Android でストレージ参照を作成する

ファイルは Google Cloud Storage バケットに保存されます。このバケット内のファイルは、ローカル ハードディスク上のファイル システムや Firebase Realtime Database 内のデータと同様の階層構造で表されます。アプリからファイルにアクセスするには、そのファイルへの参照を作成します。作成した参照を使うと、データのアップロードやダウンロード、メタデータの取得や更新、ファイルの削除などを行うことができます。参照は特定のファイルまたは階層内の上位ノードをポイントします。

Firebase Realtime Database を使用したことがある場合は、これらのパスになじみがあると思いますが、ファイルデータの格納場所は Realtime Database ではなく Google Cloud Storage になります。

参照を作成する

ファイルをアップロード、ダウンロード、または削除したり、ファイルのメタデータを取得または更新したりするには、参照を作成します。参照はクラウド内のファイルへのポインタと考えることができます。参照は軽量なので、必要なだけいくつでも作成でき、複数の操作で再利用することもできます。

参照を作成するには、FirebaseStorage シングルトン インスタンスを使用して getReference() メソッドを呼び出します。

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

既存の参照で getChild() メソッドを使用することにより、ツリーの下位('images/space.jpg' など)への参照を作成することができます。

// Create a child reference
// imagesRef now points to "images"
StorageReference imagesRef = storageRef.child("images");

// Child references can also take paths
// spaceRef now points to "images/space.jpg
// imagesRef still points to "images"
StorageReference spaceRef = storageRef.child("images/space.jpg");

getParent() メソッドや getRoot() メソッドを使用してファイル階層を上に移動することもできます。getParent() は 1 つ上のレベルに移動し、getRoot() は最上位に移動します。

// getParent allows us to move our reference to a parent node
// imagesRef now points to 'images'
imagesRef = spaceRef.getParent();

// getRoot allows us to move all the way back to the top of our bucket
// rootRef now points to the root
StorageReference rootRef = spaceRef.getRoot();

child()getParent()getRoot() を複数つなげて参照を返すことができます。ただし、getRoot().getParent() を呼び出すと null が返されます。

// References can be chained together multiple times
// earthRef points to 'images/earth.jpg'
StorageReference earthRef = spaceRef.getParent().child("earth.jpg");

// nullRef is null, since the parent of root is null
StorageReference nullRef = spaceRef.getRoot().getParent();

参照のプロパティ

getPath()getName()getBucket() メソッドを使用して参照を調べ、参照がポイントしているファイルを詳しく知ることができます。これらのメソッドは、ファイルの完全なパス、名前、バケットを取得します。

// Reference's path is: "images/space.jpg"
// This is analogous to a file path on disk
spaceRef.getPath();

// Reference's name is the last segment of the full path: "space.jpg"
// This is analogous to the file name
spaceRef.getName();

// Reference's bucket is the name of the storage bucket that the files are stored in
spaceRef.getBucket();

参照の制約事項

参照のパスと名前には、有効な Unicode 文字を任意の順序で含めることができますが、次のような一定の制約があります。

  1. UTF-8 でエンコードする場合は、reference.fullPath の全体の長さを 1~1,024 バイトにする必要があります。
  2. キャリッジ リターン文字またはラインフィード文字は使用できません。
  3. #[]*? の使用は避けてください。これらの文字は、Firebase Realtime Databasegsutil などのツールでうまく機能しません。

// Points to the root reference
storageRef = storage.getReference();

// Points to "images"
imagesRef = storageRef.child("images");

// Points to "images/space.jpg"
// Note that you can use variables to create child values
String fileName = "space.jpg";
spaceRef = imagesRef.child(fileName);

// File path is "images/space.jpg"
String path = spaceRef.getPath();

// File name is "space.jpg"
String name = spaceRef.getName();

// Points to "images"
imagesRef = spaceRef.getParent();

次に、Cloud Storage にファイルをアップロードする方法を学習しましょう。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。