สร้างข้อมูลอ้างอิงของ Cloud Storage บน Android

ระบบจะจัดเก็บไฟล์ไว้ในที่เก็บข้อมูล Cloud Storage ไฟล์ในที่เก็บข้อมูลนี้จะแสดงในโครงสร้างแบบลำดับชั้น เช่นเดียวกับ ระบบไฟล์ในฮาร์ดดิสก์ในเครื่อง หรือข้อมูลใน Firebase Realtime Database การสร้างการอ้างอิงถึงไฟล์จะทำให้แอปของคุณมีสิทธิ์เข้าถึงไฟล์นั้น จากนั้นคุณจะใช้ข้อมูลอ้างอิงเหล่านี้เพื่ออัปโหลดหรือดาวน์โหลดข้อมูล รับหรืออัปเดตข้อมูลเมตา หรือลบไฟล์ได้ การอ้างอิงอาจชี้ไปยังไฟล์ที่เฉพาะเจาะจงหรือไปยังโหนดระดับที่สูงกว่า ในลำดับชั้นก็ได้

หากคุณเคยใช้ Firebase Realtime Database เส้นทางเหล่านี้จะ ดูคุ้นเคยเป็นอย่างยิ่ง อย่างไรก็ตาม ข้อมูลไฟล์จะจัดเก็บไว้ใน Cloud Storage ไม่ใช่ใน Realtime Database

สร้างการอ้างอิง

สร้างการอ้างอิงเพื่ออัปโหลด ดาวน์โหลด หรือลบไฟล์ หรือเพื่อรับหรืออัปเดตข้อมูลเมตาของไฟล์ คุณสามารถคิดว่าการอ้างอิง เป็นตัวชี้ไปยังไฟล์ในระบบคลาวด์ การอ้างอิงมีขนาดเล็ก คุณจึงสร้างได้มากเท่าที่ต้องการ และยังใช้ซ้ำได้สำหรับการดำเนินการหลายอย่าง

สร้างการอ้างอิงโดยใช้FirebaseStorageอินสแตนซ์ Singleton และ เรียกใช้เมธอด getReference()

Kotlin

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

Java

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

จากนั้นคุณจะสร้างการอ้างอิงไปยังตำแหน่งที่อยู่ลึกลงไปในโครงสร้างได้ เช่น "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")

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");

นอกจากนี้ คุณยังใช้วิธี getParent() และ getRoot() เพื่อไปยังระดับที่สูงขึ้นใน ลำดับชั้นของไฟล์ได้ด้วย getParent() จะเลื่อนขึ้นไป 1 ระดับ ส่วน 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

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();

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

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();

พร็อพเพอร์ตี้อ้างอิง

คุณสามารถตรวจสอบการอ้างอิงเพื่อให้เข้าใจไฟล์ที่อ้างอิงได้ดียิ่งขึ้น โดยใช้วิธีการ 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

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();

ข้อจำกัดในการอ้างอิง

เส้นทางและชื่ออ้างอิงอาจมีลำดับอักขระ Unicode ที่ถูกต้องใดก็ได้ แต่จะมีข้อจำกัดบางอย่าง ได้แก่

  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

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();

ถัดไป เราจะมาดูวิธี อัปโหลดไฟล์ไปยัง Cloud Storageกัน