Эта страница переведена с помощью Cloud Translation API.

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

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

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

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

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

Чтобы создать ссылку, получите экземпляр службы хранилища с помощью getStorage() а затем вызовите ref() с службой в качестве аргумента. Эта ссылка указывает на корень вашего сегмента Cloud Storage .

Web

import { getStorage, ref } from "firebase/storage";

// Get a reference to the storage service, which is used to create references in your storage bucket
const storage = getStorage();

// Create a storage reference from our storage service
const storageRef = ref(storage);storage_create_ref.js

Web

// Get a reference to the storage service, which is used to create references in your storage bucket
var storage = firebase.storage();

// Create a storage reference from our storage service
var storageRef = storage.ref();create-reference.js

Вы можете создать ссылку на местоположение ниже в дереве, скажем 'images/space.jpg' передав этот путь в качестве второго аргумента при вызове ref() .

Web

import { getStorage, ref } from "firebase/storage";

const storage = getStorage();

// Create a child reference
const imagesRef = ref(storage, 'images');
// imagesRef now points to 'images'

// Child references can also take paths delimited by '/'
const spaceRef = ref(storage, 'images/space.jpg');
// spaceRef now points to "images/space.jpg"
// imagesRef still points to "images"storage_create_ref_child.js

Web

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

// Child references can also take paths delimited by '/'
var spaceRef = storageRef.child('images/space.jpg');
// spaceRef now points to "images/space.jpg"
// imagesRef still points to "images"create-reference.js

Навигация с помощью ссылок

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

Web

import { getStorage, ref } from "firebase/storage";

const storage = getStorage();
const spaceRef = ref(storage, 'images/space.jpg');

// Parent allows us to move to the parent of a reference
const imagesRef = spaceRef.parent;
// imagesRef now points to 'images'

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

Web

// Parent allows us to move to the parent of a reference
var imagesRef = spaceRef.parent;
// imagesRef now points to 'images'

// Root allows us to move all the way back to the top of our bucket
var rootRef = spaceRef.root;
// rootRef now points to the rootcreate-reference.js

child() , parent и root могут быть объединены в цепочку несколько раз, поскольку каждый из них возвращает ссылку. Исключением является parent элемент root , который имеет null .

Web

import { getStorage, ref } from "firebase/storage";

const storage = getStorage();
const spaceRef = ref(storage, 'images/space.jpg');

// References can be chained together multiple times
const earthRef = ref(spaceRef.parent, 'earth.jpg');
// earthRef points to 'images/earth.jpg'

// nullRef is null, since the parent of root is null
const nullRef = spaceRef.root.parent;storage_navigate_ref_chain.js

Web

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

// nullRef is null, since the parent of root is null
var nullRef = spaceRef.root.parent;create-reference.js

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

Вы можете проверять ссылки, чтобы лучше понять файлы, на которые они указывают, используя свойства fullPath , name и bucket . Эти свойства получают полный путь к файлу, имя файла и корзину, в которой хранится файл.

Web

import { getStorage, ref } from "firebase/storage";

const storage = getStorage();
const spaceRef = ref(storage, 'images/space.jpg');

// 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 where files are stored
spaceRef.bucket;storage_ref_properties.js

Web

// 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 where files are stored
spaceRef.bucket;create-reference.js

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

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

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

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

Web

import { getStorage, ref } from "firebase/storage";

const storage = getStorage();

// Points to the root reference
const storageRef = ref(storage);

// Points to 'images'
const imagesRef = ref(storageRef, 'images');

// Points to 'images/space.jpg'
// Note that you can use variables to create child values
const fileName = 'space.jpg';
const spaceRef = ref(imagesRef, fileName);

// File path is 'images/space.jpg'
const path = spaceRef.fullPath;

// File name is 'space.jpg'
const name = spaceRef.name;

// Points to 'images'
const imagesRefAgain = spaceRef.parent;storage_ref_full_example.js

Web

// Points to the root reference
var storageRef = firebase.storage().ref();

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

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

// File path is 'images/space.jpg'
var path = spaceRef.fullPath;

// File name is 'space.jpg'
var name = spaceRef.name;

// Points to 'images'
var imagesRef = spaceRef.parent;create-reference.js

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