您的文件存儲在Cloud Storage 存儲桶中。此存儲桶中的文件以層次結構呈現,就像本地硬盤上的文件系統或 Firebase 實時數據庫中的數據一樣。通過創建對文件的引用,您的應用程序可以訪問它。這些引用隨後可用於上傳或下載數據、獲取或更新元數據或刪除文件。引用可以指向特定文件或層次結構中的更高級別節點。
如果您使用過Firebase Realtime Database ,這些路徑對您來說應該非常熟悉。但是,您的文件數據存儲在 Cloud Storage 中,而不是實時數據庫中。
創建參考
創建引用以上傳、下載或刪除文件,或者獲取或更新其元數據。可以將引用視為指向雲中文件的指針。引用是輕量級的,因此您可以根據需要創建任意數量的引用。它們也可重複用於多種操作。
使用FirebaseStorage
單例實例並調用其getReference()
方法創建引用。
Kotlin+KTX
// Create a storage reference from our app var storageRef = storage.reference
Java
// Create a storage reference from our app StorageReference storageRef = storage.getReference();
接下來,您可以通過對現有引用使用child()
方法來創建對樹中較低位置的引用,例如"images/space.jpg"
。
Kotlin+KTX
// Create a child reference // imagesRef now points to "images" var imagesRef: StorageReference? = storageRef.child("images") // Child references can also take paths // spaceRef now points to "images/space.jpg // imagesRef still points to "images" var spaceRef = storageRef.child("images/space.jpg")
Java
// 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()
向上導航一個級別,而getRoot()
一直導航到頂部。
Kotlin+KTX
// parent allows us to move our reference to a parent node // imagesRef now points to 'images' imagesRef = spaceRef.parent // root allows us to move all the way back to the top of our bucket // rootRef now points to the root val rootRef = spaceRef.root
Java
// 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
。
Kotlin+KTX
// References can be chained together multiple times // earthRef points to 'images/earth.jpg' val earthRef = spaceRef.parent?.child("earth.jpg") // nullRef is null, since the parent of root is null val nullRef = spaceRef.root.parent
Java
// 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()
方法檢查引用以更好地理解它們指向的文件。這些方法獲取文件的完整路徑、名稱和存儲桶。
Kotlin+KTX
// Reference's path is: "images/space.jpg" // This is analogous to a file path on disk spaceRef.path // Reference's name is the last segment of the full path: "space.jpg" // This is analogous to the file name spaceRef.name // Reference's bucket is the name of the storage bucket that the files are stored in spaceRef.bucket
Java
// 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 字符序列,但有一定的限制,包括:
- 使用 UTF-8 編碼時,reference.fullPath 的總長度必須在 1 到 1024 字節之間。
- 沒有回車符或換行符。
- 避免使用
#
、[
、]
、*
或?
,因為這些不能很好地與其他工具(例如Firebase 實時數據庫或gsutil)一起使用。
完整示例
Kotlin+KTX
// Points to the root reference storageRef = storage.reference // Points to "images" imagesRef = storageRef.child("images") // Points to "images/space.jpg" // Note that you can use variables to create child values val fileName = "space.jpg" spaceRef = imagesRef.child(fileName) // File path is "images/space.jpg" val path = spaceRef.path // File name is "space.jpg" val name = spaceRef.name // Points to "images" imagesRef = spaceRef.parent
Java
// 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();
接下來,讓我們學習如何將文件上傳到雲存儲。