Cloud Storage dla Firebase umożliwia wyświetlanie zawartości Zasobnik Cloud Storage. Pakiety SDK zwracają zarówno elementy, jak i prefiksy obiektów w bieżącym odwołaniach Cloud Storage.
Projekty korzystające z interfejsu List API wymagają Cloud Storage dla Firebase Reguły w wersji 2. Jeśli masz już projekt Firebase, wykonaj czynności opisane w sekcji Przewodnik po regułach zabezpieczeń.
Funkcja list()
używa funkcji
Interfejs Google Cloud Storage List API.
W Cloud Storage dla Firebase używamy /
jako separatora, który pozwala nam
emulować semantykę systemu plików. Aby umożliwić sprawne przemierzanie dużych,
hierarchicznych zasobników Cloud Storage, interfejs List API zwraca prefiksy
elementów oddzielnie. Jeśli na przykład prześlesz 1 plik /images/uid/file1
,
root.child('images').listAll()
zwraca prefiks/images/uid
.root.child('images/uid').listAll()
zwróci plik jako element.
Pakiet SDK Cloud Storage dla Firebase nie zwraca ścieżek obiektów zawierających dwa
następujących po sobie znaków /
lub kończy się znakiem /
. Weźmy na przykład zasobnik z
następujące obiekty:
correctPrefix/happyItem
wrongPrefix//sadItem
lonelyItem/
Operacje wyświetlania listy elementów w tym zasobniku dają następujące wyniki:
- Operacja na liście na poziomie głównym zwraca odwołania do
correctPrefix
,wrongPrefix
ilonelyItem
jakoprefixes
. - Operacja listy na elemencie
correctPrefix/
zwraca odwołania docorrectPrefix/happyItem
jakoitems
. - Operacja na liście w
wrongPrefix/
nie zwraca żadnych odwołań ponieważwrongPrefix//sadItem
zawiera dwa kolejne elementy/
. - Operacja na liście w
lonelyItem/
nie zwraca żadnych odwołań ponieważ obiektlonelyItem/
kończy się na/
.
Wyświetl wszystkie pliki
Aby pobrać wszystkie wyniki z katalogu, możesz użyć narzędzia listAll
.
Najlepiej sprawdza się to w przypadku małych katalogów, ponieważ wszystkie wyniki są buforowane w pamięci.
Operacja może też nie zwrócić spójnego zrzutu, jeśli obiekty zostały dodane lub
usunięte w trakcie tego procesu.
W przypadku dużej listy użyj metody list()
z podziałem na strony, ponieważ listAll()
buforuje wszystko
w pamięci.
Poniższy przykład pokazuje listAll
.
Kotlin+KTX
val storage = Firebase.storage val listRef = storage.reference.child("files/uid") // You'll need to import com.google.firebase.storage.component1 and // com.google.firebase.storage.component2 listRef.listAll() .addOnSuccessListener { (items, prefixes) -> for (prefix in prefixes) { // All the prefixes under listRef. // You may call listAll() recursively on them. } for (item in items) { // All the items under listRef. } } .addOnFailureListener { // Uh-oh, an error occurred! }
Java
StorageReference listRef = storage.getReference().child("files/uid"); listRef.listAll() .addOnSuccessListener(new OnSuccessListener<ListResult>() { @Override public void onSuccess(ListResult listResult) { for (StorageReference prefix : listResult.getPrefixes()) { // All the prefixes under listRef. // You may call listAll() recursively on them. } for (StorageReference item : listResult.getItems()) { // All the items under listRef. } } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // Uh-oh, an error occurred! } });
Wyniki dotyczące listy stron
Liczba zwracanych wyników interfejsu API list()
jest ograniczona. list()
zapewnia spójną odsłonę i ujawnia element pageToken, który umożliwia kontrolę nad
kiedy pobrać dodatkowe wyniki.
pageToken koduje ścieżkę i wersję ostatniego elementu zwróconego w metodzie poprzedniego wyniku. W kolejnym żądaniu używającym parametru pageToken, elementy pojawiające się po wyświetleniu tokena pageToken.
Ten przykład ilustruje dzielenie wyniku na strony:
Kotlin+KTX
fun listAllPaginated(pageToken: String?) { val storage = Firebase.storage val listRef = storage.reference.child("files/uid") // Fetch the next page of results, using the pageToken if we have one. val listPageTask = if (pageToken != null) { listRef.list(100, pageToken) } else { listRef.list(100) } // You'll need to import com.google.firebase.storage.component1 and // com.google.firebase.storage.component2 listPageTask .addOnSuccessListener { (items, prefixes, pageToken) -> // Process page of results processResults(items, prefixes) // Recurse onto next page pageToken?.let { listAllPaginated(it) } }.addOnFailureListener { // Uh-oh, an error occurred. } }
Java
public void listAllPaginated(@Nullable String pageToken) { FirebaseStorage storage = FirebaseStorage.getInstance(); StorageReference listRef = storage.getReference().child("files/uid"); // Fetch the next page of results, using the pageToken if we have one. Task<ListResult> listPageTask = pageToken != null ? listRef.list(100, pageToken) : listRef.list(100); listPageTask .addOnSuccessListener(new OnSuccessListener<ListResult>() { @Override public void onSuccess(ListResult listResult) { List<StorageReference> prefixes = listResult.getPrefixes(); List<StorageReference> items = listResult.getItems(); // Process page of results // ... // Recurse onto next page if (listResult.getPageToken() != null) { listAllPaginated(listResult.getPageToken()); } } }).addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // Uh-oh, an error occurred. } }); }
Obsługa błędów
list()
i listAll()
nie powiodły się, jeśli nie uaktualnisz aplikacji
reguły zabezpieczeń do wersji 2. Jeśli widzisz tę informację, uaktualnij reguły zabezpieczeń
błąd:
Listing objects in a bucket is disallowed for rules_version = "1".
Please update storage security rules to rules_version = "2" to use list.
Inne możliwe błędy mogą wskazywać, że użytkownik nie ma odpowiednich uprawnień. Więcej informacji o błędach znajdziesz w Obsługa błędów.