자바 XML 제어 라이브러리 XStream : JAVA

XStream 은 XML 자료를 자바 객체로 생성하거나 반대로 자바 객체를 XML 데이터로 생성해주는 라이브러리를 제공하고 있다.
공식 사이트 튜토리얼을 보면서, 참 쓸만한것 같아, 포스팅을 하게 되었다.
XML 문서를 읽을때는 jdom 이 좋을 것 같고, 생성할 때는 XStream 사용하는 것이 효율적인 것 같다.
속성을 사용하게 되면 복잡한 구조가 되지만, 노드만으로도 XML 문서를 완성할 수 있기에 좋은 것 같다.

++ 공식사이트 : http://xstream.codehaus.org
++ 내려받기 : http://xstream.codehaus.org/download.html

내려받기 링크를 클릭하여 최신버전의 바이너리를 받으면 된다. 압축을 풀고, lib 폴더에 xstream-1.3.1.jar 파일을 복사하여 라이브러리에 반영하면되겠다. 아래의 내용은 XStream 에서 제공하는 튜토리얼을 참조하여 작성하였다.

XStream 패턴은 XML 노드네임과 일치하는 자바 Model 이 꼭 필요하다. 임의적으로 모델명을 치환할수도 있다.

1. XML 데이터를 생성하자.

모델을 생성

/**
@class Person.java
@brief Person Model
*/
package com.syaku;

public class Person {

  private int num;
  private String name;
  private String sex;
  private String memo;

  public int getNum() { return num; }
  public void setNum(int num) { this.num = num; }
  public String getName() { return name; }
  public void setName(String name) { this.name = name; }
  public String getSex() { return sex; }
  public void setSex(String sex) { this.sex = sex; }
  public String getMemo() { return memo; }
  public void setMemo(String memo) { this.memo = memo; }

}

XML 데이터 생성

** 줄바꿈은 그대로 XML 에 반영되어 오류가 출력되기 때문에 줄바꿈은 하지 않도록하자. 상단 선언부를 참조하면 이해가 될 것이다. 만약 줄바꿈을 하게 될 경우 파이어폭스에서 다음과 같은 오류메세지를 보게된다.

XML 변환기 에러: XML 혹은 텍스트 선언이 외부 엔티티 시작에 올수 없음 위치: http://url 행 2, 글자 위치 1:
<?xml version="1.0" encoding="euc-kr" ?>
^

-- 내용 추가 : contentType="text/xml; 할 경우 <?xml version="1.0" encoding="euc-kr" ?> 삽입하지 않아도 된다.

<%@ page contentType="text/xml; charset=euc-kr"%><%@ page import="com.thoughtworks.xstream.*" %><%@ page import="com.thoughtworks.xstream.io.xml.DomDriver" %><%@ page import="com.syaku.*" %><?xml version="1.0" encoding="euc-kr" ?>
<%
// 메소드 선언
XStream xstream = new XStream(new DomDriver());

// 모델 적용
xstream.alias("person", Person.class);

// 데이터 적용
Person person = new Person();
person.setNum(1);
person.setName("최석균");
person.setSex("남자");
person.setMemo("오!!!");

// XML 생성
String xml = xstream.toXML(person);
// XML 출력
out.print(xml);
%>

결과

<?xml version="1.0" encoding="euc-kr" ?>
<person>
  <num>1</num>
  <name>최석균</name>
  <sex>남자</sex>
  <memo>오!!!</memo>
</person>