[Swift] CoreData 활용해보기 (Subclass 생성법, Double 타입 선언 안되는 이유)

---

 CoreData를 활용해서 작은 프로젝트를 하나 만들어서 연습해볼까합니다! 

< 연습 프로젝트 >
이름, 성별, 나이를 입력한 후
저장 버튼을 누르면, CoreData에 저장되고
전체삭제를 누르면 모든 데이터를 초기화합니다.

0

---

---

① 프로젝트 생성

우선 프로젝트를 하나 생성합니다.
그리고 하단에 CoreData를 선택합니다.

그러면 위와 같이 xcdatamodeld 파일이 자동 생성됩니다.



만약에 프로젝트를 진행중에 CoreData를 추가해야한다면?

Command + N 으로 데이터 모델 파일을 추가하면 됩니다.

② Entity, Attributes, Relationships 설정

이제 하단 Add Entity를 클릭해서 Entity를 추가합니다.

여기서 Entity이름은 중요하니까 잘 기억하기!
(저는 Test프로젝트라 제 이름 Yegr라고 지었습니다 :D)

그리고 + 버튼으로 Attributes 추가합니다. (객체 이름, 타입 설정)
이 부분은 저장할 객체를 추가한다고 생각하시면 됩니다.

기본적으로 타입을 옵셔널로 만들어지는데,
우측 상단 인스펙터 영역을 통해 변경할 수 있습니다.



다음으로 Entity의 Class 하단에 있는 Codegen에 대해서 정리하면,

이렇게! 상황에 맞게 설정해주시면 됩니다!

 

NSManagedObject Subclass 생성 방법

제가 이전에 CoreData를 Attributes가 추가적으로 필요해서
중간에 하나를 더 추가한적이 있는데,
분명 Double? 타입으로 만들었는데도 불구하고
사용하려고 하면 컴파일에서 Double 타입으로 인식되는 문제가 있었습니다.🤯


그래서 Subclass 생성해서 타입을 수동으로 변경해줬습니다.

상단 Editor에서 Create NSManagedObject Subclass를 선택해줍니다.

그럼 이렇게 파일 두개가 생성됩니다.

---

공식 문서를 살펴보면,
https://developer.apple.com/documentation/coredata/modeling_data/generating_code

Generating code | Apple Developer Documentation

 

CoreData는 Entities, Attriubtes 및 relationships을 정의한 후,
Entity 인스턴스를 만드는데 사용할 클래스를 지정합니다.
CoreData는 선택적으로 클래스 파일과 속성 파일이라는 두 개의 파일을 생성합니다.

클래스 파일은 클래스를 NSManagedObject의 하위 클래스로 선언합니다.
속성 파일은 attributes, relationships, 해당 접근자 및 이 유형의 인스턴스를 가져오기 위해 도움을 주는
@NSManaged 속성을 가진 extension으로 선언합니다.

관리되는 객체 서브클래스 생성은 CoreData가 처리하지만,
로직을 추가하거나 속성을 편집해야 할 때는 사용자가 직접 제어할 수 있습니다.

---

네.. 이렇답니다.

상황에 따라 바로 위에 Codegen에 대해 정리했던대로
클래스 정의를 선택할 수 있다는 말인 것 같아요.

그리고 Create NSManagedObject Subclass를 통해 파일을 생성하면,
새 파일은 해당 위치의 기존 파일을 덮어 쓴다는는 점에 유의하라고 적혀있습니다!

 

CoreData Subclass의 Double? 타입이 선언이 안되는 경우

Double? 타입으로 선언하려고 보니,

'Property cannot be marked @NSManaged because its type cannot be represented in Objective-C'

이런 에러 문구가 뜨더라고요..😧


알아보니,
CoreData는 기본적으로 Objective-C와 함께 개발된 프레임워크라서
Swift에서 사용하더라도 일부 Objective-C 특성을 가지고 있다고 합니다.

Objective-C는 Double이라는 타입을 가지고 있지 않고,
대신에 NSNumber 타입을 가지고 있다고 해요.

(Double 타입 말고도 지원하지 않는 타입이 있다고 해요.
사용 시, CoreData에서 지원하지 않는 타입들을 찾아보시면 좋을 것 같습니다!)

extension Yegr {

    @nonobjc class func fetchRequest() -> NSFetchRequest<Yegr> {
        return NSFetchRequest<Yegr>(entityName: "Yegr")
    }

    @NSManaged var aspectRatioValue: NSNumber?
    
    var aspectRatio: Double? {
        get {
            aspectRatioValue?.doubleValue
        }
        set {
            aspectRatioValue = newValue as NSNumber?
        }
    }
}

그래서 위와 같이 Double? 타입이 아닌 NSNumber? 타입으로 선언하고,
Swift에 맞게 계산 프로퍼티를 통해 타입을 변환하여 Double? 타입을 사용할 수 있도록 하였습니다. 😀

③ PersistentContainer 설정

Entity, Attributes, Relationships 등 필요한 설정이 끝낸 후,

AppDelegate에서 관리하는 persistentContainer를 가져올겁니다!
(persistentContainer는 CoreData의 데이터 스택을 관리하는 객체이고,
이 객체를 통해서 CoreData의 NSManagedObjectContext에 접근할 수 있습니다.)

    private func configurePersistentContainer() {
        let appDelegate = UIApplication.shared.delegate as! AppDelegate
        self.container = appDelegate.persistentContainer
    }

이 코드를 통해서 AppDelegate에서 초기화한 persistentContainer를 뷰컨에서 사용할 수 있게 됩니다!
(참고로 NSManagedObjectContext는 CoreData 객체를 다루고, 데이터 추가, 수정, 삭제 작업을 수행하는 객체입니다.)

 

④ 데이터 생성 (Create)

처음에 Entity 설정할 때, 이름 꼭 기억하라고 했던거 기억하시죠?
그 이름을 EntityName에 넣어 해당 Entity를 가져오고, NSManagedObject를 사용해서 새로운 객체를 생성할겁니다.

    private func createEntity(name: String, gender: String, age: Int) {
        if let entity = NSEntityDescription.entity(forEntityName: "Yegr", in: self.container.viewContext) {
            let object = NSManagedObject(entity: entity, insertInto: self.container.viewContext)
            object.setValue(name, forKey: "name")
            object.setValue(gender, forKey: "gender")
            object.setValue(age, forKey: "age")
        }
        
        saveData() // 이 메서드는 다음 설명에 있습니다.
    }

NSEntityDescription.entity(forEntityName: in:)로 "Yegr" 엔티티를 가져오고,
NSManagedObject를 사용해서 새로운 객체를 생성했습니다.

그리고 setValue(forKey:) 메서드를 사용해서 텍스트 필드에서 받은 데이터를 해당 객체의 속성에 설정해줬습니다.
(저는 '저장'버튼을 클릭했을 때, 데이터를 저장하고 싶어서 넣어줄 값은 매개변수로 받아줬습니다.)



⑤ 데이터 저장(Save)

container.viewContext.save()를 호출해서 변경된 데이터를 저장소에 저장합니다.

    private func saveData() {
        do {
            try self.container.viewContext.save()
        } catch {
            print("error!: \(error.localizedDescription)")
        }
    }

⑥ 데이터 불러오기(Fetch)

Yegr.fetchRequest()로 Yegr 엔티티에 대한 데이터를 가져옵니다.

    private func fetchData() -> [Yegr]? {
        do {
            let data = try self.container.viewContext.fetch(Yegr.fetchRequest())
            return data
        } catch {
            print("error!: \(error.localizedDescription)")
        }
        
        return nil
    }

(저는 tableView에 데이터를 보여주기 위해 반환값으로 해당 데이터를 받아주었습니다.)


⑦ 데이터 초기화 (Reset)

NSBatchDeleteRequest를 사용해서 "Yegr" 엔티티의 모든 데이터를 삭제합니다.
execute(deleteRequest)로 삭제 작업을 수행합니다.

    private func resetData() {
        let fetchRequest: NSFetchRequest<NSFetchRequestResult> = NSFetchRequest(entityName: "Yegr")
        let deleteRequest = NSBatchDeleteRequest(fetchRequest: fetchRequest)

        do {
            try container.viewContext.execute(deleteRequest)
        } catch {
            print("Error deleting data: \(error)")
        }
        
        coreDataView.tableView.reloadData() // 전체 삭제 버튼 클릭 후, 테이블뷰 리로드
    }

---

이번 글에서는 CoreData를 사용한 간단한 CRUD작업을 구현하는 방법을 정리해봤습니다.
CoreData는 복잡한 데이터 작업을 간소화해주는 강력한 도구로,
데이터베이스와 객체 모델을 연결하여 객체지향적으로 데이터를 관리할 수 있게 해줍니다.

이번 CoreDataEX 프로젝트를 통해 기본적인 패턴을 이해할 수 있었던 것 같습니다.😆
앞으로도 앱을 개발하면서 기회가 생긴다면 CoreData를 계속 활용해봐야겠네요!


<프로젝트 github 링크>
https://github.com/yeggrrr/CoreDataEX

GitHub - yeggrrr/CoreDataEX: CoreData 연습

---