잘못된 웹표준, 웹접근성 상식

두서에서 밝힙니다. 이글은 웹 페이지에서 javascript 를 사용함에 있어 “Graceful Degradation” 과 “Progressive Enhancement” 에 대해서 말하고 있습니다. 이렇게 운을 떼는건 이 두가지가 오래전부터 회자되어 온 새로운게 아니란겁니다. 관련해서 잘 아시는 분은 읽지 않으셔도 됩니다

Graceful Degradation

Graceful Degradation 은 “우아한 낮춤”, “적절한 퇴보”, “성능 저하” 등 여러가지로 번역되고 있습니다.

의미는, 먼저  최신의 기술 기반 혹은 최신의 기기에서 동작하는 기능을 만들고 나서 오래된 기술 기반 혹은 오래된 기기에서도 유사하게 (성능을 낮춰서라도) 동작하도록 조치하는것을 말합니다. 이런 의미에서 위의 번역들은 모두 틀리지 않다고 할 수 있겠습니다. (광의적으로 “성능 저하”도 틀리지는 않지만 웹 개발의 관점에서 보면 사용자 경험을 낮춰서라도 기능을 지원하는 것이기 때문에 “성능 저하”는 맞지 않을 것 같네요.)

※ 컴퓨터 시스템에서의 허용 오차 시스템(Fault tolerant system) 과 유사하다고 할 수 있습니다. 허용 오차 시스템은 프로그램 구동 환경에 문제가 생겨도 프로그램이 정지하지 않고 성능을 낮추면서 프로그램 구동을 지속하도록 하는 시스템을 말합니다.

우리가 잘 알고 있는 예를 들자면 IMG 태그에 alt 속성을 지정하는걸 들 수 있겠네요. 이미지를 표시하는 브라우저에서는 이쁘게 이미지를 표시하지만 텍스트 브라우저라든지 이미지를 렌더링하지 못하는 브라우저에서는 alt 속성에 부여한 대체 텍스트를 표시하도록 구성 합니다. (이 예에서는 성능을 낮춘다기보다 사용자 경험을 낮춰서라도 … 의 표현이 어울리겠네요. )

javascript 관점에서 Graceful Degradation 을 보자면 NOSCRIPT 라는 태그를 들 수 있습니다. 보통 NOSCRIPT 는 두가지 방식으로 사용됩니다.

NOSCRIPT (대체 콘텐츠 제공)

위의 예제에서 slide.js 는 서버로부터 이미지 3개를 받아 사용자 경험이 풍부한 스라이드 쇼를 만드는 스크립트입니다. (있다고 칩시다 –;) 바로뒤에 NOSCRIPT 태그를 사용해 스크립트가 동작하지 않는 브라우저에게 대신할 수 있는 콘텐츠를 제공하고 있습니다.

꽤 괜찮은 방법이라고 생각합니다. 자바스크립트가 구동되지 않는 환경에서도 콘텐츠에 접근할 수 있으며 IMG에 alt 를 제공하고 링크까지 걸려 있어 검색엔진도 좋아하는 형태입니다.

이 예에서의 문제는 NOSCRIPT 태그의 근본적인 문제입니다. 브라우저는 자바스크립트를 지원하지만 자바스크립트 파일을 통제하는 네트웍 환경 (보안상의 이유로?)에 있거나 자바스크립트를 다운로드 하지 못한 경우 사용자는 아무것도 볼 수 없게 됩니다.

NOSCRIPT (자바스크립트를 켜세요 ?)

우리는 사용자가 왜 자바스크립트가 동작하지 않는 브라우저를 사용하는지, 자바스크립트를 비활성화 시켰는지 알지 못합니다. 그런 상황에 사용자에게 “이래라, 저래라” 하는것은 좋은 방법이 아닙니다. 그리고 위 지시 문은 사용자가 자바스크립트가 뭔지 알고 있고, 자바스크립트를 활성화 시킬 수 있다고 가정하고 있습니다. 하지만, 태반의 사용자가 이런 사항 잘 알지 못합니다. 순전히 개발자의 관점에서 작성된 겁니다.

반성합니다 !! 저도 두번째 예제 코드를 무수히 만들었습니다. 변명을 하자면 KADO-WAH 초기 버전에서 (지금은 안 그렇죠?) SCRIPT 태그 이후에 NOSCRIPT 가 없는 경우 오류 (경고?)로 잡았었습니다. 그래서 기계적으로 SCRIPT 태그가 있는 곳에 NOSCRIPT (자바스크립트를 켜세요) 를 넣었고, 이게 또 HEAD 안에서는 P 태그 등이 올 수 없기 때문에 모든 SCRIPT/NOSCRIPT 태그를 BODY 밑으로 내리는 작업을 했습니다.  반성합니다.

Graceful Degradation 접근 방법

위의 두가지 예제를 보면 구현 모양은 다르지만 동일한  Graceful Degradation 접근 방법을 사용하고 있습니다.

자바스크립트로 slide.js 라는 사용자 경험 풍부한 기능을 먼저 만들고 자바스크립가 지원되지 않는 환경을 위해 NOSCRIPT를 이용해 추가(개선) 작업을 하고 있습니다. 이것이 뒤에서 말하려는 Progressive Enhancement 과 대조되는 부분입니다.

Progressive Enhancement

“점진적 향상” 이라고 번역할 수 있겠습니다.

말 그대로 기능을 점진적으로 향상시키는것을 말합니다. 바로 웹과 결부해서 말하자면

1. HTML 로만 콘텐츠를 구성합니다. (CSS 를 지원하지 않는 브라우저에서도 접근 가능합니다.)
2. CSS 로 시각적인 향상을 꾀합니다. (HTML은 이미 구성되었으므로 외부 CSS파일이 적당하겠네요.)
3. Javascript 를 적용해 사용자 경험을 향상 시킵니다. (역시 외부 js 파일을 두고 이벤트를 가로채는 방법으로 사용해야겠네요)

1.2.3 의 순서로 점차적으로 향상 시키고 있습니다. 이렇게 구현했을 때 나중에 나온 기술(css, javascript)들이 지원되지 않더라도 콘텐츠에 접근하는데 무리가 없습니다. 추가로 얻을 수 있는 장점은 이 방법을 사용하면 밑에 예제를 봐도 알겠지만 구조, 표현, 동작이 자연스럽게 분리된다는 점입니다. 단계적으로 html, css, js 가 추가되기 때문입니다. (솔깃하네요.)

직접 Progressive Enhancement 방법을 사용해 구현을 해 보겟습니다. 예제로는 어느 사이트에나 있는 FAQ를 사용합니다.

1. HTML 구성

위의 FAQ는 에디트플러스 사이트에서 가져왔습니다. FAQ 목록에 DL 을 사용하는게 적절한지는 논외로 하겠습니다. HTML 만 사용했을 때 질문과 답변을 구분할 수 있도록 하는 목록 태그로는 적절하다고 생각해서 사용했습니다.

HTML만 적용된 화면

1단계에서 중용한 건 의미 있는 마크업을 논리적인 순서에 따라 구축하는게 중요하겠습니다. 물론, 이를 만족하기 위해서는 웹 표준을 준수하는게 우선되어야 할거고요.

하지만, 기획팀 으로부터 넘어온 스토리보드, 화면설계와 디자인팀으로 부터 잘려 넘어온 이미지들을 보고 있으면 당최 논리적으로 짜보기가 두려워 집니다. 뭐, 이런걸 잘 하는것도 우리의 능력중의 하나라고 봐야겠습니다. (전 멀었습니다.;;)

2. CSS 적용

CSS 까지 적용된 화면

네, 이쁘지 않은거 압니다. 제 미적감각이 이정도입니다. (사실, 최선을 다하지 않았다고 변명을 … ㅠㅠ)

3. javascript 적용

javascript 까지 적용된 화면

네, 썩 좋지 않은거 압니다. (사실, 돌아가게 만드는게 우선이엇다는 변명을 … ㅠㅠ 정말 오랜만에 mootools 없이 javascript 만들어봤네요;;)

좋지 않은 예이긴 하지만, HTML → CSS → javascript 수순으로 점진적으로 향상시키고 있음을 주목해주세요.

위의 예는 faq.htm 에서 보실 수 있습니다. (ie8, firefox 에서만 테스트 되었습니다.)

정리

구현할 때 “누가 요새 javascript 안되는 브라우저를 쓰겠어?” 라는 생각이 들 정도로 자바스크립트는 대부분의 브라우저에서 지원하고 있는게 사실입니다. 사실, 그냥 막 써도 이로인한 불평(자바스크립트가 안되는 환경에서의 불평)도 들어본적이 없습니다. 아마, 사용자들 스스로가 감내하고 있겠지요. 하지만, 웹 접근성을 생각하고 이를 보장하고자 한다면 자바스크립트에 의존하는 코드를 사용해서는 안되겠습니다. href=”javascript:…” , href=”#” onclick=”" 이러 코드 때문에 얼마나 많은 시간을 웹 접근성 개선을 위해 허비했는지 … Progressive Enhancement  방법을 수행하는게 쉬운것만은 아닙니다. 아마 Graceful Degradation 과 비교해서 시간, 노력 등의 자원을 더 필요로 할겁니다. 기 구축된 사이트를 개선하는 작업에 있어서는 Progressive Enhancement 보다 Graceful Degradation 을 선택하는게 더 현명한 방법일지도 모르겠습니다. 하지만 잊지말아야 할 원칙 하나는 “Web for All”. 팀 버너스 리의

웹의 힘은 그것의 보편성에 있다. 장애에 구애없이 모든 사람이 접근할 수 있는 것이 필수적인 요소이다.
(The power of the Web is in its universality, Access by everyone regardless of disability is an essential aspect.)

라는 것이겠지요.


출처 : http://www.yangkun.pe.kr/post/874

SELECT 컬럼,
        LTRIM(sys_connect_by_path(컬럼,','),',') AS 컬럼명
FROM  (
        SELECT 컬럼,
        menurole_id,
        row_number() OVER (partition by 그룹컬럼 order by 정렬할컬럼) rn,
        COUNT (*) OVER (partition by 그룹컬럼 ) cnt
        FROM 테이블명
)
WHERE level = cnt
start with rn = 1
connect by prior 그룹컬럼 = 그룹컬럼 and prior rn = rn-1

====================================================================

 세로로 출력되는 값들이 가로로 출력되는걸 확인할수 있다.

컬럼1   컬럼2

1                  나

2                  너

1                  우리

1                  개똥이

컬럼1       컬럼2

1                 나,우리,개똥이

2                 너


출처 : http://kinjsp.pe.kr/board/board_view.kin?boardId=721.0&boardTypeCode=1072&fastFlag=true&numberPerPage=10&pageNumber=0

출처 : http://kinjsp.pe.kr/board/board_view.kin?boardId=721.0&boardTypeCode=1072&fastFlag=true&numberPerPage=10&pageNumber=0

[tmax@test ~]$ ./jeus50-unix-vm.bin

Preparing to install...

Extracting the JRE from the installer archive...

Unpacking the JRE...

Extracting the installation resources from the installer archive...

Configuring the installer for this system's environment...

Launching installer...

Preparing CONSOLE Mode Installation...

===============================================================================

JEUS5.0                           (created with InstallAnywhere by Macrovision)

-------------------------------------------------------------------------------

===============================================================================

Introduction

------------

InstallAnywhere will guide you through the installation of JEUS5.0.

It is strongly recommended that you quit all programs before continuing with

this installation.

Respond to each prompt to proceed to the next step in the installation.  If you

want to change something on a previous step, type 'back'.

You may cancel this installation at any time by typing 'quit'.

PRESS <ENTER> TO CONTINUE:

===============================================================================

License Agreement

-----------------

Installation and use of JEUS5.0 requires acceptance of the following License

Agreement:

JEUS (Java Enterprise User Solution) Release JEUS5.x

TmaxSoft Co., Ltd. (hereafter, TmaxSoft) End-User License Agreement

Product : JEUS

This is a legal agreement between you (either an individual or an company) and

TmaxSoft, Incorporated.  By opening the sealed software package and/or by using

the software, you agree to be bound by the terms of this agreement.

TmaxSoft License

1.  Grant of License:  This TmaxSoft License Agreement ("License") permits you

to use one copy of the TmaxSoft product JEUS, on any single computer, provided

the software is in use on only one computer at any one time.  If this package

is a license pack, you may make and use additional copies of the software up to

the number of licensed copies authorized.  If you have multiple licenses for

the software, then at any time you may have as many copies of the software in

use as you have licenses.

  The software is "in use" on a computer when it is loaded into the temporary

memory (i.e., RAM) or installed into the permanent memory (e.g., hard disk,

CD-ROM, or other storage devices) of that computer, except that a copy

installed on a network server for the sole purpose of distribution to other

computers is not "in use".  If the anticipated number of users of the software

will exceed the number of applicable licenses, then you must have a reasonable

PRESS <ENTER> TO CONTINUE:

mechanism or process in place to ensure that the number of persons using the

software concurrently does not exceed the number of licenses.

2.  Copyright:  The software (including any images, "applets," photographs,

animations, video, audio, music and text incorporated into the software) is

owned by TmaxSoft or its suppliers and international treaty provisions.

Therefore, you must treat the software like any other copyrighted materials

(e.g., a book or musical recording) except that you may either (a) make one

copy of the software solely for backup or archival purposes, or (b) transfer

the software to a single hard disk provided you keep the original solely for

backup or archival purposes.  You may not copy the printed materials

accompanying the software, nor print copies of any user documentation provided

in "online" or electronic form.

3.  Other restrictions: This license is your proof of license to exercise the

rights granted herein and must be retained by you. You may not rent, lease, or

transfer your rights under this license on a permanent basis provided you

transfer this license, the software, and all accompanying printed materials,

retain no copies, and the recipient agrees to the terms of this license. You

may not reverse engine, decompile, or disassemble the software, except to the

extent that the foregoing restriction is expressly prohibited by applicable

law.

PRESS <ENTER> TO CONTINUE:

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y

===============================================================================

Choose Platform

---------------

Choose current system ( OS - architectures  )

1)HP-UX PA-RISC

2)Solaris Ultra-Sparc

3)AIX Power PC

4)Linux i386

Quit) Quit Installer

Choose Current System (DEFAULT: 4): 4

===============================================================================

Choose Install Folder

---------------------

Where would you like to install?

  Default Install Folder: /home/tmax/jeus5

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT

      :

===============================================================================

Choose Install Set

------------------

Please choose the Install Set to be installed by this installer.

  ->1- Full Install

    2- Typical

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT

   : 1

===============================================================================

Choose JDK Folder

-----------------

Please Choose a Folder:

Input User JDK Folder (DEFAULT: /usr):

===============================================================================

Password Input

--------------

Enter the Password for the administrator account.

This password will be registered in JEUS as the first user.

Input Password::

--------------------------

 This is a Wrong Password

--------------------------

    Above 7 characters

    a ~ z  A ~ Z  0 ~ 9

Input Password::

Corfirm Password::

===============================================================================

Pre-Installation Summary

------------------------

Please Review the Following Before Continuing:

Product Name:

    JEUS5.0

Install Folder:

    /home/tmax/jeus5

Install Set

    Full Install

Disk Space Information (for Installation Target):

    Required:  253,712,462 bytes

    Available: 94,800,117,760 bytes

PRESS <ENTER> TO CONTINUE:

===============================================================================

Installing...

-------------

 [==================|==================|==================|==================]

 [------------------|------------------|------------------|------------------]

===============================================================================

Installation Complete

---------------------

Congratulations! JEUS5.0 has been successfully installed to:

/home/tmax/jeus5

Press Done to quit the installer.

PRESS <ENTER> TO EXIT THE INSTALLER:

[tmax@test ~]$

USB메모리에 위키가 쏘옥~, Dokuwiki on a stick

호스팅서버에서 DokuWiki 사용

설치

문제 해결

E-mail 문제

Strato 호스팅 문제 해결

번역

DokuWiki 설명서

1. Requirements
다음과 같은 시스템 요구사항을 가진다. 일반적인 것이기 때문에 다음 소프트웨어의 설치는 생략한다.

• Java 1.4 이상
• tomcat 5.5 이상

2. 다운로드
다음 URL에서 JSPWiki를 다운받는다.
http://www.jspwiki.org/wiki/JSPWikiDownload
여기서 설치할 버전은 2.6.4를 기준으로 한다.

3. 설치
Zip 파일을 풀면 JSPWiki.war 파일이 있다. tomcat을 구동하고 webapps 밑에 복사한다.
여기 경우는 context root를 단순히 wiki로 하기 위해 wiki.war로 이름을 바꾸어서 webapps 밑에 넣었다.
tomcat 이 war를 풀면서 다음과 같은 에러가 발생한다. 일단 무시하고 tomcat을 내린다.

이제 war가 풀린 디렉토리에서 작업할 것이다. webapps/wiki.war는 삭제하고 풀린 webapps/wiki 만 남긴다. 주의할 점은 tomcat이 기동된 상태에서 wiki.war를 삭제하면 wiki 디렉토리도 삭제된다는 점이다.

4. WEB-INF/jspwiki.properties 수정
각종 wiki 데이터가 생성될 디렉토리가 필요하다. 여기서는 /home/wikidata 디렉토리 생성했다.

그리고 tomcat의 webapps/wiki 디렉토리 밑의 WEB-INF/jspwiki.properties 중 다음 내용을 수정한다.

그리고 다시 tomcat 시작...

5. 설치확인
다음 URL로 접속하여 설치사항을 확인한다. 물론 ip와 port는 자신의 환경에 맞게...
URL: http://localhost:8080/wiki/Install.jsp
처음에는 관리계정이 없다. 각각 설정을 확인하고 "Configure" 버튼을 클릭한다. 그러면 설치가 되고 admin 계정이 생성되고 임의적으로 생성된 Password를 알려준다.
생성된 admin 암호는 "Configure" 클릭한 다음 화면에 나타나니 화면이동 말고 잘 적어둔다.

6. 접속
다음 URL에 접속하고 admin으로 로그인해서 이것 저것 살펴본다. ^^
http://localhost:8080/wiki/

출처 : http://greatkim91.tistory.com/entry/JSPWiki-%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0

Continuous Integration(점진적 통합,이하 CI)이란, 개발자가 각각 개발한 소스코드를 모아서 한꺼번에 빌드하는 통합 빌드의 과정을 특정 시점이 아니라 매일이나 매주와 같이 아주 잦은 주기로 수행함으로써 통합에서 발생하는 오류와 시간을 줄이기 위한 기법이다.
Extreme Programming Community (XP)에서 애자일 방법론의 일부로 Kent Beck에 의해서 고안된 방법으로 다음과 같은 특징을 가지고 있다.

1. CI의 특징
(1) 소스코드 일관성 유지
CI툴을 설정하기 위해서는 기본적으로 소스 관리 시스템이 필요하다.
대표적인 소스 관리 시스템은 Subversion,CVS,Perforce등이 있다.
CI툴은 이 소스 관리 시스템으로부터 프로젝트 소스의 메인 브랜치(trunk 라고도 한다.) 코드를 Check out 받아서 빌드를 수행한다.

(2) 자동 빌드
소스 코드에 대한 빌드는 CI툴에 의해서 자동적으로 이루어 져야 한다.
빌드가 이루어지는 시점을 정하는 방법이 두가지가 있는데 다음과 같다.

1) 커밋에 따른 자동 빌드
다른 방법으로는 소스코드가 소스 관리 시스템에 커밋이 되었을 때 마다 CI툴이 이를 감지 하고 자동으로 빌드를 수행하도록 설정할 수 있다.
이렇게 설정할 경우 소스 코드의 변경이 있을 때 마다 빌드 작업을 수행하기 때문에 소스 관리 시스템에 저장된 소스 코드에 대한 무결성을 보장하기는 매우 좋지만, 빌드 시간이 길 경우 빌드가 적체 되는 현상이 발생할 수 있다.
(일반적으로 대규모 애플리케이션의 FULL 빌드는 길게는 2~3시간 까지 소요될 수 있다.) 그래서 이 방법은 빌드 시간이 오래 걸리는 경우나 커밋이 자주 발생하는 경우에는 적절하지 않다.

2) 시간 간격에 의한 빌드
일정 시간 간격을 정해서 빌드를 하는 방법이다. 매일 5시에 빌드를 한다. 또는 매주 금요일 저녁 5시에 빌드를 한다는 것과 같이 주기를 정할 수 있다. 빌드 스케쥴이 미리 정해져있기 때문에 개발자들이 커밋에 대한 스케쥴을 관리할 수 있고 빌드 시간이 오래걸리는 대규모 빌드에도 적정하다.
 빌드 시간을 정할 때 중요한 점은 가급적이면 퇴근 시간 1~2시간 전으로 개발자들이 퇴근하기 전 시간으로 여유를 두는 것이 좋다.
이후 빌드가 깨진 경우는 컴파일이 실패하였거나 테스트가 통과하지 못하였을 경우인데 이때 소스 관리 시스템에 저장된 코드는 문제가 있는 코드이다. (빌드가 깨졌기 때문에) 이 코드들을 다른 개발자가 체크아웃 받아서 개발을 했을 때 잘못된 코드로 인해서 잘못된 개발 방향으로 갈 수 가 있기 때문에 빌드가 깨졌을 때는 가급적 빨리 문제를 수정하여 빌드를 정상화 시키고 소스 관리 시스템에 저장되 코드의 무결성을 회복하거나 빌드가 성공한 전버전으로 BACK(Revert) 해서 무결성이 보장된 코드내에서 작업하도록 한다. Revert를 위해서는 소스 관리 시스템에 빌드때마다 Tagging을 해서 무결성이 보장된 버전에 대한 History를 관리해야 한다.

Silent period에 대해서
CI툴에서는 소스 관리 시스템으로부터 소스를 체크아웃 또는 업데이트 받을 때 Silent Period라는 옵션을 제공한다.
개발자가 소스를 커밋하고 있을 때 커밋이 완료되지 않은 상태에서 CI툴이 소스를 체크아웃하게 되면 불완전한 코드가 내려와서 빌드가 망가질 수 있다. 이를 방지하는 옵션이 Silent Period인데, 커밋이 있은후 일정 시간동안 소스 관리 시스템에 변화가 없을 때 CI툴이 체크아웃을 받아서 불완전한 코드를 내려 받을 수 있는 가능성을 최소화 하는 것이다.

이렇게 자동 빌드를 하면서 얻을 수 있는 이점은, 주기적인 빌드를 통해서 소스코드의 무결성 관리와 빅뱅방식의 통합에서 올 수 있는 리스크를 개발과정 전반으로 분산할 수 있다.

(3) 자동 테스팅
빌드 과정에서 테스트를 포함할 수 있는데, 주기적인 빌드 과정에 테스트를 포함해서 자동 빌드를 통한 Syntax에 대한 검증과 더불어 테스팅을 통한 기능과 비기능적(성능등)에 대한 요건을 매번 검증함으로써 코드의 품질에 대한 무결성을 함께 유지한다.

(4) 일일 체크아웃과 빌드
개발자가 출근후 소스 관리 시스템에서 최신 코드를 내려받고, 출근전에 현재 코드를 소스 관리 시스템에 저장함으로써 소스 코드에 대한 무결성을 유지한다.

예를 들어 개발자 A와 개발자 B가 같이 개발을 할 때, 개발자 A가 작성한 모듈을 개발자 B가 참고해서 사용한다고 하자, 이런 경우 개발자 A가 임의로 컴포넌트에 대한 작동 방식이나 인터페이스를 변경했을 때 일일 체크아웃과 빌드를 하면 개발자 A의 모듈을 사용하는 개발자 B의 모듈의 컴파일 오류나 또는 테스트 오류가 발생할 것이고 코드 변경으로 인한 임팩트를 빠르게 발견하여 수정할 수 있다.
그러나 통합 빌드의 과정이 일일이 아니거나 일일 체크아웃 빌드를 하지 않고 일주일이나 한달 단위로 할 경우 일주일동안 개발자 B는 잘못된 코드를 양산할것이고, 그 만큼의 시간 낭비가 발생한다.

일일 체크아웃과 빌드는 이를 방지해주는 역할을 한다.

2.CI 프로세스

CI에 대한 프로세스를 정리해보면 다음과 같다.
 

(1) 개발자
1) 개발자는 아침에 출근해서 소스 관리 시스템으로부터 최신 코드를 Checkout 또는 update받는다.
2) 코드를 가지고 개발을 수행하고 테스트를 작성한다.
3) 로컬에서 빌드 및 테스트를 진행한다.
4) 테스트과정에서 커버러지분석과 Code Inspection을 수행한다. (Optional)
 커버리지 분석
커버러지 분석은 테스트의 대상중에 테스트에 해당하는 부분중에 어느 부분이 테스트가 수행이 되었는지를 체크하는 과정이다. 개발 과정에서의 테스트 커버러지 분석은 일반적으로 코드 커버러지로 분석한다.
코드 커버러지란 테스트가 전체 소스 코드중 어느부분을 수행했는지를 검토하는 것이다.
코드 커버러지를 측정할 때 가장 중요한 것은 목표 커버러지율을 결정하는 것이다. 코드 100%를 테스트하는 것이 좋겠지만, Exception,If 문에 대해서 100% 테스트가 불가능하다. 또한 Setter와 Getter만 있는 ValueObject의 경우 테스트를 작성하는 것도 쉽고 테스트 자체가 의미가 없나 Coverate rate는 많이 올릴 수 있다. 만약 커버러지율을 강제적으로 높이고자 하면 개발팀에서 VO등 테스트가 필요하지 않고 테스트가 쉬운곳에만 테스트를 집중할 수 있기 때문에 컴포넌트의 우선순위를 정해서 중요한 컴포넌트에 대해서 커버러지를 관리하는 것이 필요하다.
커버러지율은 잘 만든 테스트라도 50~70% 내외이고, 고 가용성 시스템도 80%를 넘기 힘들기 때문에, 컴포넌트의 중요도별로 목표 커버러지율을 융통성 있게 결정하는 것이 필요하다.
대표적인 오픈소스 도구로는 EMMA와 Cobertura등이 있고, 상용 도구로는 Atlassian社의 Clover등이 있다.
 Code Inspection
Code Inspection이란, 완성된 코드에 대한 검토를 통해서 코드상에 존재하고 있는 잠재적인 문제를 발견하는 과정이다. 흔히 “정적 분석” 이라는 이름으로도 불리는데, 이 과정에서 Deadlock에 대한 검출 Lock contention과 같은 병목 구간에 대한 검출 Memory Leak이나 Connection Leak과 같은 자원 누수에 대한 검출과 코딩 스타일 (변수명이나 메서드명 규칙등)에 대한 가이드를 수행한다.
보통 이런 도구들은 룰 셋을 추가하여 Inspection을 각 팀의 스타일에 맞춰서 Customizing할 수 있으며 대표적인 오픈 소스 도구로는 PMD, FindBugs등이 있다.
5) 완료된 코드를 소스 관리 시스템에 저장한다.
완료된 코드와 테스트를 소스 관리 시스템에 커밋한다.

(2) CI Tools

1) 체크아웃
CI Tools는 정해진 시간이나 소스가 커밋이 되었을 때 등 정책에 따라서 빌드를 시작한다. 먼저 소스 코드를 체크아웃 받는다.
2) 컴파일
체크아웃 받은 코드에 내장되어 있는 빌드 스크립트를 기동하여 컴파일을 수행한다.
3) 배포
컴파일이 완료된 코드를 테스트 서버에 배포한다.
4) 테스트 수행
체크아웃 받은 코드내에 있는 테스트 코드들을 수행하고 리포팅을 한다.
5) 커버러지 분석
테스트 과정중에 코드 커버러지를 수행한다.
커버러지의 기본 원리는 커버러지 분석 대상이 되는 코드내에 커버러지 분석 코드를 삽입하여 테스트가 완료된 후에 그 결과를 수집하여 분석을 하는데 분석 코드를 삽입하는 과정을 Code Instrument라고 한다. Instrumented된 코드는 커버러지 분석 기능으로 인해서 성능 저하를 유발할 수 있기 때문에 만약에 테스트 과정에 성능이나 응답시간에 관련된 테스트가 있을때는 커버러지 분석을 위해서 테스트를 마친후에 Instrument를 다시하여 3),4) 과정을 다시 거쳐서 커버러지 분석을 해야 테스트 과정에서 성능에 대한 요소를 올바르게 추출할 수 있다.
6) Code Inspection
다음으로 Code Inspection을 수행하고 리포트를 생성한다.
7) 소스 태깅
1)~6) 과정이 정상적으로 수행되었을 때, 현재 소스 관리 시스템에 저장된 버전을 안정적인 버전으로 판단하고 소스 관리 시스템에 현재 버전에 대한 이미지를 저장하기 위해서 Tagging을 수행하여 현재 버전을 저장해놓는다.
8) Reverse (Optional)
만약에 빌드나 테스트가 실패하였을때는 이전에 성공한 빌드 버전으로 소스를 롤백하고, 실패의 원인을 파악한후에 다시 커밋한다.
이것은 소스 관리 시스템에 저장된 소스는 문제가 없는 소스를 항상 유지하여 개발자들이 문제가 없는 소스로 작업을 할 수 있게 보장해주며, 릴리즈가 필요한 시기에 언제든지 릴리즈가 가능하도록 지원해준다.
9) 결과 분석
빌드와 테스트가 완료된 후에 테스트 결과서를 통해서 문제가 있는 테스트를 개발자가 수정하도록 하고, Code Inspection결과를 PM이 검토하여 담당 개발자가 수정하도록 한다.
다음으로 Coverage 분석 결과를 통해서 테스트가 부족한 부분은 PM이 담당 개발자에게 지시항 테스트를 보강하도록 한다.

3.Hudson 설치

(1) Hudson의 설치 및 기동

1) https://hudson.dev.java.net/ 에서 hudson을 다운로드 받는다.
2) 다운로드 받은 Hudson.war를 Apache Tomcat에 deploy해서 구동 하거나 도는 java –jar hudson.war로 hudon으르 기동한다. 디폴트로 설치된 hudson은 8080포트를 통해서 접근이 가능하다. (Tomcat을 통해서 설치 하지 않은 경우)

WAS에 인스톨 정보
http://hudson.gotdns.com/wiki/display/HUDSON/Containers

(2) Hudson과 소스 관리 시스템 연동
좌측 메뉴에서 “New Job”을 선택하여 새로운 작업을 등록한다.
Job name을 선택하고 “Build a free-style software project”를 선택한다. 아직까지 다른 빌드 선택은 안정화 되어있지 않기 때문에 이 메뉴를 중심으로 설명한다.
 

(3) 소스 관리 시스템과 연동
Job이 생성되고 나면 초기화면에서 Job을 선택할 수 있다 Job을 선택하면 좌측에 Configure라는 메뉴가 생기는데, 그 안으로 들어가면 Job에 대한 설정을 할 수 있다.

먼저 소스 관리 시스템으로부터 코드를 내려받도록 설정해야 한다.
“Source Code Management”에서 사용하는 소스 관리 시스템을 선택한다.
이 예제에서는 Subversion을 선택한다.
Subversion을 선택한후 Repository URL에 SVN접근 주소를 입력한다.
svn://source.example.com/trunk 그 아래에 “Local module directory”에 SVN 레파지토리의 하위 디렉토리를 선택한다. “/myproject” 식으로
이렇게 하면 svn://source.example.com/trunk/myproject 에서 소스 코드를 매번 내려받게 된다. Repository URL과 Location을 지정하면 Hudson이 자동으로 SVN에 접속을 시도해본다. 만약에 id와 passwd가 필요한 경우에는 아래 그림과 같이 “enter credential”이라는 링크가 Repository URL 아래 나타나서 id와 passwd를 입력할 수 있게 한다.
 

 Use Update
소스 관리 시스템에서 소스를 내려받을 때 디폴트가 모든 소스를 매번 다운로드 받는것인데 이런 경우에는 소스양이 많을 경우 다운로드에 많은 시간이 소요되서 전체 빌드 시간이 늘어날 수 있다. 이때 “Use Update”라는 옵션을 사용하면 처음에만 소스 코드를 전체 다운로드 받고, 두번째 부터는 변경된 소스 코드만 다운로드 받기 때문에 소스 코드를 다운 받는 시간을 많이 줄일 수 있다. (svn update와 같은 명령)

 Repository Browser
Repository Browser란 소스 관리 시스템에 저장된 소스의 내용 웹에서 브라우징할 수 있는 도구이다. 도구에 따라서 이전 버전과 변경된 부분에 대한 Diff비교 또는 처음 소스 코드가 생성되었을 때부터 매번 커밋되었을 때 변경 내용에 대한 Revision등에 대한 모든 히스토리를 출력해준다. 이런 기능은 빌드가 깨졌을 때, 바로 빌드 버전에 대한 소스 변경 내용을 추적하여 누가 어떤 코드를 변경하였는지를 추적하여 가능한한 빠른 시간내에 문제를 해결하게 해준다.
이 옵션을 체크해놓으면 빌드가 완료된후 Job의 Changes를 보면 소스 코드가 변경된 부분에 대해서 Repository Browser로 링크가 걸려서 소스를 웹에서 바로 확인하거나 전버전에서 바뀐 부분을 확인할 수 있다.
대표적인 Repository Browser로는 오픈소스 제품인 Sventon과 상용제품인 Fisheye등이 있다.

(4) 빌드 트리거링
다음 설정해야 하는 부분이 Build Triggers 설정이다.
이 설정은 언제 빌드가 돌아야 하는가를 설정하는 부분으로 3가지 옵션을 제공한다.

1) Build after other projects are built
이 옵션에는 다른 Job(Project)의 이름을 인자로 넣는다.
이렇게 하면 지정된 프로젝트의 빌드가 정상적으로 끝나면 자동으로 이 프로젝트가 Invoke된다. 만약에 빌드만 하는 Job과 테스트만 하는 Job이 있고 테스트는 자주 사용하고 빌드후에 반드시 테스트를 해야할 때, 테스트 Job에서 이 옵션으로 선행작업을 빌드로 해놓으면 빌드를 수행할 때 마다 빌드가 성공하면 테스트를 수행하게 된다. 테스트만 수행하면 빌드와 상관없이 테스트만 수행된다.
이 옵션은 프로젝트 실행의 전후 관계(Chainning)을 하는데 매우 유용하게 사용할 수 있다.

2) Poll SCM
이 옵션을 사용하면 여기에 지정한 주기별로 소스 관리 시스템을 폴링(체크)하여 변경이 있을 경우에만 빌드를 수행한다.
 

시간 설정 방법은 unix의 crontab 명령과 같은 형식으로 아래와 같은 형식을 사용한다.
분 시간 날짜 월 요일

사용 예는 다음과 같다.
# 매일 12시에 실행
00 12 * * *
# 매주 일요일 1시에 실행
00 01 * * 7
# 매일 12시와 5시에 실행
00 05 * * *
00 12 * * *

3) Build periodically
마지막으로 Build periodically는 정해진 시간 주기별로 소스가 변경과 상관없이 무조건 주기적으로 빌드를 수행하며 Poll SCM과 마찬가지로 crontab과 같은 형식으로 스케쥴을 등록한다.

(5) Build
정해진 스케쥴 정책에 따라 빌드 프로세스가 기동되면 실제 빌드를 수행할 빌드 스크립트가 구동되어야 하는데, Hudson에서는 ANT,MAVEN,그리고 Unix/Windows shell을 수행할 수 있도록 되어 있다. 여기서는 ANT 기반으로 설명을 한다.
 

Invoke ANT를 선택 하면 다음과 같은 옵션을 선택할 수 있다.

 ANT Version
Hudson 초기화면에서 “Manage Hudson”메뉴로 들어가면 “System configuration” 메뉴에서 여러 개의 ANT_HOME을 등록할 수 있다.
ANT 버전에 따라서 플러그인이 차이가 날 수 도 있고, 프로젝트에 따라서 사용해야 하는 ANT 버전이 틀릴 수 있기 때문에 여러 개의 ANT를 등록할 수 있게 해준다.
예를 들어 프로젝트가 JUnit 3.8대와 JUnit 4.X대로 각각 구현되어 있다면 ANT에 설치되어야 하는 JUnit 라이브러리 버전이 틀리기 때문에 두개의 ANT를 설정해야 할 수 있다. 이런 경우에 “System configuration”에서 ANT를 여러 개 등록해놓고, 이 ANT Version 메뉴에서 필요한 ANT 버전을 선택하면 된다.

 Target
ANT 스크립트의 Target을 설정한다.

 Build File
ANT 스크립트를 지정한다. 일반적으로 build.xml을 지정한다.

 Properties
ANT 스크립트에 전달해야 하는 Property를 지정한다.
예를 들어 스크립트내에 $workspace라는 변수를 지정하였을 경우 –Dworkspace=값 이런식으로 텍스트 상자에 정의하면 빌드 스크립트로 인자를 전달할 수 있다.

 Java Options
ANT 를 기동하는데 필요한 자바 옵션을 지정한다. ANT도 자바 프로그램이기 때문에 여러가지 JVM 옵션이 지정되는데 Heap,Perm size등을 여기서 –Xmx256m 식으로 지정하여 이 옵션으로 ANT 프로세스를 실행할 수 있다.

여기 까지 설정하면 주기적으로 빌드를 자동화 하는 설정이  완료 되었다.

(6) Hudson의 사용
초기화면에 들어가면 등록된 프로젝트 리스트들이 나온다.
 

초기화면에서 프로젝트를 클릭하면 아래와 같은 화면이 나오는데
 

(7) Hudson과 Email 연동
Hudson 초기화면에서 Manage Hudson > System Configuration 메뉴에 들어가면 Email-Notification 설정부분이 있는데, 여기 SMTP 서버를 설정해주면 빌드가 실패하였을 때 등에 담당자들에게 메일로 통보를 할 수 있다. SMTP 설정을 한후 프로젝트의 configuration 메뉴에서 Post-build Actions에서 Email Notification에 Receipients에 이메일 주소를 적어놓으면 빌드가 실패했을때와 실패한 빌드가 복구 되었을 때 이메일이 발송된다.
 

(8) JUnit 테스트 연동
CI에 대해서 설명할 때 Test에 대해서 설명했는데, Hudson에서는 JUnit Test Report를 출력해주는 기능을 지원한다.
프로젝트 configuration에서 Post-build actions의 “Publish JUnit test result report” 메뉴에서 JUnit 리포트 파일명을 지정해주면 아래와 같이 테스트가 끝나고 테스트 리포트가 생성되면 테스트 성공 실패 여부를 그래프로 나타내주고, 테스트의 Progress도 누적 그래프로 프로젝트 초기화면에서 출력해준다.

이때 주의할점은 JUnit의 테스트 리포트의 파일 경로는 절대 경로가 아니라 프로젝트 Workspace에 대한 상대 경로이기 때문에 상대 경로로 지정해야 한다.

(9) Hudson과 Japex를 이용한 부하 테스트 연동
Japex는 단위 테스트에 대한 부하 테스트를 할 수 있는 단위 부하 테스트 자동화 프레임웍이다. Japex에 대한 사용 방법은 단위 테스트의 “단위 부하 테스트” 부분을 참고하기 바란다.
Japex 역시 JUnit과 마찬가지로 성능에 대한 결과 (테스트 소요 시간)를 그래프로 출력할 수 있다. JUnit과 설정 방법이 같으며 프로젝트 > configuration > Post-build Actions > Record Japex test report에 Japex 테스트 리포트 경로를 추가하면 된다.
 
설정이 제대로 됐으면 테스트 수행후에 왼쪽에 Japex Trends Report라는 메뉴가 생겨서 성능 테스트에 대한 결과를 누적 그래프로 출력해준다.

Japex 테스트 플러그인은 Hudson에 Default로 포함된 것이 아니기 때문에 http://hudson.dev.java.net에서 다운받아서 Hudson에 추가로 설치해줘야 한다.

(10) Hudson과 Cobertura를 이용한 Coverage분석
Coverage 분석에 대해서는 EMMA와 Cobertura, Clover에 대한 확장 플러그인을 제공하는데, 플러그인을 설치한후 JUnit과 Japex와 동일한 방법으로 리포트에 대한 위치를 등록해주면 아래와 같이 커버러지의 누적 그래프를 클래스별,라인별,브랜치별로 출력해준다.
 

(11) 그외의 기능들
본 문서에서는 Hudson에 대한 대략적인 기능을 살펴보았다.
Hudson은 이 이외에도 여러 개의 Hudson 인스턴스를 구성하여 클러스터된 빌드환경을 구축할 수 있다. 여기서 클러스터란 로드분산이나 장애 대응등의 의미가 아니라,
하나의 소스 코드를 가지고 Windows,AIX,HP 버전으로 각각 빌드가 필요할 때, 각 서버에 Hudson을 따로 설치하고 각각 관리하는 것이 아니라 설치는 각각 하더라도 하나의 콘솔화면에서 컨트롤을 하도록 설정이 가능하다.
또한 여러 확장 플러그인을 통해서 기능 확장이 가능하다.

(12) Hudson 사용시 주의할점
Hudson은 이미 JBoss 프로젝트나 기타 상용 프로젝트에서 사용될정도로 매우 널리 쓰이고 안정적인 버전이다. 그럼에도 불구하고 오픈 소스의 한계점과 잦은 업그레이드로 인해서 잠재적인 버그가 있고 특히 플러그인들의 버전이 Hudson의 버전 업그레이드를 쫓아가지 못해서 일부 플러그인들은 하위 버전에서만 작동하고 최신 버전에서 작동하지 않는 경우가 있기 때문에 자신이 사용하고자 하는 플러그인들에 맞는 Hudson 버전을 사용하는 것이 중요하다.
여기서 소개된 플러그인들은 Hudson 1.7 버전을 기준으로 사용 및 검증이 되었다.

4. 그외의 CI Tools
예전에는 CI 툴이 Cruise Control이나 Ant hill이 주류를 이루고 있었으나,
Hudson이 등장하면서 많은 프로젝트들이 쉽고 직관적인 인터페이스와 확장성으로 인해서 많이 사용되고 있다.
TeamCity의 경우 일반 버전은 무료로 제공되며 TeamCity Pro는 상용이다. 무료 버전도 상용 코드를 기반으로 하는 만큼 Hudson에 비해서 높은 안정성을 가지고 있으다.
AntHill Pro 역시 꾸준히 Java 진영의 CI도구로 사용되고 Atlassian의 Bamboo도 근래에 들어 많이 프로젝트에 사용되고 있다.

Hudson을 이용한 빌드와 테스트의 자동화.doc

invalid-file

CI 스터디에서 참관멤버인 kenny 군이 소개한 CI TOOL인 hudson 이 무료이면서 기능 또한 상당히 좋은것 같아 바로 설치해 보았다.
(설치한 날은 꽤 지났는데, 이제야 포스팅 하네요;;)

JDK 1.6 설치
http://java.sun.com
Java SE Development Kit 6u7
jdk-6u7-solaris-sparc.sh  79.45 MB 
Java SE Development Kit 6u7
jdk-6u7-solaris-sparcv9.sh  10.79 MB 

64bit 시스템이라서 solaris-sparcv9 도 설치

[hostname:/usr/jdk] sh ./jdk-6u7-solaris-sparc.sh
라이센스 읽고 나서 yes 입력후 ENTER
[hostname:/usr/jdk] sh ./jdk-6u7-solaris-sparc.sh
라이센스 읽고 나서 yes 입력후 ENTER

/usr/jdk/jdk1.6.0_07 에 설치완료

ciuser 사용자계정생성
useradd -g other -d /export/ciuser -s /bin/ksh ciuser

tomcat 설치
http://tomcat.apache.org/download-60.cgi
/export/ciuser 에 압축 해제.
/export/ciuser/apache-tomcat-6.0.16/conf/server.xml 에서 port 8080 에서 8090 으로 변경

ant 설치
http://ant.apache.org/bindownload.cgi
/export/ant 에 압축 해제.

hudson 설치
https://hudson.dev.java.net/servlets/ProjectDocumentList?folderID=2761&expandFolder=2761&folderID=0
에서 최신버젼을 다운로드
/export/ciuser/apache-tomcat-6.0.16/webapps 에 hudson.war 를 복사한다.
ROOT direcotry로접근 (http://xx.xxx.xxx.xxx:8090/)을 위해 tomcat 의 $CATALINA_HOME/webapps 밑에 모든파일 삭제후  hudson.war 를 webapps 에 복사후 ROOT.war 로 이름변경
자세한 사항은 다음을 참고한다.
http://hudson.gotdns.com/wiki/display/HUDSON/Tomcat

환경변수및 PATH 설정
다음과 같이 환경변수 및 PATH 를 설정한다.(.profile)
vi /export/ciuser/.profile

hudson 사용을 위한 모든 준비작업이 완료됐다.
이제 접속해 보자.
서버의 아이피를 12.12.12.12 로 가정하자.

http://12.12.12.12:8090/
다음과 같이 처음화면이 나온다.

Hudson#

• Hudson 시작하기
• Hudson plugin 설치하기
• Hudson Junit 리포트 생성하기
• Hudson PMD 리포트 생성하기
• Hudson FindBugs 리포트 생성하기
• Hudson Clover 리포트 생성하기

출처 : http://openframework.or.kr/Wiki.jsp?page=Theory#section-Theory-Hudson

필수 플러그인

• Spring IDE

  • update site : http://springide.org/updatesite/
  • http://blog.openframework.or.kr/140

• M2eclipse

  • update site : http://m2eclipse.sonatype.org/update/

• Subclipse

  •  http://subclipse.tigris.org/update_1.6.x

• Subversive

  • update site : 반드시 2개를 다 깔아야 함

    • Subversive plug-in : http://download.eclipse.org/technology/subversive/0.7/update-site/
    • Subversive SVN Connectors : http://www.polarion.org/projects/subversive/download/eclipse/2.0/update-site/

설치하면 좋은 플러그인

• jad eclipse : class 파일을 역컴파일해서 보여줌

  • update site : http://java.decompiler.free.fr/jd-eclipse/update
  • 설정방법:
  
  
  

• More Junit : Junit테스트코드와 실행코드 사이를 왔다갔다하는 것을 편하게함

  • update site : http://moreunit.sourceforge.net/org.moreunit.updatesite/

• EclEmma

  • update site : http://update.eclemma.org/

cn출처 : http://benelog.springnote.com/pages/4214931

Confluence 3.4.x

User's Guide

The Confluence User's Guide is for project managers, developers, testers – anyone who uses Confluence. New to Confluence? Start by exploring the Confluence dashboard and learning about spaces, pages and blog posts. Try creating a new space, then add a page to that space, add some content and a comment to that page and then export the page to PDF. Using the SharePoint Connector? Visit the SharePoint Connector User's Guide. Want to build up your skills from white belt (beginner) to Confluence master? Try our wiki ninja tutorial. Interested in what other people are doing with Confluence or want to share your own tips? See our tips via Twitter and tips of the trade pages.

Administrator's Guide

The Confluence Administrator's Guide is for people with Confluence administration rights. It will help you set up users and groups, security for users, groups and spaces, and keep track of any changes and updates made within your Confluence site. You may want to customise the look and feel of Confluence, by applying a theme to a space or modifying colour schemes and layouts. Admin tasks such as backup are also covered. You may also find the Knowledge Base, FAQ and the Confluence Announcements and User forums useful. If you are using the Confluence SharePoint Connector, see the SharePoint Connector Administrator's Guide.

Installation Guide

The Confluence Installation Guide is for people who are installing Confluence for the first time. Check the requirements and supported platforms, then download and install Confluence. Where to next? The Confluence 101 will help you get started. When setting up Confluence, load the Example Site ('Demonstration Space'), which contains a tutorial and additional content to help you get familiar with using Confluence. For help with installing and configuring the Confluence SharePoint Connector, see the SharePoint Connector Installation and Upgrade Guide. If you are using other Atlassian products, take a look at the Integration Guide.

Upgrade Guide

The Confluence Upgrade Guide is for people who are upgrading their instance of Confluence. Start by reading the latest Release Notes, the Upgrade Notes Overview and version-specific Upgrade Notes for the version to which you are upgrading. Then, download Confluence and follow the main Upgrade Guide.

Developer Resources

These resources are for software developers who want to create their own plugins for Confluence. Take a look at the Confluence developer documentation and the API documentation. You may also find the Confluence developers forum useful. (Click here to subscribe.)

Trac 소개

Trac 설치

ubuntu 8.10 데스크탑 / 서버 설치

http://ayasaki.egloos.com/4069282

Trac 한글

한국어 환경을 위한 Trac 설정

http://pplab.cs.kookmin.ac.kr/projects/ctms/wiki/TracForKorean

한글로 표시되는 Trac 사용하기

http://scolor.tistory.com/26

Trac Plugins

Trac eclipse plugin  http://trac-hacks.org/

Trac plugin 설치

Trac 으로 Project 관리하기

trac, Ticket system과 workflow의 이해

Trac 사용 : http://beatblue.tistory.com/304

이슈 트래커 개발자가 들려주는 이슈 트래커 이야기

1회(2007년 11월): 무엇을 어떻게 골라쓸까

2회(2007년 12월): 이슈 트래커를 슬기롭게 활용하자

Why do I get an error when accessing secured web sites

http://wiki.eclipse.org/Mylyn/FAQ#Why_do_I_get_an_error_when_accessing_secured_web_sites.3F

참조

• 우분투 Trac webadmin 설치 및 Trac login 설정법
• http://silent2k.tistory.com/118
• Trac 사용 소감 : http://blog.tnccompany.com/153

출처 : http://gtko.springnote.com/pages/2958612

시작

이 기사에서는 까다로운 상황을 처리하는 데 필요한 Android SDK 도구 중 일부에 대해 다룬다. Android 애플리케이션을 개발하려면 JDK(Java Development Kit)가 필요한 최신 Android SDK가 필요하다. 필자는 Android 2.2 및 JDK 1.6.0_17을 사용했다(이러한 도구에 대한 링크는 참고자료 참조). 실제 장치는 없어도 된다. 이 기사에 있는 모든 코드는 SDK와 함께 제공되는 Android 에뮬레이터에서 정상적으로 실행된다. 이 기사에서는 기본적인 Android 개발에 대해서는 설명하지 않기 때문에 사용자는 Android 프로그래밍에 익숙해야 한다. 하지만 Java 프로그래밍 언어에 대한 지식이 있으면 이 기사의 내용을 이해할 수 있을 것이다.

위로

동시성 및 네트워킹

Android 애플리케이션의 가장 일반적인 태스크 중 하나는 네트워크를 통해 데이터를 검색하거나 원격 서버로 전송하는 것이다. 이 조작을 수행하면 사용자에게 표시하기 원하는 일부 새로운 데이터가 생성되는 경우가 자주 있다. 이는 사용자 인터페이스를 수정해야 한다는 것을 의미한다. 대부분의 개발자는 사용자가 기본 UI 스레드에서 네트워크(특히 네트워크 연결 속도가 매우 느린 휴대전화)를 통해 데이터에 액세스하는 것과 같은 잠재적인 장기 실행 태스크를 수행해서는 안 된다는 것을 알고 있다. 이러한 장기 실행 태스크를 수행하면 해당 태스크가 완료될 때까지 애플리케이션이 멈춘다. 실제로 이 태스크를 수행하는 데 5초 넘게 걸리는 경우 Android 운영 체제는 그림 1에 있는 악명 높은 Application Not Responding 대화 상자를 표시한다.

사용자의 네트워크 연결 속도가 얼마나 느릴지는 알 수 없다. 모험을 피하기 위해서는 이러한 태스크를 다른 스레드에서 수행해야 하거나 최소한 기본 UI 스레드에서는 수행해서는 안 된다. 대부분은 아니더라도 다수의 Android 애플리케이션은 복수의 스레드를 처리해야 하기 때문에 동시성을 처리해야 한다. 애플리케이션에는 데이터를 로컬로 유지해야 할 경우가 있는데 이 경우 Android의 로컬 데이터베이스가 매력적인 옵션이다. 이러한 세 가지 시나리오(다른 스레드, 동시성 및 로컬로 데이터 유지) 모두에는 Java 환경에서 이러한 사항을 수행하는 일부 표준 방식이 있다. 하지만 이 기사에서 알 수 있듯이 Android는 일부 다른 옵션을 제공한다. 이러한 각각의 옵션과 이러한 옵션의 장단점에 대해 살펴본다.

위로

Android 네트워크

Java 프로그래밍에서 네트워크를 통해 호출을 작성하는 것은 간단하다. 익숙한 java.net 패키지에는 이를 수행하는 데 필요한 몇 가지 클래스가 포함되어 있다. 이러한 클래스는 대부분 Android에도 있으며 다른 Java 애플리케이션에서와 같이 실제로 java.net.URL 및 java.net.URLConnection과 같은 클래스를 사용할 수 있다. 하지만 Android에는 Apache HttpClient 라이브러리가 포함되어 있다. 이 방식은 Android에서 네트워킹을 수행하기 위해 선호되는 방법이다. 일반적인 Java 클래스를 사용하는 경우라도 Android의 구현에서는 계속 HttpClient를 사용한다. Listing 1에서는 이 필수 라이브러리의 사용 예를 보여 준다. (모든 소스 코드는 다운로드를 참조한다.)

private ArrayList<Stock> fetchStockData(Stock[] oldStocks) 
    throws ClientProtocolException, IOException{
    StringBuilder sb = new StringBuilder();
    for (Stock stock : oldStocks){
        sb.append(stock.getSymbol());
        sb.append('+');
    }
    sb.deleteCharAt(sb.length() - 1);
    String urlStr = 
        "http://finance.yahoo.com/d/quotes.csv?f=sb2n&s=" + 
                sb.toString();
    HttpClient client = new DefaultHttpClient();
    HttpGet request = new HttpGet(urlStr.toString());
    HttpResponse response = client.execute(request);
    BufferedReader reader = new BufferedReader(
            new InputStreamReader(response.getEntity().getContent()));
    String line = reader.readLine();
    int i = 0;
    ArrayList<Stock> newStocks = new ArrayList<Stock>(oldStocks.length);
    while (line != null){
        String[] values = line.split(",");
        Stock stock = new Stock(oldStocks[i], oldStocks[i].getId());
        stock.setCurrentPrice(Double.parseDouble(values[1]));
        stock.setName(values[2]);
        newStocks.add(stock);
        line = reader.readLine();
        i++;
    }
    return newStocks;
}

이 코드는 Stock 오브젝트의 배열을 포함한다. 이러한 오브젝트는 사용자가 소유하는 주식에 대한 정보(예: 종목 기호, 주가 등)와 이 주식에 대해 사용자가 지불한 금액과 같은 보다 개인적인 정보를 함께 보유하는 기본적인 데이터 구조 오브젝트이다. HttpClient 클래스를 사용하여 Yahoo Finance에서 동적 데이터(예: 주식의 현재 가격)를 검색한다. HttpClient는 HttpUriRequest를 사용하며 이 경우에서 사용자는 HttpUriRequest의 서브클래스인 HttpGet을 사용한다. 이와 비슷하게 데이터를 원격 서버에 게시해야 하는 경우를 위한 HttpPost 클래스가 있다. 클라이언트로부터 HttpResponse를 수신하면 응답의 기본 InputStream에 액세스하여 버퍼링한 후 구문 분석하여 주식 데이터를 얻을 수 있다.

네트워크를 통해 데이터를 검색하는 방법을 살펴봤으니 이제는 이 데이터를 사용하여 멀티스레딩을 통해 Android UI를 효율적으로 업데이트하는 방법을 살펴본다.

위로

Android 동시성의 실제

Listing 1에 있는 코드를 애플리케이션의 기본 UI 스레드에서 실행하는 경우 사용자 네트워크의 속도에 따라 Application Not Responding 대화 상자가 나타날 수 있다. 따라서 스레드를 파생(spawn)시켜 이 데이터를 페치해야 한다. Listing 2에서는 이를 수행하는 한 가지 방법을 보여 준다.

private void refreshStockData(){
    Runnable task = new Runnable(){
        public void run() {
            try {
                ArrayList<Stock> newStocks = 
                    fetchStockData(stocks.toArray(
                                  new Stock[stocks.size()]));
                for (int i=0;i<stocks.size();i++){
                    Stock s = stocks.get(i);
                    s.setCurrentPrice(
                                  newStocks.get(i).getCurrentPrice());
                    s.setName(newStocks.get(i).getName());
                    refresh();
                }
            } catch (Exception e) {
                Log.e("StockPortfolioViewStocks", 
                            "Exception getting stock data", e);
            }
        }
    };
    Thread t = new Thread(task);
    t.start();
}

Listing 2의 캡션은 기본 코드임을 나타내고 있으며 실제로도 그렇다. 이 간단한 예제에서는 Listing 1의 fetchStockData 메소드를 Runnable 오브젝트에서 랩핑한 후 새 스레드에서 실행하여 호출한다. 이 새 스레드에서는 둘러싸는 Activity(UI를 작성하는 클래스)의 멤버 변수인 stocks에 액세스한다. 이름이 나타내듯 이는 Stock 오브젝트의 데이터 구조이다(이 예에서는 java.util.ArrayList). 달리 말하면 두 개의 스레드(기본 UI 스레드와 파생(spawn)된 스레드(Listing 2에 있는 코드에서 호출됨) 사이에서 데이터를 공유한다. 파생(spawn)된 스레드에서 공유 데이터를 수정하면 Activity 오브젝트에 대한 refresh 메소드를 호출하여 UI를 업데이트한다.

Java Swing 애플리케이션을 프로그래밍한 경우에는 이와 같은 패턴을 따랐을 것이다. 하지만 Android에서는 이 패턴이 작동하지 않는다. 파생(spawn)된 스레드는 UI를 전혀 수정할 수 없다. 그렇다면 UI를 멈추지 않고 데이터가 수신되면 UI를 수정할 수 있는 방식으로 데이터를 검색하려면 어떻게 해야 하는가? android.os.Handler 클래스를 사용하면 스레드 사이에서 조정하고 통신할 수 있다. Listing 3에서는 Handler를 사용하는 업데이트된 refreshStockData 메소드를 보여 준다.

private void refreshStockData(){
    final ArrayList<Stock> localStocks = 
          new ArrayList<Stock>(stocks.size());
    for (Stock stock : stocks){
        localStocks.add(new Stock(stock, stock.getId()));
    }
    final Handler handler = new Handler(){
        @Override
        public void handleMessage(Message msg) {
            for (int i=0;i<stocks.size();i++){
                stocks.set(i, localStocks.get(i));
            }
            refresh();
        }
    };
    Runnable task = new Runnable(){
        public void run() {
            try {
                ArrayList<Stock> newStocks = 
                    fetchStockData(localStocks.toArray(
                                  new Stock[localStocks.size()]));
                for (int i=0;i<localStocks.size();i++){
                    Stock ns = newStocks.get(i);
                    Stock ls = localStocks.get(i);
                    ls.setName(ns.getName());
                    ls.setCurrentPrice(ns.getCurrentPrice());
                }
                handler.sendEmptyMessage(RESULT_OK);
            } catch (Exception e) {
                Log.e("StockPortfolioViewStocks", 
                            "Exception getting stock data", e);
            } 
        }
    };
    Thread dataThread = new Thread(task);
    dataThread.start();
}

Listing 2에 있는 코드와 Listing 3에 있는 코드 사이에는 두 가지 주요 차이점이 있다. 두드러진 차이점은 Handler의 존재 여부이다. 두 번째 차이점은 파생(spawn)된 스레드에서 UI를 수정하지 않는다는 것이다. 대신 메시지를 Handler에 전송하면 Handler가 UI를 수정한다. 또한 이전과 같이 스레드에서 stocks 멤버 변수를 수정하지 않는다는 것에 유의한다. 대신 데이터의 로컬 사본을 수정한다. 이는 반드시 필요한 것은 아니지만 이 방법이 더 안전하다.

Listing 3에서는 동시 프로그래밍에서 매우 일반적인 패턴으로 판명된 방식인 데이터를 복사한 후 일부 장기 태스크를 수행하는 새 스레드에 전달하고 결과 데이터를 다시 기본 UI 스레드에 전달한 후 해당 데이터로 기본 UI 스레드를 업데이트하는 방식을 보여 준다. Handlers는 Android에서 이를 위한 기본 통신 메커니즘이며 이 패턴의 구현을 더 용이하게 만든다. 하지만 Listing 3에는 여전히 상용구 코드가 상당히 포함되어 있다. 다행히도 Android는 이 상용구 코드 대부분을 캡슐화하여 제거할 수 있는 방법을 제공한다. Listing 4에서 이 방법을 보여 준다.

private void refreshStockData() {
    new AsyncTask<Stock, Void, ArrayList<Stock>>(){
        @Override
        protected void onPostExecute(ArrayList<Stock> result) {
            ViewStocks.this.stocks = result;
            refresh();
        }

        @Override
        protected ArrayList<Stock> doInBackground(Stock... stocks){
            try {
                return fetchStockData(stocks);
            } catch (Exception e) {
                Log.e("StockPortfolioViewStocks", "Exception getting stock data", e);
            }
            return null;
        }
    }.execute(stocks.toArray(new Stock[stocks.size()]));
}

여기서 알 수 있듯이 Listing 4에는 Listing 3보다 훨씬 적은 상용구가 포함되어 있다. 사용자는 스레드 또는 Handlers를 작성하지 않는다. AsyncTask를 사용하여 모두를 캡슐화한다. AsyncTask를 작성하려면 doInBackground 메소드를 구현해야 한다. 이 메소드는 항상 별도의 스레드에서 실행되므로 자유롭게 장기 실행 태스크를 호출할 수 있다. 입력 유형은 작성되는 AsyncTask의 유형 매개변수에서 제공된다. 이 경우에는 첫 번째 유형 매개변수가 Stock이었기 때문에 doInBackground에는 Stock 오브젝트의 배열이 전달된다. 마찬가지로 ArrayList<Stock>이 AsyncTask의 세 번째 유형 매개변수이기 때문에 리턴된다. 이 예제에서 필자는 onPostExecute 메소드도 대체하도록 선택했다. 이 메소드는 doInBackground에서 다시 제공되는 데이터에 대해 수행해야 할 사항이 있는 경우 구현할 선택적 메소드이다. 이 메소드는 항상 기본 UI 스레드에서 실행되므로 UI를 수정하는 데 아주 적합하다.

AsyncTask를 사용하면 멀티스레드 코드를 매우 단순화할 수 있다. AsyncTask는 개발 경로에서 다수의 동시성 위험을 제거한다. 하지만 AsyncTask 오브젝트에 있는 doInBackground 메소드가 실행되는 동안 장치에서 방향이 변경되면 발생하는 문제와 같은 AsyncTask의 일부 잠재적 문제점을 여전히 찾을 수 있다. 이와 같은 경우를 처리하는 방법에 대한 일부 기술은 참고자료에 있는 링크를 참조한다.

이제 Android가 데이터베이스에 대한 일반적인 Java 작업 방식과 상당한 차이를 보이는 또다른 일반적인 태스크에 대해 살펴본다.

위로

Android 데이터베이스 연결

Android의 한 가지 매우 유용한 기능은 로컬 관계형 데이터베이스가 있다는 것이다. 물론 데이터를 로컬 파일에 저장할 수 있지만 RDBMS(Relational Database Management System)를 사용하여 데이터를 저장하는 것이 더 유용한 경우가 자주 발생한다. Android는 Android와 같은 임베디드 시스템에 최적화된 유명한 SQLite 데이터베이스를 제공한다. 이 데이터베이스는 Android의 많은 핵심 애플리케이션에서 사용한다. 예를 들어, 사용자 주소록이 SQLite 데이터베이스에 저장된다. Android의 Java 구현을 고려하면 JDBC를 사용하여 이러한 데이터베이스에 액세스할 수 있을 것으로 예상할 수 있다. 놀랍게도 Android에는 JDBC API의 대부분을 구성하는 java.sql 및 javax.sql 패키지도 포함되어 있다. 하지만 로컬 Android 데이터베이스에 대해 작업하는 경우에는 이것이 아무 쓸모가 없는 것으로 판명되었다. 대신 android.database 및 android.database.sqlite 패키지를 사용한다. Listing 5에서는 이러한 클래스를 사용하여 데이터를 저장하고 검색하는 예제를 보여 준다.

public class StocksDb {
    private static final String DB_NAME = "stocks.db";
    private static final int DB_VERSION = 1;
    private static final String TABLE_NAME = "stock";
    private static final String CREATE_TABLE = "CREATE TABLE " + 
        TABLE_NAME + " (id INTEGER PRIMARY KEY, symbol TEXT, max_price DECIMAL(8,2), " +
            "min_price DECIMAL(8,2), price_paid DECIMAL(8,2), " +
            "quantity INTEGER)";
    private static final String INSERT_SQL = "INSERT INTO " + TABLE_NAME +
            " (symbol, max_price, min_price, price_paid, quantity) " +
            "VALUES (?,?,?,?,?)";
    private static final String READ_SQL = "SELECT id, symbol, max_price, " +
            "min_price, price_paid, quantity FROM " + TABLE_NAME;
    private final Context context;
    private final SQLiteOpenHelper helper;
    private final SQLiteStatement stmt;
    private final SQLiteDatabase db;
    public StocksDb(Context context){
        this.context = context;
        helper = new SQLiteOpenHelper(context, DB_NAME, null, 
                DB_VERSION){
            @Override
            public void onCreate(SQLiteDatabase db) {
                db.execSQL(CREATE_TABLE);
            }

            @Override
            public void onUpgrade(SQLiteDatabase db, int oldVersion, 
                    int newVersion) {
                throw new UnsupportedOperationException();
            }
        };
        db = helper.getWritableDatabase();
        stmt = db.compileStatement(INSERT_SQL);
    }
    public Stock addStock(Stock stock){
        stmt.bindString(1, stock.getSymbol());
        stmt.bindDouble(2, stock.getMaxPrice());
        stmt.bindDouble(3, stock.getMinPrice());
        stmt.bindDouble(4, stock.getPricePaid());
        stmt.bindLong(5, stock.getQuantity());
        int id = (int) stmt.executeInsert();
        return new Stock (stock, id);
    }
    public ArrayList<Stock> getStocks() {
        Cursor results = db.rawQuery(READ_SQL, null);
        ArrayList<Stock> stocks = 
                 new ArrayList<Stock>(results.getCount());
        if (results.moveToFirst()){
            int idCol = results.getColumnIndex("id");
            int symbolCol = results.getColumnIndex("symbol");
            int maxCol = results.getColumnIndex("max_price");
            int minCol = results.getColumnIndex("min_price");
            int priceCol = results.getColumnIndex("price_paid");
            int quanitytCol = results.getColumnIndex("quantity");
            do {
                Stock stock = new Stock(results.getString(symbolCol), 
                        results.getDouble(priceCol), 
                        results.getInt(quanitytCol), 
                                    results.getInt(idCol));
                stock.setMaxPrice(results.getDouble(maxCol));
                stock.setMinPrice(results.getDouble(minCol));
                stocks.add(stock);
            } while (results.moveToNext());
        }
        if (!results.isClosed()){
            results.close();
        }
        return stocks;
    }
    public void close(){
        helper.close();
    }    
}

Listing 5에 있는 클래스는 주식 정보를 저장하는 데 사용된 SQLite 데이터베이스를 완전히 캡슐화한다. 애플리케이션에서 사용될 뿐만 아니라 애플리케이션에서 작성하기도 하는 임베디드 데이터베이스에 대해 작업하기 때문에 데이터베이스를 작성하는 데 필요한 코드를 제공해야 한다. Android는 이를 위해 SQLiteOpenHelper라는 유용한 추상 헬퍼 클래스를 제공한다. 이를 구현하려면 이 추상 클래스를 확장한 후 코드를 제공하여 onCreate 메소드에서 데이터베이스를 작성한다. 이 헬퍼의 인스턴스가 확보되면 임의의 SQL문을 실행하는 데 사용할 수 있는 SQLiteDatabase의 인스턴스를 얻을 수 있다.

데이터베이스 클래스에는 몇 가지 편의 메소드가 포함되어 있다. 첫 번째는 새 주식을 데이터베이스에 저장하는 데 사용되는 addStock이다. SQLiteStatement 인스턴스를 사용한다는 것에 주목한다. 이 인스턴스는 java.sql.PreparedStatement와 비슷하다. addStock이 호출될 때마다 재사용할 수 있도록 클래스의 생성자에서 이 인스턴스가 컴파일되는 방식에 유의한다. 각각의 addStock 호출 시 SQLiteStatement의 변수(INSERT_SQL 문자열에 있는 물음표)는 addStock에 전달된 데이터에 바인드된다. 이것 역시 JDBC에서 익숙한 PreparedStatement와 매우 비슷하다.

다른 편의 메소드는 getStocks이다. 이름이 나타내듯이 이 메소드는 데이터베이스에서 모든 주식을 검색한다. JDBC에서와 마찬가지로 여기서도 SQL 문자열을 사용한다는 것에 다시 한번 주목한다. SQLiteDatabase 클래스에서 rawQuery 메소드를 사용하여 이를 수행한다. 이 클래스에는 SQL을 직접 사용하지 않고 데이터베이스를 쿼리할 수 있는 몇 가지 쿼리 메소드도 포함되어 있다. 이러한 다양한 메소드는 모두 java.sql.ResultSet와 매우 비슷한 Cursor 오브젝트를 리턴한다. 쿼리에서 리턴되는 데이터 행 위로 Cursor를 이동할 수 있다. 각각의 행에서 getInt, getString 및 기타 메소드를 사용하여 쿼리하는 데이터베이스 테이블의 다양한 열과 연관된 값을 검색할 수 있다. 역시 이것도 ResultSet와 매우 비슷하다. ResultSet와 비슷하므로 작업을 완료한 경우에는 Cursor를 닫는 것이 중요하다. Cursors를 닫지 않으면 빠르게 메모리 부족이 발생하여 애플리케이션에 오류가 발생할 수 있다.

로컬 데이터베이스를 쿼리하면 프로세스의 속도가 저하될 수 있으며 데이터 행의 수가 많거나 여러 테이블을 결합하는 복합 쿼리를 실행해야 하는 경우에는 특히 더 그렇다. 데이터베이스 쿼리 또는 삽입에 5초 이상 소요되어 Application Not Responding 대화 상자가 표시될 가능성은 없지만 코드가 데이터를 읽고 쓰는 중에 UI를 잠재적으로 멈출 수 있기 때문에 권장되지 않는다. 따라서 이러한 상황을 예방하는 가장 쉬운 방법은 AsyncTask를 사용하는 것이다. Listing 6에서는 이러한 예제를 보여 준다.

Button button = (Button) findViewById(R.id.btn);
button.setOnClickListener(new OnClickListener(){
    public void onClick(View v) {
        String symbol = symbolIn.getText().toString();
        symbolIn.setText("");
        double max = Double.parseDouble(maxIn.getText().toString());
        maxIn.setText("");
        double min = Double.parseDouble(minIn.getText().toString());
        minIn.setText("");
        double pricePaid = 
                Double.parseDouble(priceIn.getText().toString());
        priceIn.setText("");
        int quantity = Integer.parseInt(quantIn.getText().toString());
        quantIn.setText("");
        Stock stock = new Stock(symbol, pricePaid, quantity);
        stock.setMaxPrice(max);
        stock.setMinPrice(min);
        new AsyncTask<Stock,Void,Stock>(){
            @Override
            protected Stock doInBackground(Stock... newStocks) {
                // There can be only one!
                return db.addStock(newStocks[0]);
            }
            @Override
            protected void onPostExecute(Stock s){
                addStockAndRefresh(s);
            }
        }.execute(stock);
    }
});

단추의 이벤트 리스너를 작성하는 것으로 시작한다. 사용자가 단추를 클릭하면 다양한 위젯(정확하게는 EditText 위젯)에서 주식 데이터를 읽고 새 Stock 오브젝트를 채운다. AsyncTask를 작성하고 doInBackground 메소드를 통해 Listing 5의 addStock 메소드를 호출한다. 따라서 기본 UI 스레드가 아니라 백그라운드 스레드에서 addStock이 실행된다. 완료되면 새 Stock 오브젝트를 데이터베이스에서 기본 UI 스레드에서 실행되는 addStockAndRefresh 메소드로 전달한다.

위로

결론

이 기사에서는 Android가 Java 환경에 있는 많은 API의 서브세트만 지원하면서도 기능 면에서 전혀 부족하지 않다는 것을 보여줬다. 네트워킹과 같은 일부 경우에는 익숙한 API를 완전히 구현하지만 더 편리한 방법도 제공한다. 동시성의 경우에서 Android는 따라야 하는 API 및 규칙을 추가한다. 마지막으로 데이터베이스 액세스의 경우 Android는 데이터베이스에 액세스하는 완전히 다른 방법을 제공한다(익숙한 개념이 다수 포함되어 있음). 이들은 표준 Java 기술과 Android의 Java 기술 사이의 임의의 차이점에 그치지 않고 Android 개발의 기본적인 빌딩 블록을 형성한다.

• 메이븐 2 개요
• 메이븐 2 종속성 관리 모델 이해하기
• 메이븐 2 저장소(repository)와 메이븐 2 코디네이트(coordinates)
• 메이븐 2 생명주기, 각 단계들, 플러그인, 모조(mojo)
• 메이븐 2 다운로드와 설치
• 메이븐 2 다루기 - 첫 번째 메이븐 2 프로젝트
• POM(Project object model) 커스터마이징
• 여러 프로젝트로 작업하기
• 메이븐 2 다루기 - 여러 프로젝트 빌드하기
• 이클립스 3.2에 메이븐 2.X 플러그인 설치하기
• 이클립스 3.2에서 메이븐 2.X 플러그인 사용하기

출처 : http://www.ibm.com/developerworks/kr/library/tutorial/j-mavenv2/index.html

무료 오픈 소스 VCS(Version Control System)에 익숙하지 않은 개발자의 경우 과거에 유명했던 CVS(Concurrent Versions System) 대신 Subversion을 비상업용 표준 VCS로 사용하고 있다. CVS는 제한적이기는 하지만 지금도 유용하게 사용되고 있다. 하지만 Subversion에는 웹 서버에서 간단한 설치 작업만 수행하면 된다는 매력적인 장점이 있다. Subversion에도 약간의 문제가 있기는 하지만 대부분의 경우 정상적으로 작동한다. 이 기사에서는 이러한 문제에 대해서도 설명한다.

그렇다면 또 다른 도구가 필요한 이유가 무엇일까? Git(대문자 "G", git는 명령행 도구임)는 많은 면에서 Subversion보다 좋게 설계되었으며 많은 분산 VCS 중 하나이다. 분산 VCS 중 필자가 처음으로 경험한 제품은 Arch/tla였으며 Mercurial, Bazaar, darcs 등도 사용해 보았다. 여러 가지 이유로(이에 대해서는 관련된 본문에서 설명한다.) Git는 많은 인기를 얻고 있으며 Subversion과 함께 개인 또는 기업 VCS로서 가장 많이 사용되고 있는 제품으로 인정 받고 있다.

Subversion 사용자가 Git에 관심을 보이는 두 가지 중요한 이유는 다음과 같다.

• Subversion의 일부 기능이 제한적이기 때문에 Git로 이동하려고 한다.
• Git에 대한 호기심이 있어서 Subversion과 비교해 보고 싶다.

아마도 Git가 비교적 새롭게 떠오르는 기술이기 때문에 이력서에 넣고 싶다는 세 번째 이유도 있을 것이다. 이 이유가 주 목적이 아니길 바란다. Git를 배우는 것은 개발자가 가장 큰 보람을 느낄 수 있는 일 중 하나이다. 지금 당장 Git를 사용하지 않는다고 하더라도 이 분산 VCS에 담겨 있는 개념과 워크플로우는 향후 10년 이내에 IT 산업의 대부분의 분야에서 겪게 될 지리적인 대규모 분산 환경에서의 거대한 변화에 대응하기 위한 필수 지식이 될 것이다.

중요한 이유가 아닐 수도 있겠지만 마지막으로 들 수 있는 이유는 다음과 같다. Linux 커널 개발자가 아닐 경우 Git를 사용하여 커널 및 기타 수많은 주요 프로젝트를 관리하고 있기 때문에 기여도를 높이기 위해 Git에 익숙해지고 싶다는 것이다.

이 기사는 입문 수준에서 중급 수준 사이의 Subversion 사용자를 위한 것이다. 따라서 Subversion에 대한 입문자 수준의 지식과 버전 제어 시스템에 대한 일반적인 지식이 있어야 한다. 이 기사의 정보는 주로 UNIX® 계열(Linux® 및 Mac OS X) 시스템의 사용자를 대상으로 하며 Windows® 사용자를 고려한 부분도 조금 있다.

이 시리즈의 Part 2에서는 Git의 고급 사용 방법 즉, 분기 병합, 차이 생성 등을 비롯한 일반적인 작업에 대해 설명한다.

Subversion 및 Git 기초

앞으로는 편의를 위해 "Subversion"을 "SVN"으로만 쓰겠다.

그렇다면 SVN의 장점은 무엇일까? 이미 알고 있을지도 모르지만 VCS는 파일에 대한 것이 아니라 바로 변경 사항에 대한 것이다. 중앙 서버에서 실행되는 SVN은 변경 사항을 데이터 저장소에 추가한 후 변경 작업이 발생할 때마다 사용자에게 스냅샷을 제공할 수 있으며 이 스냅샷에는 개정 번호가 있다. 그리고 이 개정 번호는 SVN과 사용자 모두에게 매우 중요한 요소이다. 변경 사항이 차례로 적용되기 때문에 개정 번호를 통해 최신 변경 사항을 확인할 수 있다.

Git에도 변경 사항 추적이라는 비슷한 목표가 있다. 그러나 중앙 집중식 서버를 사용하지는 않는다. 이 점이 매우 중요한 차이점이다. 즉, SVN은 중앙 집중식인 반면 Git는 분산식이다. 따라서 Git에는 "최신 개정"이 없기 때문에 증가하는 개정 번호를 제공하는 방법도 없다. 물론 고유 개정 ID가 있기는 하지만 SVN 개정 번호처럼 유용하지는 않다.

Git에서 중요한 작업은 더 이상 커미트가 아니다. 여기에서 중요한 작업은 바로 병합이다. 누구나 저장소를 복제한 후 복제본에 대해 커미트를 수행할 수 있다. 그리고 저장소의 소유자는 병합된 변경 사항을 되돌릴 수 있다. 또는 개발자가 변경 사항을 저장소에 다시 push할 수 있다. 여기에서는 마지막 방법인 authorized-push 모델에 대해서만 설명한다.

위로

SVN에서 디렉토리 관리하기

먼저 SVN을 사용하여 디렉토리의 컨텐츠를 추적하는 일반적인 간단한 예제부터 살펴보자. SVN 서버, 파일이 있는 디렉토리 그리고 해당 서버에서 적어도 하나의 경로에 대한 커미트 권한이 있는 계정이 있어야 한다. 먼저 다음과 같이 디렉토리를 추가하고 커미트하자.

% svn co http://svnserver/...some path here.../top
% cd top
% cp -r ~/my_directory .
% svn add my_directory
% svn commit -m 'added directory'

이렇게 디렉토리를 설정한 후에는 이 디렉토리에서 커미트된 파일의 최신 버전을 확인하고, 파일을 삭제하고, 파일의 이름을 바꾸고, 새 파일 또는 디렉토리를 작성하고, 기존 파일에 변경 사항을 커미트하는 등의 작업을 수행할 수 있다.

# get latest
% svn up
# what's the status?
% svn st
# delete files
% svn delete
# rename files (really a delete + add that keeps history)
% svn rename
# make directory
% svn mkdir
# add file
% svn add
# commit changes (everything above, plus any content changes)
% svn commit

이러한 명령에 대해서 자세히 설명하지는 않겠지만 잘 알고 있어야 한다. svn help COMMAND를 입력하면 이들 명령에 대한 설명을 볼 수 있으며 자세한 정보를 보려면 설명서를 참조해야 한다.

위로

Git에서 디렉토리 관리하기

이 섹션도 SVN 예제와 같은 방식으로 설명한다. 앞에서와 마찬가지로 디렉토리에 이미 데이터가 있다고 가정한다.

여기에서는 무료 github.com 서비스를 원격 서버로 사용하지만 원한다면 사용자의 고유 서버를 설정할 수도 있다. GitHub를 사용하면 원격 Git 저장소를 쉽게 관리할 수 있다. 이 기사의 집필 당시를 기준으로 무료 계정의 경우 최대 300MB의 데이터를 저장할 수 있으며 저장소가 공용이어야 한다. 필자는 "tzz"라는 사용자로 등록한 후 "datatest"라는 공용 저장소를 작성하여 편하게 사용하고 있다. 그리고 공용 SSH 키를 제공했다. 이 키가 아직 없다면 새롭게 생성해야 한다. Gitorious 서버나 repo.or.cz를 사용할 수도 있으며 git.or.cz Wiki에서 Git 호스팅 서비스 목록을 볼 수 있다(참고자료의 링크 참조).

GitHub의 장점은 친숙하다는 것이다. Git를 설정하고 저장소를 초기화하는 데 필요한 명령을 정확하게 알려 준다. 이제 이 과정을 자세히 살펴보자.

먼저 각 플랫폼에 해당하는 Git를 설치하고 초기화해야 한다. Git 다운로드 페이지(참고자료 참조)에서 플랫폼에 따른 다양한 옵션을 볼 수 있다. (Mac OS X의 경우 필자는 port install git-core 명령을 사용했다. 하지만 MacPorts를 먼저 설정해야 한다. 또한 Git 다운로드 페이지에 연결된 독립 실행형 MacOS X Git 설치 프로그램을 사용하면 대부분의 경우 쉽게 설치할 수 있다.)

설치한 후에는 다음과 같은 명령을 사용하여 기본 설정을 수행해야 한다(고유 사용자 이름 및 이메일 주소 선택).

% git config --global user.name "Ted Zlatanov"
% git config --global user.email "tzz@bu.edu"

이미 SVN과의 차이점을 알았을 것이다. SVN에서는 사용자 ID가 서버측에 있으며 이 ID를 사용해야만 한다. 하지만 Git에서는 원한다면 The Wonderful Monkey Of Wittgenstein이 될 수도 있다. (다행히 필자는 유혹에 넘어가지 않았다.)

이제 데이터 파일을 설정한 후 이 파일을 사용하여 저장소를 초기화할 차례이다. (GitHub에서는 공용 SVN 저장소에서도 가져오므로 유용하게 사용할 수 있다.)

# grab some files
% cp -rp ~/.gdbinit gdbinit
% mkdir fortunes
% cp -rp ~/.fortunes.db fortunes/data.txt
# initialize
% git init
# "Initialized empty Git repository in /Users/tzz/datatest/.git/"
# add the file and the directory
% git add gdbinit fortunes
% git commit -m 'initializing'
#[master (root-commit) b238ddc] initializing
# 2 files changed, 2371 insertions(+), 0 deletions(-)
# create mode 100644 fortunes/data.txt
# create mode 100644 gdbinit

위 출력을 보면 파일 모드에 대한 정보를 볼 수 있다. 여기서 100644는 파일의 권한 비트를 나타내는 8진수 버전이다. 이에 대해서는 크게 신경 쓰지 않아도 되지만 2371 insertions의 의미가 궁금할 것이다. 두 개의 파일만 변경되었을 뿐이다. 이 숫자의 실제 의미는 삽입된 행의 번호이다. 그리고 아무 것도 삭제하지 않았다.

새로운 변경 사항을 GitHub 서버에 push하려면 어떻게 해야 할까? 설명서를 보면 "origin"이라는 원격 서버를 추가하는 방법을 알 수 있다. 이 경우 원격 서버에 원하는 이름을 지정할 수도 있다. 그리고 GIT 명령에 대해 알고 싶은 경우에는 예를 들어, git remote에 대한 정보가 필요한 경우에는 git remote --help 또는 git help remote를 입력하면 된다. 이 방법은 명령행 도구에서 일반적으로 사용되는 방법으로 SVN에서도 유사한 방법으로 필요한 정보를 얻을 수 있다.

# remember the remote repository is called "datatest"?
% git remote add origin git@github.com:tzz/datatest.git
# push the changes
% git push origin master
#Warning: Permanently added 'github.com,65.74.177.129' (RSA) to the list of known hosts.
#Counting objects: 5, done.
#Delta compression using 2 threads.
#Compressing objects: 100% (4/4), done.
#Writing objects: 100% (5/5), 29.88 KiB, done.
#Total 5 (delta 0), reused 0 (delta 0)
#To git@github.com:tzz/datatest.git
# * [new branch]      master -> master

github.com이 아직 알려진 호스트가 아니기 때문에 OpenSSH에서 경고가 발생하지만 걱정하지 않아도 된다.

Git 메시지는 말 그대로 완벽하다. SVN 메시지와는 달리 쉽게 이해할 수 있다. Git는 멘타트를 위해 멘타트가 작성한 프로그램이기 때문이다. Frank Herbert의 Dune 세계에서 휴먼 컴퓨터로 훈련 받은 인물이라면 아마도 고유 버전의 Git를 이미 작성했을 것이다. 그럴 수 있는 능력을 지닌 존재이니까 말이다. 그런 존재가 아닌 우리는 Git에 사용되는 델타 압축 및 수많은 스레드와 별로 관련이 없으며 알려고 하면 도리어 머리만 아플 뿐이다.

SSH를 통해 push 작업이 수행되었지만 HTTP, HTTPS, rsync 및 file 등의 다른 프로토콜도 사용할 수 있다(git push --help 참조).

SVN과 Git의 차이점 중 가장 중요하고 기본적인 차이점은 바로 커미트에 있다. SVN의 커미트는 "이 변경 사항을 중앙 서버에 push하는 것"을 의미한다. SVN에서는 커미트 전까지의 변경 사항이 언제라도 사라질 수 있다. 하지만 Git에서는 커미트가 로컬에서 수행되고 로컬 저장소를 사용하기 때문에 원격측에서 어떤 일이 발생하더라도 문제가 되지 않는다. 원격 서버와의 상호 작용 없이 변경 사항을 되돌리고, 분기를 만들고, 분기에 대한 커미트를 수행하는 등의 작업을 수행할 수 있다. Git를 사용하여 push 작업을 수행하면 로컬 저장소의 상태와 원격 서버를 효과적으로 동기화할 수 있다.

이제 마지막으로 발생한 작업에 대한 Git 로그를 살펴보자.

% git log
#commit b238ddca99ee582e1a184658405e2a825f0815da
#Author: Ted Zlatanov <tzz@lifelogs.com>
#Date:   ...commit date here...
#
#    initializing

로그에는 커미트에 대한 정보만 있다. 그리고 SVN 개정 번호와는 달리 임의로 생성된 긴 커미트 ID를 볼 수 있다. 하지만 git push를 통한 동기화에 대한 정보가 없다는 것을 알 수 있다.

위로

Git를 통해 협업하기

지금까지는 Git를 SVN에 대한 대안으로 사용해 왔다. 이제 흥미를 높이기 위해 사용자와 변경 세트를 추가해 보자. 이를 위해 저장소를 다른 시스템에 체크아웃한다. 이 시스템에서는 Ubuntu GNU/Linux가 실행되고 있으므로 git 대신 git-core를 설치해야 한다.

% git config --global user.name "The Other Ted"
% git config --global user.email "tzz@bu.edu"
% git clone git@github.com:tzz/datatest.git
#Initialized empty Git repository in /home/tzz/datatest/.git/
#Warning: Permanently added 'github.com,65.74.177.129' (RSA) to the list of known hosts.
#remote: Counting objects: 5, done.
#remote: Compressing objects: 100% (4/4), done.
#Indexing 5 objects...
#remote: Total 5 (delta 0), reused 0 (delta 0)
# 100% (5/5) done
% ls datatest
#fortunes  gdbinit
% ls -a datatest/.git
# .  ..  branches  config  description  HEAD  hooks  index  info  logs  objects  refs
% ls -a datatest/.git/hooks
# .  ..  applypatch-msg  commit-msg  post-commit  post-receive post-update
#  pre-applypatch  pre-commit  pre-rebase  update

다시 한번 이 시스템에서 SSH를 통해 GitHub와 작업한 적이 없음을 나타내는 OpenSSH 경고가 표시된다. git clone 명령은 SVN checkout과 유사하지만 병합된 버전의 컨텐츠(특정 개정 또는 최신 개정의 스냅샷)를 가져오는 대신 전체 저장소를 가져온다.

이 기사에서는 모든 컨텐츠를 볼 수 있도록 datatest/.git 디렉토리 및 hooks 서브디렉토리의 컨텐츠를 포함시켰다. Git에서는 기본적으로 모든 내용이 공개되지만 이에 반해 SVN에서는 저장소가 기본적으로 비공개로 설정되며 스냅샷에 대한 액세스만 허용된다.

부수적으로 Git 저장소에서 모든 커미트 또는 일부 커미트에 대해 규칙을 적용하려는 경우에는 hook를 사용할 수 있다. 후크는 SVN 후크와 매우 유사하며 두 후크 모두 "성공 시 0을 리턴하고, 실패 시 임의 값을 리턴하는" 표준 UNIX 규칙을 따른다. 이 기사에서는 후크에 대해 자세히 설명하지 않겠지만 Git를 팀에서 사용할 경우에는 후크에 대해 잘 알고 있어야 한다.

이제 활기에 찬 "The Other Ted"가 마스터 분기(SVN의 TRUNK에 해당)에 새 파일을 추가하고 새 분기를 작성한 후 gdbinit 파일에 변경 사항을 적용하려고 한다.

# get a file to add...
% cp ~/bin/encode.pl .
% git add encode.pl
% git commit -m 'adding encode.pl'
#Created commit 6750342: adding encode.pl
# 1 files changed, 1 insertions(+), 0 deletions(-)
# create mode 100644 encode.pl
% git log
#commit 675034202629e5497ed10b319a9ba42fc72b33e9
#Author: The Other Ted <tzz@bu.edu>
#Date:   ...commit date here...
#
#    adding encode.pl
#
#commit b238ddca99ee582e1a184658405e2a825f0815da
#Author: Ted Zlatanov <tzz@lifelogs.com>
#Date:   ...commit date here...
#
#    initializing
% git branch empty-gdbinit
% git branch
#  empty-gdbinit
#* master
% git checkout empty-gdbinit
#Switched to branch "empty-gdbinit"
% git branch
#* empty-gdbinit
#  master
% git add gdbinit
% git commit -m 'empty gdbinit'
#Created commit 5512d0a: empty gdbinit
# 1 files changed, 0 insertions(+), 1005 deletions(-)
% git push
#updating 'refs/heads/master'
#  from b238ddca99ee582e1a184658405e2a825f0815da
#  to   675034202629e5497ed10b319a9ba42fc72b33e9
#Generating pack...
#Done counting 4 objects.
#Result has 3 objects.
#Deltifying 3 objects...
# 100% (3/3) done
#Writing 3 objects...
# 100% (3/3) done
#Total 3 (delta 0), reused 0 (delta 0)

예제가 너무 길어서 보다가 졸지 않았기를 바란다. 만일 졸았다면 변경 세트의 왈츠를 들으며 Git 저장소를 동기화하는 꿈을 꾸었기를 바란다. (하긴 앞으로 그런 꿈을 꾸게 될지도 모르겠다.)

먼저 파일을 추가하고(encode.pl, 단 한 줄) 커미트했다. 커미트 이후 GitHub에 있는 원격 저장소에서는 방금 전의 변경 사항을 모른다. 그런 다음 empty-gdbinit이라는 새 분기를 작성한 후 이 분기로 전환했다. (필자는 git checkout -b empty-gdbinit을 사용하여 이 작업을 수행했다.) 이 분기에서 필자는 gdbinit 파일을 비우고 해당 변경 사항을 커미트했다. 마지막으로 원격 서버에 push했다.

마스터 분기로 전환하면 로그에 빈 gdbinit이 표시되지 않을 것이다. 따라서 각 분기에는 당연히 고유 로그가 있다.

# we are still in the empty-gdbinit branch
% git log
#commit 5512d0a4327416c499dcb5f72c3f4f6a257d209f
#Author: The Other Ted <tzz@bu.edu>
#Date:   ...commit date here...
#
#    empty gdbinit
#
#commit 675034202629e5497ed10b319a9ba42fc72b33e9
#Author: The Other Ted <tzz@bu.edu>
#Date:   ...commit date here...
#
#    adding encode.pl
#
#commit b238ddca99ee582e1a184658405e2a825f0815da
#Author: Ted Zlatanov <tzz@lifelogs.com>
#Date:   ...commit date here...
#
#    initializing
% git checkout master
#Switched to branch "master"
% git log
#commit 675034202629e5497ed10b319a9ba42fc72b33e9
#Author: The Other Ted <tzz@bu.edu>
#Date:   ...commit date here...
#
#    adding encode.pl
#
#commit b238ddca99ee582e1a184658405e2a825f0815da
#Author: Ted Zlatanov <tzz@lifelogs.com>
#Date:   ...commit date here...
#
#    initializing

push를 수행하면 Git가 GitHub의 서버에 "새 파일 encode.pl이 있어"라고 말한다.

이제 GitHub의 웹 인터페이스에 encode.pl이 표시되지만 아직도 GitHub에는 하나의 분기만 있다. 왜 empty-gdbinit 분기가 동기화되지 않았을까? 왜냐하면 Git는 사용자가 분기와 변경 사항을 기본적으로 push하려고 한다고 가정하지 않기 때문이다. 이를 위해서는 모든 내용을 push해야 한다.

% git push -a
#updating 'refs/heads/empty-gdbinit'
#  from 0000000000000000000000000000000000000000
#  to   5512d0a4327416c499dcb5f72c3f4f6a257d209f
#updating 'refs/remotes/origin/HEAD'
#  from 0000000000000000000000000000000000000000
#  to   b238ddca99ee582e1a184658405e2a825f0815da
#updating 'refs/remotes/origin/master'
#  from 0000000000000000000000000000000000000000
#  to   b238ddca99ee582e1a184658405e2a825f0815da
#Generating pack...
#Done counting 5 objects.
#Result has 3 objects.
#Deltifying 3 objects...
# 100% (3/3) done
#Writing 3 objects...
# 100% (3/3) done
#Total 3 (delta 1), reused 0 (delta 0)

여기에서 다시 한번 자세한 멘타트 인터페이스를 볼 수 있다. 하지만 충분히 이해할 수 있을 것이다. 멘타트는 아니지만 상식적으로 생각해 보면 0000000000000000000000000000000000000000은 일종의 특별한 초기 태그라는 것을 알 수 있다. 또한 Listing 9의 로그를 보면 5512d0a4327416c499dcb5f72c3f4f6a257d209f 태그가 empty-gdbinit 분기의 마지막이자 유일한 커미트라는 것도 알 수 있다. 나머지 부분도 대부분의 사용자에게는 아람말처럼 보이겠지만 염두에 두지 않아도 된다. 이제 GitHub에 새 분기와 변경 사항이 표시된다.

git mv 및 git rm을 사용하면 각각 파일을 관리하는 작업과 이름 바꾸기 및 제거 작업을 수행할 수 있다.

위로

결론

이 기사에서는 기본적인 Git 개념을 설명한 후 Git를 사용하여 버전 제어 아래에 있는 간단한 디렉토리의 컨텐츠를 관리하는 방법을 설명하면서 Git와 Subversion도 함께 비교했다. 그리고 간단한 예제를 사용하여 분기에 대해서도 설명했다.

Part 2에서는 병합, 차이 생성 등을 비롯한 기타 Git 명령에 대해 설명한다. 이해하기 쉬운 Git 설명서나 튜토리얼을 읽어 보기를 권장한다. 이러한 자료는 모두 Git 홈 페이지에서 구할 수 있으므로 약간의 시간을 투자해서 살펴보기를 바란다. (아래 참고자료에서 링크를 볼 수 있다.) SVN 사용자라면 그 이상의 자료가 필요하지는 않을 것이다.

반면 Git는 다양한 기능을 갖춘 DVCS이므로 Git의 기능을 잘 알고 있으면 이러한 기능을 활용하여 VCS 워크플로우를 단순화하고 향상시키는 데 큰 도움이 될 것이다. 게다가 Git 저장소에 대한 꿈을 한두번 꿀지도 모르겠다.

참고자료

교육

• Git - SVN Crash Course에서는 SVN에 익숙한 사용자에게 유용한 간단한 정보를 볼 수 있다. Flavio Castelli의 Howto use Git and SVN together도 좋은 튜토리얼이다.
  
  
• Git 호스팅 리소스를 보려면 GitHub, Gitorious, repo.or.cz 및 Public Git hosting sites의 목록을 살펴보자.
  
  
• 다양하고 종합적인 정보를 제공하는 Wikipedia's take on Subversion은 Git를 시작하기에 좋은 웹 사이트이다.
  
  
• Subversion에서 Git로 마이그레이션한 Robby Russell의 이야기를 들어보자.
  
  
• developerWorks Linux 영역에서는 Linux 개발자에게 도움이 되는 여러 가지 리소스를 제공하고 있으며 가장 인기 있는 기사와 튜토리얼도 볼 수 있다.
  
  
• developerWorks에 있는 Linux 팁과 Linux 튜토리얼을 모두 볼 수 있다.
  
  
• developerWorks 기술 행사 및 웹 캐스트를 통해 최신 정보를 얻을 수 있다.
  
  

제품 및 기술 얻기

• Git를 다운로드하고 Git download 페이지를 비롯한 수많은 문서와 도구를 살펴보자.
  
  
• developerWorks에서 직접 다운로드할 수 있는 IBM 시험판 소프트웨어를 사용하여 Linux와 관련된 후속 개발 프로젝트를 구현해 볼 수 있다.
  
  

토론

• 사용자의 개인 프로파일과 사용자 정의 홈 페이지가 제공되는 My developerWorks community에서는 관심을 가지고 있는 developerWorks의 여러 주제를 추적할 수 있으며 다른 developerWorks 사용자들과 의견을 나눌 수도 있다.
  
  

필자소개

Teodor Zlatanov는 1999년에 Boston University에서 컴퓨터 공학 석사 학위를 받았으며 1992년부터 Perl, Java, C 및 C++를 사용하는 프로그래머로 활약했다. 텍스트 구문 분석, 데이터베이스 아키텍처, 사용자 인터페이스 및 UNIX 시스템 관리에 대한 오픈 소스 활동에 관심을 두고 있다.


출처 : http://www.ibm.com/developerworks/kr/library/l-git-subversion-1/