|
 |
Enterprise Java Technologies 테크팁 |
||
| 2006년 3월 3일자 |
| ||||||
| ||||||
|
3월의 Technology Day! Java User Group 세미나
*참가신청은 이름, 소속, 연락처를 적어 메일로 보내주시기 바랍니다. |
|
| 이번 호에서는, » JAXB 2.0에 새로 추가된 기능 » 웹 서비스 모니터링 에 대해 다룹니다. 이 팁들은 Java EE 5의 오픈소스 구현(GlassFish)을 이용하여 개발되었으며, GlassFish 프로젝트 페이지에서 GlassFish를 다운로드 받으실 수 있습니다. -샘플 아카이브 다운로드 받기- JAXB |
||
 |
JAXB 2.0에 새로 추가된 기능 |  |
저자 Kim LiChong JAXB(Java Architecture for XML Binding)는 자바 프로그래밍 언어 애플리케이션에서 XML 컨텐츠의 사용을 간소화해주는 기술로서, XML 문서의 XSD 스키마를 바탕으로 하여 XML 문서와 JavaBeans 기술 컴포넌트 간의 바인딩을 지정함으로써 작업을 수행한다. 지난 J2EE 테크팁에서는 JAXB를 이용한 XML 직렬화와 JAXB에서 RelaxNG 이용하기를 다룬 바 있으며, 두 팁 모두 Java WSDP(Java Web Services Developer Pack) 1.6 패키지에 포함되어 있는 JAXB 1.0이 사용되었다. JAXB 2.0, JSR 222에는 JAXB 1.0에서 개선된 중요한 항목이 다수 포함되어 있는데, 그중 일부를 소개하면 다음과 같다.
본 팁에서는 이러한 개선사항 중 다음의 두 가지를 예시한다 - JAXP 검증 API를 이용한 검증(마샬링/언마샬링의 일부로서)과 Java-to-Schema 바인딩. 본 팁과 관련한 코드는 다운로드 아카이브에서 찾을 수 있으며, 예제를 실행하려면 JAXB 2.0 참조 구현의 최신 얼리 액세스 3 버전이 필요하다. JAXB 2.0 참조 구현의 얼리 액세스 3 버전은 Java WSDP 2.0 패키지에도 포함되어 있다. JAXP 1.3 검증 스키마를 이용한 언마샬링/마샬링 JAXB 2.0에서 개선된 사항 중 하나가 바로 JAXP 1.3 검증 API를 이용한 추가 검증 기능이다. 그럼, 먼저 JAXP 1.3 검증 스키마를 이용한 JAXB 2.0 언마샬링/먀샬링 기능을 살펴보록 한다. 자바 애플리케이션은 JAXB를 이용하여 XML 인스턴스 문서를 자바 컨텐트 객체로 언마샬링 할 수 있으며, 옵션으로 자바 컨텐츠 객체를 생성하기 전에 소스 XML 문서를 검증할 수 있다. 자바 애플리케이션은 또한 JAXB를 이용하여 자바 컨텐츠 객체를 XML 인스턴스 문서로 마샬링 할 수 있다. XML 문서를 언마샬링 하려면 먼저 XML 문서의 스키마를 해당 스키마를 나타내는 일련의 자바 인터페이스 및 클래스로 바인드해야 하고, 그런 다음 인터페이스와 클래스를 컴파일한다. 본 팁의 예제에서는 구입 주문서 스키마 <xsd:element name="quantity">
<xsd:simpleType>
<xsd:restriction base="xsd:positiveInteger">
<xsd:maxExclusive value="100"/>
</xsd:restriction>
<xsd:attribute name="partNum" type="SKU"
use="required"/>
수량은 100을 초과할 수 없으며 부품번호에는 반드시 JAXB 2.0의 스키마도 JAXB 1.0의 경우와 마찬가지로 XML 바인딩 컴파일러( 바인딩 및 컴파일을 완료한 후에는 XML 문서를 언마샬링 할 수 있다. 본 팁에서 사용하는 XML 문서 <item partNum="002" >
<productName>Reliving the Ordeal</productName>
<quantity>150</quantity>
<USPrice>11.99</USPrice>
</item>
JAXB 2.0의 언마샬링은 JAXB 1.0의 언마샬링과 거의 동일하다. 먼저 JAXB API에 대한 엔트리 포인트를 제공하는 JAXBContext jc = JAXBContext.newInstance( "techtip" ); Umarshaller u = jc.createUnmarshaller(); 언마샬링 프로세스에서 JAXB 2.0이 JAXB 1.0과 다른 점이 바로 검증 부분인데, JAXB 1.0에서는 다음을 지정함으로써 언마샬링 프로세스의 일부로서 소스 데이터를 관련 스키마와 대조하여 검증할 수 있다. unmarshaller.setValidating(true); JAXB 2.0에서는 JAXP 1.3 스키마 검증 프레임워크를 이용하여 검증 기능을 보다 향상시켰다. 이처럼 강화된 레벨의 검증을 이용하려면 먼저 W3C XML Schema 1.0 언어를 위한 SchemaFactory sf = SchemaFactory.newInstance(
javax.xml.XMLConstants.W3C_XML_SCHEMA_NS_URI);
Schema schema = sf.newSchema(new File("po.xsd"));
그런 다음 u.setSchema(schema); 애플리케이션은 기본값 이벤트 핸들러를 오버라이드하여 검증 오류 처리를 커스터마이즈할 수 있는 옵션을 가지는데, 이 경우에는 메소드 콜 JAXB 1.0으로 언마샬링을 하는 이전의 접근법(소위 '구조적 언마샬링')은 유효하지 않은 XML 컨텐츠에 대해 더 엄격한 편이다. JAXB 1.0은 복구 불가능한 구조적 불일치가 탐지되면 언마샬링 프로세스를 취소하고 이와 달리 JAXB 2.0은 보다 유연한 언마샬링을 허용하는데, 이는 부적절한 XML 컨텐츠의 언마샬링 과정에서의 예측 가능성을 더욱 높여준다. JAXB 2.0의 경우, 컨텐츠 모델 내의 엘리먼트 위치를 기준으로 하여 엄격하게 적용시키기 보다는 엘리먼트 이름 별로 xml을 언마샬링한다. 각자의 커스텀 이벤트 핸들러를 지정하는 방법은 다음과 같다. u.setEventHandler(new DefaultValidationEventHandler()); 커스텀 검증 이벤트 핸들러는 반드시 public class MyValidationEventHandler implements
ValidationEventHandler{
public boolean handleEvent(ValidationEvent ve) {
if (ve.getSeverity()==ve.FATAL_ERROR ||
ve .getSeverity()==ve.ERROR){
ValidationEventLocator locator = ve.getLocator();
//print message from valdation event
System.out.println("Message is " + ve.getMessage());
//output line and column number
System.out.println("Column is " +
locator.getColumnNumber() +
" at line number " + locator.getLineNumber());
}
return true;
}
}
JAXB 스펙은 오류 발생 시 모든 프로바이더 구현이 검증 오류를 보고할 것을 요구하고 있지만, 구현이 데이터 프로세싱을 중단할 필요까지는 없다. 한편, XML 문서가 유효하지 않더라도 JAXB 구현은 XML 문서를 성공적으로 언마샬링 할 수 있다.
JAXBElement<?> poElement =
JAXBElement<?>)u.unmarshal(
new FileInputStream( "po.xml" ) );
PurchaseOrderType po = (
PurchaseOrderType)poElement.getValue();
USAddress address = po.getShipTo();
컨텐츠를 다시 XML 파일로 마샬링하려면 JAXB 1.0과 동일한 단계를 거치도록 한다. (앞서 언마샬링 과정에서 본 것처럼) Marshaller m = jc.createMarshaller();
m.setProperty( Marshaller.JAXB_FORMATTED_OUTPUT,
Boolean.TRUE );
OutputStream os = new FileOutputStream(
"incorrectpo.xml" );
m.marshal(po, os);
본 팁의 예제 코드에는 표시되어 있지 않지만, JAXB 2.0은 마샬링 시에(언마샬링 시에도) 검증을 지원한다. 한편, JAXB 1.0의 경우에는 언마샬링 시에만 검증을 규정하고, JAXB 컨텐츠 트리의 온디맨드 검증을 지원하는데, 마샬링 시의 검증은 웹 서비스 때문에 추가된 것이다. 웹 서비스 프로세싱 모델은 데이터를 읽어들일 때는 어느 정도 느슨하고 반대로 데이터를 기록할 때는 엄격해야 한다. 이 모델에 부합하도록, JAXB 2.0은 사용자가 xml 문서를 JAXB 양식으로 수정할 경우 문서가 무효화되지 않도록 하기 위해 마샬링 시의 검증을 추가하였다. Java-to-Schema 바인딩을 이용하여 자바 클래스에서 XML 생성하기 앞서 얘기한 것처럼, JAXB 1.0의 경우 XML Schema-to-Java 매핑은 지정되었지만 Java-to-XML Schema의 매핑은 지정되지 않았다. 한편, JAXB 2.0은 Java-to-XML Schema의 매핑을 지정함으로써 이 작업을 완수함과 동시에 "A Metadata Facility for the Java Programming Language", JSR 175에 명시된 주석을 이용하여 이 바인딩을 제어한다. 본 팁에서는 JAXB 2.0을 이용하여 기존의 자바 클래스로부터 XML 파일을 생성한 다음 생성된 XML 파일의 내용을 콘솔로 프린트하는 방법을 예시해보도록 한다. 사용되는 두 가지 클래스는 클래스는 XML Schema 컴플렉스 타입 또는 XML Schema 심플 타입으로 매핑되는데, XML Schema 타입은 클래스에 포함된 JavaBean 속성 및 필드의 매핑을 기초로 하여 파생된다. JAXB 2.0에서 주석은 Java-to-Schema 바인딩 프레임워크에 대해 자바 클래스를 취급하는 방법을 지시하기 위해 사용된다. 톱 레벨 값 클래스에 대해서는 주석 @XmlType
public class Person {
private String name;
private int age;
.....
톱 레벨 클래스에 @XmlRootElement
public class Scientist {
private Person person;
private String researchInstitute;
private Collection publications;
...
이 주석들은 주석과 기본값 매핑은 기존 코드를 최소한으로 변경하여 클래스를 스키마에 매핑할 수 있도록 설계되었으며, 기본값 매핑은 주석이 지정되지 않더라도 프로그램 엘리먼트에 적용되는 것으로 간주되는 기본값 주석을 기초로 하여 지정된다. 이와 관련한 자세한 내용을 보려면 최종본 JAXB 2.0 스펙의 섹션 8.12를 참조할 것. 본 팁의 코드 예제의 경우, Java-to-XML Schema 매핑이 갖추어진 상태에서는 JAXBContext context =
JAXBContext.newInstance(Scientist.class);
Marshaller m = context.createMarshaller();
m.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);
해당 속성을 이용하여 필요한 Scientist scientist = js.getScientist(); m.marshal(scientist, System.out); JAXB 2.0에 관한 더 자세한 내용은 JAXB 2.0 프로젝트 페이지를 참조할 것. 예제 코드 실행하기 예제 패지키에는 팁에서 다룬 기법을 예시하는 본 팁이 포함되어 있다. 예제를 설치하고 실행하려면 다음의 작업 절차를 따르도록 한다.
필자 소개 Kim LiChong은 썬 마이크로시스템즈 Java Web Services Performance Engineering Group 기술진의 멤버로서, XML 파싱 성능에 대해 특히 지대한 관심을 가지고 있으며, StAX 1.0 White Paper: Streaming APIs for XML Parsers의 공동 저자 중 한 사람이기도 하다. 그는 또한 XML 파싱 성능 측정에 사용되는 마이크로벤치마크인 xmltest의 공동 소유자이다. xmltest에 관한 자세한 내용을 보려면 xmltest 프로젝트 페이지를 참조할 것. 맨위로 | ||
| 웹 서비스 모니터링 | ||
|
J2EE 1.4에서 새로 소개된 기술 중 하나가 바로 J2EE Management, JSR 77이었다. J2EE Mnagement는 J2EE 컴포넌트를 위한 관리 정보, 오퍼레이션, 속성 공개 및 액세스를 위한 표준 관리 모델을 제공할 뿐 아니라 JMX(Java Management Extensions)와 같은 기술과 더불어 개발자들에게 J2EE 서버 상에서의 리소스 관리 및 모니터링을 위한 벤더 중립적 방식을 제공한다. (JMX에 관한 자세한 내용을 보려면 테크팁 JMX 기술 이해하기를 참조할 것.) 이런 기술들을 통해 관리하고 모니터할 수 있는 리소스의 하나가 바로 웹 서비스이다. 하지만, 그동안 웹 서비스의 관리와 모니터링의 용이성을 높이기 위해 이런 기술들을 활용하는 툴을 찾아보기란 거의 불가능했다. 최근의 예외 중 하나가 바로 Java EE 5의 오픈소스 애플리케이션 서버 구현인 GlassFish인데, GlassFish에서 웹 서비스는 모니터 및 관리가 용이한 1차 클래스 객체이다. 이제 여러분은 본 팁에서 이 GlassFish 기능을 이용하여 웹 서비스를 모니터할 수 있는 기회를 갖게 될 것이다. 시작하기 먼저 초기 설정 작업부터 시작해보도록 하자. GlassFish를 아직 구하지 못했다면 GlassFish 다운로드 페이지에서 다운로드한 다음, 아래와 같이 환경 변수를 설정한다.
아울러, ant 위치를 각자의 본 팁은 테크팁 JAX-WS를 이용하여 웹 서비스 개발하기에서 설명한 1차 클래스 객체로서의 웹 서비스 대부분의 J2EE 준수 애플리케이션 서버는 배치된 아카이브, 즉 ear, war, jar, rar 파일을 리스트하지만, 배치된 웹 서비스는 리스트하지 않는 것이 일반적이다 -- 적어도, 도메인 내에 배치된 모든 웹 서비스 엔드포인트를 쉽게 찾을 수 있는 방식으로 리스트하지는 않는다. 이러한 유형의 애플리케이션 서버에서 웹 서비스를 관리하기 위해서는 해당 웹 서비스에 대한 배치 서술자를 검토해야 한다. 한편, 이와는 대조적으로 GlassFish에서는 모든 웹 서비스 엔드포인트가 명확하게 표시된다. 모든 웹 서비스는 EJB(Enterprise JavaBeans) 컴포넌트 및 서블릿과 같은 다른 엔터프라이즈 리소스와 더불어 GlassFish 관리 콘솔에 리스트되는데, 이는 웹 서비스를 쉽게 관리할 수 있게 해준다. 예시를 위해 다음 명령어를 입력하여 GlassFish 애플리케이션 서버를 시작한다. <GLASSFISH_HOME>\bin\asadmin start-domain domain1 이 때, <GLASSFISH_HOME>은 GlassFish가 설치된 디렉토리를 나타낸다. 다음과 같은 내용이 표시되어야 한다. Starting Domain domain1, please wait. Log redirected to <GLASSFISH_HOME>/domains/domain1/logs/server.log. Domain domain1 started. GlassFish가 시작된 후 각자의 브라우저를 
웹 서비스 모니터링하기 GlassFish는 초당 요청 수, 평균 응답 시간, 쓰루풋 등과 같은 웹 서비스의 운영 통계를 추적하고 그래픽 형식으로 표시해주는 기능을 갖추고 있으며, 사용자는 애플리케이션 내의 개별 웹 서비스에 대한 모니터링을 인에이블("사용함")시킬 수 있다. 모니터링은 다음과 같은 세 가지 레벨을 지원한다.
(LOW 또는 HIGH를 지정하여) 웹 서비스에 대한 모니터링 기능을 작동시키면, 해당 웹 서비스에 의해 수행되는 모든 연산에 대해 모니터링이 인에이블된다. 모니터링 정보를 디스플레이하려면 웹 서비스에 관한 상세 정보가 표시되는 창에서 Monitor 탭을 클릭한다. 모니터링 기능은 OFF로 기본 설정되어 있으므로 처음에는 "No Statistic is available for this web service"라는 메시지가 표시된다. 이 때, 창의 Configuration 탭을 클릭하면 모니터링이 작동된다. 통계와 메시지의 수집을 시작하려면 모니터링 레벨을 HIGH로 설정하고 Save를 클릭한다. 
이제 "JAX-WS를 이용하여 웹 서비스 개발하기" 테크팁의 "클라이언트 실행(Run the Client)" 섹션의 지시사항에 따라 Calculator 웹 서비스에 SOAP 요청을 전송한다. 다음과 유사한 출력이 표시되어야 한다. runtest-jaxws:
[echo] Executing appclient with client class as
client.JAXWSClient
[exec] Retrieving port from the service
com.techtip.jaxws.sample.CalculatorService@162522b
[exec] Invoking add operation on the calculator port
[exec] Adding : 0 + 10 = 10
[exec] Adding : 1 + 10 = 11
[exec] Adding : 2 + 10 = 12
[exec] Adding : 3 + 10 = 13
[exec] Adding : 4 + 10 = 14
[exec] Adding : 5 + 10 = 15
[exec] Adding : 6 + 10 = 16
[exec] Adding : 7 + 10 = 17
[exec] Adding : 8 + 10 = 18
[exec] Adding : 9 + 10 = 19
all:
BUILD SUCCESSFUL
Total time: 6 seconds
Monitor 창의 Statistics 탭을 클릭하면 Calculator 웹 서비스와 관련하여 수집된 다음의 통계가 표시되어야 한다. 
다음의 CLI 명령어를 이용해도 동일한 결과를 얻을 수 있다(명령어는 한 행에 입력해야 함). <GLASSFISH_HOME>\bin\asadmin get -m --port 4848 "server.applications.jaxws-webservice-web.Calculator. webservice-endpoint.*" 다음과 유사한 출력이 표시되어야 한다. server.applications.jaxws-webservice-web.Calculator. webservice-endpoint.averageresponsetime-count = 9 server.applications.jaxws-webservice-web.Calculator. webservice-endpoint.averageresponsetime-description = Average response time measured in milliseconds server.applications.jaxws-webservice-web.Calculator. webservice-endpoint.averageresponsetime-lastsampletime = 1136835037801 server.applications.jaxws-webservice-web.Calculator. webservice-endpoint.averageresponsetime-name = AverageResponseTime ... 결과물에는 Administration 콘솔에 표시된 것보다 더 많은 정보가 포함된다는 점에 유의할 것. 예를 들어, CLI 결과에는 각 통계와 그 측정 단위에 대한 설명이 모두 포함되어 있다. Message Trace 사용하기 모니터링 레벨이 HIGH인 경우에는 웹 서비스 엔드포인트에 대한 마지막 n개의 메시지를 디스플레이할 수 있다(기본값은 25). 메시지는 각 서버 인스턴스의 해당 메모리에 보관된다. 메시지는 SOAP 요청의 세부사항과 더불어 응답 및 HTTP 헤더 정보를 표시하는데, 메시지를 디스플레이하려면 Monitor 창의 Messages 탭을 클릭한다. 
Messages 창에서 메시지를 클릭하면 메시지에 대한 추가 세부사항을 볼 수 있으며, 디스플레이된 세부사항에도 XML 포맷의 세부사항을 요청하는데 사용되는 버튼이 포함되어 있다. 필자 소개 Satish Viswanatham은 썬 Application Server 팀 소속 엔지니어로, 초창기부터 J2EE 기술에 참여해 왔다. 그는 현재 J2EE 애플리케이션 서버를 서비스 지향 아키텍처(SOA) 엔진으로 만드는 작업에 적극적으로 참여하고 있으며, JDBC/EJB 트랜잭션 및 관리 기술 분야에서 풍부한 경력을 쌓은 바 있다. 썬에 합류하기 전에 Satish는 Kiva 애플리케이션 서버와 Netscape 웹 서버 같은 pre-J2EE 애플리케이션 서버 작업에 참여했으며, 썬에 재직하는 동안 3개의 특허를 출원하기도 했다. Nazrul Islam은 Application Server의 Administration & Management 팀의 고참 멤버로서 지난 5년 동안 J2EE 그룹에 꾸준히 참여해 왔다. 그는 Application Server Enterprise Edition 설계와 구현에 크게 기여했으며, 썬에 재직하는 동안 8개의 특허를 출원했다. 맨위로 | ||
본
메일은 수신을 동의한 회원님에게만 발송됩니다.
본 메일의 수신을 거부하거나 수신주소를 변경하려면 SKDN@Sun.com으로 문의 주시기 바랍니다. SKDN(Sun Korea Developers Network)에서 J2EE/J2SE 테크팁 등 다양한 아티클들을 참고하세요. Copyright 2003-2006 Sun Korea, Ltd. All rights reserved. |