Firebase Realtime, Firestore DB
Updated:
🔷 Firebase Realtime Database
Firebase Realtime Database official docs - https://firebase.google.com/docs/database/ios/start
특징
-
비관계형 클라우드 데이터 베이스: NoSQL database 로써, 대량의 data를 대규모로 처리하는데, 점점더 많은 데이터들을 수집하고 활용하고 모바일, 웹 개발에 적합한 DB 타입 입니다
-
보통 json 형태로 저장, 관리 되어 사용되는데, 다른 table db 와 관계를 맺지않고, 단독으로 key, value 식으로 하나의 단일 문서 안에 모든 data 를 담는 형태로 사용됩니다
-
실시간으로 처리됨니다: HTTP 요청이 아닌 동기화 방식임
- HTTP: 보통 db와 통신할때 사용하는데 HTTP API (REST API) 값을 서버에 요청이 발생할때 server 를 거쳐서 database 의 data를 받게 됨
- Firebase: realtime db 는 observer 와 snapshot 을 제공하는 SDK 는 클라이언트와 직접 동기화 합니다. realtime db 와 연결된 모든 기기에서 거의 동시에 서버의 변경사항을 실시간으로 반영할 수 있습니다
-
오프라인: 로컬에 저장후 네트워크 연결시 동기화 app 이 오프라인 일때도, 액션에 대한 변경사항을 저장해 주었다가 app 이 다시 네트워크에 연결되었을때, update 하는 기능을 제공 합니다
-
서버 없이 DB와 client 를 직접 액세스 합니다. app 에서 직접 접근하기 위해서 server 가 없어도 db에 직접 연결합니다. 데이터를 read, write 할때 보안 규칙을 위해서 데이터베이스에 대한 접근에 대한 보안, 데이터 검증을 제공하기 때문에 안전하게 db 관리를 할 수 있습니다
🔷 Firebase Cloud Firestore
-
realtime db 와 같이 비관계형 클라우드 데이터베이스 형태입니다
-
사용하고자 하는 app 이 어떠한 특성을 가지고 있느냐에 따라서 권장하는 데이터 베이스가 다른데 Firestore 에서 지원하는 것중에 하나가 Query 기능입니다
-
Query: 데이터 베이스에 정보를 요청하는 것을 의미 합니다 특정 문자열, 데이터를 찾기 위해 사용합니다. 정보를 요청하는 명령문 행위등을 말합니다: Firebase firestore 에서는 고급 쿼리 를 지원합니다
realtime Database vs Cloud Firestore
| Realtime DataBase | Cloud Firestore |
|---|---|
| 기본적인 데이터 동기화 | 고급 쿼리, 정렬, 트랜젝션 |
| 적은양의 데이터가 자주 변경 | 대용량 데이터가 자주 읽힘 |
| 간단한 JSON 트리 | 구조화된 컬렉션 |
| 많은 데이터베이스 | 단일 데이터베이스 |
🔷 Firebase Realtime Database CRUD
Firebase Realtime DB 설치
# Pods for 09_creditCardList
pod 'Firebase/Database'
pod install
Firebase Realtime DB 읽기
// CardListViewController.swift
import FirebaseDatabase
class CardListViewController: UITableViewController {
var ref: DatabaseReference! // Firebase Realtime DB 참조 변수
// MARK: Firebase Realtime DB READ
/*Firebase Database 읽기*/
self.ref = Database.database().reference()
self.ref.observe(.value) { snapshot in
guard let value = snapshot.value as? [String: [String: Any]] else { return }
do {
let jsonData = try JSONSerialization.data(withJSONObject: value)
let cardData = try JSONDecoder().decode([String: CreditCard].self, from: jsonData)
let cardList = Array(cardData.values)
self.creditCardList = cardList.sorted { $0.rank < $1.rank }
DispatchQueue.main.async {
self.tableView.reloadData()
}
} catch let error {
print("Error json parsing \(error)")
}
}
Firebase Realtime DB 쓰기
// in CardListViewController.swift
// MARK: Firebase realtime DB Write
let cardID = creditCardList[indexPath.row].id
//option1: 경로를 아는 경우에 쓰기
self.ref.child("Item\(cardID)/isSelected").setValue(true)
//option2: 경로를 모르는 경우
self.ref.queryOrdered(byChild: "id").queryEqual(toValue: cardID).observe(.value) {[weak self] snapshot in
guard let self = self,
let value = snapshot.value as? [String: [String: Any]],
let key = value.keys.first else { return }
self.ref.child("\(key)/isSelected").setValue(true)
}
Firebase Realtime DB 삭제
// forRowAt: cell delete
override func tableView(_ tableView: UITableView, commit editingStyle: UITableViewCell.EditingStyle, forRowAt indexPath: IndexPath) {
if editingStyle == .delete {
// MARK: Firebase realtime DB Delete
let cardID = creditCardList[indexPath.row].id
self.ref.queryOrdered(byChild: "id").queryEqual(toValue: cardID).observe(.value) {[weak self] snapshot in
guard let self = self,
let value = snapshot.value as? [String: [String: Any]],
let key = value.keys.first else { return }
self.ref.child(key).removeValue()
}
...
🔷 Firestore Database CRUD
Firebase Firestore 설치
Get started with Cloud Firestore - https://firebase.google.com/docs/firestore/quickstart#ios+
# Pods for 09_creditCardList
pod 'Firebase/Firestore'
pod 'FirebaseFirestoreSwift'
pod install
Firebase firestore 에 데이터 입력
- firestore 에는 json 파일을 web console 을 통해서 한번에 바로 입력하는 기능이 없기 때문에 code swift 에서 dummy data 를 import 하는 과정을 거져야 합니다.
// in CreditCardDummy.swift
import Foundation
struct CreditCardDummy {
static let card0 = CreditCard(id: 0, rank: 1, name: "신한카드", cardImageURL: "https://www.shinhancard.com/_ICSFiles/afieldfile/2019/04/26/190426_pc_mrlife_cardplate600x380.png", promotionDetail: PromotionDetail(companyName: "신한", period: "2023.01.07(목)~2023.01.31(토)", amount: 13, condition: "온라인 채널을 통해 이벤트 카드를 보유하고, 혜택조건을 충족하신 분", benefitCondition: "이벤트 카드로 결제한 금액이 합해서 10만원이상 결제", benefitDetail: "현금 10만원", benefitDate: "2023.03.01(월)이후"), isSelected: nil)
static let card1 = CreditCard(id: 1
......
// in AppDelegate.swift
import FirebaseFirestoreSwift
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// firebase init
FirebaseApp.configure()
// firebase db 선언
let db = Firestore.firestore()
// collection 에서 creditCardList 를 찾고, snapshot 과 error 를 불러옴(해당 db에 데이터가 없을 경우에 한번에 데이터를 넣어 주는 경우 사용)
db.collection("creditCardList").getDocuments { snapshot, _ in
guard snapshot?.isEmpty == true else { return } // snapshot 으로 db가 비어 있는 상태에서만 ture 로 설정
let batch = db.batch()
let card0Ref = db.collection("creditCardList").document("card0")
let card1Ref = db.collection("creditCardList").document("card1")
let card2Ref = db.collection("creditCardList").document("card2")
let card3Ref = db.collection("creditCardList").document("card3")
let card4Ref = db.collection("creditCardList").document("card4")
let card5Ref = db.collection("creditCardList").document("card5")
let card6Ref = db.collection("creditCardList").document("card6")
let card7Ref = db.collection("creditCardList").document("card7")
let card8Ref = db.collection("creditCardList").document("card8")
let card9Ref = db.collection("creditCardList").document("card9")
do {
try batch.setData(from: CreditCardDummy.card0, forDocument: card0Ref)
try batch.setData(from: CreditCardDummy.card1, forDocument: card1Ref)
try batch.setData(from: CreditCardDummy.card2, forDocument: card2Ref)
try batch.setData(from: CreditCardDummy.card3, forDocument: card3Ref)
try batch.setData(from: CreditCardDummy.card4, forDocument: card4Ref)
try batch.setData(from: CreditCardDummy.card5, forDocument: card5Ref)
try batch.setData(from: CreditCardDummy.card6, forDocument: card6Ref)
try batch.setData(from: CreditCardDummy.card7, forDocument: card7Ref)
try batch.setData(from: CreditCardDummy.card8, forDocument: card8Ref)
try batch.setData(from: CreditCardDummy.card9, forDocument: card9Ref)
} catch let error {
print("ERROR: wirting card to Firestore \(error.localizedDescription)")
}
// batch 에 commit 을 해주어야지 data 가 추가가 됨
batch.commit()
}
return true
}
- app build 후에 firestore 에서 data 가 import 된 것을 확인 할 수 있습니다
firebase Firestore 읽기
import UIKit
import Kingfisher
import FirebaseFirestore
// UITableViewController 는 UITableView 에 필요한 delegate source 를 기본 연결된 상태로 제공하기 때문에 별도로 delegate 선언을 하지 않아도 됨
// 또, rootView 로 UItableView 를 가지게 됩니다
class CardListViewController: UITableViewController {
// DB 선언
var db = Firestore.firestore()
// MARK: Variable
var creditCardList: [CreditCard] = []
// MARK: LifeCycle
override func viewDidLoad() {
super.viewDidLoad()
// UITabelView Cell Register
let nibName = UINib(nibName: "CardListCell", bundle: nil)
tableView.register(nibName, forCellReuseIdentifier: "CardListCell")
// firestore 읽기 code 추가
db.collection("creditCardList").addSnapshotListener { snapshot , error in
guard let documents = snapshot?.documents else {
// 값이 없을 경우에 error 처리
print("ERROR Firesotre fetching document \(String(describing: error))")
return
}
// 데이터 처리 : compactMap 을 사용하는 것을 nil 값을 배열 안에 넣지 않게 하지 위해서
self.creditCardList = documents.compactMap { doc -> CreditCard? in
do {
let jsonData = try JSONSerialization.data(withJSONObject: doc.data(), options: [])
let creditCard = try JSONDecoder().decode(CreditCard.self, from: jsonData)
return creditCard
} catch let error {
print("ERROR JSON Parsing \(error)")
return nil
}
}.sorted { $0.rank < $1.rank }
// main tread 에서 돌아가는 tableView reload
DispatchQueue.main.async {
self.tableView.reloadData()
}
}
}
}
firebase Firestore 쓰기
-
struct model 에 있는
isSelected: Bool?을 갑을 통해 선택되면 select 가 되게끔 firestore 에 값 입력하기 입니다 -
파일의 경로를 알때와 모를때 두가지 경우에 수에 따라 code 방식이 다름
// in CardListViewController.swift
// didSelectRowAt: cell 을 선택 했을때, CardDetailViewController 로 넘어가는 action
override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
// 상세화면 전달
let storyboard = UIStoryboard(name: "Main", bundle: Bundle.main)
guard let detailViewController = storyboard.instantiateViewController(withIdentifier: "CardDetailViewController") as? CardDetailViewController else { return }
detailViewController.promotionDetail = creditCardList[indexPath.row].promotionDetail
self.show(detailViewController, sender: nil)
// Firestore 데이터 쓰기
// option1 : 경로를 알고 있을 경우
let cardID = creditCardList[indexPath.row].id
db.collection("creditCardList").document("card\(cardID)").updateData(["isSelected": true])
// option2: 경로를 모르고 있을 경우
// id 값을 검색한다음에 그 결과로 찾은 문서에 업데이트 해줘야함
db.collection("creditCardList").whereField("id", isEqualTo: cardID).getDocuments { snapshot, _ in
guard let document = snapshot?.documents.first else {
// error 처리
print("ERROR Firestore fetching document")
return
}
// cardID 가 있다면
document.reference.updateData(["isSelected": true])
}
}
항목을 클릭한 값에 data field 에 isSelected: true 가 생성됨을 확인
firebase Firestore 삭제
// in CardListViewController.swift
// forRowAt: cell delete
override func tableView(_ tableView: UITableView, commit editingStyle: UITableViewCell.EditingStyle, forRowAt indexPath: IndexPath) {
if editingStyle == .delete {
// firestore 의 삭제
// Option 1: 경로를 알고 있을때
let cardID = creditCardList[indexPath.row].id
// db.collection("creditCardList").document("card\(cardID)").delete()
// Option 2: 경로를 모르고 있을때 : wherefield method 를 통해 문서 전체를 검색한 후에 snpshot 을 제공함
db.collection("creditCardList").whereField("id", isEqualTo: cardID).getDocuments { snapshot, _ in
guard let document = snapshot?.documents.first else {
print("ERROR")
return
}
document.reference.delete()
}
}
}
For more Details Code - https://github.com/jacobkosmart/creditCard-iOS-practice
🔶 🔷 📌 🔑 👉
🗃 Reference
creditCard-iOS-practice code - https://github.com/jacobkosmart/creditCard-iOS-practice
LEEO TIL Dev Log - https://dev200ok.blogspot.com/2020/09/ios-kingfisher.html
fastcampus - https://fastcampus.co.kr/dev_online_iosappfinal
Leave a comment