|
 |
Enterprise Java Technologies 테크팁 |
||
|
2005년
12월 27일자 |
|
||||||
|
||||||
|
|
이번 호에서는, » 자바 기술을 이용한 AJAX의 활용 » POJO를 Persistent Entity로 변환하기 를 다룹니다. 이 테크팁은 Java EE 5의 오픈소스 레퍼런스를 구현(프로젝트명: GlassFish)하여 개발되었습니다.GlassFish는 https://glassfish.dev.java.net/ 에서 다운로드 할 수 있습니다. -샘플 아카이브 받기- 자바 기술을 이용한 AJAX의 활용 POJO를 Persistent Entity로 변환하기 |
||
 |
자바 기술을 이용한 AJAX의 활용 |  |
|
AJAX는 'Asynchronous JavaScript and XML'의 머리글자를 딴 것으로, 웹 애플리케이션이 웹 페이지에 대한 사용자 인터랙션을 효율적으로 처리할 수 있도록 하는 수단을 제공한다(사용자 인터랙션이 이루어질 때마다 페이지를 리프레시(새로 고침)하거나 전체 페이지를 리로드하는 번거로움을 덜어줌). 이는 또한 브라우저를 이용한 리치 비헤이비어(rich behavior)를 가능케 해준다(데스크톱 애플리케이션 또는 플러그인 기반 애플리케이션의 경우와 유사). AJAX 인터랙션은 백그라운드에서 비동기적으로 처리되고, 그 동안 사용자는 페이지에 대한 작업을 계속할 수 있다. AJAX 인터랙션은 웹 페이지 내의 JavaScript에 의해 시작되는데, AJAX 인터랙션이 완료되면 JavaScript는 페이지의 HTML 소스를 업데이트한다. 변경 작업은 페이지 리프레시 없이 즉시 이루어진다. 이 AJAX 인터랙션은 서버측 논리를 이용한 폼 엔트리 검증(사용자가 입력하는 동안), 서버의 상세 데이터 검색, 페이지 상의 데이터에 대한 동적 업데이트, 그리고 페이지에서 폼을 부분적으로 제출하는 등의 작업에 이용될 수 있다. 여기서 특히 흥미를 끄는 부분은 AJAX 애플리케이션이 별도의 플러그인을 요구하지 않으며 플랫폼/브라우저 중립적 특성을 지니고 있다는 점이다. 첨언하자면, 구형 브라우저에서는 AJAX가 충분히 지원되지 않으며, 브라우저간의 차이를 유발하는 클라이언트측 스크립트를 작성할 때는 주의를 기울여야 한다. 따라서 브라우저의 차이를 추상화(abstract)하는 JavaScript 라이브러리를 사용하거나 경우에 따라서는 대체 인터랙션 기법을 이용하여 구형 브라우저를 지원하는 것도 좋은 방법이 될 수 있다. 자세한 내용은 자바 개발자를 위한 AJAX FAQ(영문)를 참조할 것. 자바 기술은 어떤 작업에 적합한가? 자바 기술과 AJAX는 서로 궁합이 잘 맞는다. 자바 기술은 AJAX 인터랙션을 위한 서버측 프로세싱 기능을 제공하는데, 이는 서블릿, JSP(JavaServer Pages) 기술, JSF(JavaServer Faces) 기술, 웹 서비스 등을 통해 제공될 수 있다. AJAX 요청 처리를 위한 프로그래밍 모델은 종래의 웹 애플리케이션에서 사용하던 것과 동일한 API를 사용한다. JSF 기술은 클라이언트측 JavaScript와 그에 대응하는 서버측 AJAX 프로세싱 코드를 작성하는 재사용 가능 컴포넌트를 생성하는 데 사용될 수 있다. 이제 AJAX와 서블릿의 활용 예제를 살펴보기로 하자. 자동 완성(autocomplete) 예제 사용자가 종업원에 관한 정보를 검색할 수 있는 웹 페이지를 상상해보자. 이 페이지에는 사용자가 종업원의 이름을 입력할 수 있는 필드가 포함되어 있다. 이 예제에서 엔트리 필드는 자동 완성(autocomplete) 기능을 가지고 있는데, 다시 말해 사용자가 종업원 이름의 일부를 입력하면 웹 애플리케이션은 입력한 문자로 이름이나 성이 시작되는 모든 종업원을 열거하여 이름을 자동으로 완성하게 된다. 자동 완성 기능은 사용자가 종업원의 정식 이름을 일일이 기억하거나 다른 페이지에서 이름을 찾아보아야 하는 번거로움을 덜어준다. 
검색 필드의 자동 완성 기능은 AJAX를 이용해서 구현될 수 있으며, 이를 위해서는 클라이언트와 서버 상에 코드를 제공해야 한다. 클라이언트 상에서
먼저, 사용자가 브라우저에 의해 로드되는 페이지의 URL을 지정한다. 한편, 이 예제에서는 JSF 컴포넌트, 서블릿, 또는 JSP 페이지에 의해 생성되는 HTML 페이지가 사용되었다고 가정하자. 페이지에는 JavaScript 함수
<input type="text"
size="20"
autocomplete="off"
id="complete-field"
name="id"
onkeyup="doCompletion();">
사용자가 폼 텍스트 필드에 문자 "M"을 입력한다고 가정해보자. 그에 대한 응답으로
function initRequest(url) {
if (window.XMLHttpRequest) {
return new XMLHttpRequest();
} else if (window.ActiveXObject) {
isIE = true;
return new ActiveXObject("Microsoft.XMLHTTP");
}
}
function doCompletion() {
if (completeField.value == "") {
clearTable();
} else {
var url = "autocomplete?action=complete&id=" +
escape(completeField.value);
var req = initRequest(url);
req.onreadystatechange = function() {
if (req.readyState == 4) {
if (req.status == 200) {
parseMessages(req.responseXML);
} else if (req.status == 204){
clearTable();
}
}
};
req.open("GET", url, true);
req.send(null);
}
}
비동기 호출을 이용할 때는 callback 함수를 설정해야 하는데,
서버 상에서
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws IOException, ServletException {
...
String targetId = request.getParameter("id");
Iterator it = employees.keySet().iterator();
while (it.hasNext()) {
EmployeeBean e = (EmployeeBean)employees.get(
(String)it.next());
if ((e.getFirstName().toLowerCase().startsWith(targetId) ||
e.getLastName().toLowerCase().startsWith(targetId))
&& !targetId.equals("")) {
sb.append("<employee>");
sb.append("<id>" + e.getId() + "</id>");
sb.append("<firstName>" + e.getFirstName() +
"</firstName>");
sb.append("<lastName>" + e.getLastName() +
"</lastName>");
sb.append("</employee>");
namesAdded = true;
}
}
if (namesAdded) {
response.setContentType("text/xml");
response.setHeader("Cache-Control", "no-cache");
response.getWriter().write("<employees>" +
sb.toString() + "</employees>");
} else {
response.setStatus(HttpServletResponse.SC_NO_CONTENT);
}
}
이 서블릿을 보면 알 수 있듯이, AJAX 처리를 위해 서버측 코드 작성 방법을 배우는 데 필요한 새로운 내용은 전혀 나와있지 않다. XML 문서를 교환하고자 할 경우에 대비해서 응답 컨텐트 유형을
<employees>
<employee>
<id>3</id>
<firstName>George</firstName>
<lastName>Murphy</lastName>
</employee>
<employee>
<id>2</id>
<firstName>Greg</firstName>
<lastName>Murphy</lastName>
</employee>
<employee>
<id>11</id><firstName>Cindy</firstName>
<lastName>Murphy</lastName>
</employee>
<employee>
<id>4</id>
<firstName>George</firstName>
<lastName>Murray</lastName>
</employee>
<employee>
<id>1</id>
<firstName>Greg</firstName>
<lastName>Murray</lastName>
</employee>
</employees>
다시 클라이언트로
처음 호출을 한
function parseMessages(responseXML) {
clearTable();
var employees = responseXML.getElementsByTagName(
"employees")[0];
if (employees.childNodes.length > 0) {
completeTable.setAttribute("bordercolor", "black");
completeTable.setAttribute("border", "1");
} else {
clearTable();
}
for (loop = 0; loop < employees.childNodes.length; loop++) {
var employee = employees.childNodes[loop];
var firstName = employee.getElementsByTagName(
"firstName")[0];
var lastName = employee.getElementsByTagName(
"lastName")[0];
var employeeId = employee.getElementsByTagName(
"id")[0];
appendEmployee(
firstName.childNodes[0].nodeValue,
lastName.childNodes[0].nodeValue,
employeeId.childNodes[0].nodeValue);
}
}
<div style="position: absolute;
top:170px;left:140px" id="menu-popup">
사용자가 문자를 더 많이 입력할수록 목록 길이는 줄어들게 되고, 이어서 사용자는 여러 이름 중 하나를 클릭할 수 있다. 이제 여러분은 AJAX가 단순히 페이지의 백그라운드에서 HTTP를 통해 정보를 교환하고 결과를 토대로 해당 페이지를 동적으로 업데이트한다는 것을 알게 되었을 것이다. AJAX와 자바 기술에 관한 자세한 내용은 테크니컬 아티클 Asynchronous JavaScript Technology and XML (AJAX) With Java 2 Platform, Enterprise Edition(영문)을 참조하기 바란다. 아울러 AJAX BluePrints 페이지(영문)와 Greg Murray의 블로그에 실려 있는 AJAX FAQ for the Java Developer(영문)의 내용도 함께 참조할 것. 예제 코드 실행하기 본 팁에는 본문에서 다루어진 기법을 예시하는 예제 패키지가 첨부되어 있는데, Servlet 2.4 이상의 API를 지원하는 웹 컨테이너라면 모두 예제 패키지 설치가 가능하다. 예제를 설치하고 실행하려면 다음 단계를 따르도록 한다.
필자 소개 서블릿 스펙 분야를 주도하고 있는 Greg Murray는 Java BluePrints 팀의 전 멤버로, 웹 티어 권고(recommendations) 부문을 담당한 바 있으며, 현재 그는 BluePrints 팀의 도움을 받아 썬의 AJAX 프로젝트를 이끌고 있습니다. 또한 Greg은 국제화, 웹 서비스, J2SE 독립형 클라이언트, AJAX 기반 웹 클라이언트 등의 분야에서 다양한 경력을 쌓기도 했습니다. 맨 위로 |
||
| POJO를 Persistent Entity로 변환하기 | ||
|
Java EE 5의 목표 중 하나는 개발을 용이하게 하는 것으로서, EJB(Enterprise JavaBeans) 3.0 스펙 JSR-220의 한 부분으로 정의되는 새 Java Persistence API는 상기 취지를 충족하기 위해 설계된 핵심 구성요소라 할 수 있다. 또한, 인기 높은 Java Servlet API 2.5 역시 개발의 용이성을 지원하는 기능을 부분적으로나마 포함하고 있다. 본 테크 팁에서는 자바 서블릿에서 사용되는 Java Persistence API의 예제를 다룰 것이며, 아울러 POJO(Plain Old Java Object)를 persistent entity로 변환하는 방법과 자바 서블릿에서의 entity 사용 방법에 대해서도 알아보도록 한다. 또한 여러분은 이런 기능을 사용하는 예제 애플리케이션을 실행해 볼 수도 있다. POJO를 Persistent Entity로 변환하기
먼저 POJO로 시작해보자. (예제 코드 실행하기 섹션에서 설명한 대로 예제 패키지를 다운로드하여 압축을 풀면 POJO와 예제를 위한 다른 소스 코드를 살펴볼 수 있다.) 이 예제에서 POJO는 JavaBean 컴포넌트로 구현되는
package com.example.entity;
public class Customer implements java.io.Serializable {
private Integer customerId;
private int version;
private String firstName;
private String lastName;
private String company;
...
public Integer getCustomerId() {
return customerId;
}
protected void setCustomerId(Integer customerId) {
this.customerId = customerId;
}
...
현재의 형태로는 클래스가 지속될 수 없는데, 이를 테면 관계형 데이터베이스에 저장할 수 없다는 말이다. 따라서 클래스를 지속시키려면 entity로의 변환이 필요하다. Enterprise JavaBeans 3.0 스펙(JSR-220)에서는 entity를 보잘 것 없고 고집 센 도메인 오브젝트 정도로 정의하고 있다. 한편, Java Persistence API는 POJO를 entity로 변환하는 데 도움이 되는 몇 가지 주석을 정의한다.
POJO를 entity로 변환하는 첫 번째 단계는 persistence 주석을
package com.example.entity;
import javax.persistence.*;
@Entity
public class Customer implements java.io.Serializable {
그 지속성을 예시하기 위해 이 예제의 entity를 관계형 데이터베이스-보다 구체적으로는 Apache Derby 데이터베이스(Apache Derby 데이터베이스는 GlassFish와 함께 패키지에 포함되어 있다)-에 저장하기로 한다. 다음은 entity가 저장될 테이블을 생성하는 데 사용되는 SQL이다.
CREATE TABLE Customer (
custId INTEGER PRIMARY KEY NOT NULL,
firstName VARCHAR(60),
lastName VARCHAR(60),
company VARCHAR(255),
address_1 VARCHAR(255),
address_2 VARCHAR(255),
city VARCHAR(60),
state VARCHAR(60),
zip VARCHAR(10),
emailAddress VARCHAR(80),
phoneNumber VARCHAR(80)
)
다음 단계는
package com.example.entity;
import javax.persistence.*;
@Entity
@Table(name="customer")
public class Customer {
데이터베이스 테이블(
모든 entity는 반드시 1차 키를 가져야 하고, 고객 데이터베이스 테이블의 경우 1차 키는
@Id(name="custId")
public String getCustomerId(){
return customerId;
}
다음 단계는 빈(bean) 속성을 데이터베이스 속성으로 매핑하는 것인데, 이 작업은
private Integer customerId;
private String firstName;
private String lastName;
private String company;
private String address1;
private String address2;
private String city;
private String state;
private String zip;
private String emailAddress;
private String phoneNumber;
실제로 빈 속성 이름과 그에 대응하는 데이터베이스 속성 이름 사이에는 몇 가지 차이점이 있다. 예를 들어, 클래스에는 주소의 첫 행에 대해
@Column(name="address_1")
public String getAddress1() {
return address1;
}
다음으로,
public static List<Customer> findAllCustomers(
EntityManager em) {
Query query = em.createQuery(
"SELECT OBJECT(cust) FROM Customer cust");
List<Customer> customers = query.getResultList();
return customers;
}
쿼리 메소드
다음은
public static Customer findCustomerById(EntityManager em,
Integer custId) {
Query query = em.createQuery(
"SELECT OBJECT(cust) FROM Customer cust "
+ "WHERE cust.customerId = :custId");
query.setParameter("custId", custId);
List<Customer> customers = query.getResultList();
if (customers != null && customers.size() > 0) {
return customers.get(0);
} else {
return null;
}
}
상기한 Persistence Descriptor
persistence descriptor는
<?xml version="1.0" encoding="UTF-8"?>
<persistence xmlns="http://java.sun.com/xml/ns/persistence"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<persistence-unit name ="myEntityManager">
<description>Sample Customer Database</description>
</persistence-unit>
</persistence>
엔티티 패키징은 프로바이더와 구성을 포함한 명명된(named) 엔티티 관리자, 일련의 관리 클래스, 클래스를 데이터베이스에 매핑하는 메타데이터 등을 그룹화하는 persistence unit을 기반으로 이루어진다. 다음은 이 예제에서 사용되는 persistence unit이다.
<persistence-unit name ="myEntityManager">
<description>Sample Customer Database</description>
<jta-data-source>jdbc/__default</jta-data-source>
<class>com.example.entity.Customer</class>
</persistence-unit>
컨트롤러 서블릿
본 팁의 예제에는 컨트롤러 서블릿이 포함되어 있는데, 이 서블릿은 주석 다음은 코드의 한 부분이다.
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
...
public class ControllerServlet extends HttpServlet {
@PersistenceContext EntityManager myEntityManager;
...
변수 컨트롤러 서블릿은 제공된 엔티티 매니저 인스턴스를 이용하여 데이터베이스 및 jsp 파일을 뷰 레이어로서 액세스한다. 예를 들어, 서블릿 내의 다음 메소드를 이용하여 데이터베이스 내의 모든 고객 레코드를 디스플레이한다.
private void doQueryByExample(HttpServletRequest request,
HttpServletResponse response) throws ServletException,
IOException {
...
List<Customer> customers =
Customer.findAllCustomers(myEntityManager);
if (customers.size() > 0) {
request.setAttribute(
ATTRIBUTE_CUSTOMER_LIST, customers);
getRequestDispatcher("/list.jsp").forward(
request, response);
} else {
getRequestDispatcher("/index.jsp").forward(
request, response);
}
}
예제 코드 실행하기 본 팁에는 팁에서 다룬 기법을 예시하는 예제 패키지가 첨부되어 있고, 예제 패키지에는 예제에 관한 소스 코드, 필요한 기술자(descriptor) 파일, 빌드 스크립트 등이 포함되어 있다. 예제를 실행하려면 다음 단계를 따르도록 한다.
저자 소개 Sriramulu Lakkaraju는 Sun Java System Enterprise Application Server 그룹의 스태프 엔지니어로, 지난 7년간 썬 자바 기술 분야에 공헌해 왔습니다. 또한 그는 J2SE (Security & Networking), J2EE (JSP, Servlet, JSTL, EJB) 등의 분야를 비롯하여 Sun Java System Application Server의 고가용성 기능 구현에도 일조한 바가 큽니다. Abhijit Kumar는 Sun Java System Application Server, Platform Edition의 설계자이며, 지난 10년간 자바 개발자로서 역할을 훌륭히 수행해오고 있습니다. 맨 위로 |
||
본
메일은 수신을 동의한 회원님에게만 발송됩니다.
본 메일의 수신을 거부하거나 수신주소를 변경하려면 SKDN@Sun.com으로 문의 주시기 바랍니다. SKDN(Sun Korea Developers Network)에서 J2EE/J2SE 테크팁 등 다양한 아티클들을 참고하세요. Copyright 2003-2005 Sun Korea, Ltd. All rights reserved. |
