어제는 근로자의 날이라서 출근하지는 않았었다. 그리고 전날은 부부동반 모임이 있어서, 늦에 들어온 것을 핑계삼아 간만에 게으름도 피우고 그랬다. 아니 사실은 게으름을 피운 것운 것이 아니라, 감기인지 못살인지 몸이 좋지 않아서 누워서 오전을 보냈다. 선천적으로 늦잠을 좋아하지 않는 관계로 시간이 무척 아까웠다.

무엇을 할까 고민하다가, Google App Engine에 스프링으로 간단한 페이지를 한번 올려봐야지라는 생각이 들었다.
최근에 Google의 Eclipse 플러그인과 SDK는 이미 설치해서 간단한 것들은 적용해 본 상태여서, Google의 App Engine의 인증만 남은 상태이므로 남은 작업은 정말 간단하다.

만약 Eclipse에 Google App Engine Plugin과 SDK를 설치 하지 않았으며,
이전에 블로그에 올렸던 다음의  글을 "Google App Engine SDK 설치 및 실행" 를 참조 하기 바란다.

위와 같이 Google App Engine을 위한 기본 환경을 만들었으면, Spring Framework를 다운 받아야 한다.
이미 Spring Framework를 이용하여 개발한 경험이 있는 개발자라면, 기존에 가지고 있던 Library들을 그대로 사용하면 되지만, 그렇지 않은 개발자라면 www.springframework.org 에서 다운 받아야 한다.
                      - Spring Framework 2.5 Dependency Version Download

지금은 SpringFramework 3.0M3가 공개되고 있지만, 정식 Release된 2.5.5버전을 예제 작성에 사용할 것이다.
(물론 다른 버전을 사용해도 큰 영향은 없을거라 생각된다. 환경만 잘 맞추어 주면 말이다.)

자 이제 본론으로 들어가서, Google App Engine의 Eclipse Plugin을 정상적으로 설치하게 되면, Eclipse의 상단 메뉴텝에 다음과 같이 3개의 아이콘들이 생겨난 것을 볼수 있을 것이다.

   

위에 첨부한 메뉴 이미지 중에서 왼쪽에 있는 메뉴 아이템을 클릭하여 "New Web Application Project"창을 아래와 같이 띄운다.

위의 창에 생성할 프로젝트 이름을 입력하고, 기본적으로 생성할 패키지명도 입력한다. 만약 Google Web Toolket를 사용하기 원하지 않으면 체크박스에서 체크 표시를 지워주고 하단에 있는 "Finish"버튼을 클릭하면 된다.

프로젝트를 생성하면 기본적인 Servlet을 예제로 제공한다. 자 일단 테스트를 위해서 이를 실행해 보자.
아래와 같이 "Debug As" 메뉴의 서브 메뉴인 "Web Application" 를 실행시키면 웹서버가 실행된다.

이를 확인하기 위해서는 웹브라우져의 주소창에 "http://localhost:8080" 입력하여 실행하면 된다.

정상적으로 동작하는 것을 확인하면, 이제 스프링을 실행할 수 있는 환경을 만들어 보겠다.
예제는 아는 사람들에게는 잘 알려져 있는 "step-by-step" 를 예제로 작업할 것이다. 환경을 만들어 주기 위해서는 이전에 다운 받은 Springframework에서 Spring.jar, Spring-mvc.jar 그리고 common-log.jar 파일을 WEB-INF/lib 디렉토리 아래로 복사한다. (아래  그림 참조)

common-log.jar 파일은 Google에서 제공하는 logging 패키지를 이용해도 되지만, Spring의 "DispatcherServlet"을 로딩할때 에러가 나기 때문에 넣어준 것이다. 위의 "step-by-step" 예제를 따라하면, 기본적인 웹페이지를 작성할 수 있을 것이다. 다만, "Ant Build"에 관한 내용과 "Unit Test"에 관한 부분은 크게 신경 쓰지 않아도 된다.

Spring의 "DispatcherServlet"을 이용한 기본적인 예제는 큰 에러 없이 작성될거라 믿는다. 만약 에러가 난다면, Google의 SDK없이 만들어서 돌려보기 바란다. 기본적인 개념을 익히는데 큰 도움이 될거라 믿는다.

일단 http://localhost:8080 을 이용해서 무리가 없으면,

위 이미지의 메뉴중(붉은 박스로 안에 있는)에 세번째 아이템(비행기 모양의 버튼)을 클릭을 하여 "Deploy Project to Google App Engine" 윈도우를 띄운다. 



위와 같은 창이 뜨면, 입력할 값들을 입력박스에 채워 넣고 Deploy를 실행하면 되는데, 이를 위해서는 Google App Engine의 인증이 필요하다. 인증을 위해서는 이미 구글의 Account가 있어야 하고, 이를 이용하여 Deplore를 진행할 수 있다.

아래의 이미지는 서버에서 서비스할 application을 위한 기본적인 정보인데, 간단하게 필요한 내용을 입력하면 된다.


위 화면의 "Applicatiion Identifier"는 자신이 원하는 App Engine상의 sub 도메인 역할을 하는 것이고, "Appication Title" 은 적절한 이름을 넣어주면 된다. 인증 관련된 부분은 특별한 설정 없이 그래도 놓은면, 누구다 다 접속이 가능하고, 별도의 추가 설정이 필요하면 "Edit" 링크를 눌러서 추가 설정을 해주면 된다. (자세한 내용은 구글에서 제공하는 가이드를 참고하기 바란다.)
 
설정을 마쳤으면 "Save" 버튼을 클릭하면 서버상의 설정을 마쳐지게 된다.

내가 작성한 셈플 프로그램은 여기에 있다.
    Sample Progrom 링크 : http://happyzoo2009.appspot.com/hello.htm

추가적인 사항으로는 Google App Engine에서 제공하는 DB는 공식적으로는 없다. 다만 Google App Engine의 Datastory를 이용이 가능하다. 하지만 이 역시도 Google에서 제공하는 Library를 통해서 JPA와 JDO틀 통한 이용이 가능하다. 이를 이용해서 Persistance 데이터들을 관리해서 사용해야 한다. 이의 사용은 기존의 관계형 DB와는 차이가 있다. 때문에 제대로 이용하기 위해서는 역시 공부하고, 분석하는 시간들이 필요하다.

하지만, 관계형 DB의 사용도 가능하나 역시 제약이 뒤 따른다. HSQLDB를 이용하여 in-memory상에서 동작을 시키는 경우이다. (이런 경우는 Hibernate의 이용이 가능하다. ) 
 
이제는 데이터를 어떤식으로 다룰지에 대한 고민들이 남아있다.
한가지 한가지씩 배워나가는 즐거움이 있는 장남감이다. SprignSource에선 Groovy와 Grails을 이용한 예제를 벌써 내 놓았다. 아직은 이들을 적용하고 싶은 생각은 없지만, 조만간 한번을 이들에 대해서도 공부하고 알아야 겠다는 생각은 늘상 가지고 있다. 일단은 Jruby를 먼저 적용해 보고 싶은 생각이 크다.

이번이 계획하였었던 내용으로는 마지막이다.

  - Eclipse에서 hsqldb 사용하기(1)
  - Eclipse에서 hsqldb 사용하기(2)

지난번까지 해 왔던 작업들을 정리하면, 먼저,Jave와 Eclipse 환경에서 개발하기 위해서 hasqldb.jar를 Spring Framewor의 Libray디렉토리로 부터 복사해서 Eclipse의 "lib" 디렉토리에 넣어, Eclipse와 Ant로 Build 시 사용할수 있도록 환경을 만들어 주는 것을 배웠다.

그리고, Ant로 빌드하기 위해서, Data Source를 Propeties로 부터 참조할 수 있도록 별도의 파일로 나누었고,이를 참조하는 방법에 대해서 배웠다.

이번에는 지난번에 작성하였던 "Build.xml" 파일이 정상적으로 동작하는지 실행해보고, 실제로 생정한 값들이 새로 만들어진 Table에 추가되었는지를 Eclipse의 Plug-in을 통해서 확인하는 방번에 대해서 이야기 할 것이다.

우선, 가장 먼저 해야 할 일은, 지난 번에 만들어 놓은 배치 파일(server.bat)을 이용해서, hsqldb 서버를 실행시켜 주어야 한다.

나의 경우는 배치파일에 아래와 같이 정의 되어 있다. 물로 도스 창에서 Typing해서 실행할 수 있지만, 자주 사용하는 것이므로 배치파일로 만드는 것이 편리하다.

java -classpath ..\war\WEB-INF\lib\hsqldb.jar org.hsqldb.Server -database test

도스창이 뜨로 정상적으로 실행이 되었으면, 이제 본격 적으로 실행을 시켜 보겠다.

내가 사용하는 Eclipse버전은 Eclipse IDE for Java EE Develosers 버전을 www.eclipse.org 에서 다운 받아 사용하는데, 이유는 WTP(Web Tools Platform) 이 이미 포함되어 있어서 별도로 설치할 필요가 없기 때문이다.

먼저 Elclipse에서 Ant를 실행 시켜 보도록 하자.

Eclipse IDE 왼쪽 하단에 있는 툴바의 제일 왼쪽에 있는 버튼을 클릭을 한다.
(아래 그림 참조)

그러면 아래와 같은 pop-up 창이  나타날 것이다. 메뉴 항목중에 Ant를 찾아서 클릭을 해줌면 Ant의 View 윈도우가 나타난다.


만약 위 pop-up창에서 Ant 메뉴가 보이지 않으면, 위 그림 하단에 있는 "Other..."를 선태하거나, 단축키(Alt-Shiff+Q, Q)를 눌러서 아래의 "Show View" 윈도우를 호출한다.
여기서 "Ant"를 찾아 선택한다.(아래 그림 참조)


그러면 아래와 같이 Ant의 View 화면이 나타나게 된다.(사실 여기서는 Build.xml을 선택한후 Ant View를 띄우는 순서로 진행한것이다.) 
우리는 Table을 생성을 하려고 하는 것이므로 아래 그림의 왼쪽에 있는 트리에서 "ceate Tables"를 더블 클릭한다.그러면 아래와 같이 "Ant Cofiguration Selection"창이 나타 나는데 여기서는 "createTables"라는 항목을 실행 시킨다.
 
그러면 Eclipse IDE의 Consol 창에 테이블 생성이 성공 되었다는 메시지가 아래와 같이나타날 것이다.

자 그러면 이제는 Sample 데이터를 만들어 보자.
이 것도 역시 지난번에 만들어 놓은 Built.xml에 있는 스크립트를 이용하면 된다.
이번에도 Eclipse의 Ant View에서 실행 시켜 보겠다.
단추키 "Alt+Shift+Q, Q"를 이용하여 "Show View"창을 띄우고,"Ant"를 선택하면 아래와 같이 "Ant View"창을 나타날 것이다. 여기 트리에서 "loadData" 선택해서 Table을 생성했던고 마찬가지로 실행을 시킨다.


Ant는 아래와 같이 만들어 놓은 스크립트를 참조해서 데이터를 hsqldb에  생성하게 되는데, 생성되는 과정은 Eclipse IDE의 Console창의 로그를 통해서 확인이 가능하다.

자 이번에는 위의 3개의 Data가 정말로 DB의 Products 테이블로 잘 생성되어는지를 Eclipse의  Plugin을 통해서 확인해 보자.

현재 사용하고 있는 IDE에 Database를 관리해 주는 Plugin View가 없다면, 이미 여러번 사요해본 단추키 "Alt+Shift+Q, Q"를 이용하여 "Show View"창을 아래와 같이 띄우고, 창의 상단에 "data"라고 입력한다. 이때 아래의 트리는 관련된 기능들을 보여주는데,여기서 아래와 같이 "databases" 를 선택한다. 


아래의 DatabasesView창의 상단 툴바 메뉴에서 "Add"버튼을 클릭한다.
(왼쪽에서 2번째 버튼, 마우스를 가져다 대면 툴팁이 나타난다.)


그러면 Database Connection을 추가 할 수 있도록 아래와 같이 창이 나타난다.
나는 여기서 "Connetion name"을 "hSqlServe"이라고 넣었다.



위 화면에서 "Next >"버튼을 눌러서 아래와 같이 Connection 정보를 설정하는 화면으로 이동을 한다. 이미 드라이버에 대한 정보가 있다면, Combobox에서 hsqlDriver를 선택하면 되지만, 만약 없다면 "Add..." 버튼을 눌러서 드라이버 정보를 추가해야 한다.


위와 같이 설정이 되면, "Test connection"버튼을 눌러서 Connection 테스트를 해본다. 성공했으면, "Finish"버튼을 눌러서 "Databases View"창에 추가한다.

성공적으로 완료가 되었다면 아래와 같이 Tree에 추가되어 나타날 것이다.
Ant를 이용해서 추가했던 Sample 데이터를 보기 위해서는 Tree에서 우리가 보기 원하는 "PRODUCTS" 테이블을 더블클릭해 주면 된다.


그러면 그 결과 테이블들이 다음과 같이 Eclipse IDE에 나타나게 된다.


Ant를 이용해서 생성했던 3개의 새로운 데이터가 성공적으로 추가된 것이 보인다.

지금까지 여러가지를 보아왔다. hsqldb에 대한 설명은 없었지만, 개념상으로 알아두면 된다. 그리고 이는 단지 hsql을 위한 기능이 아니라, 다른 Database에 대해서도 동일하게 적용이 가는하다. 단지 여기서 이를 두고 설명한 것은 가볍고, 설치가 용이하기 때문에 이를 예제로 사용한 것 뿐이다.

그리고, Ant build를 이용하여 개발에 반복적인 작업들을 처리하도록 하였는데, 사실 이부분은 개발뿐 만 아니라 자신이 만든 코드에 대한 Unit Test에도 상당히 도움이 된다. 테이블을 생성해서 데이터를 읽는 테스트 코드를 만들고 초기화 하는 부분을 반복적으로 사용한다면, 굉장히 도움이 많이 될것이다.

마지막으로 Eclipse의 IDE에 추가해서 사용했던 Plugin은 설명한 것 말고도 다른 유용한 것들이 있다. 그러나 이 역시 지금 추가해서 사용했던 것과 대동 소이 할 것이다.

마지막으로 여기에서 사용하였던, 예제로 사용한 파일 3개와 Build.xml 파일을 아래에 추가해 놓겠다. Eclipse Project의 "db/" 디렉토리에서 생성한 파일 들이다.

create_products.sql load_data.sql bulid.xml server.bat

지난 번에는 hsqldb를 명령행에서 실행 시키는 것에 대해서 알아 보았다.
예제는 지난 번과 마찮가지로 Step-by-Step 에 있는 내용을 이용할 것이다. 왜냐하면, 개인적으로는 Spring Framework를 처음 시작하고나 Spring MVC에 대해서 알아가는 개발자에게 가장 추천할 만한 예제이다. 물론 이것이 Spring MVC의 전부를 말해주지는 않는다. 최근에 발표된 Spring Framework 3.0.0.M1 버전에선 Anotation과 REST를 지원할 수 있도록 많은 부분이 새로 추가되고 되었기 때문이다. 그러나 그 기본은 결코 변하지 않을 것이다.

Ant를 사용해본 사람들은 Ant의 기본 Build에 이용되는 파일이 Build.xml 파일이라는 것을 익히 잘알고 있을 것이다. Ant가 Build.xml File을 실행할 때, 중복된 상수 값들은 Text파일에 저정하여 사용하는데, 여기서는 "build.properties"라는 파일을 이용하여, 정의하고 이를 "Build.xml"에서 읽어 올 것이다.

아래는 "build.properties"파일에 저장된 내용이다. Database에 접속하기 위한 기본 정보들이 정의되어 있다. 여기서 정의된 내용들을 Ant의 빌드 파일에서 읽어들여 사용할 것이다.
hsqldb의 Driver와 필요한 항복들은 아래와 같고, passwork는 여기서는 사용하지 않는다.


아래는 위에서 정의한 "build.properties"파일의 내용을 Ant의 Build.xml 파일에서 읽어오기 위해서 아래와 같이 정의한다. 공용으로 사용할 항목들은 별도로 정의하는 것이 관리하기 편리한다. 그 아래는 Build를 위한 기본 Class path를 정의하여야 한다. 여기서는 "hsqldb.jar"가 "/WEB-INF/lib" 아래 이미 복사되어져 있다. (지난 번에 이를 설명하였다.)

위에서 Data Source를 정의하고 이를 읽는 것에 대해서 설명하였다.
아래에서는 정위한 Data Source의 내용을 이용하여 Table을 생성하는 스크립트를 실행하도록 "Build.xml"에 정의한 것이다. 여기서는 "src="db/create_products.sql" 파일을 읽고, 이 파일에 정의되어 있는 스크립트를 실행하는 Task이다.
그리고 그 아래는 생성된 Table을 삭제하는 스크립트를 실행하는 Task를 정의한 것이다.
(직접 SQL 문을 호출하여 Table을 DB에서 Drop시켰다.)

아래는 위에서 정의한 "src="db/create_products.sql" 파일에 정의된 Table 생성 구문이다.
(참고로 "db/"는 디렉토리를 의미한다. Eclipse의 Project의 임의의 디렉토리 아래 db를 관리하기 위해 만들어 놓은 디렉토리이다.)
SQL문을 사용해본 경험이 있다면, 이해하는데, 크게 어렵지 않을 거하 생각된다.

아래는 "db/load_data.sql"파일에 정의해야할 구문인데, 생성된 DB Table(Products Table) 에 생성한 테스트 데이터 들이다.

아래는 위에 정의한 "load_data.sql"파일을 이용하여 Test데이터를 생성하기 위한 "Build.xml" 파일에 정의된 Task이다. src="db/load_data.sql" 이라고 정의된 것이 보일 것이다.


다음에는 이렇게 정의되어 있는 Ant의 "Build.xml" 파일을 이용하여 Eclipse에서 실행하고, 생성된 Test 데이터를 읽는 방법에 대해서 설명하려고 한다.

Eclipse와 Spring Framework를 이용하여 웹 개발을 한다면,가장 사용하기 쉬운 Database는 아마도 hsql이지 않을까 쉽다. 그 이유는 아무래도, Spring Framework에 포함 되어 있는 hsql.jar 라이브러리이 때문이다.

기본 적인 사용 법에 대해서는 Springframework에서 제공하는 Step-by-Step 예제에 잘 나와 있는데, 이를 기준으로 해서 설명하겠다.
먼저, Eclipse에서 설정해서 사용하기 위해서는, Build Path를 라이브러리(hsqldb.jar)를 등록 시켜 주어야 한다. Spring Framework 2.5버전을 다운 받아서, PC에 설치하였다면, "/lib" 디렉토리 아래 "hsqldb" 디렉토리 아래에 있는 "hsqldb.jar" 파일을 자신의 Eclipse의 Build Path 또는 라이브러리 디렉토리로 옮겨 주면 된다.

아래는 내가 사용하는 Eclipse의 환경이다. 참고하기 바란다. Library 디렉토리는 "war/WEB_INF/lib" 가 있고, 그 아래에 hsqldb.jar 파일이 있다.


이의 사용은 우리는 실제 운영 서버보다는 개발을 위한 용도로 쓰기가 용이한데, 이를 위해서 서버를 구동하는 방법을 알아보자.

아래와 같이 bat파일을 만들거나, DOS의 명령행에서 실행을 시켜 주면 된다.
(물론 JAVA_HOME은 정의 되어 있어야 한다.)


그러면 아래와 같이 실행되는 로그들이 창위에 나타날 것이다.


위에서는 도스 상에서 서버를 실행하는 것을 보여 주었는데, 이는 Eclipse의 Class Path에 
hsqldb.ja를 포함시키는 것과는 상관이 없다.
 
그러므로, 다음 번에는