[xml] RestAPI XML Return

RestAPI 통신을 활용해서 개발하다보면 접속대상지 서버가 구성되는데까지 시간이 다소 소요되는 경우가 많다. 그래서 나의 경우에는 자체적으로 dummy rest api 서버를 만들어두고 더미데이터를 return 해주는 것으로 임시방편 해결을 하는 편.

이번엔 XML 형태의 RestAPI 통신이 이루어지다보니, 잘 다루지 않던 XML 파싱 및 XML Return하는 것을 간단히 정리한다.

 

필요한 라이브러리는 다음과 같으며, maven에서는 바로 가져올 수 있다.

1. jackson-dataformat-xml-2.11.4.jar 2. (의존성) jackson-core-2.11.4.jar 3. (의존성) woodstox-core.6.2.3.jar 4. (의존성) jackson-databind-2.12.3.jar 5. (의존성) stax-2-api-4.2.1.jar 6. (의존성) jakarta.activation-api-1.2.1.jar 7. (의존성) jakarta.xml.bin-api-2.3.2.jar 8. (의존성) jackson-module-jaxb-annotations-2.11.4.jar

 

만들고자 하는 XML 형태는 아래와 같다.

<MAIN>
  <AGE>16</AGE>
  <SEX>Male</SEX>
  <JOB>Student</JOB>
  <PHONE>01022223333</PHONE>
  <STATUS>Normal</STATUS>
</MAIN>

 

소스는 다음과 같다.

 

1.  testXml

import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement;
 
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
 
@Data
@NoArgsConstructor
@AllArgsConstructor
@JacksonXmlRootElement(localName="MAIN") //루트태그명
public class TESTXml {
  @JacksonXmlProperty private String AGE;
  @JacksonXmlProperty private String SEX;
  @JacksonXmlProperty private String JOB;
  @JacksonXmlProperty private String PHONE;
  @JacksonXmlProperty private String STATUS;
}

xml로 생성할 항목들에 대해 TESTXml이라는 이름으로 데이터 클래스를 생성해준다.

@JacksonXmlProperty Annotation은 루트태그의 하위에 들어가는 그룹 요소로 생성이 된다.

 

2. DummyController

import org.springframework.http.MediaType;
 
 
@GetMapping(path="/xmlTest", produces=MediaType.APPLICATION_XML_VALUE)
public TESTXml xmlDummy(HttpServletRequest request) throws Exception {
  TESTXml testxml = new TESTXml();
  testxml.setAGE("16");
  testxml.setSEX("Male");
  testxml.setJOB("Student");
  testxml.setPHONE("01011112222");
  testxml.setSTATUS("Normal");
  
  return testxml;
}

lombok 라이브러리를 이용했기에 getter/setter 지정이 아주 깔끔하다. 이렇게 해주면 /xmlTest라는 URL을 호출했을 때 예제와 같은 형식으로 사용이 가능하다.

 

아래의 블로그를 통해 정리했다. 도움 많이 받음.

https://binit.tistory.com/28