데이터매퍼 어댑터 개발하기: DataMapper ORM과 백엔드 저장소 연결

DataMapper 어댑터 개발은 다음 다섯 가지 핵심 기능 구현을 요구합니다.

1. 연결 및 초기화

• initialize 메서드에서 super 호출 후 데이터베이스에 연결합니다.
• adapter 메서드를 통해 원시(raw) 드라이버 접근을 제공하는 것이 관례입니다.
• field_naming_convention 및 resource_naming_convention을 정의하여 DataMapper 속성/클래스 이름을 저장소의 명명 규칙에 맞게 변환할 수 있습니다.

2. 레코드 생성 (Create)

• create 메서드는 resources 배열을 처리합니다.
• attributes_as_fields 메서드는 DataMapper의 비마샬링된 데이터를 저장소의 필드명과 데이터 타입에 맞게 마샬링하는 데 필수적입니다.
• 생성 후에는 저장된 레코드 수를 반환해야 하며, 예외 없이는 DataMapper가 성공으로 간주합니다.

3. 레코드 조회 (Read)

• read 메서드는 DataMapper::Query 인스턴스를 받아 비마샬링된 해시 배열을 반환합니다.
• DataMapper::Query 객체를 저장소의 네이티브 쿼리 언어로 파싱하는 것이 핵심입니다. 쿼리는 Operation과 Condition으로 구성됩니다.
• 연관 관계 처리: DataMapper는 백엔드 독립성을 위해 JOIN 대신 여러 개의 개별 쿼리를 실행합니다. condition.value가 비마샬링된 resources 배열로 제공될 경우, 이를 저장소가 이해할 수 있는 형태로 변환해야 합니다.

4. 레코드 삭제 (Delete)

• destroy 메서드는 DataMapper::Collection 객체를 받으며, collection.query를 통해 DataMapper::Query 객체를 얻어 파싱 후 삭제를 수행합니다.

5. 레코드 업데이트 (Update)

• update 메서드는 changes 해시를 받아 attributes_as_fields를 사용하여 마샬링한 후 업데이트를 수행합니다.

기타 중요 고려사항

• 로깅: 어댑터가 저장소에 명령을 보낼 때마다 info 레벨로 로깅하여 사용자 디버깅을 돕는 것이 중요합니다.
• 모델 확장 및 고유 기능 활용: DataMapper는 모델 확장을 통해 저장소의 고유 기능을 통합할 수 있습니다. 예를 들어, MongoDB의 BSON ID를 resource.key로 반환하려면, 모델에 property :_id를 추가하고 create 메서드에서 ID 처리 및 resource.key.clear_cache 호출을 통해 캐시를 갱신해야 합니다.