Home

✔ 뷰어로 보기

Android

2017.03.15 09:26

json 데이터 다루기 - GSon 사용법

조회 수 11056 댓글 0

단축키

Prev이전 문서

Next다음 문서

가 + - Up Down Comment Print

단축키

Prev이전 문서

Next다음 문서

가 + - Up Down Comment Print

1. 기본 JSON API(org.json.*)의 불편함

1-1. Checked Exception을 던진다

기본 API를 쓰면서 try/catch 문이 가장 불편했다. 대부분 간단한 형식의 JSON 을 쓰기 때문에 예외가 발생할 상황은 거의 없었다. 하지만 기본 API는 Checked Exception을 던지기 때문에 빈 try/catch 문이라도 만들어야 했다. Gson을 사용하면 이런 상황을 피할 수 있다. Gson은 Runtime Exception을 던지기 때문에 필요한 사람만 try/catch문을 만들면 된다.

1-2. JSON 으로 DAO를 만들 때 할 일이 많다

기본 API로 DAO를 만들려면 JSONObject/JSONArray의 get()를 호출해서 값을 읽고, DAO객체에 값을 설정해야한다. 기본 API는 손이 많이 간다. Gson을 사용하면 더 간단하게 코딩할 수 있다.

2. 이클립스에서 Gson 설정하기

2-1. 라이브러리 다운로드 하기

gson-github 홈페이지의 'Gson Downloads'에 나오는 링크를 클릭해서 gson-maven 페이지로 이동한다.

gson-maven 홈페이지의 아래쪽에 배포 가능한 라이브러리 목록이 있다. 알맞은 라이브러리를 다운로드한다.

2-2. 이클립스 프로젝트에 라이브러리 추가하기

Prpject > Properties > Java Build Path > Libraries > 'Add External JARs...'를 선택해서 라이브러리를 추가한다.

2-3. Could not find class ‘com.google.gson.Gson’ 에러 피하기

라이브러리를 추가하고 바로 코딩하면 이런 에러 메시지를 볼 수 있다.

아래처럼 추가 설정을하면 에러를 피할 수 있다.

Prpject > Properties > Java Build Path > Order and Export에서 추가한 Gson라이브러리를 체크한다. (그래도 에러가 발생하면, 'Up 버튼'으로 Gson의 순서를 높여주자.)

3. Gson 사용법

3-1. 단일블록 JSON 파싱하기

Gson 클래스(com.google.gson.Gson)를 사용하면 단일블록(JSON 객체/배열)의 데이터변환(JSON ↔ Java)을 쉽게 할 수 있다. 아래의 예제코드에서 Gson 클래스의 사용법을 보자.

3-1-1. JSON 객체 파싱하기

기본설정으로 Gson을 사용하려면 변수이름을 지을 때 주의해야 한다. JSON객체와 Java객체의 변수이름을 똑같이 만들어야 한다. 예를 들어 JSON객체의 변수이름으로 'phone_number'를 만들었다면 Java객체(Person)의 변수이름도 'phone_number'로 만들어야한다.

@Test
public void jsonToJava() {
  Gson gson = new Gson();
  String json = "{'name':'김태희', 'phone_number':'010-1234-5678'}";
  Person java = gson.fromJson(json, Person.class);
  assertEquals("김태희", java.name);
  assertEquals("010-1234-5678", java.phone_number);
}
 
@Test
public void javaToJson() {
  Gson gson = new Gson();
  Person java = new Person("김태희", "010-1234-5678");
  String json = gson.toJson(java);
  assertEquals("{\"name\":\"김태희\",\"phone_number\":\"010-1234-5678\"}", json);
}
 
static class Person {
  String name;
  String phone_number;
 
  Person(String name, String phoneNumber) {
    this.name = name;
    this.phone_number = phoneNumber;
  }
}

3-1-2. JSON 배열 파싱하기

@Test
public void parseArray() {
  Gson gson = new Gson();
  assertArrayEquals("JSON=>java", new int[] {1,2,3}, gson.fromJson("[1,2,3]", int[].class));
  assertEquals("java=>JSON", "[1,2,3]", gson.toJson(new int[] {1,2,3}));
}

3-2. 다중블록 JSON 파싱하기

흔히 JSON 으로 데이터를 주고 받을 때 여러 개의 블록으로 묶어서 사용한다. 다중블록 JSON 파싱은 아래 순서대로 하면 된다.

(1) JsonParser로 JSON 의 최상위 노드를 만든다.

(2) [반복] JsonObject/JsonArray로 원하는 노드를 찾는다.

(3) Gson으로 DAO객체를 만든다.

private static String JSON_DATA =
  "{'muses':"
  + "["
    + "{'name':'김태희', phone_number='010-1234-5678'}, "
    + "{'name':'유라'}"
  + "]"
+ "}";
 
@Test
public void twoDepthJsonToJava() {
  JsonObject root = new JsonParser().parse(JSON_DATA).getAsJsonObject();
  JsonArray subnode = root.get("muses").getAsJsonArray();
  Gson gson = new Gson();
     
  Person firstGirl = gson.fromJson(subnode.get(0), Person.class);
  assertEquals("김태희", firstGirl.name);
  assertEquals("010-1234-5678", firstGirl.phone_number);
         
  Person secondGirl = gson.fromJson(subnode.get(1), Person.class);
  assertEquals("유라", secondGirl.name);
  assertEquals(null, secondGirl.phone_number);
}

[깨알팁] optional data의 기본 값으로 null 대신 빈 문자열 설정하기

위 예제코드에서 JSON 객체는 name과 phone_number라는 변수가 있다. name은 모든 객체가 갖고 있어야하는 '필수 데이터'이고 phone_number는 '옵션(선택적 입력) 데이터'이다.

Gson은 JSON객체에서 Java객체을 만들 때, 갖고 있지 않은 데이터는 기본 값으로 설정한다. int, float 등 primitive type은 0으로 설정하고, reference type은 null로 설정한다. 위의 예제코드에서 secondGirl.phone_number에 null값이 들어가 있는 이유도 이런 규칙 때문이다.

레퍼런스 변수에 null값이 하나라도 들어있으면 null체크 코드를 만들어야 한다. 때때로 null체크 크드를 만들기 귀찮은 순간이 있다. 아래의 예제처럼 코딩하면 null대신 빈 문자열을 기본 값으로 설정할 수 있다.

@Test
public void jsonToJava_setDefaulValueAsNotNull() {
  Gson gson = new Gson();
  String json = "{'name':'유라'}";
  Person2 java = gson.fromJson(json, Person2.class);
  assertEquals("유라", java.name);
  assertEquals("", java.phone_number);
}
 
static class Person2 {
  String name;
  String phone_number = ""; // optional data에 기본값 설정하기
}

위 코드는 빈 생성자만 있을 때 가능한 구현이다. DAO객체에 파라미터를 받는 생성자가 있다면 아래처럼 코딩해야 한다.

@Test
public void jsonToJava_setDefaulValueAsNotNull_hasArgsConstructor() {
  Gson gson = new Gson();
  String json = "{'name':'유라'}";
  Person3 java = gson.fromJson(json, Person3.class);
  assertEquals("유라", java.name);
  assertEquals("", java.phone_number);
}
     
static class Person3 {
  String name;
  String phone_number;
 
  Person3() {
    this(null, ""); // optional data에 기본값 설정하기
  }
 
  Person3(String name, String phoneNumber) {
    this.name = name;
    this.phone_number = phoneNumber;
  }
}

4. 마치며

지금까지 Gson의 기본 설정만으로 코딩을 했다. 대부분의 경우에 기본 설정만으로 원하는 코딩을 할 수 있을 것이다. 좀 더 많은 기능이 필요한 사람은 Gson User Guide와 Gson API Doc을 읽기를 바란다.

출처: http://newy.tistory.com/entry/post-2 [뉴와이의 이지코딩]

« Prev [Java] 자바에서 콜백(Callback) 구현하기

[Java] 자바에서 콜백(Callback) 구현하기 2017.03.15by 〈

json 데이터 핸들링 Next »

json 데이터 핸들링 2017.03.09by 〉

♥ 0

Dreamy의 코드 스크랩

내가 모으고 내가 보는

Category

List of Articles
번호	분류	제목	날짜	조회 수
405	Pi	SSD1306 OLED Displays with Raspberry Pi	2017.05.10	9100
404	Pi	SPI란? (Serial Peripheral Interface)	2017.04.20	17857
403	Pi	LCD interface 종류 및 Driver IC	2017.04.17	8717
402	Pi	아두이노의 인터럽트 (interrupt) 사용	2017.04.13	16879
401	JAVA	[Java] 자바에서 콜백(Callback) 구현하기	2017.03.15	28246
»	Android	json 데이터 다루기 - GSon 사용법	2017.03.15	11056
399	Python	json 데이터 핸들링	2017.03.09	11076
398	Pi	라즈베리파이 gpio utility	2017.02.15	8539
397	C++	STL queue 사용법	2017.02.14	30737
396	C++	C++ string 정리 (C++ 문자열)	2017.02.14	15142
395	Pi	라즈베리파이 3, Spec & PIN Map	2017.02.06	33010
394	일반	Anet A8 Prusa i3: tips and tricks	2017.02.04	25122
393	MFC	[Collection] ArrayList 예제	2017.01.25	8975
392	MFC	[Collection] CArray Class 사용법	2017.01.25	18118
391	업무	ABS / PLA	2017.01.18	8483

태그 쓰기

json 데이터 다루기 - GSon 사용법

단축키

단축키

Dreamy의 코드 스크랩

내가 모으고 내가 보는

나눔글꼴 설치 안내

이 PC에는 나눔글꼴이 설치되어 있지 않습니다.