Tworzenie referencji Cloud Storage w Flutter

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 bazie danych 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 lub pobierania danych, uzyskiwania lub aktualizowania metadanych albo usuwania pliku. Odwołanie może wskazywać konkretny plik lub węzeł wyższego poziomu w hierarchii.

Jeśli korzystasz z Bazy danych czasu rzeczywistego Firebase, te ścieżki powinny być Ci dobrze znane. Dane plików są jednak przechowywane w Cloud Storage, a nie w bazie danych czasu rzeczywistego.

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.

Utwórz odwołanie za pomocą instancji singletona FirebaseStorage i wywołaj jego metodę ref().

final storageRef = FirebaseStorage.instance.ref();

Następnie możesz utworzyć odwołanie do lokalizacji znajdującej się niżej w drzewie, np. "images/space.jpg", za pomocą metody child() w istniejącym odwołaniu.

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

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

Możesz też użyć właściwości parent i root, aby przejść wyżej w hierarchii plików. parent przenosi o 1 poziom wyżej, a root przenosi na samą górę.

// parent allows us to move our reference to a parent node
// imagesRef2 now points to 'images'
final imagesRef2 = spaceRef.parent;

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

child(), parent i root można łączyć ze sobą wielokrotnie, ponieważ każdy z nich jest odwołaniem. Dostęp do root.parent powoduje jednak null.

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

// nullRef is null, since the parent of root is null
final nullRef = spaceRef.root.parent;

Właściwości referencyjne

Możesz sprawdzić odwołania, aby lepiej zrozumieć, do jakich plików się odnoszą, za pomocą właściwości fullPath, name i bucket. Te właściwości 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
spaceRef.fullPath;

// 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;

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.:

  1. Łączna długość pola reference.fullPath musi wynosić od 1 do 1024 bajtów po zakodowaniu w formacie UTF-8.
  2. Nie używaj znaków powrotu karetki ani znaku nowego wiersza.
  3. Unikaj używania znaków #, [, ], * i ?, ponieważ nie działają one prawidłowo z innymi narzędziami, takimi jak Baza danych czasu rzeczywistego Firebase czy gsutil.

Pełny przykład

// Points to the root reference
final storageRef = FirebaseStorage.instance.ref();

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

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

// File path is "images/space.jpg"
final path = spaceRef.fullPath;

// File name is "space.jpg"
final name = spaceRef.name;

// Points to "images"
imagesRef = spaceRef.parent;

Następnie dowiedz się, jak przesyłać pliki do Cloud Storage.