Utwórz referencję Cloud Storage w Cloud Storage dla C++

Pliki są przechowywane w Cloud Storage. są wyświetlane w strukturze hierarchicznej, tak jak systemu plików na lokalnym dysku twardym lub danych w pamięci masowej Firebase Realtime Database. 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 używasz ścieżki Firebase Realtime Database, te ścieżki powinny wydają się znajome. Dane plików są jednak przechowywane w Cloud Storage, nie w: Realtime Database.

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 Miejsce na dane 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");

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:

  1. W przypadku kodowania UTF-8 łączna długość parametru reference.fullPath musi wynosić od 1 do 1024 bajtów.
  2. Brak znaków przejścia do nowej linii lub przejścia do nowej linii.
  3. Unikaj stosowania atrybutów #, [, ], * lub ? – nie działają one dobrze z inne narzędzia, takie jak Firebase Realtime Database. 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