Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

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

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

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

สร้างข้อมูลอ้างอิง

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

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

Kotlin+KTX

// 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+KTX

// 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() นำทางขึ้นไปหนึ่งระดับ ในขณะที่ getRoot() นำทางไปจนสุด

Kotlin+KTX

// 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+KTX

// 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+KTX

// 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+KTX

// 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 กัน