쉽게 배우는 JRuby on Rails

쉽게 배우는

JRuby on Rails

arton·

이창신

iv

“다시는 책 작업을 하지 않겠다”

고 했었습니다. 번역이건 저술이건, 고통도 이런 고통이 없습니다. 교훈이 학습될 법도 한데,

어찌된 일인지 매번 시쳇말로 ‘낚이고’ 맙니다.

누군가는 저에게 그러더군요. 병이라고. 매년 한두 권 정도 (책을) 내고 있으니 그렇게 부를

만도 할 지 모르겠습니다만, Ajax에 이어 레일스는 저에게 ‘무한도전’에 가까웠습니다. 왜냐고

요? 저도 루비와 레일스는 처음이었기 때문이죠.

최근 (마시는) 차 장사를 접고 IT 업계로 복귀한 선배형이 저에게 “또 책 내냐?”고 메신저로

묻더군요. “또”라니, 남들에게는 그렇게 비춰지는구나…하는 생각도 잠시, 선배는 저에게 되려

자신의 심정을 토로했습니다.

“(일은) 지겹기도 하고, 역시 책 번역하는 게 (새로운 기술을) 공부하는 좋은 방법인 거 같

아”

얻는 게 있으면 잃는 것도 있는 법. 어쩌면 그래서 절필도 마음대로 안되나 봅니다.

“왜 JRuby인가?”

이 책은 원서와 많이 다릅니다. 원서는 작년 10월에 나왔는데, 그때는 현재 표준으로 삼고 있

는 레일즈 1.2가 나오기 전(정확히는 1.1.6)이었습니다. 따라서 일부 코드는 deprecated 경고를

뿜어냈고, 그런 부분을 모두 고쳐야 했습니다.

하지만, 그건 빙산의 일각이었습니다. 원서의 후반부는 일본 현지에서(만) 쓸 수 있는 Open

API를 이용하는 방법을 다루어서, 지난번 Ajax 책 번역의 악몽을 떠오르게 했습니다. (그때는

Ajax 책의 한 장(chapter)이 구글 거리 지도 API만을 다루었는데 아시겠지만 한국에서는 제공

되고 있지 않죠)

역자 서문

v

고민이 많았습니다. 게다가 이직과 겹치면서 혹독한 적응기까지 함께 해서(스프링노트 www.

springnote.com 프로젝트에 급투입되었는데 루비 온 레일스로 개발했죠. 물론 전 루비도 레일

스도 처음이었습니다), 애초 계획했던 일정(차마 밝히기가 민망하네요)은 고사하고 '2007년 안

에 나올 수 있을까' 하는 자괴감에까지 빠졌습니다.

그런데 위기가 기회로 보이기 시작했습니다. 올해 1사분기에 루비와 레일스 책들이 쏟아지면

서, 출간시기를 피하려고 하다보니 6월에 JRuby가 1.0을 냈습니다. “이때다!” 하는 심정으로

저는 과감히 루비 대신 JRuby를 택했습니다. 예제들은 또다시 JRuby로 이식되고 검증되며 (설

정을 위주로) 바뀌었습니다. 그리고 그동안 저를 괴롭혀온 원서의 후반부는 자바와의 연동으로

대체되어 마무리를 가능하게 해주었습니다.

아마 세계 최초의 JRuby on Rails 책일 것입니다. ^^

“독자분들께 꼭!꼭! 당부드리고 싶은 것”

이제 일방적인 교육의 시대는 끝났습니다. 루비도 레일스도 모두 오픈 소스입니다. 더 이상

누구만 알 수 있고 누구는 알 수 없는 것은 없습니다. 게다가 JRuby는 자바로 만든 루비 언어

구현체입니다. 자바를 안다면 얼마든지 문제를 파악해서 고칠 수 있습니다.

이 책의 예제 또한 모두 오픈 소스로 올라와 있습니다(자세한 안내는 예제 안내를 참고하세요)

책의 내용이 지면이라는 물리적인 한계로 고정된 것은 안타깝지만, 예제는 계속 고쳐지고 나아

질 수 있습니다. 그리고 그런 발전이 이 책의 2판, 3판으로 가는 길의 하나라고 생각합니다. 게

다가 레일스도 빠르게 진화하고 있습니다. 또 한 번의 혁신을 선사할 레일스 2.0이 나오면, 한

바탕 예제 업데이트가 필요할 것입니다.

그래서, 저는 독자분들이 꼭 이 책의 예제 오픈 소스 프로젝트에 참여하시길 권합니다. 예제

를 SVN 저장소에서 받아 최신의 상태로 돌려보고, 질문·의견은 공개 토론을 통해 더 많은 사

람들과 함께 하고, 문제가 있으면 보고하여 함께 고쳐나아가는 것입니다. 이미 이 책의 예제

는 JRuby나 GlassFish V3의 테스트에 쓰이고 있을 정도로 간단하면서도 기본 기능에 충실합

니다.

제 작은 소망이 있다면, 이 책의 개정판에 예제의 추가와 개선에 도움을 주신 (독자출신) 기

여자분들께 감사글을 쓰는 것입니다.

vi

JRuby on Rails

“자바가 루비를 만날 때(When Java met Ruby)"

제가 이 책에 자바를 적극적으로 끌어들였던 것은, 그만큼 (국내외 통틀어) 자바의 저변이 넓

고 두텁기 때문입니다. 제가 처음 자바를 시작할 때는 자바가 지금의 루비 같았습니다. 다들 신

기해하면서도 받아들이기를 꺼려했습니다. 그때 자바편에 있었던 저는, 그런 세상이 무척 답답

했었는데, 이제는 제가 그 답답한 세상의 일부가 된 느낌입니다. ^^;;;

그래서, 또 한 번 껍질을 깨보려고 루비를 시도했고, 배운 것이 정말 많았습니다. 저에게 루

비를 사사한 문식이형(강문식)은 그런 경험을 그냥 덮어두기에는 아까웠는지, 책을 한번 써보

면 어떻겠냐고 하더군요.

제목은 위와 같이 이미 정했습니다만, 언제 어떻게 나올지는 아무도 모릅니다. 다만, 세상

이 변하는 가운데 세대의 교체를 자연스럽게 받아들이는 모습이 담담하게 쓰여져 있으리라 믿

습니다.

“고맙습니다”

역자 서문을 쓸 때 여기까지 오면 늘 가슴이 벅찹니다.

책의 5장 앨범 예제가 JRuby 1.0에서 돌아가지 않는다는 사실을 발견하고, 그 후 고쳐진 버전

으로 1.1을 릴리즈해달라는 아주 급한 부탁에 흔쾌히 응해준 JRuby 팀 (Thanks a lot, JRuby

team!)에 가장 먼저 감사드립니다. JRuby on Rails 애플리케이션을 GlassFish에 올리면서 도

움을 주고 받은 Grizzly 팀에게도 고마움을 표하고 싶습니다.

오픈마루는 제게 새로운 기회 그 자체였습니다. 엔씨소프트 김택진 사장님과 오픈마루 스튜

디오 김범준 실장님, 웹 서비스팀 이광호 팀장님, 그리고 서현동 오픈마루 사무실에서 함께 일

하는 모든 분들께 오늘날의 제가 있도록 도와주신 데 대해 감사드립니다.

스프링노트 시즌 1 팀은 미숙한 제게 가장 위대한 스승이었습니다. 자냐(강규영), 문식이형,

영록닷컴(박영록), 라면(윤정환), 프로도(고명석), 제팩토리(장기형), 알타리(김승욱), 손권남씨

(손권남), 도로씨(김태연), 레이니걸(이준행), 1픽셀(황지섭). 시즌 2에는 등장하지 않지만 저는

언제나 시즌 1의 감동을 마음에 담고 잊지 않으려 합니다.

분당 싱글 모임의 희경이 누나(윤희경), 올리브 누나(유지현), 재현이형(배재현), 정진동생(박

정진), 듀(홍상민), 주마군(이주미)은 자칫 건조해질 수 있는 분당 라이프를 윤기있게 해주는 좋

은 친구들입니다. 출간 기념 모임이라도 조촐하게 해서 고마움을 나눠야겠습니다.

vii

윈도우에서의 예제 확인과 본문 검증을 해준 험브롤(정상일)의 도움은 마무리 작업에 큰 역할

을 했습니다. 고마움과 더불어 앞으로도 활발한 활동 기대합니다.

밀리고 밀리는 일정에도 불구하고 멀리 분당까지 오셔서 격려를 아끼지 않아 주신 위키북스

박찬규 사장님과 김윤래 팀장님은 제가 부러워하는 분들이기도 합니다. 좋은 책을 만드시겠다

는 진심이 느껴져서 저도 힘을 내지 않을 수 없었습니다.

매주 뵐 때마다 책의 진도를 물어보시던, 부모님께 이제 다 했다는 말씀을 드릴 수 있게 되

어 기쁩니다.

마지막으로, 이걸로 이름이 세 번째 나오는 문식이형의 조언과 가르침이 아니었다면 이 책은

나올 수 없었습니다. 이로써 루비를 하는 사람이 한명이라도 더 생긴다면, 문식이형에게 받은

것을 조금이나마 돌려준 것이 아닐까 생각합니다.

2007년 7월 7일 토요일 파주출판단지 위키북스 사무실에서

이창신

viii

JRuby on Rails

이 책의 모든 예제는 구글 코드 호스팅의

http://code.google.com/p/rubyonrails-for-web-and-enterprise/

에 오픈 소스 프로젝트로 관리되고 있습니다.

예제는 기본적으로 책에 설명한 대로 따라하면 일부는 생성되고 일부는 작성하는 방식입니다

만, 자신이 작업하고 있는 코드가 맞는지를 비교하는 차원에서 이용할 수도 있을 것입니다.

먼저, 예제 프로젝트들을 모두 모은 압축 파일을

http://code.google.com/p/rubyonrails-for-web-and-enterprise/downloads/list

에서 example-x.y.zip 이라는 이름의 파일로 받으실 수 있습니다. x와 y는 각각 주·부 버전 번

호로서, 이 책의 1판(현재 보고 있는 판)인 경우 1.y, 2판이라면 2.y가 될 것입니다. y는 앞으로

수정, 변경될 것을 염두에 두고 붙인 것입니다. 따라서 최초 버전은 1.0이 되겠지만, 앞으로 1.1

또는 그 이상의 버전도 나올 수 있으니 최신 배포판을 이용하시기 바랍니다.

또, 예제 소스 코드의 가장 최신 상태를 프로젝트의 SVN 저장소에서 접근할 수 있습니다.

http://code.google.com/p/rubyonrails-for-web-and-enterprise/source

에 나온 안내에 따라 SVN 저장소를 접속하시기 바랍니다.

끝으로 예제 코드에 대한 문의나 의견은 구글 그룹

http://groups.google.com/group/jruby-on-rails-for-web-and-enterprise

으로 보내주시고,

예제 코드의 버그나 개선은

http://code.google.com/p/rubyonrails-for-web-and-enterprise/issues/list

으로 올려주시면 감사하겠습니다.

예제 안내

ix

저자 서문

2005년에 ‘자바보다 열 배 높은 생산성’이라는 캐치프레이즈로, 정말이지 웹 개발 세계에 선

풍을 불러 일으킨 것이 이 책에서 소개하려는 루비 온 레일스(Ruby on Rails)입니다. 루비 온

레일스를 만든 사람은 데이빗 하이네마이어 한슨씨입니다(줄여서 DHH라고 불리고 있기도 합

니다)

이 전까지는, 일본에 있는 커뮤니티와 일부 첨단을 걷는 세계적인 개발자(그 필두가 ‘달인 프

로그래머’라고 불리는 데이브 토마스씨입니다)등 ‘아는 사람은 아는’ 존재에 가까웠던 루비가,

루비 온 레일스라는 웹 애플리케이션 개발 프레임워크의 출현으로 이제는 모르는 사람이 없는

프로그래밍 언어가 되었다고 해도 좋을 것입니다.

루비 온 레일스의 좋은 점은 많습니다. 여기서는 그 중 가장 중요한 점에 대해서만 설명해 보

겠습니다.

그것은 ‘복잡하지만 간단’ 하다는 것입니다.

원래, 웹 애플리케이션이라는 것은 무척 어렵고 복잡한 프로그램입니다. 그것을 단순화해서

간단하게 해버리려고 하면 무리가 생깁니다. 이전에도 간단한 웹 애플리케이션 작성용 프로그

래밍 언어는 있었습니다. 하지만 간단하게만 처리하는 것에는 대가가 따랐습니다. 그 이상 애

플리케이션을 발전시키는 것이 어렵다든가, 복잡한 일을 행하려는 순간 문턱이 갑자기 높아져

버린다든가 하는 것입니다.

루비 온 레일스는 사실 무척 복잡한 프레임워크입니다. 이 책을 읽기 시작하면 곧 알게 되겠

지만, 어딘가 적당한 디렉토리에 CGI 프로그램을 1개 두면 바로 동작하는 것과 같은 간단함은

어디에도 없습니다. 많은 디렉토리와 파일을 이용합니다. 그리고 데이터베이스를 쓰는 것이 전

제되어 있습니다.

그러나 이러한 루비 온 레일스의 복잡함은 아주 중요한 것입니다. 복잡함 덕분에 애플리케이

션을 확장한다거나 수정한다거나 하는 것이 간단하게 되기 때문입니다. 많은 파일과 디렉토리

는 역으로, “무엇을 하기 위해서는 어디를 바꾸는가”를 알기 쉽게 가르쳐 줍니다.

x

JRuby on Rails

이렇게 복잡함에도 불구하고, 실제로 프로그램을 작성해야 할 것은 그리 많지 않습니다. 간

단한 것이 그냥 간단하다거나, 복잡한 것이 짜증날 정도로 복잡하다는 것은 당연합니다. 하지

만 루비 온 레일스는 절묘하게 ‘복잡하지만 간단’이라는 신기한 세계를 성공적으로 보여주고 있

습니다.

복잡한 것을 간단하게 하는 것은 실제로 지금까지 여러 분야에서 이뤄져왔습니다. 그 비결을

보여주는 정치용어가 있습니다. 그것은 “분할하여 통치하라” 입니다. 분할해버리면 원래 어렵

고 복잡한 것이 당연한 것처럼 없어집니다. 남아있는 진짜 어려움은 최초에 잘 분할하는 것입니

다. 그래서 루비 온 레일스의 비밀은 웹 애플리케이션이라는 복잡한 시스템을 DHH씨가 깜짝

놀랄 정도로 ‘잘’ 분할하여 조합하는 데에 있습니다.

루비

루비 온 레일스가 분할통치하는 각 부분 사이에 마찰이 생기지 않게 윤활유 역할을 하는 것이

가벼운 동적 프로그래밍 언어인 루비입니다. 루비를 개발한 마츠모토 유키히로씨는 ‘즐겁게 프

로그래밍할 수 있도록’ 하기 위한 목적으로 루비를 개발했다고 합니다. 프로그래머로서 즐거운

프로그래밍 언어라 하는 것은, 자기가 임금님이 된 것처럼 자유자재로 컴퓨터를 다루고 있다는

것을 실감시켜주는 언어입니다. 자유자재로 컴퓨터를 다루기 위해서는 뭐든지 가능하지 않으면

안됩니다. 그래서 루비는 실제 상황에서도 뭐든지 할 수 있는 프로그래밍 언어입니다. 그리고

이것은 루비의 복잡함에도 이어집니다.

DHH씨의 분할통치에 대한 센스는 여기에서도 빛납니다. 루비는 어떨 때는 유연하게 루비 온

레일스의 레일(철로)의 이음매를 감추고, 어떨 때는 견고하게 레일을 지지해 줍니다. 하지만, 루

비가 숨겨 놓은 그러한 복잡함과 어려움은 루비 온 레일스의 내부에 숨겨져서 거의 밖으로 드러

나지 않습니다. 그렇기 때문에, 루비 온 레일스로 만든 프로그램을 처음 보면, 뭔가 웹 애플리케

이션을 짜기 위해 최적화된 특별한 프로그래밍 언어로 쓰였구나 하는 느낌을 줍니다.

이 책의 내용

이 책은 직접 손으로 해보고, 손에 익히는 것에 주안점을 둔 루비 온 레일스 입문서입니다. 설

명은 최소한의 것에 맞춰 있습니다. 우선은 실제의 프로그램을 작성한 다음, 움직여 보고, 그리

고 실제 동작을 확인해 주시기 바랍니다.

xi

감사의 글

루비 온 레일스 책으로 감사의 글을 쓴다니 정말이지 믿기지 않습니다. 루비를 개발하고 있

는 사람과, 루비 온 레일스를 개발하고 있는 사람은 많이 있기 때문입니다. 그것뿐만 아니라,

MySQL, Apache, FastCGI등의 오픈 소스 프로젝트가 없었다면 이 책은 있을 수 없었을 것

입니다. 여기에는 대표하여, 루비를 개발한 마츠모토 유키히로씨, 루비 온 레일스를 개발한

DHH씨, Ruby-GetText를 개발한 모토오 마사오씨, Engines와 LoginEngine을 개발한 제임

스 아담씨에 감사의 뜻을 표합니다.

웹 상에 루비 온 레일스에 대한 정보를 공개한 분도 많이 계십니다. 이 책을 집필하는 무렵

에 특히 참고한 사이트로 “레일스로 위키 클론을 만들기 (http://tam.qmix.org/wiki/Min-

ki01.html)”를 공개하고 있는 tam씨, “큐마큐마 (http://wota.jp/ac/)”의 카즈노리 니시씨,

“netswitch! (http://blog.netswitch.jp/)”의 하루오 난키씨, “2nd life (http://d.hatena.

ne.jp/secondlife/)”의 유이치 타테노씨에게 감사드립니다.

많이 바쁘신 중에도 불구하고 이 책에 대한 리뷰에 흔쾌히 응해주신 마사요시 타카하시씨, 준

야 오기노씨, 신타로 카쿠타니씨, 마사노리 스미씨, 미네로 마오키씨에게 감사드립니다.

끝으로, 이 책의 레일(Rail)을 놓아준 편집의 나카무라씨와 루라씨에게 감사드립니다.

이책을 통해 독자 모두가 루비와 루비 온 레일스의 매력을 깨닫고, 아직 가능성으로 충만한

웹 애플리케이션의 세계로 나아가는 데에 도움이 되면 기쁘겠습니다.

이 책을 읽는 법

각 장의 구성

이책은 주제별로 1일째부터 9일째까지, 총 9장으로 나누어져 있습니다. 각 장은 아래와 같은

코너로 구성돼 있습니다.

▒ 예제 소개 - 각 장에서 작성하는 예제를 소개합니다.

▒ 기초 지식 - 그 장을 읽기 전에 필요한 기초지식을 모아두고 있습니다.

▒ 작성 순서 - 실제로 예제 프로그램을 작성하는 순서를 소개합니다.

▒ 코드 설명 - 그 장에 나온 프로그램의 자세한 설명과, 본문에는 소개할 수 없었던 프로

그램을 소개합니다.

▒ 좀더 알고 싶어요 Q&A - 프로그래밍에 대한 의문점에 답합니다.

▒ 정리 - 그 장에서 배운 것을 정리합니다.

xii

JRuby on Rails

이 책이 전제로 하고 있는 동작환경

이 책은 아래의 OS 상에서 동작하는 것을 전제로 하여 쓰여졌습니다.

윈도 비스타, 윈도 XP, 윈도 2003 서버, 윈도 2000

자세한 동작환경에 대해서는, 이 책의 1일째를 참고하세요.

표기에 대해

이책은 기본적으로 윈도우 환경을 토대로 쓰여져 있습니다.

코맨드 실행 화면

코맨드를 실행하고 있는 코맨드 프롬프트를 표시하고 있습니다.

script/server -d

리스트

프로그램의 내용을 소개합니다.

코맨드의 표기

[jruby] script/plugin discover

[ ]으로 둘러 싸인 부분은, 경우에 따라 생략가능한 것을 표시하고 있습니다.

프롬프트의 디렉토리 표시

C:\-\rails>rails yellowpage

“-”은 이 사이에 표시된 디렉토리를 생략하고 있는 것을 나타냅니다.

module ApplicationHelper

include LoginEngine

include Authenticated

end

xiii

리스트의 캡션

[ 리스트 5-03 ...... list.rhtml ]

<div class="menu"> (생략)

위 리스트는 ‘list.rhtml’이라는 파일에 대한 내용을 소개하는 리스트라는 것을 나타내고 있

습니다.

[ 리스트 5-08 ...... lib/tasks/gettext ]

require 'gettext/utils' (생략)

위 리스트는 그 파일이 있는 위치의 경로와 함께 파일 이름을 보여주기 위한 것입니다. 5일째

의 예제 프로그램인 albumj 프로젝트 밑에 있는 lib 디렉토리 밑의 tasks 디렉토리에 ‘gettext.

rake’라는 파일이 있다는 것을 나타내고 있습니다. 이 경우는, 경로의 구별 문자에 ‘\’가 아닌

‘/’을 씁니다.

xiv

JRuby on Rails

목 차

역자 서문 .................................................... iv

예제 안내 .................................................... viii

저자 서문 .................................................... ix

1일째 레일스 준비

레일스의 특징 ................................................ 2

레일스의 철학 ............................................... 2

원칙 1. 같은 일을 반복하지 말라 .................................. 3

원칙 2. 설정보다는 규칙을 우선하라 ............................... 4

레일스 설치에 필요한 것 ........................................ 5

동작 환경 .................................................. 6

1장을 읽어 나가기 위해 필요한 툴 ................................ 7

설치 순서 .................................................... 7

좀더 알고 싶어요! Q&A ......................................... 16

1일째 내용 정리 .............................................. 17

2일째 처음 만나는 레일스

웹 애플리케이션 구조 .......................................... 22

레일스가 생성하는 스켈레톤(skeleton)의 종류 ....................... 22

페이지와 프로그램의 연관성 ..................................... 23

디렉토리 구성 ................................................ 25

개발에 필요한 툴 ............................................. 26

명령 프롬프트 ............................................... 26

에디터 .................................................... 26

hello 프로젝트 개발 순서 ........................................ 27

xv

1. 컨트롤러와 뷰 만들기 ........................................ 27

2. 모델 작성 ................................................. 29

3. 컨트롤러 프로그램 .......................................... 30

4. 뷰 프로그램 ............................................... 31

5. 웹 브라우저에서 접속해 봅시다 ................................ 33

6. 레이아웃과 스타일시트 작성 .................................. 33

7. 라우트(route) 설정 .......................................... 35

코드 설명 .................................................... 37

좀더 알고 싶어요! Q&A ......................................... 46

2일째 내용 정리 .............................................. 47

3일째 데이터베이스 이용하기

즐겨 찾는 웹 페이지를 등록하는 웹 주소록(yellowpage)을 만듭니다 ..... 50

관계형 데이터베이스 기초입문 ................................... 52

레일스와 관계형 데이터베이스 .................................. 52

관계형 데이터베이스 .......................................... 52

관계형 데이터베이스와 정규화 .................................. 53

관계형 데이터베이스 프로그램의 이용 ............................. 54

레일스가 이용하는 데이터베이스 ................................. 56

레일스 실행환경 ............................................. 56

레일스가 미리 지정하는 데이터베이스 이름 ......................... 56

Rake의 역할 ................................................ 57

yellowpage 프로젝트 개발 순서 .................................. 59

MySQL 준비 ................................................ 59

1. 프로젝트 작성 ............................................. 60

2. 데이터베이스와 사용자 작성[Rake 사용] .......................... 61

3. 테이블 작성［마이그레이션 이용］ ............................... 64

마이그레이션이란 .......................................... 64

예 1 .................................................... 65

예 2 .................................................... 65

이용하는 테이블 ........................................... 65

마이그레이션 작성 .......................................... 66

테이블 작성 프로그램 구현 .................................... 67

xvi

JRuby on Rails

database.yml 설정 .......................................... 68

마이그레이션 실행 .......................................... 70

4. 애플리케이션 작성 .......................................... 71

컨트롤러 ................................................ 72

모델 .................................................... 72

뷰 .................................................... 72

코드 설명 .................................................... 73

좀더 알고 싶어요! Q&A ......................................... 77

3일째 내용 정리 .............................................. 79

4일째 Ajax 이용

Ajax 를 사용하여 계산기를 만들기 ................................ 82

레일스에서 Ajax를 이용하기 .................................... 82

calc 프로젝트의 작성 순서 ...................................... 84

HTTP와 Ajax 기초 입문 ....................................... 85

HTTP에 의한 데이터 교환 ....................................... 85

GET 메소드와 POST 메소드 ..................................... 86

Ajax .................................................... 87

calc 프로젝트 작성 순서 ........................................ 88

1. 프로젝트 작성 ............................................. 88

2. 컨트롤러와 뷰 작성 ......................................... 88

3. 뷰 프로그램 ............................................... 89

4. 부분 rhtml 파일 작성 ........................................ 90

5. 컨트롤러 프로그래밍 ........................................ 91

6. 동작 확인 ................................................. 92

코드 설명 .................................................... 93

좀더 알고 싶어요! Q&A ......................................... 100

4일째 내용 정리 .............................................. 101

5일째 파일 업로드와 표시

포토앨범 만들기 .............................................. 104

xvii

웹 브라우저로부터 업로드 된 파일 내려받기 ......................... 104

album 프로젝트 작성 순서 ...................................... 106

album 프로젝트 작성순서 ....................................... 107

1. 프로젝트 작성 ............................................. 107

2. 데이터베이스 작성용 빌드파일 작성 ............................. 107

3. 데이터베이스 작성 .......................................... 109

4. 데이터베이스 설정 .......................................... 109

5. 모델 작성 ................................................. 109

6. 테이블 작성 ............................................... 110

7. 컨트롤로와 뷰 작성 ......................................... 111

8. 모델 프로그램 ............................................. 112

9. 이 후의 프로그램 순서 설명 ................................... 113

10. 요약 표시 프로그램 ........................................ 116

11. 레코드를 신규 작성하는 프로그램 .............................. 118

12. 페이지 표시 프로그램 ....................................... 121

13. 페이지 편집 프로그램 ....................................... 122

14. 페이지 삭제 프로그램 ....................................... 124

코드 설명 .................................................... 127

좀더 알고 싶어요! Q&A ......................................... 143

5일째 내용 정리 .............................................. 146

6일째 애플리케이션에 인증기능 추가하기

플러그인으로 인증기능 추가하기 ................................. 148

포토 앨범에 Restful Authentication을 플러그인해서 갱신 페이지를

보호하기 ................................................... 148

플래시（flash） .............................................. 151

application_helper.rb ....................................... 151

albumx 프로젝트의 작성 순서 ................................... 151

플러그인 이란 ................................................ 152

플러그인 관리 스크립트 ........................................ 152

명령어 해설 - 플러그인 검색 사이트의 등록과 해제 .................... 152

명령어 해설 - 플러그인의 검색 ................................... 154

xviii

JRuby on Rails

명령어 해설 - 플러그인의 설치 ................................... 155

명령어 해설 - 플러그인 갱신..................................... 155

albumx 프로젝트 작성 순서 ...................................... 156

1. 프로젝트 작성 ................................................ 156

2. Restful Authentication 설치 ................................... 156

3. 환경 설정 ................................................. 156

4. 테이블 작성 ............................................... 157

5. 프로그램 수정 ............................................. 157

6. 플래시 이용을 위한 수정 ..................................... 160

7. 를러그인을 이용하기 위한 수정 ................................ 160

코드 설명 .................................................... 164

6일째 내용 정리 .............................................. 169

7일째 애플리케이션 개발

점심메뉴 정보를 소개하는 포토 블로그 만들기 ....................... 172

7일째의 요점 ................................................ 174

LunchBooks 프로젝트 작성 순서 ................................. 174

테이블의 릴레이션십과 레일스에서의 프로그래밍 .................... 175

테이블과 릴레이션십 .......................................... 175

릴레이션십의 표현............................................ 176

LunchBooks 프로젝트 작성 순서 .................................. 178

1. 프로젝트 작성 ............................................. 178

2. 데이터베이스 작성 .......................................... 178

3. 데이터베이스 설정 .......................................... 179

4. Restful Authentication 플러그인 설치 ........................... 180

5. 모델의 작성 ............................................... 181

6. 테이블 작성 ............................................... 182

7. 컨트롤러와 뷰 작성 ......................................... 184

8. 모델 프로그램 ............................................. 185

9. 요약 프로그램 표시 ......................................... 186

10. 신규등록 프로그램 ......................................... 189

11. 나머지 처리의 구현 ........................................ 194

xix

코드 설명 .................................................... 195

좀더 알고 싶어요 Q&A .......................................... 210

7일째 내용 정리 .............................................. 213

8일째 애플리케이션 배포

자바 웹 애플리케이션의 단위 .................................... 216

Goldspike 설치 .............................................. 216

Goldspike 실행 .............................................. 217

Java ee 서버 설치 ............................................ 218

GoldFish V2의 시동과 애플리케이션 배포........................... 220

WAR 애플리케이션 실행 ....................................... 220

WAR 패키징 없이 레일스 애플리케이션 배포하기 ..................... 221

8일째 내용 정리 .............................................. 224

9일째 자바와의 연동

자바와의 연동 ................................................ 226

연동의 단위 ................................................. 226

라이브러리 연동 ............................................. 227

컴포넌트 연동 ............................................... 233

서비스 연동 ................................................. 234

9일째 내용 정리 .............................................. 238

찾아 보기 239

xx

JRuby on Rails

1

1일째 ‘레일 위의 루비’라는 의미를 지닌 ‘루비 온 레일스(Ruby on Rails)’.

여기에서는 먼저 루비 온 레일스의 철학에 대해 소개하고,

이어서 컴퓨터에 설치하는 방법을 알아봅니다.

루비를 탈선시키지 않고 레일을 따라 잘 달릴 수 있도록 준비합시다.

레일스 준비레일스 소개와 설치

2

JRuby on Rails

레일스의 특징기초지식

루비 온 레일스(이하 레일스)는 개발의 간단함과 그에 그치지 않고 깊이 있는 내용으로 전에

없는 주목을 받고 있는 웹 애플리케이션용 프레임웍입니다. 레일스는 데이빗 하이네마이어 한

슨(David Heinemeier Hansson)씨 1 에 의해 고안되어, 오픈소스 프로젝트로서 개발이 계속되

고 있습니다.

레일스의 특징은 다음 3가지입니다.

웹 애플리케이션을 위한 모든 기능을 지원

레일스는 웹 애플리케이션을 구성하는 3개층, 즉 클라이언트와의 인터페이스, 데이터베이

스, HTML 생성(이 3개층을 합쳐 ‘풀 스택(full stack)’이라고 부르기도 합니다)의 전부를 아

우릅니다.

웹 애플리케이션의 생애(라이프사이클) 지원

레일스는 단지 애플리케이션 개발을 지원하는 것만 아니라 테스트, 도입, 유지·보수까지 망

라합니다.

전체를 통일하는 철학

레일스는 ‘풀 스택’이며 동시에 애플리케이션의 전 생애에 영향을 미칩니다. 그렇기 때문에 일

반적으로 생각하면 개발자가 기억해야 할 것은 매우 커지게 되죠. 하지만 레일스는 전체를 통일

하는 철학에 따라 이 노력을 최소한으로 줄여 줍니다.

레일스의 철학

프로그래밍 입문서에서 갑자기 철학이 나오니 조금 생뚱맞습니다만, 이것은 레일스를 이용하

는 데 있어 매우 중요하기 때문에 알아두시기 바랍니다. 철학이라는 것은 살아가는 방법이나 생

각하는 방법의 지침이 되는 것입니다. 따라서 레일스의 철학을 이해한다면 처음부터 그 이치를

파악하고 있기 때문에, 왜 레일스로는 이렇게 구현돼 있는 걸까 또는 자신이 하고 싶은 일을 레

1 줄여서 DHH로도 불리고 있습니다.

1일째......레일스 준비

3

일스로 하려면 어떻게 하면 좋을까 같은 고민에 대한 해결을 좀더 쉽게 풀어나갈 수 있기 때문

입니다.

DRY [Don't Repeat Yourself]같은 일을 반복하지 말라

Convention over Configuration설정보다는 규칙을 우선하라

그럼, 차례대로 살펴 봅시다.

원칙 1....... DRY [같은 일을 반복하지 말라.]

“같은 일을 반복하지 않는 것”은 프로그래밍의 달인이라고 알려져 있는 데이브 토마스(Dave

Thomas)씨가 공저 ‘프로그래밍의 달인-시스템 개발의 장인으로의 길’에서 제창한 원칙입니다.

DRY 원칙에서는 반복은 피합니다. 예를 들어 코드를 복사하여 붙이면, 프로그램의 여러 곳에

같은 코드가 생깁니다. 이것은 DRY 원칙에 위배 됩니다. 이 경우 복사하여 붙인 코드는 공통처

리로 묶어서 그것을 호출하는 식으로 프로그래밍합니다. 이미 비슷한 기능을 제공하는 프로그

램이 있다면 새로 작성하지 않고 그 프로그램을 이용하는 것도 DRY입니다. 단지 거기에 머물지

않고 만일 비슷한 기능을 제공하는 프로그램이 2개 있다면 그 중 어느 한 쪽을 선택하여 그것만

을 철저하게 이용하는 것도 DRY입니다.

이렇듯 DRY는 단순한 원칙입니다. 그것은 시스템을 구성하는 여러 부분을 단일화 한다는 것

뿐이기 때문입니다. 만약 어떤 기능을 실현하는 프로그램이 시스템에 2종류 있다면, 유지보수

는 마땅히 그 2개의 프로그램에 대해 이뤄져야 합니다. 또 지식과 경험을 단일한 리소스에 집

중하여 깊게 하는 것도 불가능합니다. 시스템의 견고함과 유지보수성을 높여 더 한층 유연성을

확보하며, 그 위에 자신이 지닌 기술과 지식을 심화하기 위해서 DRY 원칙은 참으로 올바른 사

고 방식입니다.

하지만 DRY를 실현하는 것은 결코 단순하지 않습니다. 예를 들어 데이터베이스에 접속하는

데에는 SQL, HTML 생성에는 XML을 이용한 탬플릿 등과 같이, 이렇게 저렇게 적절하다고 생

각되는 방법을 골라 끝내곤 합니다. 그렇다고 그것이 꼭 틀린 선택이라고는 할 수 없습니다(철학

4

JRuby on Rails

에 정답은 없겠죠?) 그러나 그것은 DRY가 아닙니다.

레일스는 DRY를 충실히 반영하고 있습니다. 기억할 필요가 있는 프로그래밍 언어는 루비뿐

입니다. 또 XML이나 SQL과 같은 어미에 L(Language의 “L”)이 붙은 3자리 문자 용어를 외울

필요가 없습니다. 실제로는 YAML(확장자는 yml)이라고 하는 예외가 있습니다만, YAML은 기

억할 필요가 있는 3자리 문자 L은 아닙니다.

대부분의 경우 레일스는 올바른 방법이 1가지밖에 없습니다. 취향이 아니라는 등의 이유로 다

른 방법을 사용해서 쓸데없는 고생을 하는 일도 있습니다. 왜냐하면 그것은 DRY가 아니기 때문

입니다. 즉 레일스는 말 그대로 레일입니다. 레일 위로 루비 코드가 달립니다. 레일로부터 벗어

나면 대참사입니다. 그 대신 레일 위를 달리는 한, 정시에 도착하고 정각에 출발합니다.

원칙 2...... Convention over Configuration [설정보다 규칙을 우선하라.]

레일스의 또 하나의 철학은, “설정보다도 규칙을 우선하는 것”입니다. 어떤 의미로는 DRY의

다른 표현이라고 말할 수도 있습니다.

예를 들어 레일스로 애플리케이션을 생성하면, 소스파일은 app라는 디렉토리 밑에 만들어집

니다. 설정 파일을 저장할 디렉토리의 이름을 지정할 일도 없습니다. 웹 서버에 공개하는 디렉

토리는 public이라는 이름으로 생성됩니다. 이것도 그런 규칙입니다. 이용하는 데이터베이스의

테이블 이름과 프로그램의 대응 코드에 대한 규칙도 있습니다. 테이블 이름 등에 대해서는 바꾸

고 싶다면 바꾸는 것도 가능합니다. 2

그러나 레일스의 규칙을 따르면 전혀 작업이 필요 없게 되기도 하지만, 변경을 가하면 그에 따

라 노력도 시간도 듭니다. 그것은 명명규칙에 대해 이미 레일스의 제작자가 그러한 레일을 깔았

기 때문입니다. 같은 일(명명규칙의 결정)을 반복하는 것은 DRY에 반하는 셈이죠.

레일스를 가장 유용하게 쓰기 위해서는 레일스의 규칙을 따르는 것이 최우선입니다. 독자 여러

분도 레일스의 규칙을 따르시기 바랍니다. 그렇게 하면 레일 위를 쾌적하게 달릴 수 있을 것입

니다.

2 그것이 가능하지 않다면 이미 시스템 상에 존재하는 데이터베이스를 이용할 수 없습니다.


5

레일스 설치에 필요한 것동작환경

여기서는 이 책을 읽어 나아가기 위해 필요한 레일스의 실행환경을 컴퓨터에 설치하는 방법에

대해 설명합니다. 그럼 지금부터 그 순서를 소개합니다.

1......데이터베이스 관리 시스템

데이터베이스를 관리하는 프로그램. 이 책에서는 MySQL을 이용합니다.

2......루비(Ruby)

레일스를 이용하는 프로그래밍 언어.

3......RubyGems

루비 라이브러리. 애드온(add-on) 프로그램의 패키지 관리 프로그램.

4......루비 온 레일스(Ruby on Rails)

웹 애플리케이션용 프레임웍.

웹 서버

HTTP를 이용하여 클라이언트(주로 웹 브라우저)로부터 요청을 받아 HTML과 이미지 등 정

적컨텐츠와, 웹 애플리케이션을 실행한 출력 결과(주로 HTML)를 응답하는 프로그램. 이 책에

서는 레일스에 내장된 개발용 서버인 WEBrick을 씁니다.

UTF-8을 지원하는 에디터

Ultraedit, EditPlus, (윈도우에 기본으로 있는) 메모장, (맥용) TextMate 3

3 윈도우 메모장을 이용하는 경우, 레일스가 생성하는 스켈레톤 파일의 줄 바꿈 코드 등 몇 가지 문제점이 있습니다. 대응 방법은 뒤에 쓰겠습

니다만 가능하면 다른 에디터를 쓰는 쪽이 좋겠습니다.

6

JRuby on Rails

동작 환경

레일스는 리눅스, Mac OS X, 윈도우 등의 각종 OS상에서 실행 가능하며, 이 책에서는 주로

MS 윈도우를 기준으로 합니다. 또한 조합하여 이용 가능한 웹 서버와 DBMS도 여러 가지 존재

합니다. 여기서는 이 책을 읽으면서 예제 프로그램을 실행하는 데에 특별한 고려가 필요 없는 구

성에 대해 설명합니다.

OS (다음 중 하나)

▒ 윈도우 비스타, 윈도우 XP, 윈도우 2003 서버, 윈도우 2000

▒ Mac OS X 10.4 이상(gcc 4.0 ‘애플 판’이상이 설치돼 있는 것)

▒ 리눅스 각종 배포판(gcc 2.95 이상이 설치돼 있는 것)

웹 서버

루비에는 WEBrick이라는 웹 서버가 딸려 있습니다. 레일스의 개발 모드에서는 WEBrick이

이용되므로 웹 서버에 대해 특별히 신경 쓰지 않아도 됩니다.

레일스

Ruby

Web

Gems

Ruby

Ruby Forge

새로운 00은 있어?

인터넷

애플리케이션

서버 데이터베이스

Ruby의 프로그램 아카이브

다음에 기동하면이 버전을쓰도록 해

클라이언트의 요구를처리하여

이 파라미터로이 HTML을

만들어 주세요

데이터를읽어 ~을해주세요

데이터를쓰세요

데이터를읽으세요

HTML이 나오면돌려주고

그림 1.1 루비를 쓴 애플리케이션의 전체 그림


7

데이터베이스 관리 시스템

데이터베이스 관리 시스템으로는 MySQL 5.0 이상을 이용합니다.

1장을 읽어 나가기 위해 필요한 툴

윈도우 환경에서는 명령을 실행할 때 명령 프

롬프트를 이용합니다. 시작▷모든 프로그램▷보

조프로그램▷명령 프롬프트 로 표시할 수 있습

니다.

설치 순서

그러면 설치를 시작합시다. 먼저 MySQL을 설치합니다.

1...... MySQL 내려받기

1. MySQL 사이트 (http://www.mysql.com)에 접속합니다.

2. 화면 좌측(바뀔 수 있습니다)의 메뉴에서 ‘Downloads’를 선택합니다.

3. ‘Current release (Recommended)’(현재 릴리스-추천)을 클릭합니다. 4

4. 표시된 페이지에서 OS에 맞는 패키지를 찾아, ‘Download’를 클릭합니다. 윈도우의 경우

는 표시된 화면에서 ‘Windows Essentials (x86)’을 선택합니다.

5. 인터넷 익스플로러를 이용하여 내려받는 경우, 파일을 실행할지 저장할지를 확인하는 대

화창이 뜹니다. ‘저장’ 버튼을 눌러서 적당한 디렉토리에 저장하세요.

4 ‘MySQL Administrator’로의 링크도 있습니다.

그림 1.2 명령 프롬프트 화면

8

JRuby on Rails

2...... MySQL 설치

1. 내려받은 파일(예를 들어 mysql-essential-5.0.x-win32.msi(x는 숫자. 클수록 최

신))을 더블 클릭하여 실행하면, 윈도우 환경에 따라 보안 경고가 뜹니다. 확실히 MySQL

사이트로부터 받았다면 ‘실행’ 버튼을 눌러 설치를 시작하시기 바랍니다.

2. 마법사가 시작하여 ‘Welcome to the Setup Wizard for MySQL Server 5.0’이라는 타이틀 화

면을 표시합니다. 이후, 기본 설정 그대로 ‘Next’ 버튼을 누르면서 앞으로 진행하세요.

‘Ready to Install the Program’이라는 화면이 표시되면 내용을 확인한 후에 ‘Install’ 버튼을

누르면 설치가 시작됩니다.

3. 설치가 끝나면 ‘MySQL.com Sign-Up’이라는 화면이 표시됩니다. MySQL.com에 계정을

만들고 싶은 경우는 이 화면에서 정보를 입력하면 됩니다. 여기에서는 ‘Cancel’ 버튼을

누르겠습니다.

4. 마지막으로 ‘Wizard Completed’라는 대화창이 표시되면 ‘Configure the MySQL Server

now’를 체크(기본으로 체크되어 있습니다)하고 ‘Finish’ 버턴을 누릅니다.

3...... MySQL 설정

1. 이어서 MySQL 설정을 시작합니다. 이후 특별히 다루지 않는 항목에 대해서는 기본 설

정 그대로 ‘Next’ 버튼을 눌러 설정을 진행하시기 바랍니다. 다만, 일단 각 대화창의 내

용은 확인하세요.

2. 아래 그림과 같은 캐릭터 셋을 설정하는 화면까지 진행하면, ‘Manual Selected Default Char-

acter Set / Collation’을 체크하고, ‘Character Set’ 선택 리스트 박스 중 ‘utf8’로 맞춥니다.

그림 1.3 기본 문자 셋 설정


9

3. 다음 그림 1.4에 표시되는 화면에서 ‘Include Bin Directory in Windows PATH’를 체크하세요.

‘Install As Windows Service’는 기본으로 체크돼 있으므로 그대로 둡니다.

그림 1.4

4. 마지막으로 root(관리자) 암호를 설정합니다. 이 암호는 데이터베이스를 작성할 때 이용

하므로 반드시 기억해 두기 바랍니다.

그림 1.5 루트 암호의 설정

5. 다음에 각종 설정 파일을 작성하는 화면이 표시되면 ‘Execute’ 버튼을 누릅니다. 설정 파

일이 작성되면 ‘Finish’ 버턴을 눌러 종료합니다.

10

JRuby on Rails

■■ 리눅스의 경우 ■■

여기서는 RPM을 이용하지 않는 리눅스에서의 설치 방법을 설명합니다. 참고로 릴리즈４ 또

는 ３ 버전 등 이전 버전의 MySQL을 실행하고 있는 경우 시작되지 않도록 설정을 바꿔두시기

바랍니다. 아래 사이트에서 내려받아 설치합니다

1. MySQL 사이트（http://www.mysql.com/）의 Downloads 페이지에서 ‘Linux（non RPM

package）downloads’을 찾아서 내려받습니다.

2. 아래와 같이 실행합니다. 모든 명령어는 sudo 등을 이용하여 슈퍼유저 권한으로 실행

하세요. 여기서는 내려받은 파일명은 mysql-standard-5.0.x-linux-i686-glibc23.

tar.gz(x는 숫자. 클 수록 최신), 파일을 저장한 디렉토리는 /var/tmp로 표시하므로, 파

일명 등은 실제로 내려받은 파일의 명칭으로 바꿔서 읽어주세요.

우선 mysql 그룹과 유저를 작성합니다.

groupadd mysql

useradd -g mysql mysql

압축을 풀 디렉토리（여기서는 /usr/local）로 이동합니다. /usr/local에 압축을 풀면 MySQL의

디폴트 설정 파일을 그대로 이용할 수 있습니다.

cd /usr/local

M I N I C O L U M N

MySQL 서비스의 시작과 정지

MySQL 서비스의 시작과 정지는 윈도 ‘시스템 관리 툴’의 ‘서비스’를 이용해 실행합니다. ‘서비

스’ 화면을 표시하는 데에는, 윈도우의 제어판▷관리 도구▷서비스 를 더블클릭합니다.

서비스 화면


11

내려받은 압축파일의 압축을 풉니다

tar -zxvf /var/tmp/mysql-standard-5.0.x-linux-i686-glibc23.tar.gz

mysql이라는 디렉토리명의 심볼릭 링크를 작성합니다.

ln -s /usr/local/mysql-standard-5.0.x-linux-i686-glibc23 mysql

지금 작성한 디렉토리 내에 들어갑니다.

cd mysql

설치 스크립트를 실행합니다.

./scripts/mysql_install_db --user=mysql

디렉토리와 파일의 퍼미션을 변경합니다.

chown -R root

chown -R mysql data

chgrp -R mysql

서버가 자동으로 시작되도록 하려면 support-file/mysql.server를 init 디렉토리로 복사합니

다. 다음은 Debian/GNU 리눅스에서의 예입니다. 이 때, 예전 버전의 MySQL이 시작되도록 설

정되어 있는 경우에는 파일을 삭제하든지, 새로운 파일로 덮어씌우기를 해주세요.

cp support-files/mysql.server /etc/init.d

ln -s /etc/init.d/mysql.server /etc/rc0.d/K20mysql


ln -s /etc/init.d/mysql.server /etc/rc2.d/S20mysql





서버를 시작합니다.

./bin/mysqld_safe &

관리자（root）패스워드를 설정합니다. 아래 예에서는 ror이라는 패스워드를 설정하고 있습니다.

./bin/mysqladmin -u root password ror

12

JRuby on Rails

4...... JRuby 설치

JRuby 설치는 기본적으로 운영체계에 따라 다르지 않습니다. 이는 JRuby가 자바에 기반하

기 때문이기도 합니다.

1. 먼저 http://java.sun.com/javase/downloads/index.jsp 에서 최신의 JDK를 내려받

아 설치한 다음, JDK가 설치된 디렉토리를 JAVA_HOME 환경 변수로 설정합니다. 예

를 들어 윈도우에서 c:\java\jdk6에 JDK를 설치했다면,

set JAVA_HOME=c:\java\jdk6

를 명령 프롬프트에서 실행합니다. (위 설정을 영구적으로 하기 위해 제어판▷시스템▷고

급▷환경 변수 에 추가해도 좋습니다.)

2. 다음으로 http://dist.codehaus.org/jruby/에서 최신의 JRuby를 다운받아 설치합니

다. 압축 파일을 받아 적당한 디렉토리에 푼 다음 그 디렉토리를 JRUBY_HOME 환경

변수로 설정합니다. 예를 들어 윈도우에서 c:\java\jruby에 JRuby를 설치했다면,

set JRUBY_HOME=c:\java\jruby

를 명령 프롬프트에서 실행합니다. (이 설정도 위에서 설명한 방법으로 영구적으로 할 수

있습니다.)

3. JAVA_HOME 아래의 bin 디렉토리와 JRUBY_HOME 아래의 bin 디렉토리를 PATH

환경 변수에 추가합니다. 윈도우에서

set PATH=%JRUBY_HOME%\bin;%JAVA_HOME%\bin;%PATH%

M I N I C O L U M N

MySQL 문자 세트의 설정

MySQL의 초기화 파일을 작성하여 규정의 문자 세트를 utf-8로 합니다. 슈퍼유저 권한으

로 /etc/my.cnf를 작성하고 아래의 내용을 추가합니다. 참고로 잘못 설정하면 MySQL 을

시작할 수 없습니다. 대·소문자에 주의해서 올바르게 작성해 주세요

/etc/my.cnf

[mysqld]

character-set-server = utf8

init-connect='SET NAMES utf8'


13

를 명령 프롬프트에서 실행합니다(이 설정을 제어판을 통해 설정해두면 편합니다).

혹시 자신의 환경이 방화벽 뒤에서 HTTP 프록시를 쓴다면, HTTP_PROXY (형식은 http://

HTTP 프록시 호스트:HTTP 프록시 포트) 환경 변수도 설정할 필요가 있습니다.

5...... 레일스 설치

레일스는 RubyGems(JRuby에는 내장되어 있습니다)를 이용하여 설치합니다.

1. gem 명령을 쓰기 위해 명령 프롬프트를 열어 다음과 같이 실행합니다.

gem install rails –y --no-ri --no-rdoc

2. JDBC로 데이터베이스를 연결하기 위해 ActiveRecord-JDBC 라는 패키지를 설치합니다.

gem install ActiveRecord-JDBC --no-rdoc --no-ri

3. MySQL용 JDBC 드라이버를 받아 설치합니다.

먼저 http://dev.mysql.com/downloads/connector/j/에서 압축 파일을 받은 다음 적당한

디렉토리에 풉니다. 풀려진 디렉토리에 있는 mysql-connector-java-x.y.z-bin.jar 파일(x,

y, z는 숫자)을 $JRUBY_HOME/lib에 복사합니다.

M I N I C O L U M N

Mac OS X에서의 자바 설정

위의 썬 자바 사이트에는 Mac OS X용 JDK가 없습니다. 대신 Mac OS X의 경우 운영 체

제에 JDK가 내장되어 있어 그것을 쓰면 됩니다.

/System/Library/Frameworks/JavaVM.framework/Versions 밑으로 여러 버전

이 있을 수 있는데, 되도록이면 최신 버전을 쓰는 것이 좋습니다. 만약 Versions 아래에 1.5

라는 디렉토리에 있는 버전을 쓴다면, JAVA_HOME 환경 변수를

/System/Library/Frameworks/JavaVM.framework/Versions/1.5/Home

으로 잡아주면 됩니다.

14

JRuby on Rails

6...... 레일스 설정 확인하기

이제 지금까지 이용한 명령 프롬프트를 그대로 사용해서 레일스를 잘 설치했는지 확인해 봅시

다. 다음 장인 2일째의 연습 프로젝트 5 를 작성하여 브라우저에 레일스 화면이 출력되어 제대로

설치돼 있는지를 확인하게 됩니다.

만약 잘 안 되는 경우에는, 여기까지 따라한 절차를 다시 확인하기 바랍니다.

1. 명령 프롬프트에서 홈 디렉토리의 바로 밑에 연습용 디렉토리(이 책에서는 rails라는 이

름을 이용합니다)를 만들어 이동합니다.

mkdir rails

cd rails

[유닉스 계열의 경우]

cd $HOME

mkdir rails

cd rails

2. hello라는 이름의 프로젝트를 만듭니다.

rails hello

실행 예(윈도 사용자 이름은 user로 표시)

C:\Documents and Settings\user\>mkdir rails

C:\Documents and Settings\user>cd rails

C:\Documents and Settings\user\rails>rails hello

create app/controllers

create app/helpers

(생략)

create log/production.log

create log/development.log

create log/test.log

5 레일스는 웹 애플리케이션 하나를 묶어 ‘프로젝트’라고 부릅니다. 프로젝트 안에는 그 애플리케이션에 관련된 모든 프로그램, 이미지, HTML

등이 포함돼 있습니다.


15

3. 생성된 프로젝트 디렉토리로 들어가서 개발용 서버(WEBrick)를 시작합니다.

C:\Documents and Settings\user\rails>cd hello

C:\Documents and Settings\user\rails\hello>jruby script/server

=> Booting WEBrick...

=> Rails application started on http://0.0.0.0:3000

=> Ctrl-C to shutdown server; call with --help for options

[2007-03-21 14:45:24] INFO WEBrick 1.3.1

[2006-03-21 14:45:24] INFO ruby 1.8.5 (…) [java]

[2007-03-21 14:45:26] INFO WEBrick::HTTPServer#start: pid=3908 port=3000

4. 브라우저를 열어,

http://127.0.0.1:3000을 접속합

니다. 레일스의 기본 톱 페이지가

출력됩니다. 3000은 레일스 개발

모드의 기본 포트 번호입니다.

5. 여기까지 완료했다면, Ctrl-C 키를

눌러 WEBrick을 종료합니다.

그림 1.6 프로젝트 홈 페이지

M I N I C O L U M N

업데이트 확인과 버전 업

RubyGems에 의해 관리되고 있는 패키지는 update 명령에 의해 업데이트를 확인할 수 있

습니다. 또한, 새로운 패키지가 릴리즈되어 있는 경우에는 내려받을 수 있습니다.

gem update [옵션]

RubyGems 자신의 업데이트 확인과 버전 업에는 --system 옵션을 지정합니다. 이렇게

하면 RubyGems 자신을 업데이트합니다.

gem update --system

16

JRuby on Rails

좀더 알고 싶어요! Q&A

Q. 브라우저에 지정한 “http://127.0.0.1:3000”의 의미를 알려 주세요.

웹 브라우저에 지정한 URL은 아래와 같은 형식으로 되어 있습니다.

프로토콜 이름://호스트 이름:포트번호/디렉토리 이름(파일 이름)

호스트 이름으로 ‘127.0.0.1’을 지정했습니다만 이 IP 주소는 루프백(loopback) 주소라 부르

는, 그 주소를 호출하는 컴퓨터와 같은 컴퓨터를 의미합니다. 따라서 ‘http://127.0.0.1:3000’이

라 함은 웹 브라우저에 대해 “HTTP를 이용하여 같은 컴퓨터의 포트 번호 3000으로 서비스를

하고 있는 프로그램의 ‘/’ (최상위)의 내용을 얻어라”는 지시가 됩니다.

Q. 레일스는 어떤 데이터베이스 관리자와 같이 쓰면 좋나요?

레일스가 가장 위력을 발휘하는 곳은 데이터베이스를 이용하는 웹 애플리케이션 개발입니

다. 따라서 레일스와 연동 가능한 데이터베이스 관리 시스템은 Oracle, DB2, SQL Server와

같은 상용 데이터베이스, Postgres와 같은 오픈 소스 데이터베이스, MySQL과 같은 하이브

리드 등 여러 가지입니다. 6

이 책에서는 레일스가 기본적으로 MySQL을 설정하고 있다는 점과 MySQL에는 무료로 이

용 가능한 Community Edition이 존재한다는 점, 그리고 윈도우, OS X, 리눅스 등의 각종 운

영체계용이 준비돼 있다는 점을 이유로 MySQL을 전제로 하고 있습니다. 또한 예제 프로그램

용 데이터베이스 설정의 사정상 5.0.18 이상으로 한정합니다.

아울러 MySQL을 상업적으로 이용하는 경우에는 GPL을 엄격하게 따르는 Community

Edition이 아닌, 상용 라이선스 버전(MySQL Pro Certified Server)의 이용을 검토하기 바

랍니다.

6 만약 어떤 시점에서 레일스가 지원하지 않고 있더라도 레일스를 이용하고 싶어하는 개발자가 자신이 이용하고 있는 데이터베이스 관리 시스

템용의 어댑터(레일스와 데이터베이스를 접속하여 데이터를 교환하는 라이브러리)를 만들어 이용 가능하게 할 수 있습니다.


17

1일째 내용 정리 _

레일스의 철학은 DRY “같은 일을 반복하지 말라” 와 Convention over Configuration “설

정보다 규칙을 우선하라”입니다. 레일스를 잘 쓰기 위해서는 이 철학을 존중하는 것이 중요합

니다.

기본 설정

1. MySQL (http://www.mysql.com)를 설치합니다.

2. JRuby (http://www.jruby.org)를 설치합니다.

3. RubyGems를 사용하여 Rails를 설치합니다.

레일스 프로젝트 작성

프로젝트를 만드는 데에는 아래의 명령을 실행합니다.

rails 프로젝트 이름

개발용 웹 서버를 띄우는 데에는 아래의 명령을 실행합니다.

jruby script/server

브라우저로 http://127.0.0.1:3000을 접속합니다.

18

JRuby on Rails

19

2일째 레일스를 사용하여 간단한 웹 애플리케이션을 만들어 봅시다.

만들면서 웹 애플리케이션의 얼개와 짜임새을 이해하고

프로그램의 기본적인 작성 방법을 확실히 익혀 두세요.

Rails를 이용한 개발이 어떤 순서로 진행되는지 살펴 봅시다.

처음 만나는 레일스Hello World 애플리케이션을 만들어 봅시다

20

JRuby on Rails

Hello World 애플리케이션 만들기2일째 예제 hello 프로젝트

2일째에서 만들 애플리케이션 「hello」를 설명합니다. hello는 오른쪽 페이지 그림과 같이 ３

개 페이지로 구성되며 사용자가 이름을 입력하면 그 이름을 포함한 텍스트를 표시하고 인사를

합니다.

hello는 아주 단순한 애플리케이션이지만 아래의 처리를 수행할 수 있습니다.

▒ 사용자의 입력을 받아들인다.

▒ 그 입력을 이용한다.

▒ 그 입력을 별도 페이지에서도 이용한다. 1

▒ 모든 페이지에 공통 Footer（페이지 밑부분에 표시되는 수평선 아래 부분）를 적용한다.

이들은 이후 다른 애플리케이션을 만들 경우에도 필요하므로 확실히 배워두도록 합시다. 또

레일스를 이용함에 따라 필요한 여러 가지 파일 사용 방법이 나옵니다. 각 파일의 역할과 위치

에 주의해가면서 공부해 주세요.

학습 진행 방법

여기서는 아래 순서로 hello를 개발합니다.

1. 컨트롤러와 뷰 생성

2. 모델 작성

3. 컨트롤러 프로그램

4. 뷰 프로그램

5. 문자 코드 설정

6. 웹 브라우저에서 열어보기

7. 레이아웃과 스타일시트 작성

8. 라우트 설정

1 웹 애플리케이션은 웹 브라우저로부터의 요구와 이에 대한 웹 서버의 응답으로 한 세션을 이룹니다. 이 때문에 이전 요구에서 입력된 데이

터는 별도로 기억해 두지 않습니다.

2일째......처음 만나는 레일스

21

이름 입력

Footer

「기억하기」 버튼을 클릭한다.

그림 2.1 이름 입력하기

입력한 이름을 표시하고 인사를 한다.

「다음으로」 버튼을 클릭한다.

그림 2.2 인사하기

입력한 이름을 표시하고 ‘안녕히 가세요’라는 인사를 한다.

「되돌리기」 버튼을 클릭한다.

그림 2.3 ‘안녕히 가세요’라는 인사를 한다. 「되돌리기」 버튼을 클릭하면 최초 화면으로 돌아온다.

그럼 순서대로 시작해 봅시다.

22

JRuby on Rails

웹 애플리케이션 구조기초지식

레일스가 생성하는 스켈레톤(skeleton)의 종류

레일스는 MVC라고 불리는 애플리케이션 구성방식을 프레임워크로 채용하고 있습니다.

MVC는 모델（Model）,뷰（View）,컨트롤러（Controller）의 약자로 이 3가지는 각각 다른 프로그

램으로 되어 있습니다. 레일스는 MVC와 같이 하나의 애플리케이션을, 처리하는 내용에 따라

서로 다른 프로그램으로 구성하는 것으로 애플리케이션의 작성과 수정이 쉽게 됩니다. 처리하

는 내용마다 서로 다른 프로그램으로 나눠두면 특정 부분에서의 수정이 전체에 영향을 미칠 가

능성을 낮출 수 있고, 또 각 프로그램이 깔끔하게 정리되어 읽기 쉽게 됩니다.

레일스가 생성하는 애플리케이션 스켈레톤은 주로 아래의 2종류입니다.

컨트롤러와 뷰

컨트롤러는 웹 브라우저로부터 호출을 받아 레일스가 실행하는 프로그램입니다. 주요 역할

은 웹 브라우저로부터 받은 파라미터를 모델로 보내 처리하게 하는 것과 모델을 뷰에 넘겨주

는 것입니다.

뷰는 컨트롤러로부터 호출됩니다. 주요 역할은 모델의 내용을 출력형식으로 맞추는 것입니

다. 보통은 웹 브라우저에 대한 출력물이어서 HTML을 생성합니다. 하지만 클라이언트의 요구

에 따라서는 그 이외의 형식（예를 들어 XML）을 생성하기도 합니다.

모델

모델은 컨트롤러로부터 넘겨받은 파라미터의 검증, 데이터 읽기, 데이터 가공, 데이터 갱신

같은 일을 합니다.

이들은, 서로 관련된 것을 합쳐 하나의 애플리케이션을 구성합니다만 역할이 각각 달라서 별

도의 프로그램으로 작성합니다. 다만, 웹 브라우저에서 직접 호출되는 컨트롤러와 화면에 출력

을 하는 뷰는 URL（사용자에 있어서 실제로 표시되는 페이지에 해당합니다）과 밀접하게 관련돼

있으므로 동시에 생성합니다.


23

한편, 모델은 개별 페이지와는 독립해서 존재하므로 별개로 생성합니다. 레일스가 생성하는

모델은 데이터베이스를 프로그램에서 다루기 위한 것으로서 ActiveRecord로 불립니다. 하지

만 이 장에서는 데이터베이스를 이용하지 않으므로 모델 스켈레톤 생성은 하지 않습니다. 에디

터를 사용하여 직접 작성합니다.

웹 서버 컨트롤러

데이터 처리를 잘 부탁해

모델을 HTML로 해줘

OK

OK

ERB

뷰

모델

데이터베이스

그림 2.4 컨트롤러, 뷰, 모델이 함께 돌아간다.

스켈레톤은 뼈대입니다. 이것은 실행할 수 있는 프로그램은 아닙니다만 ‘살점도 붙어있지 않

으면 피가 통하지 않는다’는 말 그대로 뼈일뿐입니다. 이 스켈레톤에 대해서 애플리케이션이라

고 하는 살을 붙여가는 것이 레일스에서의 프로그래밍입니다.

페이지와 프로그램의 연관성

여기서 작성하는 애플리케이션은 다음 페이지에서 보이는 것처럼 전부 ３페이지로 구성되어

각각의 URL을 지정함에 따라 화면에 표시 됩니다. URL 안에 프로토콜을 나타내는 http와 호

스트와 포트를 나타내는 127.0.0.1:3000 부분은 애플리케이션과는 직접 관계가 없으므로 제

외하고 생각하면, 실제로 애플리케이션으로서 고려할 필요가 있는 것은 URL의 경로명 부분입

니다.

24

JRuby on Rails

이름을 입력하는 페이지（http://127.0.0.1:3000/welcome/who）

프로그램 경로명/welcome/who

안녕하세요! 를 표시하는 페이지（http://127.0.0.1:3000/welcome/hi）

프로그램 경로명/welcome/hi

안녕히 가세요! 를 표시하는 페이지（http://127.0.0.1:3000/welcome/bye）

프로그램 경로명/welcome/bye

그림 2.5 페이지와 프로그램의 관계

레일스에서는 위에 표시한 URL 경로명의 구성요소를 다음과 같이 부릅니다.

welcome

컨트롤러액션

who

따라서 이 애플리케이션의 컨트롤러명은 welcome으로, who, hi, bye는 각 액션명이 됩니

다. 또 개별 액션 실행결과는 각각 다른 페이지로 출력되므로 뷰는 그대로 who, hi, bye ３가

지 프로그램으로 됩니다.

레일스에서는 이런 연관성을 파일시스템과 루비에 대해 다음과 같이 적용할 수 있습니다.

컨트롤러 뷰

컨트롤러명＝클래스액션명＝메소드

rb 파일＝루비 프로그램 rhtml 파일＝루비 프로그램

컨트롤러명＝디렉토리액션명＝페이지

OO.rb

OO.rb

OO/OO.rhtml

OO/OO.rhtml

OO/OO.rhtmlOO.rb

액션 1

액션 2

::

::

그림 2.6 파일시스템과 루비의 연관성


25

디렉토리 구성

하나의 프로젝트는 많은 파일로 이루어져 있어서, 각각 몇 가지 정해진 디렉토리에 생성됩니

다. 이 책에서는 프로그램 소스 파일을 설명할 때 app/controllers/application.rb와 같이 표

기하기로 합니다. 이렇게 표기하는 것은 프로젝트 app 디렉토리 아래의 controllers 디렉토리

에 있는 application.rb 파일을 의미합니다.

hello app

components

config

db

doc

lib

log

public

script

test

tmp

vendor

controllers

helpers

models

views

_controller.rb

applicaion.rb

프로젝트의 루트 디렉토리

폴더 파일

welcome

그림 2.7 프로젝트 디렉토리 구성의 예

26

JRuby on Rails

개발에 필요한 툴기초지식

명령 프롬프트

파일을 만드는 명령을 실행할 경우, 윈도우

에서는 명령 프롬프트를 이용합니다. 명령 프

롬프트에서 작업하려면 시작▷프로그램▷보조

프로그램▷명령 프롬프트 를 실행합니다.

Mac OS X, Unix 계열 OS의 경우는 터미널

화면을 사용합니다.

에디터

프로그램을 작성할 때는 에디터를 사용합니

다. 윈도우에서는 워드패드나 메모장（note-

pad.exe） 등을 사용하는 것을 전제로 하고 설

명합니다. Linux 같은 Unix 계열 환경에서는

vim 등을 사용해 주세요.

ㅣ주의ㅣ 메모장을 사용해서 프로그램을 열거

나 저장하거나 할 때는 문자 코드 문

제로 파일의 변화 작업이 필요합니다.

31페이지 칼럼을 참조하여 파일을 변

환하세요.

그림 2.8 명령 프롬프트 화면. 「C:\USER_HOME>」은 현재 C 드라이브의 USER_HOME 디렉토리에 있다는 표시입니다.

그림 2.9 워드패드 에디터 화면


27

hello 프로젝트 개발 순서

1......컨트롤러와 뷰 만들기

명령 프롬프트에 다음과 같이 입력하여 1일째 만들었던 hello 프로젝트가 있는 hello 디렉토

리로 이동합니다.

cd rails\hello

레일스에서 컨트롤러와 뷰를 만들려면 프로젝트 루트 디렉토리에서 script/generate 명령을

입력합니다. 입력 방법은 다음과 같습니다.

jruby script/generate controller 컨트롤러명 액션명 ［액션명...］

여기서는 컨트롤러명은 welcome, 액션명은 who, hi, bye 등으로 다음과 같습니다. 2

C:\―\rails\hello>jruby script/generate controller welcome who hi bye

exists app/controllers/

exists app/helpers/

create app/views/welcome

exists test/functional/

create app/controllers/welcome_controller.rb

create test/functional/welcome_controller_test.rb

create app/helpers/welcome_helper.rb

create app/views/welcome/who.rhtml

create app/views/welcome/hi.rhtml

create app/views/welcome/bye.rhtml

여기서 생성된 파일을 확인해 봅시다.

2 명령어를 입력해서 출력한 메시지에서는 디렉토리를 구분하는 문자가 「/」이 됩니다. 이것은 Ruby가 내부에서는 디렉토리 구분 문자로 「/」

를 이용하고 있기 때문입니다. 실제로는 바르게 디렉토리와 파일이 만들어집니다.

28

JRuby on Rails

표 2.1 생성된 파일

파일명 설명

welcome_controller.rb 생성된 컨트롤러의 rb 파일. app/controllers 디렉토리에 만들어진다.

welcome_controller_test.rb 생성된 컨트롤러의 유니트 테스트용 파일. （이 장에서는 이용하지 않습니다.）

test/functional 디렉토리에 만들어진다.

welcome_helper.rb 생성된 뷰에 대한 공통처리를 두는 rb 파일. （이 장에서는 이용하지 않습니다.）

app/helpers 디렉토리에 만들어진다.

who.rhtml, hi.rhtml, bye.rhtml 생성된 뷰의 rhtml 파일. app/views/［컨트롤러명］디렉토리에 만들어진다.

생성된 컨트롤러 소스 파일 확인

생성된 컨트롤러 소스 파일（app/controllers/welcome_controller.rb）을 아래에 표시합니다. 확

장자 rb가 붙은 파일은 루비 프로그램입니다. 상세한 설명은 37페이지 [코드 설명]을 참조하세요.

[ 리스트 2-01.....welcome_controller.rb ]

class WelcomeController < ApplicationController

def who

end

def hi

end

def bye

end

end

생성된 뷰 소스 파일 확인

계속해서 생성된 뷰 소스 파일을 살펴봅시다. 윈도우에서 메모장을 사용하는 경우는 다음 페

이지의 미니칼럼을 참조해서 줄 바꿈 코드를 변환하세요.

여기서는 ３개의 뷰 파일 중에서 bye.rhtml의 내용을 봅시다.

[ 리스트 2-02......app/views/welcome/bye.rhtml ]

<h1>Welcome#bye</h1>

<p>Find me in app/views/welcome/bye.rhtml</p>

위에서 보는 것처럼 rhtml 파일은 루비 프로그램이 들어가 있지 않다면 보통의 HTML과 같습니

다. 이대로는 의미 있는 처리를 할 수 없으므로 뒷 부분에서 실제로 표시하는 내용을 기술합니다.


29

2...... 모델 작성

hello 프로젝트에서는 모델（애플리케이션이 이용하는 데이터）로서 최초 페이지에서 입력된

이름을 나타내는 클래스를 작성합니다. 여기서 생각할 것은 모델의 설계를 얼마나 세밀하게 할

것인가 입니다. 여기서 이름을 물어보는 것은 웹 애플리케이션에 대한 방문자이므로 Guest를

클래스로 name을 속성으로 설계합니다. 3

모델의 저장위치는 app/models 디렉토리입니다. 따라서 작성하는 것은 app/models/guest.

rb 입니다. 또 루비에서는 클래스명은 대문자로 시작하는 규칙이 있습니다만 파일명은 전부 소

문자로 합니다. 파일명은 단어 구분으로 ‘_’를 이용해도 좋습니다. 에디터를 사용해서 다음 내

용을 입력하고 저장해 봅시다.

3 이렇게 클래스를 설계하면, 나중에 출신지의 정보가 필요한 경우에는 Guest 클래스에 hometown이라는 속성을 추가하여 대응할 수 있습니

다. 물론 name 속성을 참조하거나 설정하거나 하는 부분을 변경할 필요는 없습니다.

M I N I C O L U M N

줄 바꿈 코드 변환

레일스가 생성한 파일을 윈도우 메모장（notepad.exe）에서 열어보면 줄 바꿈이 되지 않고

전부 하나의 행으로 연결된 것처럼 표시됩니다.

environment.rb를 메모장에서 연 상태로 문자

가 죽 붙어 나옵니다. 이것은 본래 줄 바꾸기를 할

장소에 들어있는 특수 문자（줄 바꿈 코드）가 윈도우

용으로 되어 있지 않은 탓에 발생하는 현상입니다.

이 경우 아래 명령어로 생성된 파일의 줄 바꿈 코드를 윈도우 용으로 변환할 필요가 있습니다.

ruby -i.bak -p -e '$_' 파일명 （와일드 카드 이용가능）

예를 들어 뷰의 코드를 변환하려면 명령 프롬프트에서 다음과 같이 입력합니다.

cd app\views\welcome

ruby -i.bak -p -e '$_' *.rhtml

이 두 가지 명령어는 welcome 디렉토리로 이동한 후 루비에서 변환프로그램을 실행시킨 것

입니다. 이렇게 해서 확장자 rhtml 파일의 행 변환 코드가 윈도우용으로 변환되어 메모장에

서 열어도 줄 바꿈이 잘 된 상태로 표시됩니다.

30

JRuby on Rails

[ 리스트 2-03.....guest.rb ]

class Guest

def initialize(name)

@name = name

end

attr_accessor :name

end

3......컨트롤러 프로그램

모델을 작성하였으므로 다시 한번 컨트롤러로 돌아가서 모델을 이용해봅시다.



def who

end

def hi

@guest = Guest.new(params[:guest][:name])

session[:guest] = @guest

end

def bye

@guest = session[:guest]

session[:guest] = nil

end

end

컨트롤러가 실행하는 처리는 다음 2가지 입니다.

▒ 모델을 생성하거나 모델에 데이터를 넣는다.

▒ 뷰로 모델을 보내서 데이터를 출력한다.

모델 생성과 모델에 데이터를 넣는 처리를 위해서는 이용자가 입력한 데이터를 참조할 필요가

있습니다. 이 때 이용하는 오브젝트가 params입니다. 뷰로 모델을 보내 출력 데이터를 생성하

는 처리를 위해서는 뷰에서 참조하는 모델을 인스턴스(instance) 변수 4 에 설정합니다. 이것은

컨트롤러에서 이용한 인스턴스 변수를 뷰（rhtml）프로그램에서 참조할 수 있기 때문입니다. 5

4 오브젝트가 지닌 변수. @로 시작하는 변수라고 기억해 두세요.

5 보통 루비 프로그램에서는 다른 클래스의 인스턴스 변수를 직접 참조할 수 없습니다. 이 얼개는 레일스에서 제공되는 것입니다.


31

아래는 welcome_controller.rb에 포함되고 컨트롤러에서 주로 이용 가능한 특수한 오브젝트

입니다. 루비 오브젝트 작성에 대해서는 뒷부분의 [좀더 알고 싶어요 Q&A]를 참조하세요.

params......이용자가 HTML에 입력한 데이터가 담긴 오브젝트

session......다른 액션 사이에서 공유하는 데이터를 담기 위한 오브젝트

4......뷰 프로그램

뷰에서는 한글을 이용하고 있지만 문자 코드에 따라 루비로 프로그램 할 수 없거나 문자가 깨

지는 등 여러 문제가 발생합니다. 이 경우 rhtml 파일에 대해서는 문자 코드를 UTF-8로 하도

록 하세요. 영문자나 숫자만 이용하는 경우에는 UTF-8, EUC-KR 중 어떤 것도 같은 문자 코

드의 범위로 되므로 고려할 필요가 없습니다.

레일스에서 한글을 처리하는 경우에는 스크립트를 포함하는 문자 코드를 UTF-8로 하면 문자가

깨지는 것을 피할 수 있습니다. rhtml 파일을 편집하려면 UTF-8로 작성 하세요. 에디터가 UTF-8

작성을 지원하지 않는 경우, 다음 페이지 미니칼럼을 참조하여 문자 코드를 UTF-8로 변환하세요.

M I N I C O L U M N

메모장에서 파일을 작성할 때 주의

윈도우 메모장을 이용하여 UTF-8 파일을 작성할 수 있지만 이 때 메모장은 파일 앞에

BOM（Byte Order Mark）라고 하는 특수 문자를 집어넣습니다. 이것은 이용하고 있는

Unicode 종류를 표시하는 특수 문자입니다. 루비는 BOM가 붙은 파일을 처리할 수 없으므

로 그대로 이용하면 에러가 납니다. 에러를 피하려면 아래 순서로 편집하세요.

1. 레일스가 생성한 rhtml 파일의 줄 바꿈 코드를 CR/LF로 변경합니다.

ruby -i.bak -p -e '$_' *.rhtml

2. 확장자를 rhtml 에서 txt로 변경합니다.

ren *.rhtml *.txt

3. 메모장에서는 주로 텍스트 파일로 편집하고, ANSI（디폴트）로 저장합니다. 한글 윈도우

인 경우, ANSI는 EUC-KR(MS949）를 의미합니다.

메모장에서는 ANSI 그대로 저장합니다.

32

JRuby on Rails

rhtml 프로그램

그럼 rhtml 프로그램을 시작해 봅시다. 우선 처음에는 이름을 입력하는 who.rhtml입니

다. 이 rhtml은 레일스 HTML 출력 메세지를 이용하여 입력 폼을 가진 HTML을 작성합니다.

app/views/welcome/who.rhtml 파일을 에디터에서 열어서 기존 코드를 삭제하고 아래 내용

을 입력합니다.

[ 리스트 2-05.....who.rhtml ]

<% @title = '입구' %>

<h1>누구십니까？</h1>

<% form_tag :action => :hi do %>

<%= text_field :guest, :name %>

<%= submit_tag '기억하기'%>

<% end %>

<% %> 안쪽 부분에는 루비 프로그램을 기술합니다. 여기서 작성된 프로그램은 rhtml로부터

html을 생성할 때 실행됩니다.

<%= %> 안쪽 부분에도 루비 프로그램을 기술합니다. <% %>과 달리, <%= %>는 프로그램 실행결

과로 <%= %> 부분을 바꿉니다.

다음으로 인사를 표시하는 rhtml입니다. 이 페이지에서는 who 액션에서 입력한 이름을 표시

하기 위해 <%= h %>과 #{ }라는 표기법을 이용하고 있습니다.

[ 리스트 2-06.....hi.rhtml ]

<% @title = '현관' %>

<h1><%= h "안녕하세요, #{@guest.name}님！"%></h1>

<% form_tag :action => :bye do %>

<%= submit_tag '다음으로'%>

<% end %>

<%= h %> 안쪽 부분에는 루비 프로그램을 기술합니다. <%= h %>는 프로그램 실행결과로 <%= h

%> 부분을 바꿀 수 있습니다. <%= %>과 다른 점은, 실행결과를 바르게 표시하기 위해 ‘<’ 과 ‘>’ 등

의 문자를 이스케이프 처리한다는 점입니다. 따라서 레일스의 HTML 출력 메소드（HTML 태그

를 출력합니다）를 호출하는 곳 이외에서는 <%= %>가 아닌, <%= h %>를 이용하세요.

"안녕하세요, #{@guest.name}님！"에 들어가 있는 #{@guest.name} 부분은 @guest.name 의 내용에 따라

#{@guest.name}을 치환하라고 하는 루비에 대한 명령입니다.


33

마지막 작별을 고하는 rhtml을 아래에 표시합니다. 이 rhtml에는 새로운 요소는 없습니다.

[ 리스트 2-07.....bye.rhtml ]

<% @title = '출구' %>

<h1><%= h "안녕히 계세요、#{@guest.name}님！"%></h1>

<% form_tag :action => :who do %>

<%= submit_tag '되돌리기'%>

<% end %>

5......웹 브라우저에서 접속해 봅시다.

여기까지 완성했다면 실제로 http://127.0.0.1:3000/welcome/who을 웹 브라우저로 접속

해봅시다. 그 전에 WEBrick을 실행하고 있지 않다면 개발에 이용하고 있는 명령프롬프트 화면

에서 아래 명령어로 WEBrick을 시작해 주세요.

WEBrick은 반드시 프로젝트 루트 디렉토리（이 경우는 hello 디렉토리）로 이동하고 나서 시

작해 주세요.

C:\―\rails\hello>jruby script/server

여기까지 진행 순서에서 오류가 없다면 그림 같은 화면이 웹 브라우저에 표시됩니다.

그림 2.10 hello 프로젝트 탑페이지

6......레이아웃과 스타일시트 작성

일반적으로 웹 애플리케이션의 각 페이지에는 공통적인 표시 요소가 포함돼 있습니다. 예를

들어 사이드바(side bar), 헤더(header) 부분의 메뉴 등입니다. 레일스에서는 이렇게 복수 페이

지에서 공통으로 이용되는 표시요소를 레이아웃이라고 하는 기능으로 간단하게 정의할 수 있습

니다. 여기서는 hello의 모든 페이지에 공통으로 어떤 레이아웃을 이용할지 표시합니다.

34

JRuby on Rails

레이아웃용 파일（이하 간단하게 레이아웃이라고 기술하는 경우도 있습니다）은 레일스의 자동

생성 대상이 아닌 직접 app/views/layouts 아래에 작성하여 확장자는 rhtml입니다. 파일명을

컨트롤러명과 똑같이 하면 자동으로 적용됩니다. 6

[ 리스트 2-08.....app/views/layouts/welcome.rhtml ]

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

<title><%= h @title %></title>

<%= stylesheet_link_tag('welcome') %> ◀◀◀스타일시트 이름을 지정

</head>

<body>

<%= @content_for_layout %>

<div class="footer">

<hr/>

powered by <a href="http://www.rubyonrails.org">Ruby on Rails</a>

</div>

</body>

</html>

정적인 컨텐츠 배치

리스트 2-08의 stylesheet_link_tag 메소드는 디렉토리를 지정하지 않으면 이미 지정된 디렉

토리명（public /stylesheets）을 자동으로 지정합니다. 이것은 javascript_include_tag 메소드

에서도 같습니다.

레일스에서는 스타일시트（확장자는 css）같은 정적인 컨텐츠는 프로젝트 루트 디렉토리 바로

밑의 public 디렉토리 안에 배치합니다. public 디렉토리에는 미리 파일과 디렉토리가 준비되

어 있고 이들은 변경이나 추가가 가능합니다. 또 디폴트 값이 설정된 Apache의 설정 파일도 포

함돼 있습니다. 다음 표는 public 디렉토리에 배치하는 주요 파일과 디렉토리입니다.

6 레이아웃도 Convention over Configuration(“설정보다도 규칙을 우선하라” )의 예입니다. 경우에 따라서는 복수의 컨트롤러가 공통의 레이

아웃을 이용하고 싶을 경우도 있으므로 반드시 컨트롤러명과 파일명을 일치시키는 방법이 가장 좋을 이유는 없습니다. 이를 위해 컨트롤러

내에서 이용하는 레이아웃을 지정하는 것도 가능합니다.


35

표 2.2 public 디렉토리 내용

이름 종류 내용

.htaccess Apache 설정 파일 기본적인 내용을 설정하고 있음.

404.html HTML 컨텐츠가 발견되지 않은 경우에 반송하는 HTML.

500.html HTML 애플리케이션 에러시의 표시에 이용하는 HTML(Apache

이용시에는 .htacess 내의 설정 이용）.

dispatch.* 프로그램（복수） 웹 애플리케이션을 실행하기 위한 프로그램

favicon.ico 아이콘파일 기본 빈 파일이므로 아이콘을 웹 브라우저에 표시하고 싶

은 경우에 치환함.

index.html HTML 기본 빈 파일이므로 필요에 따라 내용을 추가 기록.

robots.txt 웹 크롤링(crawling) 제한 파일 기본 빈 파일이므로 필요에 따라 내용을 추가 기록.

Images 디렉토리 그림 파일을 저장하기 위한 디렉토리

javascripts 디렉토리 JavaScript을 저장하기 위한 디렉토리. 미리 Ajax용 라이

브러리 스크립트를 저장하고 있음.

stylesheets 디렉토리 스타일시트（CSS）를 저장하기 위한 디렉토리.

여기서는 stylesheets 디렉토리 안에 welcome.css라는 이름으로 CSS 파일을 작성하고 레이

아웃 footer 일부 스타일을 정의합니다.

[ 리스트 2-09.....public/stylesheets/welcome.css ]

div.footer {

padding: 2px;

text-align: right;

font-size: x-small;

}

여기까지 끝냈다면 이 장 처음에서 보여준 예제와 같은 모양을 보여줍니다. 실제로 동작시켜

footer가 표시되고 있는지 등을 확인해 봅시다.

7......라우트(route) 설정

라우트는 웹 브라우저가 필요한 URL로부터 실제 웹 애플리케이션（컨트롤러와 액션）을 결정

하기 위해 설정합니다. 기본적으로는 설정하지 않아도 이용할 수 있지만 여기서는 웹 애플리케

이션 디폴트를 welcome 컨트롤러의 who 액션으로 설정하여, http://127.0.0.1:3000에서 액

세스한 경우에 who를 실행하도록 해 봅시다. 라우트 파일명은 config/routes.rb입니다.

36

JRuby on Rails

[ 리스트 2-10.....config/routes.rb ]

ActionController::Routing::Routes.draw do |map|

(생략)

# You can have the root of your site routed by hooking up ''

# -- just remember to delete public/index.html.

map.connect '', :controller => 'welcome', :action => 'who' ◀◀◀ 수정

# Allow downloading Web Service WSDL as a file with an extension

# instead of a file named 'wsdl'

map.connect ':controller/service.wsdl', :action => 'wsdl'

# Install the default route as the lowest priority.

map.connect ':controller/:action/:id'

end

수정한 줄 위의 코멘트에 있는 것처럼 public 폴더의 index.html을 잊지 말고 제거해 주세

요. 이것으로 hello 프로젝트는 완성하였습니다. 웹 브라우저에 http://127.0.0.1:3000을 입력

하고 실제로 동작시켜 봐 주세요.


37

코드 설명

여기서는 １일째에서 소개한 소스 파일 내용에 대해 보다 자세하게 설명합니다.


class WelcomeController < ApplicationController ......A

def who ......B end ......C

def hi

end

def bye

end

end ......D

A......루비에서는 class라는 키워드 다음에 대문자로 시작한 클래스명을 부여해서 클래스를 정

의합니다. 루비에서는 대문자와 소문자가 구별되므로 앞부분의 문자가 대문자인지 소문자인지

에 따라 의미가 바뀝니다. 또 레일스 컨트롤러의 클래스명은 컨트롤러명에 Controller를 붙인다

고 하는 규칙이 있습니다.

여기서는 컨트롤러명이 welcome이므로 클래스명은 루비의 클래스명 규칙에 따라 앞부분을

대문자로 한 Welcome과, 레일스의 규칙에 따른 Controller가 추가돼 WelcomeController로

됩니다. 클래스의 정의는 아래 형식입니다.

class 클래스명[< 상속할 클래스]

……

end

클래스명은 대문자로 시작합니다. 상속할 클래스의 필요여부는 애플리케이션 처리에 따라 다

릅니다. 레일스의 경우 프레임워크가 디폴트 처리를 제공하기 때문에 생성하는 대부분의 클래

스에 상속할 클래스가 있습니다. 클래스의 상속을 이용하면 부모 클래스에 정의되어 있는 메소

드 등을 직접 이용할 수 있게 됩니다. 이를 통해 레일스가 제공하는 메소드 등을 프로그램에서

특별히 의식하지 않고 이용할 수 있습니다.

38

JRuby on Rails

B......레일스가 자동으로 생성한 액션에 대응하는 메소드에 대한 정의입니다. 여기서는 액션명

으로 who, hi, bye를 지정했기 때문에 각각에 대응하는 메소드가 생성되고 있습니다. 클래스명

과 달리 메소드명은 소문자로 시작합니다. 7

레일스에서는 액션 실행중에 뷰를 지정하지 않은 경우에는 액션명（＝메소드명）과 이름이 같

은 rhtml 을 호출합니다. 따라서 이 예에서는 메소드 내의 어떤 것도 지정하지 않았으므로

who.rhtml이 호출됩니다. 메소드 정의는 아래 서식 중 하나로 합니다.

def 메소드명［가인수 이름...］

def 메소드명（［가인수 이름...］）

……

end

메소드명의 뒤에 ( )는 생략할 수 있습니다. 레일스에서는 전체적으로 ( ) 를 쓰지 않는데, 프

로그램을 간단하게 하려는 의도입니다. 가인수(가상의 인수) 이름이라는 것은 메소드의 인수 이

름입니다. 클래스의 정의시점에서는 실인수(실제 인수）는 부여되지 않기 때문에 가인수의 이름

을 이용해서 프로그래밍합니다.

C......메소드 정의 종료를 나타냅니다.

D......클래스 정의 종료를 나타냅니다.

7 다만 클래스명과 달리 메소드명은 대문자로 시작해도 에러가 나지 않습니다. 소문자로 시작하는 것이 일반적인 작성법이라고 생각해 두세

요.

class Controller< ApplicationController상속할 클래스명

상속할 클래스를 표시하는 키워드

레일스가 부가한 부분

컨트롤러명（welcome)부분을 대문자로 한 것

클래스 정의를 표시하는 키워드

Welcome그림 2.11 클래스 정의 시작행


39

[ 리스트 2-03.....guest.rb ]

class Guest ......A def initialize(name) ......B @name = name ......C end

attr_accessor :name ......Dend

A......이미 설명한 대로 클래스는 class 키워드 뒤에 대문자로 시작하는 이름을 붙입니다. 여기

서는 상속할 클래스가 없기 때문에 클래스명까지만 쓰면 됩니다.

B......initialize라는 이름의 메소드는 특별한 의미를 가지고 있습니다. initialize 메소드는 프로그

램이 클래스 정의로부터 오브젝트를 생성할 때 필요한 초기화를 하는 메소드이기 때문입니다. 참

고로 클래스 정의로부터 오브젝트를 생성하려면 「클래스명.new」라고 씁니다.

C......이 메소드는 인수로 전달 받는 이름을 오브젝트 내용에 저장합니다. 또, 앞부분이 @로 시

작하는 변수는 생성된 오브젝트마다 다른 데이터를 저장할 수 있는 특수한 변수（인스턴스 변수）

를 표시합니다.

루비에 있는 변수 내용을 다른 변수에 설정하려면 ＝을 이용합니다. 따라서 @name = name이

라고 하는 것은 initialize 메소드의 인수인 name이라는 변수의 내용（여기서는 이름）을 @name라

는 인스턴스 변수에 설정하고 있는 것이 됩니다.

D......attr_accessor를 사용하여 인스턴스 변수 이름(앞부분의 ＠를 떼어낸 것）을 지정하면, 다

른 클래스에서도 그 인스턴스 변수를 해당 클래스의 속성으로서 접근할 수 있게 됩니다. 실제 이

용 예는 rhtml 프로그램에 나옵니다. 또 여기서 이용하고 있는 :name 같이 앞부분에 「：」를 붙

인 이름은 심볼(Symbol)로 불려, 「：」 뒷 부분을 고정적인 이름으로써 프로그램 내에서 참조하

기 위해 이용합니다.

모델을 작성하는 경우, 여기서는 애플리케이션이 다루는 모델의 내용이 이름뿐이므로

Name 클래스를 작성하는 방법을 우선 생각해 봅시다. 어떤 클래스가 대상으로 하는 범위를

작게 잡으면, 나중에 확장하고 싶은 경우에 전체적인 수정이 필요하게 됩니다. 예를 들어 이

름만이 아닌 출신지（hometown）도 입력하고 싶은 경우를 생각해 봅시다. 이미 애플리케이

션이 Name이라는 클래스를 이용하고 있는 상태입니다. 하지만 출신지는 Name과는 독립적

인 관계이므로 Name보다 범위가 큰 클래스를 이용하지 않으면 출신지를 프로그램 안에 담

을 수 없게 됩니다.

40

JRuby on Rails

결과적으로 Name이라는 클래스와 이 클래스를 이용하고 있는 곳을 전부 수정해서 보다 범

위가 큰 클래스를 이용하도록 수정할 수밖에 없게 됩니다. 이러한 상황이 발생하지 않게 하려면

페이지에 입력되는 데이터의 한 단계 상위의 개념을 클래스로 하는 것이 좋습니다.



def who ......A end

def hi

@guest = Guest.new(params[:guest][:name]) ......B session[:guest] = @guest

end

def bye

@guest = session[:guest] ......C session[:guest] = nil

end

end

A......who 액션에서는 입력이 없기 때문에 아무것도 실행하지 않습니다.

B......hi 액션이 호출되는 것은 who 페이지에서 이름이 입력된 다음입니다. 이렇게 HTML 상

에서 입력된 데이터는 params[오브젝트의 이름][오브젝트의 속성] 형식으로 끄집어 낼 수 있습니

다. 여기서는 입력한 이름을 저장하는 guest 오브젝트（모델）를 작성하고 이것을 뷰가 이용할 수

있도록 인스턴스 변수（@guest）에 설정하고 있습니다. 이어서 bye 액션에서도 이용할 수 있도록

session에도 설정해 둡니다.

C......hi 액션에서 생성하고 session에 설정해둔 guest 오브젝트를 꺼내서 뷰가 참조할 수 있도

록 인스턴스 변수에 설정합니다. 이 뒤에서 session 내의 guest 정보를 말끔히 지우기 위해 nil（

빈상태를 표시하는 특수 값）을 설정합니다.

여기서, 아래 행에 대해 설명해 나가면서 루비에서의 오브젝트 생성에 대해 설명합니다.

@guest = Guest.new(params[:guest][:name])

params 내용......params［오브젝트를 표시하는 키］［속성을 표시하는 키］


41

session 내용......session［오브젝트를 표시하는 키］

여기서 이용하고 있는 데이터를 저장하는 오브젝트는 위의 2개 입니다. 양쪽 모두 키에는 심

볼을 이용합니다. 문자열（" " 혹은 ' ' 로 싸인 문자로 줄지어 있는 것）을 키로 이용하는 것도 가

능합니다. 여기서는 읽기 쉽고 간략한 심볼을 사용합니다.

예를 들어 사용자가 이름으로 “홍길동”을 입력한 경우, params[:guest][:name] 에는 “홍길

동”이 들어갑니다. 따라서 Guest.new(params[:guest][:name]) 은 Guest.new(‘홍길동’)로 씌어진

것과 같습니다.（루비에서는 문자열은 " " 또는 ' ' 로 묶습니다. " " 을 이용한 경우는 #{ }을 사용

할 수가 있습니다. ' '을 이용한 경우 #{ }는 그 문자 자체가 됩니다.

리스트 2-03 guest.rb의 initialize 메소드 정의는 아래와 같습니다.

def initialize(name)

@name = name

end

initialize 메소드는 오브젝트가 생성될 때에 루비에 의해 호출되는 메소드입니다. initialize

메소드의 인수에는 new에 쓰여진 내용이 설정됩니다. 따라서 여기서 생성된 오브젝트의 인스

턴스 변수 @name에는 “홍길동” 이 설정됩니다. 다음은 이를 순서로 표시한 것입니다.

1......오브젝트 생성을 지시한다.

Guest.new(params[:geust][:name])

2......params［:guest］:name］의 내용이 추출된다.

Guest.new(‘홍길동’)

3......루비가 Guest 클래스의 initialize 메소드를 호출한다.

（프로그램에서는 new를 호출하는 것으로 되어 있으므로, initialize 메소드를 부르지 않도록 주의）

4......initialize 메소드가 실행된다. 이 때, 가인수(가상 인수)가 실인수(실제 인수)로 치환된다.

@name = "홍길동"

5......initialize 메소드를 마치고 루비가 생성한 Guest 오브젝트가 나온다.

6......생성된 오브젝트를 @guest에 설정한다.

@guest = 생성된 Guest 오브젝트

Guest.initialize(‘홍길동’)

42

JRuby on Rails

[ 리스트 2-05.....who.rhtml ]

<% @title = '입구' %> ......A <h1>누구십니까？</h1>

<% form_tag :action => :hi do %>

<%= text_field :guest, :name %> ......B <%= submit_tag '기억하기'%>

<% end %>

A......<% %> 안에는 루비 프로그램을 기술합니다. 여기서 쓰여진 프로그램은 rhtml에서 html을

생성할 때 실행됩니다. 따라서 이 행은 @title이라는 who.rhtml 인스턴스 변수에 「입구」라는 문

자열을 설정하는 프로그램입니다. 여기서 설정한 @title이라는 인스턴스 변수는 뒤에서 레이아웃

이 이용합니다. 레이아웃에 대해서는 다음 항목에서 설명합니다.

M I N I C O L U M N

인스턴스 변수

이전에 @로 시작하는 변수를 인스턴스 변수라 부르고, 오브젝트마다 다른 데이터를 보유할

수 있다고 설명하였습니다. 이 의미는 인스턴스 변수는 오브젝트마다 다르다는 의미입니다.

아래는 구체적인 예입니다.

gildong = Guest.new("길동")

chulsu = Guest.new("철수")

위의 예에서는 같은 Guest 클래스에서 2개의 오브젝트 gildong 과 chulsu 를 만들었습니다.

만일 @name이 클래스에 속해 있다면 마지막에 설정한 "철수"가 양쪽 오브젝트에 사용될 것입니

다. 하지만 인스턴스 변수는 오브젝트마다 만들어지므로 gildong 오브젝트의 @name에는 "길

동"이, chulsu 오브젝트의 @name에는 "철수"가 각각 설정됩니다. 이러한 구조로 되어 있기 때

문에 프로그램에서는 다른 데이터를 가진 복수의 오브젝트를 동시에 다룰 수 있습니다.

한편 메소드는 같은 클래스의 복수 오브젝트에서 공통입니다. 이 때문에

gildong.name #-> "길동"◀◀◀Guest 클래스의 attr_accessor에 의해 이 오브젝트의 @name이 참조된다.

chulsu.name #-> "철수"◀◀◀Guest 클래스의 attr_accessor에 의해 이 오브젝트의 @name이 참조된다.

라고 할 경우 같은 attr_accessor에 의해 작성된 name 메소드가 호출되게 됩니다. 하지

만 이 메소드가 돌려주는 것은 인스턴스 변수인 @name이므로 오브젝트마다 다른 결과가 나

옵니다.


43

B......<%= %> 안에는 루비 프로그램을 기술합니다. <% %>와 달리, <%= %> 처리에서는 실행결

과로써 프로그램을 둘러싼 <%= %> 부분을 치환할 수 있습니다. 다음은 여기서 이용하고 있는 레

일스 HTML 출력 메소드를 표시합니다.

form_tag :action => 액션명 do … end

지정된 액션명을 호출하는 폼（입력항목의 집합）을 시작하며 … 부분을 end 실행한 다음 폼

을 종료합니다.

text_field 오브젝트을 표시하는 키, 속성을 표시하는 키

텍스트 입력항목을 작성합니다. form_tag의 :action에서 지정된 액션에서는 아래 기술된 입력

내용을 참조할 수 있습니다.

params[오브젝트를 가리키는 키][속성을 가리키는 키]

submit_tag 문자열

지정한 문자열을 표시하는 전송 버튼을 작성합니다.

[ 리스트 2-06.....hi.rhtml ]

<% @title = '현관' %>

<h1><%= h "안녕하세요 #{@guest.name}님！"%></h1> ......A<% form_tag :action => :bye do %>

<%= submit_tag '다음으로'%>

<% end %>

A......<%= h %> 안의 부분은 <%= %> 안의 부분과 같이 루비 프로그램을 기술합니다. <%= h

%>에 기술한 처리 실행결과가 HTML로 출력됩니다. <%= h %>은 <%= %>과 달리 표시가 바르게

실행되도록 < 와 > 등의 문자를 이스케이프 처리합니다. 따라서 레일스의 HTML 출력 메소드（

HTML의 태그를 출력합니다.）를 호출하는 부분 이외에 대해서는 <%= %>가 아닌 <%= h %>를 이

용합니다. 여기서는 액션이 작성한 모델의 속성값을 HTML에 쓰기 위해 이용합니다.

"안녕하세요, #{@guest.name}님！"에 들어있는 #{@guest.name} 부분은 @guest.name의 내용에

따라 #{@guest.name}를 치환할 수 있다는 루비 명령입니다.

이렇게 " " 안에 있는 #{ } 중괄호 안의 내용은 문자열로 취급되지 않고 루비 프로그램으로 취

급됩니다. 또 문자열로써 #{ }를 출력하고 싶은 경우는 전체를 " " 가 아닌 ' ' 로 묶습니다.

44

JRuby on Rails

"안녕하세요、#{@guest.name}님！"

"안녕하세요、#{홍길동}님！"

"안녕하세요、홍길동님！"

#{ }의 내용을 실행하고, 그 결과로 치환할 수 있다（여기서는 이름에 「홍길동」으로 입력했다고 가정）

#{ }의 부분은 필요없게 되었으므로 제거한다

처음 문자열

그림 2.12......{}의 변형

[ 리스트 2-08.....app/views/layouts/welcome.rhtml ]

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

<title><%= h @title %></title> ......A <%= stylesheet_link_tag('welcome') %> ......B</head>

<body>

<%= @content_for_layout %> ......C <div class="footer">

<hr/>

powered by <a href="http://www.rubyonrails.org">Ruby on Rails</a>

</div>

</body>

</html>

A......뷰 프로그램에서 설정한 @title을 HTML의 title 태그에 이용하고 있습니다. 이처럼 레이

아웃과 뷰는 인스턴스 변수을 공유합니다.

B......sytlesheet_link_tag（‘스타일시트명’）은 레일스의 HTML 생성 메소드에서 지정한 스타

일시트명에 대한 link 태그를 생성합니다. 스타일시트명이 「.」을 포함하지 않은 경우는 확장자

로 css를 부가합니다.

C......@content_for_layout 인스턴스 변수의 내용은 뷰의 rhtml에 의해 생성된 HTML입니

다. ［A］와 달리 @content_for_layout은 HTML이므로 <%= h %>을 사용하면 태그가 전부 문자열로

표시돼 버립니다. 이 경우는 <%= %>를 이용해 주세요.

아래는 여기서 이용하고 있는 레일스의 HTML 출력 메소드를 나타내고 있습니다. javas-

cript_include_tag는 여기서는 이용하지 않지만 stylesheet_link_tag와 이용방법이 같으므로

여기서 설명합니다.


45

stylesheet_link_tag（스타일시트명）......지정한 스타일시트의 link 태그를 작성합니다. 인수로 지정

한 스타일시트명에 「.」가 포함돼 있지 않은 경우는 확장자 css를 자동으로 보충합니다.

javascript_include_tag（스타일시트명）......지정한 스크립트의 script 태그를 작성합니다. 인수에서

지정한 JavaScript명에 「.」가 포함돼 있지 않은 경우는 확장자 js를 자동으로 보충합니다.

[ 리스트 2-10.....config/routes.rb ]

ActionController::Routing::Routes.draw do |map|

(생략)

# You can have the root of your site routed by hooking up ''

# -- just remember to delete public/index.html.

map.connect '', :controller => 'welcome', :action => 'who' ......A

# Allow downloading Web Service WSDL as a file with an extension

# instead of a file named 'wsdl'

map.connect ':controller/service.wsdl', :action => 'wsdl'

# Install the default route as the lowest priority.

map.connect ':controller/:action/:id' ......Bend

A......라우트(route)에 설정하는 것은 URL의 경로 부분에 해당하는 패턴을 실행하는 액션의

대응 관계(mapping)입니다. 여기서는 http://127.0.0.1:3000 처럼 경로명이 입력되지 않은 설

정이므로 컨트롤러명 welcome, 액션명 who를 실행하도록 설정합니다. 또, 경로명이 입력되지

않은 경우 라우트 설정을 유효로 하기 위해서는 public/index.html을 제거하든지 이름을 변경

하지 않으면 안됩니다.

B......디폴트 실행설정입니다. 이보다 앞에 웹 클라이언트로부터 경로에 일치하는 설정이 없다

면, 라우트는 이 행의 정의에 따라 웹 애플리케이션을 호출합니다. 여기서 기록된 ':controller/:

action/:id'는 경로 패턴이 되는 동시에 실행하는 컨트롤러/액션과 URL의 경로 관련을 정의하

는 것입니다. 만일 웹 클라이언트로부터 받는 경로가 welcome/hi라면 여기에 기술되고 있는

':controller/ :action/: id'에 controller로 welcome, action에 hi가 선택됩니다. 이 경우 id에는 아무것

도 부여되지 않습니다. id는 데이터베이스를 이용할 경우에 키로 되는 데이터를 지정하기 위해

이용합니다. id에 관해서는 다음 장에서 설명합니다.

46

JRuby on Rails

좀더 알고 싶어요! Q&AQ. 루비에서 프로그램을 작성할 때, 기본적인 규칙을 알려주세요

중요한 것 몇 개를 모으면 아래와 같습니다.

▒ 루비는 대문자와 소문자를 구별합니다.

▒ 클래스명은 대문자로 시작합니다.

▒ 메소드명은 일반적으로 소문자로 시작합니다.

▒ 루비의 일반적인 들여쓰기는 ２문자입니다.

▒ 오브젝트를 생성하려면 「클래스명.new」로 씁니다.

▒ 루비는 오브젝트를 생성할 때에 initialize 메소드를 호출합니다.

▒ 앞부분이 「@」으로 시작하는 변수를 인스턴스 변수라 부릅니다.

▒ 인스턴스 변수는 개별 오브젝트 마다 존재합니다.

▒ 앞부분이 「:」로 시작하는 이름을 심볼로 부릅니다. 심볼은 프로그램 내에 정의된 이름을

가리키는 특별한 오브젝트입니다.

Q. rhtml을 쓸 때 사용한 태그가 다른 것에 대해 알려주세요

rhtml을 쓸 때 사용한 태그에는 아래와 같은 다른 역할이 있습니다.

▒ <% %> 안의 부분은 루비 프로그램이 실행된다.

▒ <%= %> 안의 부분은 루비 프로그램이 실행되고 난 이후의 내용으로 치환된다.（HTML

태그 출력용）

▒ <%= h %> 안의 부분은 루비 프로그램이 실행되고 난 이후의 내용으로 치환된다.（데이

터 출력용）

▒ " " 안의 문자열 내의 #{ } 로 묶인 부분은 루비 프로그램이 실행되고 난 이후 결과값으

로 치환된다.


47


여기서는 레일스로 웹 애플리케이션을 만들기 위한 기초를 배웠습니다.

1. MVC

레일스는 웹 애플리케이션을 3종류의 프로그램으로 분할한다.

모델......애플리케이션의 처리대상이 되는 데이터

컨트롤러......웹 브라우저로부터 요청을 받아 모델을 조작하고 뷰을 호출한다.

뷰......모델의 내용을 표시용으로 가공한다.

2. 스켈레톤 작성

아래 명령어를 사용해서 컨트롤러를 작성합니다.

jruby script/generate controller 컨트롤러명 액션명……

3. 컨트롤러

컨트롤러는 app/contollers 아래 배치됩니다. 아래와 같은 특징이 있습니다.

▒ 컨트롤러는 액션에 대응하는 메소드를 정의한 클래스입니다.

▒ 액션에서 작성한 인스턴스 변수는 뷰에서 이용합니다.

▒ 액션에서 특별히 지정을 하지 않으면 같은 이름의 뷰가 호출됩니다.

▒ session을 이용해서 다른 액션 간에서 데이터를 공유합니다.

▒ params를 이용해서 웹 브라우저로부터 받아 생긴 사용자 입력 데이터를 참조할 수 있

습니다.

4. 뷰

뷰는 app/views/컨트롤러명 아래에 배치됩니다. 뷰는 rhtml이라는 확장자를 가진,루비 프로그

램을 집어넣은 HTML입니다. 아래의 루비 프로그램을 위한 태그를 가집니다.

48

JRuby on Rails

<% 프로그램 %>

루비 프로그램을 실행합니다.

<%= 프로그램 %>

루비 프로그램을 실행하고 출력결과로 바꿉니다. 이 태그는 HTML을 집어넣기 위해 이용합

니다.

<%= h 프로그램 %>

루비 프로그램을 실행하고 출력결과를 필요에 대응해서 이스케이프 처리한 후에 바꿉니다.

이 태그는 데이터를 집어넣기 위해 이용합니다.

5. 레이아웃

레이아웃은 app/views/layouts 아래에 배치되어 복수의 뷰에 통일된 외관을 부여하기 위해

이용합니다. 뷰의 실행결과는 <%= @content_for_layout %>을 이용해서 집어넣습니다.

6. 정적 컨텐츠

정적 컨텐츠는 public 디렉토리 아래에 둡니다.

49

3일째 3일째의 목표는 레일스로 관계형 데이터베이스를 사용하여 애플리케이션을 만드는 것입니다.

여기서 만드는 웹 애플리케이션은 간단한 웹 주소록(yellowpage)입니다.

먼저 레일스로 관계형 데이터베이스를 이용하기 위해 어떤 준비를 해야 하는지 설명합니다.

그리고 실제 웹 애플리케이션을 만들고 돌려 봅시다.

데이터베이스 이용하기웹 주소록(yellowpage)을 만들어 보자

50

JRuby on Rails

즐겨 찾는 웹 페이지를 등록하는 웹 주소록(yellowpage)을 만듭니다

3일째 예제: 웹 주소록(yellowpage) 프로젝트

3일째 웹 애플리케이션 yellowpage는 즐겨 찾는 홈페이지를 등록하는 웹 주소록입니다. 등록

한 데이터는 편집하거나 삭제할 수 있습니다. 메뉴는 영어로 표시됩니다. 리스트 표시 화면부터

는 수정, 삭제, 표시와 신규작성을 할 수 있습니다.

학습 진행 방법

여기서는 다음 순서대로 yellowpage를 개발합니다.

1. 프로젝트 만들기

2. 데이터베이스와 사용자 만들기(Rake 이용）

3. 테이블 작성（마이그레이션 이용）

4. 애플리케이션 작성

여기서 특히 중요한 것은 Rake 또는 레일스의 마이그레이션과 스케폴드(scaffold), 이 둘의

구조입니다.

Rake......루비로 작성된 빌드 툴（지정한 작업을 실행하는 툴）

마이그레이션（migration）......데이터베이스 변경과 애플리케이션 변경을 동기화한다.

스케폴드（scaffold）......데이터베이스를 이용하는 애플리케이션 스케폴드(scaffold) 작성.

3일째......데이터베이스 이용하기

51

정보를 입력하고 나서 [Create] 버튼을 클릭하면 등록

그림 3.2 정보 등록 화면

홈페이지 이름, 카테고리, URL 등을 입력합니다.

[New item]을 클릭하고、 신규등록화면을 엽니다.

그림 3.1 처음 표시되는 빈 상태의 리스트 표시 화면

（http://localhost:3000/items）

삭제할 때 클릭

내용을 표시할 때 클릭

편집할 때 클릭

그림 3.3 리스트 화면에서 [Destroy]를 클릭하면,

삭제 확인 화면이 나옵니다.

그림 3.4 등록한 데이터는 리스트 화면에서

[Edit]를 클릭하면 재편집할 수 있습니다.

그림 3.5 리스트 화면에서 [Show]를 클릭하면

등록한 정보를 표시합니다.

52

JRuby on Rails

관계형 데이터베이스 기초입문기초지식 1

레일스와 관계형 데이터베이스

레일스를 잘 사용하려면 관계형 데이터베이스를 간단하게 조작할 수 있어야 합니다. 게시판에

올라오는 다양한 데이터(예를 들어 작성 일시, 작성자, 작성 내용 등)를 관계형 데이터베이스로

관리하면, 특정 날짜의 작성 내용을 추출하거나 작성자 목록을 뽑아내는 등의 처리는 코드 몇 줄

로 레일스（정확하게는 ActiveRecord라는 모듈입니다）가 자동으로 실행합니다. 마찬가지로 입

력된 데이터 저장 등도 코드 몇 줄로 프로그램 할 수 있습니다. 이를 위해 레일스를 사용한 웹 애

플리케이션 데이터를 저장하거나 검색하거나 하려면 관계형 데이터베이스를 이용합니다.

관계형 데이터베이스

관계형 데이터베이스는 데이터베이스 시스템（특정 형식의 데이터 집합을 통합 관리하는 시스

템）의 하나로, 데이터를 열(필드）과 행(레코드）의２차원으로 되어있는 테이블 및 테이블 간의 관

계로 표시합니다. 또, 이들의 집합을 데이터베이스라고 부릅니다. 관계형 데이터베이스라고 하

는 것은 어떤 테이블의 특정 열과 다른 테이블의 열에 같은 의미를 부여해서, 이들 테이블끼리

결합한 것입니다.

그림 3.6 관계형 데이터베이스


53

관계형 데이터베이스와 정규화

테이블과 관계의 구체적인 예로, 다음 형식의 주소록에 관해 생각해봅시다.

표 3.1 원래 주소록

등록번호 성 이름 주소 전화번호

0 김 일남 서울시 관악구 1111-1111

1 김 이남 서울시 관악구 1111-1111

2 김 삼남 서울시 관악구 1111-1111

3 박 일남 경기도 파주시 1111-1112

4 박 이남 경기도 파주시 1111-1112

5 이 일남 경기도 수원시 1111-1113

이 주소록은 필드에 등록번호, 성, 이름, 주소, 전화번호를 가지고 있습니다. 표 형식이므로

그대로 관계형 데이터베이스 테이블로 생각할 수 있습니다. 하지만 언뜻 보기에도 이 주소록은

쓸데없이 깁니다. 예를 들어 세 명이 한가족인 김씨네의 레코드에 대해 같은 내용의 필드（서울

시 관악구）가 반복되어서 나타납니다. 문제는 이러한 중복 데이터가 시스템 성능을 떨어뜨리는

데 있습니다. 여기에서 주소와 전화번호를 별도의 테이블로 옮겨서 성/이름과 주소/전화번호로

구조를 변경해 봅시다.

그림 3.7은 주소와 전화번호를 주소 테이블이라고 하는 새로운 테이블로 이동한 것입니다. 이로

인해 같은 주소와 전화번호는 하나의 레코드가 표시되도록 변경하였습니다. 원 주소록 테이블에

는 새로 ‘주소 테이블 등록번호’라고 하는 필드를 추가하였고, 이 필드에 주소 테이블의 등록번호

를 설정하도록 하였습니다. 이렇게 하여 주소와 전화번호를 알고 싶은 경우에는 주소 테이블 등

0

1

2

3

4

5

0

0

0

1

1

2

0

1

2

1 111-1111

1111-1112

1111-1113

주소록테이블

주소테이블

등록번호 성 이름 주소테이블 등록번호

김 일남

김 이남

김 삼남

박 일남

박 이남

이 일남

주소등록번호 전화번호

서울시 관악구

경기도 파주시

경기도 수원시

릴레이션쉽

그림 3.7 중복을 없앤 주소록

54

JRuby on Rails

록번호 필드값과 같은 등록번호를 가진 주소 테이블 레코드를 참조하면 됩니다.

이렇게 테이블에서 복수 레코드로 반복 출현하는 필드를 별도 테이블의 레코드로 독립시켜서

이들 테이블 간에 관계를 맺는 작업을 정규화라고 부릅니다. 정규화의 결과, 하나의 레코드에 포

함된 필드는 전부 １대１, １대 다, 혹은 다 대１의 관계로 표시됩니다.

정규화를 수행할 때는 데이터의 불필요한 나열을 보는 것도 중요하지만 필드의 의미와 필드의

집합으로써의 테이블의 의미를 합쳐서 생각하는 것이 중요합니다. 예로 든 주소록에는 ‘성’ 필드

의 내용도 중복되지만, 그렇다고 해서 ‘성’만 별도 테이블로 보내면 주소록이 가진 ‘성’과 ‘이름’에

서 주소와 전화번호를 찾는다고 하는 기본 의미를 잃어버리게 됩니다.

관계형 데이터베이스 프로그램의 이용

관계형 데이터베이스를 관리하는 프로그램을 관계형 데이터베이스 관리 시스템（RDBMS）이

라고 부릅니다. 관계형 데이터베이스 관리 시스템에는 MySQL이외에 Oracle, 마이크로소프트

의 SQL Server, IBM의 DB2 등이 있습니다.

이들 프로그램은 모두 관계형 데이터베이스를 이용하는 애플리케이션과는 서로 다른 프로그

램일 뿐만 아니라, 경우에 따라서는 서로 다른 컴퓨터에서 실행됩니다.

RDBMS와 클라이언트는 서로 다른 프로그램이므로 인터페이스에는 물리적（실제로 컴퓨터가 다른

경우）혹은 논리적（같은 컴퓨터에서 실행하는 경우）인 통신을 이용합니다. 통신을 이용하는 프로그램

은 외부의 프로그램으로 정보를 전해주거나 정보를 받거나 합니다. 안전하게 실행하기 위해서는 허가

받지 않은 클라이언트로부터의 접속을 막지 않으면 안됩니다. 이를 위해 이용하는 것이 인증입니다.

RDBMS

RDBMS클라이언트

RDBMS클라이언트

프로세스간 통신

데이터베이스

데이터베이스

데이터베이스

클라이언트 컴퓨터 서버 컴퓨터

그림 3.8 RDBMS와 클라이언트

클라이언트는 다른 컴퓨터에서 실행되거나 서버 컴퓨터의 별도 프로세스로서 실행되는 것도 있습니다


55

RDBMS도 통신을 이용하는 이상, 이용에 앞서 클라이언트에 인증을 요구합니다. 인증에 이

용되는 것은 사용자 ID와 암호입니다. 또한 사용자별로 읽기 및 쓰기가 가능한 데이터베이스를

한정함으로써, 서로 다른 애플리케이션 간에 불필요한 간섭이나 누설을 막기 위한 권한 관리자

기능도 있습니다.

이러한 클라이언트와 RDBMS의 인터페이스에 관한 정보는 직접 프로그램에 작성해서는 안됩니

다. 만일 프로그램에 사용자 ID와 데이터베이스 이름 등이 포함되면, 개발이 완료된 시점에서 이들

정보가 변경된 경우, 다시 프로그램을 수정하지 않으면 사용할 수 없는 사태가 발행합니다.

레일스에서는 config/database.yml 파일에서 아래 정보를 관리합니다.

▒ RDBMS와의 접속에 이용하는 프로그램

▒ 데이터베이스 이름

▒ 사용자 ID

▒ 암호

▒ 접속하는 쪽의 컴퓨터 이름

레일스는 실행시에 database.yml 으로부터 적절한 설정을 읽어 들여, 애플리케이션이 관계형 데

이터베이스를 이용할 수 있도록 준비합니다. database.yml 설정에 관해서는 나중에 다시 설명합

니다.

M I N I C O L U M N

레일스 사용자에게 주는 권한

보통 데이터베이스를 쓸 때에는 애플리케이션 환경마다 서로 다른 데이터베이스를 이용하는

것이 규정입니다. 한편, 레일스가 규정하는 사용자 ID는 root가 할당되어 있습니다. 하지만

이는 root 사용자가 미리 정의되어 있음을 가정하고 있으므로, 그리 바람직한 설정은 아닙니

다. 애플리케이션 데이터베이스 액세스 처리에 문제가 있는 경우, RDBMS에 접속하고 있는

사용자가 애플리케이션 고유의 데이터베이스에만 접속할 수 있게 되어 있다면, 피해는 해당 데

이터베이스 내에 한합니다. 하지만 만일 사용자가 root 권한으로 전체 데이터베이스에 대해 액

세스 할 수 있는 권한을 가지고 있다면 전체 데이터베이스가 피해의 대상이 됩니다.

이 책에서는 데이터베이스와 함께 사용자에 대해서도 모든 환경설정과 프로젝트에서 서로 다

른 ID를 할당하도록 합니다

56

JRuby on Rails

레일스가 이용하는 데이터베이스 기초지식 2

레일스 실행환경

레일스 프로젝트는 아래와 같은 3가지 실행 환경을 가정합니다.

표 3.2 레일스의 3가지 실행 환경

실행 환경 설명

development 개발에 이용하는 환경입니다. 특별히 환경을 지정하지 않고 웹 애플리케이션을 실행한

경우에 사용됩니다. 프로그램 변경을 즉시 반영하거나, 캐

시를 무효화하거나 합니다.

test 테스트에서 실행하는 환경입니다. 웹 서버를 이용하지 않고 애플리케이션을 실행하는 것으

로 간주합니다.

production 실제 운영에 이용하는 환경입니다. 성능 최적화와 실행 고속화를 다양하게 적용합니다.

레일스는 실행시에 어느 환경이 선택되는지를 환경변수 RAILS_ENV로부터 얻습니다.

RAILS_ENV 환경변수가 설정돼 있지 않은 경우에는 development가 지정돼 있는 것으로 간주합

니다. 그러나 이들 환경의 차이가 실행시의 동작에만 영향을 미치는 것은 아닙니다. 환경에 따

라 어느 데이터베이스를 이용할 것인가에도 영향을 미칩니다.

레일스가 미리 지정하는 데이터베이스 이름

레일스는 프로젝트가 생성되는 시점에서 RDBMS에 대해 실행 시에 이용하는 데이터베이스

의 설정도 기본적으로 제공합니다. 이 때 실정된 데이터베이스 이름은 프로젝트 이름에 3가지

환경(development, test, production)을 붙인 것이 됩니다. 아래 표는 각각의 환경에서 이용

되는 yellowpage 프로젝트 데이터베이스 이름을 표시한 것입니다. 물론 이와 다른 데이터베이

스 이름을 설정하는 것도 가능합니다만 이 책에서는 레일스 규칙에 따라 데이터베이스를 준비

하겠습니다.

특히, 실제 운용에 이용하는 production 용 데이터베이스와 그 이외의 데이터베이스를 나누

는 것은 중요합니다.


57

표 3.3 환경과 데이터베이스 이름의 대응（yellopage 프로젝트 경우）

실행 환경 데이터베이스 이름

development yellowpage_development

test yellowpage_test

production yellowpage_production

한창 운영하고 있는 중에 애플리케이션을 수정하기 위한 테스트를 실행한다고 가정한다면,

같은 데이터베이스를 이용하는 것이 위험하다는 것은 누구나 알 것입니다. 다른 데이터베이스

를 이용한다면, 테스트를 할 때 테이블이나 데이터를 제거하거나 새로 추가하는 것을 안전하게

할 수 있습니다.

Rake의 역할

Rake（명령 프롬프트에서는 rake로 실행합니다）는 루비로 만들어진 툴로 명령어 라인 파라미

터로 지정한 테스크를 실행합니다. 이제부터 테스크라고 부르는 것은 작업의 단위입니다. 예로

「데이터베이스 작성」이 1개의 테스크에 해당합니다.

Rake의 특징은 복수의 테스크를 등록할 수 있고, 각 테스크 간의 의존 관계를 지정할 수 있

는 것입니다. Rake가 미리 지정해서 읽어 들인 빌드 파일 이름은 rakefile（또는 Rakefile）입니

다. 1

레일스에서는 Rake를 테스트 프로그램 실행 등을 위해 이용합니다. 또, 뒤에 설명하는 마이

그레이션에도 Rake를 이용합니다. 이들 테스크를 실행하기 위해 프로젝트 루트 디렉토리 바로

아래에는 이미 Rakefile이 만들어져 있습니다. 이런 이유로, 애플리케이션 고유의 빌드 파일에

대해서도 배치 위치와 이름에 관한 규약이 설정되어 있습니다. 이 규약에 따라 빌드 파일을 만들

면 레일스 환경과 임의의 빌드 파일이 문제없이 공존할 수 있습니다.

레일스에서 Rake의 빌드 파일에 대한 규약은 lib/tasks 디렉토리 아래에 확장자 rake로 빌드

파일을 만드는 것입니다. lib/tasks 디렉토리에 배치한 빌드 파일은 Rake가 테스크를 실행할

때 자동적으로 검색 대상이 됩니다.

1 대문자 소문자를 구별하는 환경에서, 두 파일이 공존하는 경우에는 rakefile을 이용합니다

58

JRuby on Rails

M I N I C O L U M N

Rake의 빌드파일 작성법

Rake는 빌드 툴이므로 파일이나 디렉토리의 유무에 따라 지정한 테스크의 실행을 제어하는

기능을 가지고 있습니다. 다만, 여기에서는 Rake에 관한 다른 여러 기능은 이용하지 않으므

로 생략합니다. Rake의 빌드파일 작성법에 대한 상세한 설명은 아래 URL을 참조하시기 바

랍니다.

http://rake.rubyforge.org/files/doc/rakefile_rdoc.html

이미 만들어진 Rakefile

작업내용을 기술한 빌드파일은확장자 rake 를 붙여서lib/tasks 에 저장한다

그림 3.9 프로젝트 디렉토리 구성예


59

yellowpage 프로젝트 개발 순서

MySQL 준비

먼저 MySQL을 시작하여 루비에서 이용할 수 있도록 합니다.

■■ 윈도우의 경우 ■■

1일째 설명한 방법으로 MySQL을 설치하는 경우에는 자동적으로 시작되므로 별도의 준비는

필요 없습니다. MySQL이 자동으로 시작되는지를 알려면 제어판의 성능 및 유지관리▷관리 도구

▷서비스를 선택하여 MySQL▷상태 란에서 확인합니다. 만일 [상태]에서 [시작됨]이라고 표시되어

있지않으면 [확장] 탭에서 [MySQL]을 마우스 클릭하여 선택으로하여 왼쪽에 표시되는 [서비스 다

시 시작] 링크를 클릭해 주세요.

그림 3.10 서비스 화면 [상태]란에 [개시]로 표시되고 있다.

60

JRuby on Rails

■■ 리눅스의 경우 ■■

이미 $MYSQL/bin/mysqld_safe로 MySQL을 시작한 상태라면, 그대로 작업을 계속할 수

있습니다. 또는 /etc/init.d로 설정하였다면 재부팅 후에 자동적으로 MySQL이 시작됩니다.

MySQL이 서비스를 실행하고 있는지 알려면 아래 명령어로 확인할 수 있습니다.

ps -ef|grep mysql

만일 MySQL이 시작되고 있지 않다면 다음 명령어를 실행시켜 MySQL을 시작하기 바랍니다.

[sudo] $MYSQL/bin/mysqld_safe

1......프로젝트 작성

명령어 프로젝트로 rails 명령어를 사용하여 프로젝트를 만듭니다. 작성하는 프로젝트명은 yel-

lowpage입니다.

C:\-\rails>rails yellowpage

create

create app/controllers

(생략)

create log/development.log

create log/test.log

M I N I C O L U M N

MySQL이 3306번 포트에 떠 있는지 반드시 확인하세요.

명령 프롬프트에서 netstat 로 Local Address에 *.3306 또는 localhost:3306 과 같

이 나와야 합니다. 혹 떠있지 않다면, 자신의 MySQL 설정에서 skip-networking이 설정

돼 있는지 확인하고 있다면 꺼주세요. 설정 파일 my.cnf에서

와 같이 되어 있다면 다음과 같이 주석 처리 하시기 바랍니다.

[mysqld]

…

skip-networking

…

#skip-networking


61

2......데이터베이스와 사용자 작성［Rake 사용］

yellowpage는 데이터베이스를 이용하는 애플리케이션입니다. 이를 위해 애플리케이션이 이

용하는 데이터베이스와 사용자 그리고 테이블을 작성해야만 합니다. 데이터베이스 등을 작성하

기 위해서 MySQL 관리 툴을 이용하는 방법이 있습니다. 이 방법도 나쁘지는 않지만 현재 루비

와 레일스가 준비되어 있으므로, 여기에서는 프로그램으로 데이터베이스와 사용자를 만드는 방

법을 알아봅시다.

여기서 데이터베이스와 사용자를 작성하는 것은 루비로 만든 빌드 툴인 Rake입니다. 그리고

테이블에 대해서는 이 장의 후반부에서 마이그레이션이라고 하는 별도의 기능을 이용해서 만

듭니다.

데이터베이스 작성 테스크 설계

yellowpage 프로젝트에서는 아래의 5가지 테스크를 작성합니다.

테스크1......데이터베이스를 생성한다.

테스크2......데이터베이스를 삭제한다. 2

테스크3......사용자를 생성하고 데이터베이스를 조작하는 권한을 할당한다.

테스크4......사용자를 삭제한다.

테스크5......RDBMS과 접속한다.

다음으로 이들 테스크간의 의존관계 3 를 생각해 봅니다. 여기서는 모두 5개의 테스크로 작업을

분할했지만 실제에서는 아래 2개의 테스크 그룹으로 크게 나눠서 생각해보면 좋겠습니다.

데이터베이스와 사용자 준비

처음에는 RDBMS와 접속이 필요하므로 테스크５가 먼저입니다. 다음으로 테스크１에서 데이

터베이스를 생성해 두지 않으면, 테스크３으로 사용자에（테스크1로 만든）데이터베이스를 조작하

는 권한을 할당하는 것이 불가능합니다.

2 디렉토리를 제거하면 끝나는 레일스 프로젝트와는 달리, MySQL 관리 하에 있는 데이터베이스를 삭제하려면 관리 툴의 이용과 프로그램 작

성이 필요합니다. 테스크 2는 이를 위해 작성합니다.

3 어떤 테스크을 실행하기 위해서 먼저 별도의 테스크를 실행해야만 하는 경우, 이들 테스크 간의 의존관계가 있다고 말합니다

62

JRuby on Rails

데이터베이스와 사용자 제거

처음에는 RDBMS와 접속이 필요하므로 테스크5가 먼저입니다. 다음으로 테스크4로 사용자를

제거합니다. 이 사용자는 데이터베이스를 참조하고 있으므로 먼저 데이터베이스를 삭제하는 것

은 피하는 편이 좋겠습니다（실제로는 에러가 나진 않겠지만, 문제가 되는 경우도 있으므로 만든

순서와 역순으로 제거하도록 평소에 습관을 들여 놓는 것이 중요합니다）. 그리고 테스크2로 데

이터베이스를 제거합니다.

실제로는 데이터베이스와 사용자의 생성을 다른 테스크로 독립해서 실행할 필요는 없으므로,

다음부터는 이들을 같은 테스크로 포함시킵니다. 또, RDBMS에 접속하는 작업을 테스크로서 독

립시키는 것은 그다지 의미가 없습니다. 반드시 이에 연결된 다른 작업이 있기 때문입니다. 이

보다 좋은 방법은 RDBMS로의 접속은 서브루틴으로 구현하고, 분리해서 각 테스트로부터 불러

내는 것입니다. 다만, 예제 빌드파일에는 의존관계가 있는 테스크를 작성하는 방법을 보여주려

고 독립 테스크로 해두었습니다.

데이터베이스 작성 테스크의 구현

데이터베이스와 사용자의 생성/삭제를 행하는 빌드 파일을 만들어 봅시다. 파일 이름은 db_set-

up.rake로 합니다. 만드는 곳은 yellowpage（프로젝트 루트 디렉토리）/lib/tasks 디렉토리입니다.

[ 리스트 3-01.....db_setup.rake ]

env = ENV['RAILS_ENV'] || 'development'

database = "yellowpage_#{env}"

user = "ypuser_#{env[0..0]}"

require 'rubygems'

gem 'ActiveRecord-JDBC'

gem 'activerecord'

require 'jdbc_adapter'

require 'active_record'

task :db_connect do

ActiveRecord::Base.establish_connection(

:adapter => 'jdbc',

:driver => ‘com.mysql.jdbc.Driver’,

:url => 'jdbc:mysql://localhost/mysql',

:username => 'root',

:password => '??????'◀◀◀0일째에 MySQL에 설정한 root의

패스워드를 ‘?’ 대신 입력합니다

)


63

end

task :db_setup => [ :db_connect ] do

ActiveRecord::Schema.define do

create_database database

execute "create user #{user}@localhost identified by 'ror'"

◀◀◀애플리케이션 고유의 전용 사용자를 패스워드 ror에서 작성한다

execute "grant all privileges on #{database}.* to '#{user}'@'localhost'"

end

end

task :db_clean => [ :db_connect ] do

ActiveRecord::Schema.define do

execute "drop user '#{user}'@'localhost'"

drop_database database

end

end

Rake 실행시에 환경변수를 설정한다.(유닉스 계열에만 해당)

Rake 실행시에 명령어 프로젝트에서 환경변수를 설정할 수 있습니다. 실행시의 형식은 아래

와 같습니다.

rake environment 변수명=값 테스크 이름

이 시작 방식을 이용해서 production 용 데이터베이스를 설정하려면 다음과 같이 실행합니다.

C: /―/yellowpage>rake environment RAILS_ENV=production db_setup

(in C:/―/rails/yellowpage)

-- create_database("yellowpage_production")

->0.1000s

-- execute("create user ypuser_p@localhost identified by 'ror'")

-> 0.0000s

-- execute("grant all privileges on yellowpage_production.* to 'ypuser_p'@'localhost'")

윈도우를 쓰는 경우에는 set RAILS_ENV=production 을 실행한 다음 rake db_setup을 하

면 됩니다.

64

JRuby on Rails

데이터베이스 작성 테스크 실행

그러면 먼저 작성한 db_setup.rake를 실행해 봅시다. Rake에 테스크 이름을 지정해서 실행

합니다. 여기서는 개발용 데이터베이스를 만들므로 environment 지정을 하지 않습니다.

C:\―\yellowpage>rake db_setup


-- create_database("yellowpage_development")

->0.0900s

-- execute("create user ypuser_d@localhost identified by 'ror'")

-> 0.0000s

--execute("grant all privileges on yellowpage_development.* to 'ypuser_d'@'localhost'")

-> 0.0210s

마찬가지로 데이터베이스와 사용자를 삭제하는 경우에는 db_clean 테스크를 지정하여 실행합니다.

rake db_clean

3......테이블 작성［마이그레이션 이용］

마이그레이션이란

레일스 마이그레이션은 데이터베이스에 대한 변경 사항을 관리하기 위한 장치입니다.

릴리즈 1 릴리즈 2 릴리즈 3

프로그램 프로그램’ 프로그램”

테이블 테이블’ 테이블”

변경 변경

Subversion

마이그레이션

그림 3.11 테이블 변경은 마이그레이션으로 관리한다

레일스를 이용한 애플리케이션 개발의 표준적인 방법으로, 소스 파일의 관리에는 Subver-

sion 4 이라는 것을 별도로 마련하여 이용하곤 합니다. 하지만 테이블에 관해서는 구체적으로 버

전별로 변경하는 파일이 없기에 Subversion을 이용해서 관리할 수는 없습니다. 하지만 이것은

실제로 애플리케이션을 이용하는 경우에는 문제가 됩니다. ２가지 예로 생각해 봅시다.

4 프로젝트를 구성하는 파일 버전을 관리하고, 적절한 구성을 돕는 툴. 이 책에서는 Subversion을 이용한 소스 파일 관리에 관한 설명은 생략합니다.


65

예 1

운용환경으로 릴리즈１의 애플리케이션을 시작하고 있습니다. 개발환경에서 릴리즈２를 완

성하였습니다. 이것을 운용환경에 적용하기 위해서는 프로그램의 갱신만이 아닌 데이터베이스

의 변경도 필요합니다.

예 2

운용환경으로 릴리즈３을 시작하는 동시에 개발환경에서 미처 몰랐던 버그가 발견되었습니

다. 이 때문에 급히, 지금까지 동작하고 있던 릴리즈２으로 프로그램을 되돌리도록 하였습니다.

이 때, 테이블도 릴리즈２ 상태로 되돌릴 필요가 있습니다.

마이그레이션은 이처럼 릴리즈 변경시에 데이터베이스에 대한 변경사항을 관리하기 위한 도

구로, 구체적으로는 데이터베이스에 대한 관리를 릴리즈 번호를 붙여 프로그램으로 작성하여 이

것을 Rake의 테스크로 관리합니다.

마이그레이션이 지닌 특별한 의미는 아래와 같이 데이터베이스에 가한 변경이 프로그램 실행

에 영향을 줄 만한 경우 입니다.

▒ 테이블 추가／삭제

▒ 필드 추가／삭제

▒ 필드명 및 테이블명 변경

이용하는 테이블

yellowpage에서 이용하는 테이블 이름은 items로 합니다. items 테이블은 다음과 같은 필

드를 가집니다.

표 3.4 items 테이블에 포함된 필드

필드명 형 비고

id int（11） 레코드 키. 레일스가 자동 생성

name varchar（32） 이름

created_at timestamp 레코드 등록 날짜/시각

category varchar（32） 업종

url varchar（128） 사이트 URL

memo text 메모

66

JRuby on Rails

테이블 각 필드에는 그 내용에 적합한 형태를 지정할 필요가 있습니다. RDBMS로 이용 가능

한 형태에는 표준화를 통해 다른 RDBMS와 공통으로 사용하는 것이 있는 반면, RDBMS 별로

고유한 것도 있습니다.

레일스에는 가능한 한 애플리케이션이 실제로 이용하는 RDBMS를 준비하지 않아도 상관없

도록 여러 형태를 독립적으로 정의하고 있습니다[표 3.5]. 다음 형태를 이용하면 RDBMS 고유의

형명을 이용할 필요가 없게 됩니다. 이들 형태만을 이용하는 것으로 development 환경에서는

MySQL을, production에서는 DB2를 사용한다고 하는 것도 원리적으로 가능합니다.

표 3.5 레일스가 자동으로 데이터베이스용으로 변환하는 형

타입 내용 비고

:primary_key 수치 레코드 키를 나타냄

:string 문자열 :limit로 문자수를 지정（디폴트값은 255）

:text 긴 문자열

:integer 수（11자리） :limit로 자리수를 지정（디폴트값은 11）

:float 부동소수점

:datetime 일시 계측용

:timestamp 시각 계측용

:time 시각 표시용

:date 일 표시용

:binary 바이너리 데이터

:boolean 참, 거짓

마이그레이션 작성

script/generate 명령어로 마이그레이션용 프로그램을 만듭니다. 이 때, 지정한 파일명은 테

스크의 내용을 이해할 수 있는 동사와 명사를 「_ 」로 연결한 이름입니다. 명령어 사용법은 다음

과 같습니다.

jruby script/generate migration 파일명

여기서는 파일명으로 create_table를 지정한 실행예를 나타냅니다.

C:\―\yellowpage>jruby script/generate migration create_table

create db/migrate

create db/migrate/001_create_table.rb

작성된 마이그레이션용 프로그램 파일은, 파일 앞에 버전 번호가 붙여진 후 db/migrate 디렉토

리 아래에 저장됩니다.


67

[ 리스트 3-02.....001_create_table.rb［생성직후］ ]

class CreateTable < ActiveRecord::Migration

def self.up

end

def self.down

end

end

생성된 프로그램에는 self.up과 self.down ２가지 메소드가 정의돼 있습니다. 여기서 up은

해당 릴리즈 변경을 적용할 때 호출됩니다. down은 해당 릴리즈에서의 변경을 취소할 경우에

호출됩니다. 위와 같이, 프로그램의 내용까지는 생성되지 않았으므로 up/down 모두 스스로 적

절한 내용을 짜야 합니다.

테이블 작성 프로그램 구현

그러면 생성된 001_create_table.rb에 실제 테이블 작성과 삭제처리를 알아봅시다.

[ 리스트 3-03.....001_create_table.rb（수정후） ]

class CreateTable < ActiveRecord::Migration

def self.up

create_table(:items) do |table| ......A table.column :name , :string, :limit => 32 ......B table.column :category, :string, :limit => 32

table.column :url, :string, :limit => 128

table.column :created_at, :timestamp

table.column :memo, :text

end

end

def self.down

drop_table :items ......C end

end

테이블을 생성하기 위해, create_table 메소드를 호출합니다［A］. 테이블 오브젝트 column 메

소드에 필드를 정의합니다［B］. 테이블을 삭제하기 위해 drop_table 메소드에 테이블명을 부여

합니다［C］. id 필드는 레일스가 자동으로 테이블에 부가함으로, 기술할 필요는 없습니다. 그렇

지만 이 프로그램을 보면 먼저 작성한 db_setup.rake와 비교할 때 미묘한 차이를 느낄 수 있습

68

JRuby on Rails

니다. db_setup.rake에서는 ActiveRecord::Base::establish_connection 메소드를 호출해서

RDBMS와 접속을 실행합니다. 하지만 001_create_table.rb에는 그러한 기술은 없습니다.

이는 마이그레이션과 웹 애플리케이션의 실행시에 레일스에 의해 자동으로 RDBMS과 접속되

기 때문입니다. 이 때 참조된 파라미터가 config/database.yml입니다. 따라서 마이그레이션을

실행하기 전에 config/database.yml 을 설정해야 합니다

database.yml 설정

config/database.yml는 YAML이라고 하는 루비 등에서 사용하는 파라미터 파일로서, 간단

하지만（XML도 그렇습니다）사람이 읽고 쓰기 쉬운 (유감스럽지만 XML은 다릅니다）데이터 기

술 방법에 따른 파일 입니다.

따라서 database.yml에 설정하는데, YAML에 대해 알 필요는 없습니다. 다만, YAML에는

들여쓰기(indent)가 중요하다는 규칙이 있기에, 기술할 때 원래 파일의 들여쓰기를 절대로 바꾸

지 않도록 해 주세요. 아래는 레일스가 방금 생성한 database.yml입니다.

M I N I C O L U M N

레일스에서의 테이블과 파일 이름 결정

레일스 철학 「설정보다 규칙을 우선 하는 것」을 생각해봅시다. 레일스에서 테이블을 가능한

자동으로 처리를 하도록 하는 것은 이 철학과 관련되어 있습니다. 구체적으로 레일스에는 아래

와 같은 규칙이 있습니다.

▒ 테이블명은 명사의 복수형（여기서는 items）

그에 따라, 레코드 오브젝트（모델）는 같은 명사의 단수형으로 한다（실행시에는 클래스명을 복

수형으로 바꿔 테이블을 참조한다）.

▒ (프라이머리) 키의 필드 이름은 id

그에 따라 자동적으로 키 필드의 생성과 참조가 이루어진다.

▒ 자동설정시키고 싶은 작성시각 필드 이름은 created_at （날짜라면 created_on）

▒ 자동설정시키고 싶은 변경시각 필드 이름은 updated_at （날짜라면 updated_on）


69

[ 리스트 3-04....config/database.yml（생성직후） ]

# MySQL (default setup). Versions 4.1 and 5.0 are recommended.

（생략）

# http://dev.mysql.com/doc/refman/5.0/en/old-client.html

development:

adapter: mysql

database: yellowpage_development

username: root

password:

host: localhost

（생략）

앞에 붙은 #에서 시작하는 행은 전부 주석입니다. 루비나 셸프로그램과 같이 YAML에서도

#에서 시작되는 행은 주석입니다. 이 외의 문자에서 시작되는 행은 섹션을 나타냅니다. 여기서

는 development: 에서 시작하는 섹션이 정의되어 있습니다.

이 database.yml에 대해서 development 섹션을 다음과 같이 수정합니다.

[ 리스트 3-05....config/database.yml（수정후） ]

development:

adapter: jdbc ◀◀◀ 수정

#database: yellowpage_development ◀◀◀ 주석처리

username: ypuser_d ◀◀◀ 수정

password: ◀◀◀db_setup.rake에서 설정한 패스워드 ror을 설정.

#host: localhost ◀◀◀ 주석처리

driver: com.mysql.jdbc.Driver ◀◀◀ 추가

url: jdbc:mysql://localhost/yellowpage_development ◀◀◀ 추가

그리고 config/environment.rb에 JDBC를 쓸 수 있도록 설정합니다.

[ 리스트 3-06....config/environment.rb（수정후） ]

…

require File.join(File.dirname(__FILE__), ‘boot’)

if RUBY_PLATFORM =~ /java/ ◀◀◀ 추가

require 'rubygems' ◀◀◀ 추가

RAILS_CONNECTION_ADAPTERS = %w(jdbc) ◀◀◀ 추가

end ◀◀◀ 추가

Rails::Initializer.run do |config|

…

이렇게 해서 마이그레이션을 실행할 준비가 되었습니다. 명령어 프롬프트에서 아래와 같이 입

력해서 마이그레이션을 실행하세요.

70

JRuby on Rails

마이그레이션 실행

이렇게 해서 마이그레이션을 실행할 준비가 되었습니다. 명령어 프롬프트에서, 아래와 같이

입력해서 마이그레이션을 실행하세요.

rake db:migrate

아래와 같이 명령 프롬프트에 표시되면 성공입니다. 0.1500s라는 표시는 처리하는데 걸리는

시간이므로 환경에 따라 다릅니다.

C:\―\yellowpage>rake db:migrate


== CreateTable: migrating ==========================================

-- create_table(:items)

->0.1500s

== CreateTable: migrated (0.1500s) =================================

실패할 가능성으로 config/database.yml의 설정이 틀릴 경우가 있습니다. 다음 입력은 사용

자 ID를 ypuser_ds로 입력해서 틀린 경우의 출력입니다.

C:\―\yellowpage>rake db:migrate


rake aborted!

#28000Access denied for user 'ypuser_ds'@'localhost' (using password: YES)

(See full trace by running task with --trace)

M I N I C O L U M N

마이그레이션 버전 번호

script/generate가 생성한 마이그레이션의 앞에는 마이그레이션이 이용하는 001부터 버

전 번호가 붙여집니다. 이 번호는 Rake 명령어의 VERSION으로 지정할 수도 있습니다.

rake migrate VERSION=0

VERSION에 지정한 0은 최초 상태로 되돌리는 인수입니다. 현재 버전 번호부터 시작해서

앞이 001인 프로그램까지 내림차순으로, 각 프로그램의 down 매소드를 호출합니다. VER-

SION인수를 지정하지 않을 경우에는 버전 번호가 빠른 순으로 프로그램의 up 메소드가 실행

됩니다. 또한, (위의 예에서 0인 경우 001_xxx까지 호출되는 것처럼) VERSION에서 지정

하는 번호는 최종적으로 호출되는 파일의 번호보다 1 작다는 것에 주의하기 바랍니다.


71

또, database.yml 설정이 맞다고 해도 db_setup.rake 기술내용이 틀리거나 실행에 실패해

도 똑같이 denied for user（해당 사용자 접속 거부）에러로 표시 됩니다. 에러가 난 경우에는 설

정 내용이나 편집 내용에 틀린 것이 없는지 확인해 보세요.

4......애플리케이션 작성

items 테이블에 데이터를 입력하는 애플리케이션을 만들어 봅시다. 레일스에는 데이터베이

스를 이용하는 애플리케이션의 기틀(scaffold)을 만드는 기능이 있어, 이것을 스케폴드(scaf-

fold)라고 부릅니다.

스케폴드(scaffold)는 인수에서 지정한 이름에 대응하는 테이블 구조를 RDBMS로부터 읽어

들여 아래의 처리를 하는 애플리케이션을 만듭니다.

▒ 레코드 생성

▒ 레코드 표시

▒ 레코드 목록

▒ 레코드 삭제

▒ 레코드 수정

실제 애플리케이션에서는 좀더 작업을 할 필요가 있습니다만（특히, 한국 사용자를 대상으로

한다면 한글화）, 최초 개발 시점에서 테이블에 레코드를 추가/삭제할 수 있는 기능이 들어있어

서 실제로 동작을 확인하면서 개발하기에는 효율적입니다.

스케폴드를 이용해서 애플리케이션을 만드는데 있어서는 명령어 라인에 아래와 같이 입력합니다.

jruby script/generate scaffold item ［controller］

scaffold......scaffold 생성을 지정

item......모델명（테이블명의 단수형）을 지정

controller......컨트롤러명（생략한 경우는 모델명과 같이 됨）

그러면 실행해 봅시다.

72

JRuby on Rails

C:\―\yellowpage>jruby script/generate scaffold item

exists app/controllers/

exists app/helpers/

create app/views/items

（생략）

create app/views/layouts/items.rhtml

create public/stylesheets/scaffold.css

스케폴드 실행으로 아래 파일이 만들어집니다. 5

컨트롤러

app/controllers/items_controller.rb......item 모델을 조작하는 액션을 구축

모델

app/models/item.rb......items 테이블을 조작

뷰

app/views/items/list.rhtml......items 테이블의 레코드를 리스트 표시

app/views/items/new.rhtml......items 테이블에 신규 레코드를 추가

app/views/items/show.rhtml......items 테이블의 레코드 하나를 표시

app/views/items/_form.rhtm......items 테이블의 레코드 하나를 편집용으로 표시

app/views/layoutsitems/.rhtm......items_controller용 레이아웃 파일

스케폴드 생성을 완료하면, 어느 정도의 애플리케이션이 스케폴드에 의해 만들어졌는지 브라

우저을 사용해 확인해 봅시다.

먼저 WEBrick을 시작합니다. yellowpage 프로젝트 루트 디렉토리로 이동하여 다음과 같이

실행합니다.

5 이들 외에 파일 등도 생성 대상입니다.


73

다음으로 브라우저에서

http://localhost:3000/

items에 접속합니다. 옆과 같

은 화면이 나올 것입니다.

이상이 없음을 확인했다면

「New Item」을 클릭해서 레코드를 추가해 봅시다. 「Create」 버튼을 클릭하고 추가하는데 성공했

으면 리스트 표시 화면으로 돌아가 추가한 레코드가 표시됩니다. 여러가지 조작을 해보고 에러

가 나지 않는지 시험해 보세요.

그림 3.13 레코드 추가 화면 ［화상을 얻기 위해 메모란의 크기를 변경하였습니다.］

그림 3.12 레코드가 빈 상태의 리스트 표시

C:\―\yellowpage>jruby script/server

=>Booting WEBrick...

=>Rails application started on http://0.0.0.0:3000

=>Ctrl-C to shutdown server; call with --help for options

[2006-04-04 00:44:19] INFO WEBrick 1.3.1

[2006-04-04 00:44:19] INFO ruby 1.8.x (…) [java]

（생략）

74

JRuby on Rails

코드 설명

여기서는 2일째에서 소개한 소스파일의 내용에 대해 좀더 상세하게 설명합니다.

[ 리스트 3-01.....db_setup.rake ]

env = ENV['RAILS_ENV'] || 'development' ......Adatabase = "yellowpage_#{env}" ......Buser = "ypuser_#{env[0..0]}" ......C

require 'rubygems'

gem 'ActiveRecord-JDBC'

gem 'activerecord'

require 'jdbc_adapter'

require 'active_record'

task :db_connect do ......D ActiveRecord::Base.establish_connection( ······ ......E :adapter => 'mysql',

:host => 'localhost',

:username => 'root',

:password => '??????',

:database => 'mysql'

)

end ......F

task :db_setup => [ :db_connect ] do ......G ActiveRecord::Schema.define do ......H create_database database ......I execute "create user #{user}@localhost identified by 'ror'" ......J execute "grant all privileges on #{database}.* to '#{user}'@'localhost'"

end

end

task :db_clean => [ :db_connect ] do ......K ActiveRecord::Schema.define do

execute "drop user '#{user}'@'localhost'" ......L drop_database database ......M end

end


75

A......현재 실행 환경명을 환경 변수로부터 얻어서 변수 env에 설정합니다. 이 때, 만일 환경변

수가 설정돼 있지 않은 상태라면 development를 설정합니다.

env = ENV 'RAILS_ENV' 'development'논리합

환경변수 RAILS_ENV 내용

||를 사용하고 있기 때문에 ENV['RAILS_ENV']이 nil 이외의 경우는 그 설정값이 env에 설정

됩니다. 만일 ENV['RAILS_ENV']이 nil（환경변수가 미설정）이라면, 오른쪽의 'development' 가 들

어갑니다. 'development'는 내용이 있는 문자열로 nil이 아니므로, env에는 'development'가 설정

됩니다.

B......database라는 변수에 데이터베이스명을 설정합니다.

C......user라는 변수에 사용자 ID를 설정합니다. 사용자 ID는 특별한 규정은 없습니다만 여기

서는 공통부분（ypuser）에 환경 이름（development）의 맨앞 1문자를 추가한 것을 사용합니다. 이

것은 레일스에 첨부된 MySQL용과의 인터페이스 모듈이 사용자 ID로써 16문자만 읽을 수 있기

때문입니다.

"ypuser_#{env[0..0]}"에서는 이미 나온 "#{ }"을 이용해서 사용자 ID 문자열을 만들고 있습니다.

#{ }에서 괄호 안의 부분은 코드로 처리되며 여기서는 ypuser_라는 문자열에 env[0..0]의 내용을

추가한다는 의미가 됩니다.

x[s..e]라는 표현은 문자열 x의 s번째 문자로부터 e번째의 문자까지（포함하여）를 뽑아낸다는

의미입니다. 따라서 env에 "development"라는 문자열이 설정되는 경우, ０번째의 문자 d에서 ０

번째 문자 d까지의 부분 문자열, 즉 맨앞의 "d"가 나오게 됩니다.

그러므로 "ypuser_#{'d'}"라고 쓴 경우도 똑같이 되기 때문에 최종적으로 "ypuser_d"라는 문자열

을 얻게 됩니다.

D......의존성을 지니지 않은 테스크의 정의는

task 심볼 do

로 시작합니다. 여기서 지정한 심볼은 테스크명으로서 rake 실행시에 명령어라인에서 지정할 수

있도록 되어 있습니다. do는 루비에서 일련의 처리（블록）을 표시하는 키워드에 해당하는 end 사

이에 놓인 행을 순서대로 실행합니다. 여기서 해당하는 end는 ［F］입니다.

76

JRuby on Rails

E......ActiveRecord::Base.establish_connection는 RDBMS와 접속하기 위한 메소드입니다. 인수

는 아래와 같습니다.

표 2.6 ActiveRecord::Base.establish_connection 인수

인수 설명

:adapter RDBMS와의 접속에 이용하는 프로그램을 지정합니다. JDBC의 경우, 'jdbc' 입니다.

:driver JDBC 연결에 사용할 드라이버입니다.

:username 접속에 이용하는 사용자 ID입니다. 여기서는 데이터베이스를 작성하거나 사용자를 작성하거나

하므로 root를 지정합니다.

:password 0일째에 MySQL을 설치할 때 설정한 root의 암호를 설정합니다.

:url 접속하는 데이터베이스의 URL를 JDBC 문법에 맞게 씁니다. 여기서 지정하고 있는 mysql 데이

터베이스는 MySQL의 관리정보를 저장하는 특별한 테이터베이스입니다.

이들 파라미터는 config/database.yml에 설정하고 있는 정보와 같은 항목입니다（설정내용

은 다릅니다）.

F......end는 블록을 종료하기 위한 키워드 입니다. 여기서는 ［D］의 do에 해당합니다.

G......db_setup 테스크의 정의입니다. 이 테스크는 ［D］의 db_connect 테스크와 다른 의존관계

를 갖고 있습니다. 구체적으로는 이 테스크의 실행전에 db_connect 테스크가 실행되야 합니다.

의존관계를 지닌 테스크의 경우 아래와 같이 시술합니다.

task 심볼 =>［의존하는 테스크의 리스트］do

의존하는 테스크의 리스트는 의존하는（이 테스크의 실행전에 종료시킬 필요가 있다）테스크에

해당하는 심볼을 쉼표로 구분하여 나열한 것입니다. 여기서는 db_connect 테스크를 처음에 실

행할 필요가 있다는 것을 나타내고 있습니다.

H......ActiveRecord::Schema.define do 블록 안에는 RDBMS에 대한 관계형 데이터베이스 스키

마 정보（데이터 타입 등）를 정의하는 명령어 등을 기술하고 있습니다. 또, 레일스（ActiveRecord）

가 미리 준비한 메소드도 실행할 수 있습니다.

I......아래 서식에서 지정한 데이터베이스 이름을 지닌 데이터베이스를 작성합니다. 이 메소드는

ActiveRecord::Schema에 정의돼 있습니다.

create_database 데이터베이스명

J......execute 메소드는 인수로 지정한 문자열을 SQL문으로서 실행합니다. 여기서는 create

user문과 grant문을 사용하여 사용자 작성과 사용자에 ［I］로 작성한 데이터베이스 전체에 대한


77

접근 권한 부여를 실행합니다. 여기서는 애플리케이션 고유의 데이터베이스 사용자 암호로 ror을

설정하고 있습니다.

K......데이터베이스 삭제용 테스크 정의입니다. ［G］와 똑같이 db_connect 테스크에 대해 의존

성이 있습니다.

L......drop문을 호출해서 ［J］로 작성한 사용자를 삭제합니다.

M......아래 서식에서 지정한 데이터베이스 이름을 지닌 데이터베이스를 삭제합니다. 이 메소드

는 ActiveRecord::Schema에 정의돼 있습니다.

drop_database 데이터베이스 이름

78

JRuby on Rails

좀더 알고 싶어요! Q&A

Q. 프로젝트나 데이터베이스를 제거할 때는 어떻게 하면 되나요?

레일스 프로젝트를 제거할 때는 해당 프로젝트 디렉토리를 제거하면 됩니다. yellowpage 프

로젝트라면 yellowpage 디렉토리 자체를 제거합니다. 데이터베이스를 제거할 때는 데이터베이

스 관리 툴을 사용하든가 이 장에서 소개한 것처럼 스스로 제거 테스크를 짤 필요가 있습니다.

Q. Windows 환경에서 WEBrick을 띄웠을 때, 경고 창이 표시되었습니다.

그림 3.14 프로그램이 차단되어 있음을 경고하는 창

Windows XP에서 방화벽을 작동하고 있는 상태에서 WEBrick을 시작하면 그림과 같은 경

고화면이 표시됩니다. 이 메시지는 WEBrick（다이얼로그 박스에는 Ruby interpreter로 표시

되고 있습니다）가 Web 서버로서 외부 컴퓨터로부터 접속을 받도록 되어 있기 때문에 표시됩

니다. 이 경우에는 「블록을 해제함」을 클릭해서 실행을 계속하면 됩니다. 여기서 해제한 정보

는 제어판의 ‘보안센타’▷‘Windows 방화벽’ 에 있는 ‘예외’ 메뉴 탭에서 Ruby interpreter를 제거

하면 초기상태로 돌아갑니다.

Q. db_setup.rake의 실행에 실패해서 파일을 수정하였지만 역시 에러가 납니다.

파일 입력 실수 등으로 도중에 에러가 난 경우에는 그 때까지 실행해서 작성한 정보에 의해

나머지 실행이 실패할 경우가 있습니다.

웹에 올린 예제에는 에러를 무시하여 처리를 중단없이 이어가도록 하는 예외 처리가 포함

되어 있습니다. 에러가 나서 복구가 안되는 경우, 예제의 db_clean 테스크를 참고하여 be-

gin…rescue…end를 자신의 db_clean 테스크에 포함시키고, rake db_clean을 실행하여 데

이터베이스를 초기상태로 되돌린 다음 실패한 실행을 시도해 보세요.


79

Q. 레일스는 어떻게 영어의 단수형에서 복수형을 조사해서 테이블명으로 하나요?

레일스에는 단수형과 복수형의 변환, Camel 화（abc_def를 AbcDef의 형식으로 하는 것）등,

레일스가 이용하는 단수변환을 실행하는 Inflector라고 하는 유틸리티가 포함돼 있습니다. 레

일스는 필요할 때 Inflector를 호출하여 단수 변환을 실행합니다. 실제 변환 규칙은 inflec-

tions.rb라는 별도의 스크립트에서 정의하고 있습니다.

Q. person의 복수형은 persons입니까?

레일스에서는 다릅니다. person의 복수형이 무엇인지는 5일째의 Q&A를 참조하세요.

M I N I C O L U M N

프로그래밍을 위한 메모

1. 루비 진위값

루비에는 true（참）과 false（거짓）라고 하는 진위값을 표시하는 키워드 있습니다. 또 이와

별도로 오브젝트가 빈 상태를 나타내는 nil이라고 하는 특수한 값이 있습니다. 루비에서는

false만이 아닌 nil도 거짓을 표시합니다. 반대로 나머지는 전부 참으로 표시합니다. C/

C++에서 거짓으로 인식되는 0도 루비에서는 참입니다.

2. ENV［환경변수명］

ENV[ ] 안에는 환경변수를 표시하는 문자열을 설정하는 것으로 설정돼 있는 환경변수 내용

을 얻을 수가 있습니다. 만일 미설정 돼 있다면 nil（아무것도 없는 것을 표시하는 특별 정수）

로 됩니다.

3. 문자예［개시번호..종료번호］

문자예의 개시번호부터 종료번호（포함）까지를 뺀 문자열을 반환합니다.

4. ||

논리합을 실행하는 연산자입니다. 루비에서는 nil과 false이외는 모두 참으로 봅니다. 이 때

문에 ||의 결과는 false가 최초에 평가한 값입니다. 이를 이용해 오브젝트가 비어 있다면 그

외의 값을 설정하라고 하는 처리를 1행에서 기술합니다.

a = x || y # ◀◀◀ x를 a에 설정. 다만 x가 nil이라면 y를 a에 설정

a ||= x # ◀◀◀ a가 nil라면 x를 a에 설정

80

JRuby on Rails


이 장에서는 레일스에서 데이터베이스를 사용하기 위한 기초를 공부했습니다.

관계형데이터베이스

관계형데이터베이스란 테이블을 릴레이션십(관계)으로 묶은 것으로, 데이터의 관련을 표시하

는 데이터베이스 시스템입니다.

데이터베이스

데이터베이스는 관련된 테이블이나 릴레이션십의 집합입니다.

Rake

루비에서 테스크의 실행관리에 이용하는 툴입니다.

테스크 위치

레일스 애플리케이션에서 독립적으로 정의한 테스크（빌드파일）는 lib/tasks 디렉토리에 저장

됩니다.

마이그레이션

레일스에서 테이블 작성, 필드 추가 같은 데이터베이스 변경을 관리하기 위한 장치입니다.

스케폴드

지정한 모델에 필요한 데이터를 RDBMS로부터 끄집어내서 애플리케이션의 기초를 제공하

는 기능입니다.