Twoje pliki są przechowywane w zasobniku Cloud Storage. Pliki w tym zasobniku są prezentowane w strukturze hierarchicznej, podobnie jak system plików na lokalnym dysku twardym lub dane w Firebase Realtime Database. Gdy utworzysz odwołanie do pliku, Twoja aplikacja uzyska do niego dostęp. Te odwołania można następnie wykorzystać do przesyłania i pobierania danych, uzyskiwania i aktualizowania metadanych oraz usuwania plików. Odwołanie może wskazywać konkretny plik lub węzeł wyższego poziomu w hierarchii.
Jeśli korzystasz z Firebase Realtime Database, te ścieżki powinny być Ci dobrze znane. Dane plików są jednak przechowywane w Cloud Storage, a nie w Realtime Database.
Tworzenie referencji
Utwórz odwołanie, aby przesłać, pobrać lub usunąć plik albo uzyskać lub zaktualizować jego metadane. Referencję można traktować jako wskaźnik do pliku w chmurze. Referencje są lekkie, więc możesz utworzyć ich tyle, ile potrzebujesz. Można ich też używać wielokrotnie.
Odwołania są tworzone z storage
usługi w aplikacji Firebase przez wywołanie metody GetReferenceFromUrl()
i przekazanie adresu URL w formacie gs://<your-cloud-storage-bucket>
. Ten adres URL znajdziesz w sekcji Pamięć w Firebasekonsoli.
// 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>");
Możesz utworzyć odwołanie do lokalizacji niżej w drzewie, np. 'images/space.jpg'
, używając metody child
w przypadku istniejącego odwołania.
// 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");
Poruszanie się po treści za pomocą odniesień
Możesz też użyć metod Parent
i Root
, aby przejść wyżej w hierarchii plików. Parent
– przejście o 1 poziom wyżej, Root
– przejście na samą górę.
// 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();
Funkcje Child
, Parent
i Root
można łączyć ze sobą wielokrotnie, ponieważ każda z nich zwraca odwołanie. Wyjątkiem jest Parent
Root
, który jest nieprawidłowym 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();
Metody referencyjne
Możesz sprawdzić odwołania, aby lepiej poznać pliki, do których prowadzą, korzystając z metod full_path
, name
i bucket
. Te metody pobierają pełną ścieżkę, nazwę i zasobnik pliku.
// 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();
Ograniczenia dotyczące odwołań
Ścieżki i nazwy referencji mogą zawierać dowolną sekwencję prawidłowych znaków Unicode, ale obowiązują pewne ograniczenia, m.in.:
- Łączna długość pola reference.fullPath musi wynosić od 1 do 1024 bajtów po zakodowaniu w formacie UTF-8.
- Nie używaj znaków powrotu karetki ani znaku nowego wiersza.
- Unikaj używania znaków
#
,[
,]
,*
i?
, ponieważ nie działają one prawidłowo z innymi narzędziami, takimi jak Firebase Realtime Database czy gsutil.
Pełny przykład
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();
Następne kroki
Teraz dowiesz się, jak przesyłać pliki do Cloud Storage.