Tag Archives: Ruby

[Ruby] Rails 라우팅

1. 레일즈 라우터의 목적

레일즈 라우터는 외부로부터 들어오는 URL을 인식하고 컨트롤러의 액션으로 보내주는 역할을 합니다. 이를 이용하여 개발중인 뷰에서 하드코딩할 필요 없이 패스와 URL을 생성하는것 역시 가능합니다.

1.1 URL을 코드로 연결하기

당신의 레일즈 어플리케이션이 외부로부터 다음과 같은 요청을 받을 수 있습니다.

GET /patients/17

레일즈는 라우터에게 매칭되는 컨트롤러 액션이 있는지 물어보게 됩니다. 첫번째로 매칭된 라우트 정의는 다음과 같습니다.

get '/patients/:id', to: 'patients#show'

이 요청은 patients 컨트롤러의 show 액션에 { id: ’17’ } 이라는 파라미터와 함께 전달됩니다.

1.2 코드에서 패스와 URL을 생성하기

마찬가지로 패스들과 URL들을 생성하는것도 가능합니다. 위의 라우트 정의를 다음과 같이 바꾸었다고 가정하겠습니다.

get '/patients/:id', to: 'patients#show', as: 'patient'

그리고 당신의 어플리케이션은 컨트롤러의 코드에 다음을 포함합니다.

@patient = Patient.find(17)

그리고 다음의 코드가 컨트롤러에 대응되는 뷰에 존재합니다.

<%= link_to 'Patient Record', patient_path(@patient) %>

위의 과정을 통해 라우터는 /patients/17 이라는 패스를 생성합니다. 이는 당신의 코드의 복잡성을 줄여주고 이해하기 쉽게 만들어줍니다. 라우트 헬퍼를 이용할 때 id가 특정될 필요가 없습니다.

2. 리소스 라우팅 : 레일즈 기본

리소스 라우팅은 index, show, new, edit, create, update, destroy 액션들을 일일이 정의하는것 대신 일반적으로 사용되는 라우트 설정들을 매우 빠르게 정의하는것을 가능케 합니다. 리소스 라우팅은 이러한 정의를 단지 한줄의 코드로 가능하게 해줍니다.

2.1 웹상의 리소스들

브라우저들은 레일즈에 GET, POST, PATCH, PUT, DELETE와 같은 특정 HTTP 메소드를 사용한URL 요청을 통해 페이지를 요청합니다. 각각의 메소드들은 리소스들의 특정 기능을 실행하기 위한 요청이 됩니다. 리소스 라우트는 다양한 요청을 하나의 컨트롤러에 정의된 액션들에 매핑을 해줍니다.

당신의 레일즈 어플리케이션에서 다음과 같은 요청을 받았다고 가정하겠습니다.

DELETE /photos/17

이는 라우터에 질의후 컨트롤러의 액션들에 매핑해주게 됩니다. 첫번째로 매칭된 라우트 정의가 다음과 같을 경우

resources :photos

레일즈는 photos 컨트롤러의 destroy 메소드에 { id: ’17’ } 파라미터와 함께 요청을 전달해 주게 됩니다.

2.2 CRUD (Create, Read, Update, Delete), HTTP메소드, 액션

레일즈에서 리소스 라우트는 HTTP 메소드와 URL을 통해 컨트롤러의 액션에 매핑해 주는 기능을 제공해 줍니다. 컨벤션에의해 각각의 액션은 특정 데이터베이스 CRUD 작업에 매핑됩니다. 라우팅 파일에 다음의 한줄의 설정만으로 구현 가능합니다.

resources :photos

당신의 어플리케이션의 Photos 컨트롤러에 다음과 같은 7개의 다른 라우트 설정이 생성됩니다.

HTTP Method Path Action Used for
GET /photos index 모든 사진을 보여줍니다.
GET /photos/new new 새로운 사진을 등록하기 위한 HTML 폼을 보여줍니다.
POST /photos create 새로운 사진을 생성합니다.
GET /photos/:id show 특정 한개의 사진을 보여줍니다.
GET /photos/:id/edit edit 사진 정보를 수정하기 위한 HTML 폼을 보여줍니다.
PATCH/PUT /photos/:id update 사진 정보를 수정합니다.
DELETE /photos/:id destroy 특정 사진을 삭제합니다.

레일즈 라우트는 정의된 순서에 따라 매치를 하게 됩니다. get ‘photos/poll’ 액션 라우트 설정 위에 :photos 리소스가 정의 되어있을 경우 :photo 리소스에 먼저 매치가 되는 문제가 발생하게 됩니다. 이를 해결하기 위해서는 get 설정을 리소스 정의보다 위에 정의하여 먼저 매치되도록 하여야 합니다.

2.3 패스, URL 헬퍼

리소스 라우트를 생성하면 당신의 어플리케이션의 컨트롤러에 몇개의 헬퍼를 사용가능하게 됩니다. resource :photos 정의가 되어있다고 가정하겠습니다.

  • photos_path 는 /photos 를 반환합니다.
  • new_photo_path 는 /photos/new 를 반환합니다.
  • edit_photo_path(:id) 는 /photos/:id/edit 를 반환합니다. (edit_photo_path(10) 의 경우 /photos/10/edit 를 반환)
  • photo_path(:id) 는 /photos/:id 를 반환 (photo_path(10) 는 /photos/10 을 반환)

이러한 헬퍼들에 대응되는 _url 헬퍼들도 존재합니다. (예: photos_url) URL 헬퍼의 경우 패스 헬퍼와 조금 다르게 현재 호스트, 포트와 패스의 prefix를 포함한 값을 반환합니다.

2.4 다수의 리소스를 한번에 정의하기

한개 이상의 리소스를 생성할 필요가 있을 경우 한번의 resource: 호출로 해결할 수 있습니다.

resources :photos, :books, :videos

위의 정의는 정확하게 다음과 동일한 작업을 수행합니다.

resources :photos
resources :books
resources :videos

2.5 단일 리소스

때때로 클라이언트가 참조할 ID 없이도 접근 가능한 리소스가 필요할 수 있습니다. 예를 들면 /profile 에 접속하면 항상 현재 접속한 유저의 프로필을 보여줄 필요가 있을 경우가 있습니다. 이런 경우 단일 리소스 정의를 사용하여 /profile/:id 대신에 /profile 에 show 액션을 호출하도록 할 수 있습니다.

get 'profile', to: 'users#show'

문자열을 통한 매칭의 경우 Controller#Action 의 형태를 띄지만 심볼을 이용하여 정의하면 액션에 직접적으로 넘겨주게 됩니다.

resource :users do
  get 'profile', to: :show
end

# 또는 다음의 방법도 가능
get 'profile', to: :show, controller: 'users'

다음은 단일 리소스 설정 방법입니다. (단수로 지정하면 됨)

resource :geocoder

당신의 어플리케이션의 Geocoders 컨트롤러(복수형임)에 다음과 같은 6개의 라우팅 설정이 생성됩니다.

HTTP METHOD Path Action Used for
GET /geocoder/new new Geocoder를 생성하기 위한 HTML 폼을 반환합니다.
POST /geocoder create Geocoder를 생성합니다.
GET /geocoder show 하나뿐인 Geocoder 정보를 반환합니다.
GET /geocoder/edit edit Geocoder 값을 수정하는 HTML 폼을 반환합니다.
PATCH/PUT /geocoder update 하나뿐인 Geocoder 값을 수정합니다.
DELETE /geocoder destroy Geocoder 정보를 수정합니다.

단일 리소스 라우트는 다음과 같은 헬퍼들을 만들어 줍니다.

  • new_geocoder_path 는 /geocoder/new 를 반환합니다.
  • edit_geocoder_path 는 /geocoder/edit 를 반환합니다.
  • geocoder_path 는 /geocoder 를 반환합니다.

복수 리소스처럼 호스트, 포트, 패스정보가 포함되는 _url로 끝나는 헬퍼 역시 제공됩니다.

2.6 컨트롤러 네임스페이스와 라우팅

당신은 네임스페이스 이하에 컨트롤러들을 그룹으로 묶어 제공하고 싶을 수 있습니다. 대부분의 경우 관리 기능의 컨트롤러들을 Admin:: 네임스페이스 하에 둘 수 있습니다. 당신은 이런 컨트롤러들을 app/controllers/admin 이하에 둘 수 있고 라우터 설정에서 그룹으로 묶어서 정의할 수 있습니다.

namespace :admin do
  resources :posts, :comments
end

이 정의는 PostsController와 CommentsController에 대해 필요한 라우트를 생성합니다. Admin::PostsController의 경우 레일즈는 다음을 생성합니다.

HTTP METHOD Path Action Used for
GET /admin/posts index admin_posts_path
GET /admin/posts/new new new_admin_post_path
POST /admin/posts create admin_posts_path
GET /admin/posts/:id show admin_post_path(:id)
GET /admin/posts/:id/edit edit edit_admin_post_path(:id)
PATCH/PUT /admin/posts/:id update admin_post_path(:id)
DELETE /admin/posts/:id destroy admin_post_path(:id)

만약 앞에 붙은 /admin 없이 /posts를 Admin::PostsController로 라우팅하고 싶다면 다음과 같이 할 수 있습니다.

scope module: 'admin' do
  resources :posts, :comments
end

또는 다음의 한줄로도 가능합니다.

resources :posts, module: 'admin'

/admin/posts를 Admin:: 모듈 프리픽스 없이 PostsController에 라우팅하고 싶다면 다음의 방법을 사용할 수 있습니다.

scope '/admin' do
  resources :posts, :comments
end

또는 다음의 한줄 선언으로도 가능합니다.

resources :posts, path: '/admin/posts'

위에서 설명한 각각의 방법들 모두 scope를 사용하지 않고도 같은 효과를 내게 됩니다. 마지막 방법의 경우 PostsController에 매핑됩니다.

2.7 중첩 리소스

이 방법은 다른 리소스에 논리적인 자식으로 리소스를 가지는 방법을 말합니다. 예를 들어 당신의 어플리케이션이 다음의 모델들을 가지고 있다고 가정하겠습니다. (하나의 잡지에 다수의 광고가 붙을 수 있는 상황을 가정)

class Magazine < ActiveRecord::Base
  has_many :ads
end

class Ad < ActiveRecord::Base
  belongs_to :magazine
end

중첩 라우트는 이러한 관계들을 알 수 있게 해줍니다. 이런 경우 라우트 선언은 다음과 같습니다.

resources :magazines do
  resources :ads
end

매거진에 라우트를 추가하는 방법으로 이 선언은 ads로의 요청을 AdsController로 라우팅합니다. magazine에 종속된 ad URL들은 다음과 같습니다.

HTTP METHOD Path Action Used for
GET /magazines/:magazine_id/ads index 특정 매거진에 종속된 모든 광고를 보여줍니다.
GET /magazines/:magazine_id/ads/new new 특정 매거진에 종속된 새로운 광고를 추가하는 HTML 폼을 보여줍니다.
POST /magazines/:magazine_id/ads create 특정 매거진에 종속된 새로운 광고를 추가합니다.
GET /magazines/:magazine_id/ads/:id show 특정 매거진에 종속된 특정 광고를 보여줍니다.
GET /magazines/:magazine_id/ads/:id/edit edit 특정 매거진에 종속된 특정 광고의 정보를 수정하는 HTML 폼을 반환합니다.
PATCH/PUT /magazines/:magazine_id/ads/:id update 특정 매거진에 종속된 특정 광고의 정보를 수정합니다.
DELETE /magazines/:magazine_id/ads/:id destroy 특정 매거진에 종속된 특정 광고를 삭제합니다.

이것들은 magazine_ads_url 또는 edit_magazine_ad_path 와 같은 라우트 헬퍼를 생성합니다. 이러한 헬퍼들은 매거진 인스턴스를 첫번째 인자로 받습니다. (magazine_ads_url(@magazine))

2.7.1 중첩 제한

당신은 중첩 리소스를 다른 중첩된 리소스와 함께 사용할 수 있습니다. 예를 들면 다음과 같습니다.

resources :publishers do
  resources :magazines do
    resources :photos
  end
end

깊은 중첩 리소스의 경우 주소가 길어지고 복잡해 질 수 있습니다. 예를 들면 어플리케이션은 다음과 같은 패스가 생길 수 있습니다.

/publishers/1/magazines/2/photos/3

여기에 대응되는 라우트 헬퍼는 publisher_magazine_photo_url 이 됩니다. 3단계 레벨에 따른 특정한 객체도 필요로 됩니다. 실제로 이러한 상황은 충분히 혼란 스러운 상황입니다. 그러므로 중첩 리소스 선언은 1단계 레벨을 넘는 설정을 하지 않는것을 권장합니다. (영어로 never로 표현)

2.7.2 얕은 중첩

위에서 권장한 깊은 중첩을 피하기 위한 한가지 방법으로 배열을 선언하여 스코프를 특정짓는 방법이 있습니다. 다음과 같이 리소스를 식별하는데 필요한 최소한의 정보만으로 라우팅이 가능하도록 설정하는 방법입니다.

resources :posts do
  resources :comments, only: [:index, :new, :create]
end
resources :comments, only: [:show, :edit, :update, :destroy]

위의 설정을 잘 보면 알 수 있습니다만 특정 코멘트의 show, edit, update, destroy는 posts이하에 있을 필요가 없습니다. comments만의 고유 식별자로 처리가 가능한 부분입니다. 하지만 index, new, create의 경우 posts에 종속적인 데이터로 관리되어야 하는 부분이기에 posts에 종속됩니다.

이러한 방법은 설명이 가능한 라우트와 깊은 라우트간에 균형을 유지하는 느낌을 줍니다. 위의 정의를 손쉽게 할 수 있는 방법으로 :shallow 옵션을 사용하는 방법이 있습니다.

resources :posts do
  resources :comments, shallow: true
end

위의 단순한 설정은 정확하게 먼저 보여드린 복잡한 설정과 동일하게 동작합니다. :shallow 옵션을 부모 리소스에 사용하게 되면 모든 중첩 리소스들에 적용됩니다.

resources :posts, shallow: true do
  resources :comments
  resources :quotes
  resources :drafts
end

비슷하게 shallow 메소드를 사용하게 되면 해당 스코프의 모든 중첩 리소스들에 얕은 중첩이 적용됩니다. 이러한 설정은 위의 정의와 정확하게 동일한 결과를 보여줍니다.

shallow do
  resources :posts do
    resources :comments
    resources :quotes
    resources :drafts
  end
end

위에서 설명한 방법을 커스터마이징하여 특정 스코프를 적용한 얕은 라우트를 정의할 수 있습니다. 패스를 정의하는 파라미터와 함께 :shallow_path 를 정의하면 됩니다.

scope shallow_path: "sekret" do
  resources :posts do
    resources :comments, shallow: true
  end
end

comments 리소스는 다음과 같은 라우팅 정의를 갖게 됩니다.

 

[Ruby] RVM에서 rbenv로 옮기기

많은 루비 개발환경에서 RVM을 사용하는것을 볼 수 있는데요, 요즘들어 rbenv로 많이들 갈아타는 추세인것 같습니다. 이유를 물어봤더니 RVM이 사용하기 복잡하고 시스템 환경을 너무 많이 변경시킨다는 말씀들을 하시더군요. rbenv(Ruby Environment)의 경우 매우 간단한 구조로 되어있다고 하여 저도 갈아타기로 하였습니다.

rbenv는 특이하게 shims라는 방식을 사용하여 루비를 관리합니다. 환경변수 PATH의 값을 확인해 보면 다음과 같이 맨 앞에 shims가 추가된것을 볼 수 있습니다.

~/.rbenv/shims:/usr/local/bin:/usr/bin:/bin

rbenv는 rehashing이라는 작업을 통해 shims디렉토리 안의 erb, gem, irb, rake, rdoc, ri, ruby, testrb를 현재 사용중인 루비의 실제 바이너리와 연결합니다.

다음의 모든 진행은 Homebrew가 설치되어있는 맥시스템이라고 가정하고 진행합니다.

1. 설치되어있는 RVM 제거 하기

다음의 명령을 사용하여 간단하게 rvm을 제거할 수 있습니다.

$ rvm implode

기존에 환경변수 (~/.bash_profile 등)에 추가했던 설정들도 찾아서 제거해줍니다. 다음과 같은 부분입니다.

[[ -s "$HOME/.rvm/scripts/rvm" ]] && . "$HOME/.rvm/scripts/rvm" # Load RVM function

 2. rbenv 설치하기

Homebrew를 이용하면 손쉽게 설치가 가능합니다. 다음과 같이 설치를 진행해 줍니다.

$ brew update
$ brew install rbenv
$ brew install ruby-build
$ rbenv rehash

환경변수 설정을 추가해줍니다. ~/.bash_profile이면 됩니다.

if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi

 3. 원하는 Ruby 버전 설치하기

다음과 같이 설치가능한 모든 루비 버전을 확인할 수 있습니다.

$ rbenv install -l
Available versions:
  1.8.6-p383
  1.8.6-p420
  1.8.7-p249
  1.8.7-p302
  1.8.7-p334
  1.8.7-p352

  ...

제가 쓰려는 2.0.0-p353버전을 설치해 보겠습니다.

$ rbenv install 2.0.0-p353
Downloading ruby-2.0.0-p353.tar.gz...
-> http://dqw8nmjcqpjn7.cloudfront.net/78282433fb697dd3613613ff55d734c1
Installing ruby-2.0.0-p353...
Installed ruby-2.0.0-p353 to /Users/dennis/.rbenv/versions/2.0.0-p353

 4. Ruby 버전 변경하기

다음과 같이 현재 시스템에 설치되어있는 루비 버전을 출력할 수 있습니다.

$ rbenv versions
* system (set by /Users/dennis/.rbenv/version)
  2.0.0-p353

이제 조금전에 설치한 2.0.0-p353으로 사용하려는 루비를 변경해 보겠습니다.

$ rbenv global 2.0.0-p353
$ rbenv versions
  system
* 2.0.0-p353 (set by /Users/dennis/.rbenv/version)

변경된것을 확인할 수 있습니다. global은 전역 설정을 변경하는 옵션입니다. local을 사용할 경우 현재 디렉토리에 설정파일을 추가하며 프로젝트별로 루비 버전을 설정할 때 사용합니다. shell을 사용할 경우 현재 쉘이 종료될때까지 루비 버전이 설정됩니다.

$ ruby --version
ruby 2.0.0p353 (2013-11-22 revision 43784) [x86_64-darwin13.0.0]

루비 버전이 정상적으로 변경된것을 확인할 수 있습니다.

5. Bundler 설치하기

RVM과는 달리 Bundler가 기본 설치되지 않기 때문에 다음의 명령을 사용하여 추가적으로 설치를 해주어야 합니다.

$ gem install bundler
$ rbenv rehash