Создайте ссылку на облачное хранилище на Android

Ваши файлы хранятся в сегменте Cloud Storage . Файлы в этом сегменте представлены в иерархической структуре, подобно файловой системе на локальном жестком диске или данным в Firebase Realtime Database . Создав ссылку на файл, ваше приложение получит к нему доступ. Эти ссылки затем можно использовать для загрузки или загрузки данных, получения или обновления метаданных или удаления файла. Ссылка может указывать либо на конкретный файл, либо на узел более высокого уровня в иерархии.

Если вы использовали Firebase Realtime Database , эти пути должны показаться вам очень знакомыми. Однако данные вашего файла хранятся в Cloud Storage , а не в Realtime Database .

Создать ссылку

Создайте ссылку для загрузки, скачивания или удаления файла, а также для получения или обновления его метаданных. Ссылку можно рассматривать как указатель на файл в облаке. Ссылки легкие, поэтому вы можете создавать столько, сколько вам нужно. Их также можно использовать повторно для нескольких операций.

Создайте ссылку, используя экземпляр Singleton FirebaseStorage и вызвав его метод getReference() .

Kotlin 

// Create a storage reference from our app
var storageRef = storage.reference
StorageActivity.kt

Java 

// Create a storage reference from our app
StorageReference storageRef = storage.getReference();
StorageActivity.java

Затем вы можете создать ссылку на местоположение ниже в дереве, например "images/space.jpg" используя метод child() для существующей ссылки.

Kotlin 

// Create a child reference
// imagesRef now points to "images"
var imagesRef: StorageReference? = storageRef.child("images")

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

Java 

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

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

Вы также можете использовать методы getParent() и getRoot() для навигации вверх по иерархии файлов. getParent() перемещается на один уровень вверх, а getRoot() перемещается до самого верха.

Kotlin 

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

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

Java 

// getParent allows us to move our reference to a parent node
// imagesRef now points to 'images'
imagesRef = spaceRef.getParent();

// getRoot allows us to move all the way back to the top of our bucket
// rootRef now points to the root
StorageReference rootRef = spaceRef.getRoot();
StorageActivity.java

child() , getParent() и getRoot() могут быть объединены несколько раз, поскольку каждый из них возвращает ссылку. Но вызов getRoot().getParent() возвращает null .

Kotlin 

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

// nullRef is null, since the parent of root is null
val nullRef = spaceRef.root.parent
StorageActivity.kt

Java 

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

// nullRef is null, since the parent of root is null
StorageReference nullRef = spaceRef.getRoot().getParent();
StorageActivity.java

Справочные свойства

Вы можете проверять ссылки, чтобы лучше понять файлы, на которые они указывают, используя методы getPath() , getName() и getBucket() . Эти методы получают полный путь, имя и сегмент файла.

Kotlin 

// Reference's path is: "images/space.jpg"
// This is analogous to a file path on disk
spaceRef.path

// 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
StorageActivity.kt

Java 

// Reference's path is: "images/space.jpg"
// This is analogous to a file path on disk
spaceRef.getPath();

// Reference's name is the last segment of the full path: "space.jpg"
// This is analogous to the file name
spaceRef.getName();

// Reference's bucket is the name of the storage bucket that the files are stored in
spaceRef.getBucket();
StorageActivity.java

Ограничения на ссылки

Пути и имена ссылок могут содержать любую последовательность допустимых символов Юникода, но налагаются определенные ограничения, в том числе:

  1. Общая длина reference.fullPath должна составлять от 1 до 1024 байт в кодировке UTF-8.
  2. Нет символов возврата каретки или перевода строки.
  3. Избегайте использования # , [ , ] , * или ? , поскольку они плохо работают с другими инструментами, такими как Firebase Realtime Database или gsutil .

Полный пример

Kotlin 

// Points to the root reference
storageRef = storage.reference

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

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

// File path is "images/space.jpg"
val path = spaceRef.path

// File name is "space.jpg"
val name = spaceRef.name

// Points to "images"
imagesRef = spaceRef.parent
StorageActivity.kt

Java 

// Points to the root reference
storageRef = storage.getReference();

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

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

// File path is "images/space.jpg"
String path = spaceRef.getPath();

// File name is "space.jpg"
String name = spaceRef.getName();

// Points to "images"
imagesRef = spaceRef.getParent();
StorageActivity.java

Далее давайте научимся загружать файлы в Cloud Storage .