Brain to Blog

Installed the Java SDK

If you don’t have a recent version of the Java SDK installed, download and install Sun Java Standard Edition SDK.

적어도 이 문서를 찾아보는 이라면 자바는 이미 깔려 있을 것이라고 굳게 믿는다... -_-/

Installed Eclipse or your favorite Java IDE

In these tutorials, we use Eclipse because it is open source. However, GWT does not tie you to Eclipse. You can use IntelliJ, NetBeans or any Java IDE you prefer. If you use a Java IDE other than Eclipse, the screenshots and some of the specific instructions in the tutorial will be different, but the basic GWT concepts will be the same.

If your Java IDE does not include Apache Ant support, you can download and unzip Ant to easily compile and run GWT applications.

이클립스를 기준으로 한다. 현재 최신 버전인 Luna 로 하겠다.

Installed the Google Plugin for Eclipse

The Google Plugin for Eclipse adds functionality to Eclipse for creating and developing GWT applications.

구글 플러그인을 깔자.

Help - Install New Software...

Work with: https://dl.google.com/eclipse/plugin/4.4

항목중에 Google Plugin for Eclise 4.4 를 체크 - Next 버튼 클릭.

Using the Archetype

http://mojo.codehaus.org/gwt-maven-plugin/user-guide/archetype.html

메이븐 archetype 를 업데이트 해줘야 한다. (현재 최신 버전은 2.7.0 이다.)

File - New - Other...

Maven Project 선택.

gwt-maven 으로 필터링을 하게 되면 하나가 나오는데 버전이 2.5.0 일 것이다. (아래처럼 2.7.0 이라면 패스)

Add Archetype 버튼 클릭.

Archetype Group Id: org.codehaus.mojo

Archetype Artifact Id: gwt-maven-plugin

Archetype Version: 2.7.0 (현재의 최신 버전)

OK 버튼 클릭하면 archetype 을 다운로드해서 업데이트 한다.

아직 프로젝트는 안만들 것이니 Canel 버튼 클릭.

Creating the StockWatcher application (using Eclipse)

File - New  - Other... - Maven Project

Group Id: com.google.gwt.sample (아무거나 -_-)

Artifact Id: StockWatcher

Package: com.google.gwt.sample.stockwatcher

module: StockWatcher

※ 여기서 모듈명은 GWT 튜토리얼에 있는 StockWatcher 로 하겠다.

Finish 버튼 클릭.

Using the Google Eclipse Plugin

http://mojo.codehaus.org/gwt-maven-plugin/eclipse/google_plugin.html

메이븐을 이용해서 만들었는데 이클립스의 개발자 모드로 해보려면 추가 작업이 필요하다.

resources 쪽에 있는 gwt.xml 파일을 java 쪽으로 옮겨야한다.

구글 플러그인에서 resources 에 있는 gwt.xml 을 인식하지 못하는 것 같다.

src/main/resources/com/google/gwt/sample/stockwatcher 아래에 있는 StockWatcher.gwt.xml 파일을

com.google.gwt.sample.stockwatcher 패키지로 이동시킨다.

이동 결과

다음은 Google 플러그인 연결(?) 작업이다.

StockWatcher 프로젝트에서 오른쪽 버튼 클릭 - Properties

Google - Web Application

This project has a War directory 체크

Google - Web Toolkit

Use Google Web Toolkit 체크

Entry Point Modules 에 StockWatcher 가 등록되어 있다.

OK 버튼 클릭

※ OK 버튼 클릭 시 NullPointException 에러가 나면 취소 후 위 작업을 다시 해보자.

Testing the default project components

StockWatcher 프로젝트에서 오른쪽 버튼 클릭 - Run As - Web Application (GWT Super Dev Mode)

WAR 디렉토리를 선택하라고 최초에 한번 나올 것이다. src/main/webapp(기본) 를 선택하자.

앞으로 여기에 모든 파일들이 적용 된다. 라이브러리, 컴파일 되는 자바스크립트 파일 등등..

Console 창에 로그 출력 되다가 Development Mode 창에 아래와 같이 주소가 나오면 성공!

더블클릭 해서 브라우저를 띄워보자.

이제 GWT 로 "Hello World" 찍었다.

출처 : http://stackoverflow.com/questions/5312350/where-is-maven-installed-on-ubuntu

우분투 버전 확인

설치

메이븐 버전 확인

기본 명령어로 링크

http://www.webjars.org/

보통 메이븐을 통해서 자바 라이브러리(jar)들간의 의존 관계를 해결한다.

하지만 자바스크립트 라이브러리는 이런게 없다. 어디선가 js 파일 받아서 웹 소스에다가 놓고 써야한다.

예를 들어 "jQuery UI"를 써야 하면 jquery.ui.js 파일 받고 "jQuery UI"가 필요로 하는 jquery.js 를 구해서 넣어야한다.

근데! 누군가가 메이븐으로 자바스크립트 라이브러리의 의존 관계를 관리할 수 있도록 했다.

이 기발한 원리는 이러하다. ㅋㅋ

1. /META-INF/ 안에 js 파일들을 넣은 jar 파일을 만들어서 메이븐으로 쓸 수 있도록 한다.

2. 프레임워크마다의 방법으로 classpath 안의 js 파일들을 웹상에서 쓸 수 있도록 한다.

pom.xml 에 아래와 같이 jquery-ui 를 추가하면

아래와 같이 jquery 까지 다운로드 받게 된다.

실제 jar 내용을 보면 아래와 같이 js 와 관련된 파일들이 들어있다. (requireJS도? 들어있네 ㄷㄷ)

Spring 3의 mvc 네임스페이스를 이용하면 쉽게 설정 가능하다. (다른 방법은 http://www.webjars.org/documentation 참조)

html 에서는 리소스의 경로에 맞게 해주면 되겠다.

web-jars.war

 ↑ 소스 포함 war

web-jars.zip

 ↑ 이클립스 메이븐 프로젝트

Intorduction

- 도로명 주소는 2014년부터 생활(법정)주소로 전면 사용됩니다.

- 도로명주소를 사용하지 않으면 은행, 카드, 보험 등 거래처의 우편물 수신에 불편함이 있을 수 있습니다.

이렇게 나와있다... Y2K^[각주:1] 처럼 버그도 아니고, 그냥 체계가 바뀌는 거지만... 미리 준비하자. -_-/

데이터 입력

http://www.juso.go.kr

정보제공 게시판 쪽에 가보면 현재 11월 기준의 도로명 주소 데이터가 올라와 있다. 매월 말에 데이터가 갱신 되는듯 하다... ㅅㅂ

4개의 게시글 첨부파일을 다 다운로드 받은 후 txt 파일이 나올때까지 전부 압축을 해제하자.

도로명주소정보제공내용변경계획.hwp

파일을 보면 알겠지면 4개의 테이블 구조로 되어있다. 이것을 대충 ERD로 짜보면 아래와 같다. 네이밍 ㅅㅂ -_-/

road.txp

이전다음

01

이제 텍스트 파일에서 테이블로 데이터를 넣어야 한다.

근데 이게 많은 양의 데이터라서 툴을 이용해서 넣기 번거로으므로 Java 로 만들어서 넣었다 -_-;; (템플릿 메소드 패턴 이용!)

zipcode.reader.zip

↑ 메이븐 프로젝트이다.

데이터 조회

안전행정부에서 도로명 주소를 검색해 가면서 분석한 결과 아래와 같은 공식(?)이 나왔다. 

음.. 어렵다.. -_-... 위 3개의 경우를 쿼리(오라클)로 뽑아보면 아래와 같다. 쿼리로 보는게 더 편할지도? ㅋㅋ

select
    /* 우편번호 */
    t3.zipcode as zipcode
    /* 도로명 주소 */
    , t1.sido_name
    	|| case when t1.sigun_name is not null then ' ' || t1.sigun_name end
        || ' ' || t1.road_name
        || decode(t2.base_yn, '1', ' ' || '지하')
        || ' ' || t2.bldg_no1
        || case when t2.bldg_no2 != 0 then '-' || t2.bldg_no2 end
        || ' (' || t1.eup_name
        || case when t3.apt_yn = '1' and t3.sigun_bldg_name is not null then ', ' || t3.sigun_bldg_name end
        || ')'
	as address
    /* 도로명 주소 영문 */
    , decode(t2.base_yn, '1', 'Jiha' || ' ')
    	|| t2.bldg_no1
    	|| case when t2.bldg_no2 != 0 then '-' || t2.bldg_no2 end
        || ', ' || t1.road_name_eng
        || case when t1.sigun_name_eng is not null then ', ' || t1.sigun_name_eng end
        || ', ' || t1.sido_name_eng 
    as address_eng
    /* 지번 주소 (~2013 주소) */
    , t4.sido_name
    	|| case when nvl(t4.gugun_name, t1.sigun_name) is not null then ' ' || nvl(t4.gugun_name, t1.sigun_name) end
        || case when nvl(t4.eup_name, t1.eup_name) is not null then ' ' || nvl(t4.eup_name, t1.eup_name) end
        || case when t4.ri_name is not null then ' ' || t4.ri_name end
        || decode(t4.san_yn, '1', '산')
        || ' ' || t4.ji_no1
        || case when t4.ji_no2 != 0 then '-' || t4.ji_no2 end
        || case when t3.sigun_bldg_name is not null then ' ' || t3.sigun_bldg_name end
	as address_jibun
    /* 관리번호(PK) */
    , t2.num
from
    tbl_road t1
join
    tbl_road_addr t2
on
    t1.road_code = t2.road_code
    and t1.eup_seq = t2.eup_seq
join
    tbl_road_info t3
on
    t2.num = t3.num
join
    tbl_road_jibun t4
on
    t2.num = t4.num
where
    t1.using_yn = '0'
    and t4.dele_yn = '1'
    and to_char(sysdate, 'YYYYMMDD') between nvl(t1.noti_date, '11110101') and nvl(t1.cancel_date, '99991231')
    and to_char(sysdate, 'YYYYMMDD') >= nvl(t2.noti_date, '11110101')
;

뭐 보면 대충 이렇게 나온다.

데이터 가공

데이터의 양이 너무 많다. 4개의 테이블만 덤프를 떠도 1.8GB 정도 한다.

내가 이 도로명주소 데이터를 뽑는 이유는 우편번호를 사용하기 위함이기 때문에 필요없는거 다 날리고 다른 테이블에 다시 넣어보자.

아래 ERD 는 도로명 주소를 표현할 수 있는 최소한의 데이터만 사용했을 때의 테이블이다.

zipcode_road.txp

아래는 insert select 문이다.

insert into zipcode_road (
	zipcode
    , road
    , sido
    , sigun
    , eup
    , under_yn
    , bldg_no1
    , bldg_no2
    , bldg
    , num
    , apply_date
)
select
	t3.zipcode
    , t1.road_name
	, t1.sido_name
    , t1.sigun_name
    , t1.eup_name
	, decode(t2.base_yn, '1', 'Y', 'N') as under_yn
    , t2.bldg_no1
    , decode(t2.bldg_no2, 0, null, t2.bldg_no2) as bldg_no2
    , case when t3.apt_yn = '1' and t3.sigun_bldg_name is not null then t3.sigun_bldg_name end as bldg
    , t2.num
    , to_char(sysdate, 'YYYYMMDD') as apply_date
from
	tbl_road t1
join
	tbl_road_addr t2
on
	t1.road_code = t2.road_code
    and t1.eup_seq = t2.eup_seq
join
	tbl_road_info t3
on
	t2.num = t3.num
where
	t1.using_yn = '0'
	and to_char(sysdate, 'YYYYMMDD') between nvl(t1.noti_date, '11110101') and nvl(t1.cancel_date, '99991231')
	and to_char(sysdate, 'YYYYMMDD') >= nvl(t2.noti_date, '11110101')
;

이렇게 넣으니 데이터는 5,975,824건에 650MB 정도 된다. 이래도 많다... 예전 우편번호는 5만건 정도밖에 안되는데 ㅜㅜ

Web Application

이 데이터를 기반으로 조회하는걸 한번 만들어 봤다.

http://antop.nerv.kr/zipcode

zipcode.war

zipcode.zip

↑ 메이븐 프로젝트

Introduce

웹프로젝트 생성 후 추가적으로 해야할 작업을 정리합니다.

프로젝트를 생성하면 아래와 같은 구조로 생성이 됩니다.

Create Resource Folder

기본적인 메이븐 구조에 맞게 있어야 하는 폴더가 안 만들어져 있습니다.

main/java

main/resources <- 이미 생성되어 있음

test/java

test/resources

폴더를 생성하고

main/webapp

폴더는 삭제합니다.

Project Preperties 로 들어갑니다. (프로젝트에서 마우스 오른쪽 버튼 - Properties)

Java Build Path에 3개는 이미 추가되어 있으니(폴더도 없었으면서 -_-)  한개 빠진 폴더를 추가합니다.

Add Folder 버튼 클릭

남은 하나의 폴더(test/resources)를 추가합니다.

OK 후 Java  Resources 쪽에 보면 4개의 폴더가 적용되어 있습니다.

Change JRE System Library

저는 JDK 1.5 가 없습니다. 1.6 을 사용합니다. 하지만 메이븐 프로젝트를 만들면 기본적으로 빌드를 1.5로 하게 되어 있습니다. 이클립스에서 알아서 1.6으로 해주지만 경고가 표시됩니다.

Project Facets 설정 에서 1.6 으로 바꿔줄 수 있지면 나중에 pom.xml 설정을 바꾸다 보면 다시 원상 복귀 됩니다.

해결방법은 pom.xml 에서 플러그인 부분을 아래와 같이 추가 후 저장합니다.

그러면 아래와 같이 에러가 나게 됩니다.

하라는대로 합니다. ㅎㅎ 프로젝트 오른쪽 버튼 클릭후 Maven - Update Project.

그럼 메이븐 프로젝트 선택하고 나옵니다. 현재 작업중인 프로젝트를 선택합니다.

그러면 이제 1.6 으로 돌아가게 됩니다. 물론 경고도 사라집니다.

Change Web Resource Location

처음 메이븐 웹 프로젝트를 만들면 웹 관련 폴더는 {프로젝트 루트}/src/main/webapp 에 있습니다.

이게 좀 소스 찾아 들어가려면 귀찮습니다. -_-;; 이 부분을 {프로젝트 루트}/webapp 로 변경하겠습니다.

이미 위에서 src/main/webapp 폴더는 삭제했습니다. 삭제하지 안았다면 삭제합니다.

프로젝트 바로 아래에 webapp, WEB-INF 폴더, web.xml(servlet 2.5) 파일을 생성합니다.

webapp 경로가 바뀌었으니 pom.xml 파일에 maven-war-plugin 설정을 추가합니다.

수정 후 저장을 하면 다시 Update Project 하라고 에러가 납니다.

아직 추가 설정을 더 해줘야합니다!!

Navigator 뷰에서 프로젝트를 본 후 .settings 폴더에서 두개의 파일을 수정합니다.

.jsdtscope - 블럭된 부분을 삭제합니다.

org.eclipse.wst.common.project.facet.core.xml - jst.web 버전을 2.5로 변경합니다. (자신의 web.xml 따라서 변경)

모두 저장 후 Project Explorer 뷰로 이동 후 Maven - Update Project

프로젝트를 보면 Deployment Descriptor 가 표시 되었습니다.

Maven Install 이나 War Export 해보면 정상적인 구조로 말리는 걸 확인할 수 있네요~

이제서야 OSGi 에 관심이 생겨서 뭔가를 만들어보기 위해서 OSGi + Tomcat 6 + SpringDM^[각주:1] 개발 환경을 구성해 봅니다.

Eclipse Indigo + Maven Integration for Eclipse

Create Project

File - New - Other... → Maven - Maven Project

[maven-archetype-quickstart] 선택합니다.

[Group Id], [Artifact Id] 아무거나 입력 합니다. -_-;;

[Package] 는 필요가 없습니다.

Create Target Definition

File - New - Other... → Plug-in Development - Target Definition

[Parent Folder]는 전에 만든 "spring-dm-platform" 프로젝트를 선택합니다.

File name: spring-dm-tomcat.target

Initalize the target definition with: Nothing

lib 폴더를 하나 생성합니다.

target 폴더는 메이븐 라이브러리가 복사되는 곳이고, lib 폴더는 메이븐으로 구하지 못한 라이브러를 넣어둘 것입니다.

spring-dm-tomcat.target 파일을 열어 편집합니다.

Target: SpringDM with Tomcat

오른쪽 Add... 버튼을 클릭해서 Locations 을 추가합니다.

Directory 선택

Variables.. 를 이용해서 현재 프로젝트 경로(project_loc)를 얻어내고 하위 폴더 target 을 입력합니다. (그냥 입력해도 됨..)

같은 방법으로 lib 폴더도 선택합니다.

파일 저장 후 Windows - Preferences - Plug-in Development - Target Platform

SpringDM with Tomcat 을 선택합니다.

Running OSGi Framework

이제 한번 실행시켜 봅시다.

Run - Run Configurations...

왼쪽 메뉴 중에 OSGi Framework 에서 오른쪽 버튼 클릭 - New

이름 적당히 지어 주시고 Run 을 클릭해 봅시다.

org.eclipse.osgi 플러그인이 없다고 에러가 납니다.

Setting Osgi Framework on Maven

이제 메이븐으로 OSGi Framework 라이브러리를 세팅합시다.

pom.xml 파일을 열어 아래와 같이 수정 합니다.

메이븐에 대해서 설명하지는 않겠습니다. -_-;;

위의 라이브러리 저장소(repository)는 SpringSource Repository(FAQ)에서 확인할 수 있습니다.

이제 SpringSource Repository에서 번들(라이브러리)를 하나씩 찾아서 넣어야 합니다. ㅠ_ㅠ;;

검색하는 방법은 [Advanced Search]나 오른쪽 상단 [Quick Search] 을 이용해서 검색하면 됩니다.

일단 OSGi Framework 실행 했을 때 없다고한 플러그인 라이브러리를 검색해봅시다.

검색해서 나온 버전 중 가장 최신 버전을 선택합니다.

중간에 보면 Maven 부분이 있습니다. 이걸 복사해서 <dependencies> </dependencies> 사이에 붙여넣기 하면 됩니다. ㅎㅎ

저장 후 pom.xml 파일에서 오른쪽버튼 클릭 후 Run As - Maven install 클릭 합니다.

그러면 target 폴더에 jar 파일이 복사가 됩니다.

이제 spring-dm-tomcat.target 파일을 열어봅시다.

아래와 같이 번들이 추가 되어있습니다.

※ 메이븐을 이용해서 빠르게 라이브러리를 바꿔치기 하다보면 번들(라이브러리)이 갱신이 안될 때가 있는데 그냥 파일 닫았다가 다시 열어주면 갱신이 되더군요....

맨위의 타이틀 오른쪽에 "Set as Target Platform"을 클릭해야 실제 적용이 됩니다. 주의!

이제 다시 Run Configurations 로 가봅시다. 추가한 번들이 올라와 있습니다. 선택 후 Run!

콘솔 창을 보면 OSGi Framework 가 실행되었습니다. ㅠ_ㅠ

이제 OSGi 할 준비가 된 것입니다. ㅋㅋ

톰켓이나 웹로직 같이 끄려면 빨간 버튼(Terminate)을 이용해서 끄면 됩니다.

나중에 톰켓를 띄우게 될텐데 OSGi Framework 한번 실행한 상태에서 한번 실행하면 톰켓 포트 충돌로 인한 에러를 볼 수 있습니다.

Setting SpringDM on Maven

바로 SpringDM을 적용해 봅시다!!

SpringSource Repository 에서 "spring", "spring-osgi", "slf4j" 를 검색해서 최신 버전을 적용 합니다.

이제 pom.xml 에서 마우스 오른쪽 버튼 - Run As - Maven install 해서 jar 파일을 target 에 생기게 합니다.

그리고 spring-dm-tomcat.target 파일을 열어서 ${project_loc}/target 폴더에 플러그인 갯수가 늘어났는지 확인합니다.

※ 만약 파일은 존재하는데 변경이 되지 안았다면 spring-dm-tomcat.target 파일 닫고 바로 다시 열어주면 카운트가 변경 되어 있을 겁니다.

상단 오른쪽의 "Set as Target Platform" 링크를 클릭하여 라이브러리를 적용시켜 줍니다.

Run Configurations 창으로 가서 추가된 번들(또는 라이브러리)를 선택합니다.

그 후 오른쪽 아래 "Validate Bundles" 버튼을 클릭합니다. 버튼명 그대로 번들들의 유효성을 검사하게 됩니다.

아래와 같이 어떤 라이브러리에서 필요한 라이브러리가 빠져있는지 나옵니다.

웹에 관련된 부분은 바로 이어서 할 것이므로 일단 이 번들은 빼고 구동(Run)합니다.

아래와 같이 나오면 성공! 웹쪽을 뺀 SpringDM 까지 올라갔습니다.

Configuration Log4j

OSGi Framework 를 실행 하면 아래와 같은 경고가 나오게 되는데 흔하디 흔한 log4j.properties / log4j.xml 파일 못 찾는 경고입니다.

log4j.xml

첨부한 log4j.xml 파일을 프로젝트 폴더에 복사합니다.

Run Configurations 창의 Arguments 탭으로 이동합니다.

VM arguments 부분에 -Dlog4j.debug=true -Dlog4j.configuration=file:log4j.xml 를 추가합니다.

Working directory 부분은 현재 자기의 프로젝트 경로로 바꿔줍니다.

Workspace... 버튼 클릭 후 spring-dm-platform 프로젝트 폴더를 선택하면 됩니다.

이제 OSGi Framework 를 실행하면 로그가 출력 됩니다.

여기까지 했으면 이제 웹을 제외한 SpringDM을 사용할 준비가 되었습니다.

Setting Web Platform

이제 거의 다 왔습니다.... 후우~.. 이제 웹도 되게 합시다!

Run Configurations 창에서 전 단계에서 선택하지 않았던 4개의 웹 관련 번들을 선택 후 검사합니다. (Validate Bundles 버튼)

아래에 나온 없는 패키지가 포함된 번들을 찾아줘야 합니다.

일단 서블릿 2.4 버전을 찾아서 넣어줍시다.

이렇게 추가된 라이브러리를 적용한 후 다시 Run Configurations 창을 엽니다.

Add Required Bundles 버튼을 클릭하면 필요한 라이브러리를 자동으로 선택 해줍니다. (만약 있다면..)

이제 번들 유효성 검사를 해보면 아무 이상이 없다고 합니다.

실행! 잘 되는듯 하다가 에러가 나는군요...

톰켓 번들을 설치합시다.

내용이 너무 길어저 pom.xml 만 남깁니다.

번들(라이브러리) 적용 후 우효성 검사를 하면 이상이 없다고 합니다.

보면 서블릿 번들이이 2.4/2.5 두개가 있는데 이중에 한가지만 선택하면 되겠습니다.

이제 실행해 봅시다.

org.apache.catalina.Service 서비스를 찾을 수 없다. 즉 톰켓이 안 떠있다는 겁니다.

catalina.start.osgi-6.0.16-20080327.121306-4.jar

첨부한 번들을 lib 폴더에 복사해주고 적용 시킵니다. (이건 메이븐에 없더군요...)

마지막으로 실행!

후우... 성공!

web.xml

마지막으로 첨부한 web.xml 파일을 conf/web.xml 에 복사합니다. (그냥 톰켓에 있는 web.xml 입니다)

이 파일이 있어야 나중에 웹어플 배치했을 때 정상적으로 됩니다.

안그러면 배치했을 때 아래 로그와 함께 영원히 404를 볼 수 있습니다.

Trouble Shooting

설정을 바꿨는데도 안바뀐다면?

Run Configurations 의 Settings 탭에서 "Clear the configuration area before launching"를 체크해주세요.

중간 중간 아래와 같은 에러가 난다면? 하라는 대로 하면 됩니다. -_-;;

마지막으로 최종 pom.xml 파일 첨부합니다.

pom.xml

메이븐 pom.xml 에서 오라클 라이브러리를 사용하기 위한 설정입니다.

메이븐 구조의 프로젝트에서 오라클 라이브러를 쉽게 사용하기 위해서 이것저것 찾아보다가 현재 아래의 저장소 URL 이 제일 적당한 것 같습니다.

각 버전을 확인 하는 방법은 브라우저에서 위 저장소 URL 을 입력하면 [groupId / artifactId / version] 순으로 디렉토리 구조로 되어 있습니다.

목록을 보면 오라클 이외에도 많은 라이브러리가 있는 것을 볼 수 있습니다.

자기가 필요로하는 라이브러리를 찾아봅시다 -_-;;

ojdbc6.jar 를 찾아보면 아래와 같은 구조로 되어 있습니다.

딱 보면 감이 오시겠지면

1 = groupId

2 = artifactId

3 = version