Pliki są przechowywane w Zasobnik Cloud Storage. są wyświetlane w strukturze hierarchicznej, tak jak systemu plików na lokalnym dysku twardym lub danych w Bazie danych czasu rzeczywistego Firebase. Aplikacja uzyska do niego dostęp przez utworzenie odwołania do pliku. Te odwołania może być następnie używany do przesyłania lub pobierania danych, pobierania lub aktualizowania metadanych bądź usuwania plik. Odwołanie może wskazywać konkretny plik lub wyższy poziom w hierarchii.
Jeśli korzystasz z Bazy danych czasu rzeczywistego Firebase, te ścieżki powinny wydają się znajome. Dane plików są jednak przechowywane w Cloud Storage, a nie w bazie danych czasu rzeczywistego.
Tworzenie referencji
utworzyć referencję, aby przesłać, pobrać lub usunąć plik; lub aby pobrać bądź zaktualizować ich metadane. Plik referencyjny można traktować jako wskaźnik do pliku w chmurze. Pliki referencyjne są dzięki czemu możesz tworzyć ich tyle, ile potrzebujesz. Można z nich również korzystać wielokrotnie: do wielu operacji.
Pliki referencyjne są tworzone z usługi storage w aplikacji Firebase przez
wywołanie metody GetReferenceFromUrl() i przekazywanie adresu URL formularza
gs://<your-cloud-storage-bucket> Znajdziesz go w
Sekcja Pamięć w konsoli Firebase.
// 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,
powiedz 'images/space.jpg', używając metody child w istniejącym odniesieniu.
// 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");
Nawigacja z użyciem odwołań
Możesz też użyć metod Parent i Root, aby przejść do innego pliku w naszym pliku
w hierarchii. Parent przechodzi o 1 poziom wyżej, a Root – na wszystkie sposoby
do góry.
// 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 i Root można połączyć kilka razy,
każdy z nich zwraca odwołanie. Wyjątkiem jest Parent ciągu Root, który
Wartość StorageReference jest nieprawidłowa.
// 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 sprawdzać odwołania, aby lepiej zrozumieć, do których plików prowadzą
metody full_path, name i bucket. Te metody umożliwiają
ścieżkę, nazwę i zasobnik.
// 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 plików referencyjnych
Ścieżki i nazwy odwołań mogą zawierać dowolną sekwencję prawidłowych znaków Unicode, ale nakładane są pewne ograniczenia, takie jak:
- W przypadku kodowania UTF-8 łączna długość parametru reference.fullPath musi wynosić od 1 do 1024 bajtów.
- Brak znaków przejścia do nowej linii lub przejścia do nowej linii.
- Unikaj stosowania atrybutów
#,[,],*lub?– nie działają one dobrze z innych narzędzi, np. Bazy danych czasu rzeczywistego Firebase. lub 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
Na następnej lekcji dowiesz się, prześlij pliki do Cloud Storage.