책 검색 앱 (4)

Open API란?

• Open Application Programming Interface

• 특정 서비스나 소프트웨어 기능을 외부 개발자가 사용할 수 있도록 정의한 인터페이스

• 우리가 사용할 네이버 책 검색 API의 경우 우리가 검색어를 네이버에 요청하면 네이버에서 그에 대한 결과를 JSON 형태로 반환해주는 서비스

네이버 책 검색 Open API 키 발급

오픈 API 사용 규정 확인하기

API 호출하기

요 아이콘 (Extensions) 클릭

응답값(JSON)을 객체화 처리하기 = 모델 클래스 생성

1. 변수 선언 & 기본 생성자

// {
//       "title": "Harry",
//       "link": "https://search.shopping.naver.com/book/catalog/54297850481",
//       "image": "https://shopping-phinf.pstatic.net/main_5429785/54297850481.20250419202246.jpg",
//       "author": "",
//       "discount": "0",
//       "publisher": "Anson Street Press",
//       "pubdate": "20250328",
//       "isbn": "9781023086219",
//       "description": "\"Harry\" by Fanny Wheeler Hart offers a poignant glimpse into American domestic life through verse. This collection of biographical poetry explores themes of childhood and family, painted with the delicate brushstrokes of personal experience. Hart's work provides a window into a specific time, yet the emotions and experiences it captures resonate across generations."
//     }
// cf. 주석처리 하고자 하는 여러 라인을 드래그하여 `ctrl+?` 또는 `command+?`를 누르면 일괄 주석처리 됨.


class Book {
  String title;
  String link;
  String image;
  String author;
  String discount;
  String publisher;
  String pubdate;
  String isbn;
  String description;

  Book({
    required this.title,
    required this.link,
    required this.image,
    required this.author,
    required this.discount,
    required this.publisher,
    required this.pubdate,
    required this.isbn,
    required this.description,
  });
}

2. fromJson 네임드 생성자 & toJson 메서드 만들기

// 1. fromJson 네임드 생성자 만들기
Book.fromJson(Map<String, dynamic> map) : this(
  title: map['title'],
  link: map['link'],
  image: map['image'],
  author: map['author'],
  discount: map['discount'],
  publisher: map['publisher'],
  pubdate: map['pubdate'],
  isbn: map['isbn'],
  description: map['description'],
);

// 2. toJson 메서드 만들기
Map<String, dynamic> toJson() {
  return {
    'title': title,
    'link': link,
    'image': image,
    'author': author,
    'discount': discount,
    'publisher': publisher,
    'pubdate': pubdate,
    'isbn': isbn,
    'description': description
  };
}

3. 모델 클래스 테스트

1. test 파일 생성

 

import 'package:flutter_test/flutter_test.dart';

void main() {
  test('Book model test', () { // <- test() 함수 호출 시 자동완성에 의해 flutter_test.dart를 import하라는 메세지가 나옴. 그걸 적용해주어야 함. test("여기에는 테스트 내용 적고", () {여기에는 실행할 데이터 넣어줌}); <- 함수니까 마무리에는 세미콜론 넣어줘야.
    String dummyData = ''' // <- 모델 클래스에 주석처리해두었던 것을 복붙 후 주석 해제
      {
      "title": "Harry",
      "link": "https://search.shopping.naver.com/book/catalog/54297850481",
      "image": "https://shopping-phinf.pstatic.net/main_5429785/54297850481.20250419202246.jpg",
      "author": "",
      "discount": "0",
      "publisher": "Anson Street Press",
      "pubdate": "20250328",
      "isbn": "9781023086219",
      "description": "\"Harry\" by Fanny Wheeler Hart offers a poignant glimpse into American domestic life through verse. This collection of biographical poetry explores themes of childhood and family, painted with the delicate brushstrokes of personal experience. Hart's work provides a window into a specific time, yet the emotions and experiences it captures resonate across generations."
    }
''';
  });
}

2. Map으로 변환 → 3. 객체로 변환

import 'dart:convert';

import 'package:book_search/data/models/book.dart';
import 'package:flutter_test/flutter_test.dart';

void main() {
  test('Book model test', () {
    String dummyData = '''
      {
      "title": "Harry",
      "link": "https://search.shopping.naver.com/book/catalog/54297850481",
      "image": "https://shopping-phinf.pstatic.net/main_5429785/54297850481.20250419202246.jpg",
      "author": "",
      "discount": "0",
      "publisher": "Anson Street Press",
      "pubdate": "20250328",
      "isbn": "9781023086219",
      "description": "\"Harry\" by Fanny Wheeler Hart offers a poignant glimpse into American domestic life through verse. This collection of biographical poetry explores themes of childhood and family, painted with the delicate brushstrokes of personal experience. Hart's work provides a window into a specific time, yet the emotions and experiences it captures resonate across generations."
    }
''';
// 1. Map으로 변환
Map<String,dynamic> map = jsonDecode(dummyData);

// 2. 객체로 변환
Book book = Book.fromJson(map);
expect(book.pubdate, '20250328'); // 왼쪽에는 실제값, 오른쪽에는 기대값을 넣어줌. 왼쪽과 오른쪽의 값이 다르면 테스트가 종료되면서 fail을 리턴함.

  });
}

4. test 실행하기

5. toJson() 정상 작동 확인