안드로이드에서 JSON 파싱하는 방법
앱과 서버 간에 데이터를 주고받을 때 가장 널리 사용되는 형식이 바로 JSON(JavaScript Object Notation)입니다. 이 글에서는 안드로이드에서 JSON 데이터를 파싱해 화면에 표시하는 전체 과정을 단계별로 살펴보겠습니다. 예제에서는 문자열 형태의 JSON에서 직원의 이름과 급여 정보를 추출해 TextView에 출력하는 간단한 앱을 만들어 봅니다.
1단계 — 새 프로젝트 만들기
Android Studio에서 File → New Project 메뉴로 이동해 새 프로젝트를 생성하고, 필요한 모든 세부 정보를 입력합니다.
2단계 — 레이아웃 파일 작성
res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 직원의 이름과 급여를 표시할 두 개의 TextView를 화면 가운데에 배치했습니다.
<?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android" xmlns:app="https://schemas.android.com/apk/res-auto" xmlns:tools="https://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".MainActivity"> <TextView android:id="@+id/tvName" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_centerHorizontal="true" android:layout_marginTop="50dp" android:text="Name" android:textColor="#000" android:textSize="20sp" /> <TextView android:id="@+id/tvSalary" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_centerHorizontal="true" android:layout_marginTop="80dp" android:text="Salary" android:textColor="#000" android:textSize="20sp" /> </RelativeLayout>
3단계 — MainActivity 작성
src/MainActivity.java 파일에 다음 코드를 추가합니다. 미리 정의된 JSON 문자열에서 employee 객체를 꺼내 이름과 급여 값을 읽어온 뒤, 각각의 TextView에 표시하는 구조입니다.
package com.example.myapplication;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;
import org.json.JSONException;
import org.json.JSONObject;
public class MainActivity extends AppCompatActivity {
String JSON_STRING = "{\"employee\":{\"name\":\"John Doe\",\"salary\":65000}}";
String name, salary;
TextView employeeName, employeeSalary;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// TextView 참조 가져오기
employeeName = (TextView) findViewById(R.id.tvName);
employeeSalary = (TextView) findViewById(R.id.tvSalary);
try {
// JSON 문자열로부터 최상위 JSONObject 생성
JSONObject obj = new JSONObject(JSON_STRING);
// "employee" 키에 해당하는 JSONObject 가져오기
JSONObject employee = obj.getJSONObject("employee");
// 직원 이름과 급여 값 읽어오기
name = employee.getString("name");
salary = employee.getString("salary");
// TextView에 직원 이름과 급여 표시
employeeName.setText("Name: " + name);
employeeSalary.setText("Salary: " + salary);
} catch (JSONException e) {
e.printStackTrace();
}
}
}
참고: 최신 Android Studio에서 생성한 프로젝트는 android.support.v7.app.AppCompatActivity 대신 androidx.appcompat.app.AppCompatActivity를 사용합니다. import 문만 androidx 패키지로 변경하면 나머지 코드는 그대로 동작합니다.
4단계 — AndroidManifest.xml 확인
manifests/AndroidManifest.xml 파일에 아래 코드가 올바르게 등록되어 있는지 확인합니다. MainActivity가 런처(LAUNCHER) 액티비티로 지정되어 있어야 앱 실행 시 첫 화면으로 열립니다.
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.myapplication"> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="true" android:theme="@style/AppTheme"> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>
JSON 파싱 핵심 메서드 정리
- new JSONObject(String json) — JSON 문자열을 받아 최상위 JSONObject 객체를 생성합니다.
- getJSONObject(String name) — 지정한 키에 해당하는 하위 JSONObject를 반환합니다.
- getString(String name) — 지정한 키의 값을 문자열로 읽어옵니다.
- JSONException 처리 — JSON 형식이 잘못되었거나 키가 존재하지 않으면 예외가 발생하므로 반드시 try-catch 블록으로 감싸야 합니다.
앱 실행 및 결과 확인
이제 애플리케이션을 실행해 결과를 확인해 보겠습니다. 실제 안드로이드 기기를 컴퓨터에 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 버튼을 클릭하세요. 실행 대상 목록에서 자신의 모바일 기기를 선택하면, 기기 화면에 아래와 같이 JSON에서 추출한 직원의 이름과 급여가 표시됩니다.
