[Java] 자바의 Map 컬렉션 클래스 with JSON 데이터 다루기

🔎 Map 컬렉션 클래스

Map 인터페이스는 Collection 인터페이스와는 다른 저장 방식을 가집니다.

Map 인터페이스를 구현한 Map 컬렉션 클래스들은 키와 값을 하나의 쌍으로 저장하는 방식(key-value 방식)을 사용합니다.

여기서 키(key)란 실질적인 값(value)을 찾기 위한 이름의 역할을 합니다.

 

Map 인터페이스를 구현한 모든 Map 컬렉션 클래스는 다음과 같은 특징을 가집니다.

 

1. 요소의 저장 순서를 유지하지 않는다.

2. 키는 중복을 허용하지 않지만, 값의 중복은 허용한다.

 

대표적인 Map 컬렉션 클래스에 속하는 클래스는 다음과 같습니다.

1. HashMap<K, V>

2. Hashtable<K, V>

3. TreeMap<K, V>

 

❓ HashMap<K, V> 클래스

HashMap 클래스는 Map 컬렉션 클래스에서 가장 많이 사용되는 클래스 중 하나입니다.

JDK1.2부터 제공된 HashMpa 클래스는 해시 알고리즘(hash algorithm)을 사용하여 검색 속도가 매우 빠릅니다.

 

HashMap 클래스는 Map 인터페이스를 구현하므로, 중복된 키로는 값을 저장할 수 없습니다.

하지만 같은 값을 다른 키로 저장하는 것은 가능합니다.

 

다음은 hashMap을 선언하는 방법입니다.

HashMap<K, V> name = new HashMap<K, V>();

다음 예제는 userMap이라는 hashMap에 아이디, 비밀번호, 이름, 나이를 key로 해서 value까지 삽입하는 코드입니다.

HashMap<String, Object> userMap = new HashMap<String, Object>();

userMap.put("id", "doeunnkimm");
userMap.put("password" , "1234");
userMap.put("name", "김도은");
userMap.put("age", 20);

// 키값으로 value 가져오기
System.out.println(userMap.get("id")); // doeunnkimm

 

📌 JSONObject 라이브러리

자바에서 org.json 라이브러리를 이용하여 JSON 데이터를 다룰 수 있습니다.

이 라이브러리에서 제공하는 JSONObject, JSONArray 클래스는 JSON 데이터를 갖고 있고, JSON 형식의 문자열로 출력할 수 있습니다.

또한 JSON 문자열을 파일로 저장할 수도 있습니다.

 

갑자기 JSONObject를 왜 Map 컬렌션 클래스 글에서 다루냐면

JSON 데이터의 형태가 key와 value 형태로 이루어져 있기 때문입니다.

 

1. JSON ?

JSON은 JavaScript Object Notation의 약자로, Javascript에서 데이터를 전달하기 위해 만들어졌습니다.

JSON 파일은 다음과 같이 key-value 형태로 데이터를 갖고 있습니다.

{
   "pageInfo": {
         "pageName": "abc",
         "pagePic": "http://example.com/content.jpg"
    },
    "posts": [
         {
              "post_id": "123456789012_123456789012",
              "message": "Sounds cool. Can't wait to see it!",
              "likesCount": "2",
         }
    ]
}

 

2. JSONObject

JSONObject는 JSON에서 key-value 쌍으로 데이터를 표현하는 객체입니다.

JSONObject에 데이터를 입력할 때는 put(key, value)으로 입력합니다.

toString()은 JSONObject가 갖고 있는 데이터를 JSON 형식으로 출력합니다.

JSONObject jo = new JSONObject();
jo.put("name", "Johe");
jo.put("city", "Seoul");

 

3. HashMap으로 JSONObject 생성

그런데 JSONObject 객체의 매개변수로 HashMap 객체도 넘겨줄 수 있습니다.

그러면 HashMap 객체에서 put 해주었던 key와 value가 그대로 JSONObject 타입으로 변환되게 됩니다.

HashMap<String, Object> userMap = new HashMap<String, Object>();

userMap.put("id", "doeunnkimm");
userMap.put("password", "1234");
userMap.put("name", "김도은");
userMap.put("age", 20);

JSONObject userJSON = null;
userJSON = new JSONObject(userMap);

System.out.println(userJSON);

출력 결과

 

4. JSONObject에 key-value 추가(put)

key와 value의 타입이 처음에 제네릭으로 설정했던 것과 다를 수 있기 때문에 꼭 try-catch 안에 넣어주어야 합니다.

try {
    userJSON.put("gender", "F");
} catch (JSONException e) {
    e.printStackTrace();
]

 

5. JSONObject에서 key로 value 조회(get)

이 경우에도 입력한 key가 JSONObject에 없을 수 있기 때문에 try-catch 안에 작성해야 합니다.

try {
    System.out.println(userJSON.get("id"));
} catch (JSONException e) {
    e.printStackTrace();
}

 

6. JSONArray

JSON은 key-value 형태로 데이터를 갖고 있는데, 여기서 value는 아래와 같이 Array 타입이 될 수 있습니다.

"friends":["Harry","Sam"]

예를 들어 상품이라는 key가 있다면 value로 들어가는 상품이 여러 개가 있을 것입니다.

또한 그 상품에는 이름, 가격, 할인율 등의 key가 다시 또 존재할 것입니다.

따라서 하나의 key에 대해 여러 데이터를 담아야 할 때 JSONArray를 사용합니다.

 

7. 하나의 key에 대해 여러 개의 데이터 담기

아래 코드는 여러 개의 상품이 객체로 존재한다고 했을 때

이 객체들을 JSONArray에 product라는 키의 값으로 담으려고 합니다.

 

우선 상품의 정보를 담을 Product 클래스 하나를 선언해주겠습니다.

public class Product {
    private static Long sequence;
    private String productName;
    private int productPrice;
    private int productStock;
    
    public Product() {;}
   
    public Product(String productName, int productPrice, int productStock) {
      this.productId = sequence;
      this.productName = productName;
      this.productPrice = productPrice;
      this.productStock = productStock;
   }
]

 이제 ArrayList에 상품 정보들을 담아주고 이 담긴 ArrayList를 한번에 하나의 key에 다 담아버리려고 합니다.

ArrayList<Product> productList = new ArrayList<Product>(
        Arrays.asList(new Product("족발", 39000, 10), new Product("보쌈", 45000, 10)));
        
// productList에 담긴 객체 하나하나를 JSONObject로 바꿔서 다시 담을 ArrayList
ArrayList<JSONObject> productJSONs = new ArrayList<JSONObject>();

productList.strea().map(product -> new JSONObject(product)).forEach(productJSONs::add);

JSONArray products = new JSONArray(productJSONs);

System.out.println(products.toString());
// [{"productId":1,"productStock":10,"productPrice":39000,"productName":"족발"},{"productId":2,"productStock":10,"productPrice":45000,"productName":"보쌈"}]

 

8. JSONArray에서 원하는 정보 출력

사실 JSONArray는 키의 value안에 또 다시 키가 있고 value가 있는 형태여서 get을 잘 생각하면서 해야합니다.

저는 위에서 만들어 놓은 products에서 모든 상품의 이름만 모두 출력하는 코드를 작성해 보려고 합니다.

for (int i=0; i < products.length(); i++) {
    try {
        System.out.println(products.getJSONObject(i).get("productName"));
    } catch (JSONException e) {
        e.printStackTrace();
    }
}

출력 결과