GSwR V: Методы к безумию

 helpers do

  # helper methods go here

end

Для начала, мы собираемся переписать приложение, используя имена методов для описания поведения, которое мы хотим. Создайте новый файл с именем ‘play_your_cards_right_refactored.rb’ и добавьте следующий код:

 require 'sinatra'
enable :sessions

configure do
  set :deck, []
  suits = %w[ Hearts Diamonds Clubs Spades ]
  values = %w[ Ace 2 3 4 5 6 7 8 9 10 Jack Queen King ]
  suits.each do |suit|
    values.each do |value|
    settings.deck << "#{value} of #{suit}"
    end
  end
end

helpers do
 # helper methods will go here
end

get '/' do
  set_up_game
  redirect to('/play')
end

get '/:guess' do
  card = draw_card
  value = value_of card

  if player_has_a_losing value
    game_over card
  else
    update_session_with value
    ask_about card
  end
end

Это очень похоже на последний кусок кода (и он имеет точно такую ​​же функциональность), за исключением того, что гораздо проще увидеть, что происходит в каждом обработчике маршрута. Это потому, что мы заменили большую часть кода Ruby методами и выбрали некоторые описательные имена методов, чтобы сделать код более читабельным. Это почти похоже на псевдокод .

Давайте посмотрим на каждый обработчик маршрута по очереди, чтобы увидеть, что он делает:

 get '/' do
  set_up_game
  redirect to('/play')
end

Этот обработчик маршрута настраивает игру, а затем перенаправляет на маршрут «/ play»… фактически, это даже не нужно объяснять, потому что он говорит это прямо в коде! Имена методов точно сообщают нам, что происходит — весь код был извлечен в метод с именем set_up_game Поместите следующее внутри блока помощников:

 def set_up_game
  session[:deck] = settings.deck.shuffle
  session[:guesses] = -1
  session[:value] = 0
end

Это устанавливает переменные сеанса, которые нам понадобятся в игре. Колода перетасовывается, догадки устанавливаются на -1 (потому что она увеличивается на 1 при первой игре, даже если правильное предположение не было сделано), а переменная значения устанавливается на 0.

redirectto

Теперь давайте посмотрим на начало обработчика маршрута, который имеет отношение к игровому процессу:

 get '/:guess' do
  card = draw_card
  value = value_of card

    # more code follows
end

Прежде всего нам нужно нарисовать карту, поэтому мы пишем метод для этого. Добавьте следующее в блок helpers

 def draw_card
  session[:deck].pop
end

Это очень короткий метод, но он дает нам более наглядный код.

Далее мы хотим узнать стоимость карты. Код, который мы использовали для этого в части 4, был довольно длинным case Мы можем извлечь это в метод, который принимает в качестве аргумента карту, а затем возвращает значение этой карты. Следующий код также входит в блок helpers

 def value_of card
  case card[0]
    when "J" then 11
    when "Q" then 12
    when "K" then 13
    else card.to_i
  end
end

Далее у нас есть оператор if

 if player_has_a_losing value
  game_over card
else
  update_session_with value
  ask_about card
end

Это также использует имя методов, чтобы сделать код очень описательным. Первый метод называется player_has_a_losingvalue Эта комбинация имени и имени параметра делает его хорошо читаемым. Этот метод также должен идти в блоке helpers

 def player_has_a_losing value
  (value < session[:value] and params[:guess] == 'higher') or (value > session[:value] and params[:guess] == 'lower')
end

Это возвращает truefalsesession[:value]params:guess

Если метод player_has_a_losingfalse Первый — update_session_withvalue Это происходит точно так же, как указано, а также обновляет число догадок на 1. Это также входит в блок helpers

 def update_session_with value
  session[:value] = value
  session[:guesses]  += 1
end

Следующий метод, который должен идти в блоке helpersask_about Это просто спрашивает игрока, является ли карта выше или ниже. Он принимает текущую карту в качестве аргумента:

 def ask_about card
  "The card is the #{ card }. Do you think the next card will be <a href='/higher'>Higher</a> or <a href='/lower'>Lower</a>?"
end

Это последний из всех наших вспомогательных методов. Если вы попытаетесь запустить код, введя ruby play_your_cards_right_refactored.rbhttp: // localhost: 4567, вы должны увидеть ту же игру, что и раньше. Это именно то, что мы хотим сделать, когда мы реорганизуем наш код — никаких изменений снаружи, но более читаемый и поддерживаемый код внутри.

Сфера

В некоторых вспомогательных методах, которые мы только что использовали, мы должны были указать карту или значение в качестве параметра методов. Вы можете спросить, почему мы должны были это делать, когда cardvalue Это связано с тем, что переменная существует внутри метода только в том случае, если она была создана в методе или если она была введена в качестве аргумента. Это можно увидеть в следующем примере (отметьте это в IRB):

 name = "Walt"
job = "teacher"

def say_my_name
  name = "Heisenberg"
  job = "cook"
  puts "You're #{name} and you're a #{job}"
end

puts "You're #{name} and you're a #{job}"
=> You're Walt and you're a teacher

say_my_name
=> You're Heisenberg and you're a Cook

Когда putsnamejobnamejob

У метода нет никакого доступа к любой переменной, созданной вне его (они должны быть введены как аргументы метода). Вы также не можете получить доступ к любой переменной, созданной внутри метода, вне метода — любые значения Вы хотите получить доступ после того, как метод был вызван, должен быть возвращен методом. Места в коде, где доступна переменная, известны как область действия переменной.

Это все люди

Надеемся, что это руководство помогло представить методы и показать, насколько они полезны для того, чтобы сделать ваш код более гибким, поддерживаемым, многократно используемым и более легким для чтения (при условии, что они хорошо названы).

Методы, которые мы писали в этом уроке, были больше похожи на функции . Как я упоминал в самом первом посте, Ruby на самом деле является объектно-ориентированным языком, а методы должны быть методами объектов. Методы, которые мы писали, на самом деле являются всеми методами специального mainЭтот пост Pat для более подробной информации об этом).

В следующем посте мы станем классными и посмотрим, как работает система классов Ruby. Мы рассмотрим, как добавлять методы к существующим классам, таким как Strings и Integers, и как создавать свои собственные классы с их собственными открытыми и закрытыми методами. А пока, пожалуйста, оставляйте любые комментарии или вопросы, которые могут у вас возникнуть в разделе комментариев ниже.