Программирование на языке Ruby.
11.1. Рутинные объектно-ориентированные задачи.
Of his quick objects hath the mind no part, Nor his own vision holds what it doth catch…Если вы вообще не знакомы с ООП, то эта глава вас ничему не научит. А если вы понимаете, что такое ООП в языке Ruby, то, наверное, ее и читать не стоит. Если понятия ООП не слишком свежи в памяти, просмотрите главу 1, где мы приводим их краткий обзор (или обратитесь к другой книге).
С другой стороны, большая часть материала в этой главе изложена в виде руководства и довольно элементарна. Поэтому она будет полезна начинающему и менее интересна для программиста на Ruby среднего уровня. Эта книга организована как устройство ввода/вывода с произвольной выборкой, так что можете свободно пропускать те части, которые вас не интересуют.
11.1.1. Применение нескольких конструкторов.
В Ruby нет «настоящих» конструкторов, как в C++ или в Java. Сама идея, конечно, никуда не делась, поскольку объекты необходимо создавать и инициализировать, но реализация выглядит иначе.
В Ruby каждый класс имеет метод класса new, который вызывается для создания новых объектов. Метод new вызывает специальный определяемый пользователем метод initialize, который инициализирует атрибуты объекта, после чего new возвращает ссылку на новый объект.
А если мы хотим иметь несколько конструкторов? Как быть в этом случае?
Ничто не мешает завести дополнительные методы класса, которые возвращают новые объекты. В листинге 11.1 приведен искусственный пример класса для представления прямоугольника, у которого есть две длины сторон и три значения цвета. Мы создали дополнительные методы класса, предполагающие определенные умолчания для каждого параметра. (Например, квадрат — это прямоугольник, у которого все стороны равны.).
Листинг 11.1. Несколько конструкторов.
Class ColoredRectangle.
def initialize(r, g, b, s1, s2).
@r, @g, @b, @s1, @s2 = r, g, b, s1, s2.
end.
def ColoredRectangle.white_rect(s1, s2).
new(0xff, 0xff, 0xff, s1, s2).
end.
def ColoredRectangle.gray_rect(s1, s2).
new(0x88, 0x88, 0x88, s1, s2).
end.
def ColoredRectangle.colored_square(r, g, b, s).
new(r, g, b, s, s).
end.
def ColoredRectangle.red_square(s).
new(0xff, 0, 0, s, s).
end.
def inspect.
"#@r #@g #@b #@s1 #@s2".
end.
End.
A = ColoredRectangle.new(0x88, 0xaa, 0xff, 20, 30).
B = ColoredRectangle.white_rect(15,25).
С = ColoredRectangle.red_square(40).
Таким образом, можно определить любое число методов, создающих объекты по различным спецификациям. Вопрос о том, уместен ли здесь термин «конструктор», мы оставим «языковым адвокатам».
11.1.2. Создание атрибутов экземпляра.
Имени атрибута экземпляра в Ruby всегда предшествует знак @. Это обычная переменная в том смысле, что она начинает существовать после первого присваивания.
В ОО-языках часто создаются методы для доступа к атрибутам, чтобы обеспечить сокрытие данных. Мы хотим контролировать доступ к «внутренностям» объекта извне. Обычно для данной цели применяются методы чтения и установки (getter и setter), хотя в Ruby эта терминология не используется. Они просто читают (get) или устанавливают (set) значение атрибута.
Можно, конечно, запрограммировать такие функции «вручную», как показано ниже:
Class Person.
def name.
@name.
end.
def name=(x).
@name = x.
end.
def age.
@age.
end.
# ...
End.
Ho Ruby предоставляет более короткий способ. Метод attr принимает в качестве параметра символ и создает соответствующий атрибут. Кроме того, он создает одноименный метод чтения, а если необязательный второй параметр равен true, то и метод установки.
Class Person.
attr :name, true # Создаются @name, name, name=
attr :age # Создаются @age, age.
End.
Методы attr_reader, attr_writer и attr_accessor принимают в качестве параметров произвольное число символов. Первый создает только «методы чтения» (для получения значения атрибута); второй — только «методы установки», а третий — то и другое. Пример:
Class SomeClass.
attr_reader :a1, :a2 # Создаются @a1, a1, @a2, a2.
attr_writer :b1, :b2 # Создаются @b1, b1=, @b2, b2 =
attr_accessor :c1, :c2 # Создаются @c1, c1, c1=, @c2, c2, c2=
# ...
End.
Напомним, что для выполнения присваивания атрибуту необходимо указывать вызывающий объект, а внутри метода нужно в качестве такого объекта указывать self.
11.1.3. Более сложные конструкторы.
По мере усложнения объектов у них появляется все больше атрибутов, которые необходимо инициализировать в момент создания. Соответствующий конструктор может оказаться длинным и запутанным, его параметры даже не будут помещаться на одной строке.
Чтобы справиться со сложностью, можно передать методу initialize блок (листинг 11.2). Тогда инициализация объекта выполняется в процессе вычисления этого блока. Хитрость в том, что вместо обычного eval для вычисления блока в контексте объекта, а не вызывающей программы, следует использовать метод instance_eval.
Листинг 11.2. «Хитрый» конструктор.
Class PersonalComputer.
attr_accessor :manufacturer,
:model, :processor, :clock,
:ram, :disk, :monitor,
:colors, :vres, :hres, :net.
def initialize(&block).
instance_eval &block.
end.
# Прочие методы...
End.
Desktop = PersonalComputer.new do.
self.manufacturer = "Acme".
self.model = "THX-1138".
self.processor = "986".
self.clock = 9.6 # ГГц.
self.ram =16 # Гб.
self.disk =20 # T6.
self.monitor = 25 # дюймы.
self.colors = 16777216.
self.vres = 1280.
self.hres = 1600.
self.net = "T3".
End.
P desktop.
Отметим несколько нюансов. Во-первых, мы пользуемся методами доступа к атрибутам, поэтому присваивание им значений интуитивно понятно. Во-вторых, ссылка на self необходима, поскольку метод установки требует явного указания вызывающего объекта, чтобы можно было отличить вызов метода от обычного присваивания локальной переменной. Конечно, можно было не определять методы доступа, а воспользоваться функциями установки.
Ясно, что в теле блока можно делать все, что угодно. Например, можно было бы вычислить некоторые поля на основе других.
А если вам не нужны методы доступа для всех атрибутов? Если хотите, можете избавиться от лишних, вызвав для них метод undef в конце конструирующего блока. Как минимум, это предотвратит «случайное» присваивание значения атрибуту извне объекта.
11.1.4. Создание атрибутов и методов уровня класса.
Метод или атрибут не всегда ассоциируются с конкретным экземпляром класса, они могут принадлежать самому классу. Типичным примером метода класса может служить new, он вызывается для создания новых экземпляров, а потому не может принадлежать никакому конкретному экземпляру.
Мы можем определять собственные методы класса, как показано в разделе 11.1.1. Конечно, их функциональность не ограничивается конструированием — они могут выполнять любые операции, имеющие смысл именно на уровне класса.
В следующем далеко не полном фрагменте предполагается, что мы создаем класс для проигрывания звуковых файлов. Метод play естественно реализовать как метод экземпляра, ведь можно создать много объектов, каждый из которых будет проигрывать свой файл. Но у метода detect_hardware контекст более широкий; в зависимости от реализации может оказаться, что создавать какие-либо объекты вообще не имеет смысла, если этот метод возвращает ошибку. Следовательно, его контекст — вся среда воспроизведения звука, а не конкретный звуковой файл.
Class SoundPlayer.
MAX_SAMPLE = 192.
def SoundPlayer.detect_hardware.
# ...
end.
def play.
# ...
end.
End.
Есть еще один способ объявить этот метод класса. В следующем фрагменте делается практически то же самое:
Class SoundPlayer.
MAX_SAMPLE =192.
def play.
# ...
end.
End.
Def SoundPlayer.detect_hardware.
# ...
End.
Единственная разница касается использования объявленных в классе констант. Если метод класса объявлен вне объявления самого класса, то эти константы оказываются вне области видимости. Например, в первом фрагменте метод detect_hardware может напрямую обращаться к константе MAX_SAMPLE, а во втором придется пользоваться нотацией SoundPlayer::MAX_SAMPLE.
Не удивительно, что помимо методов класса есть еще и переменные класса. Их имена начинаются с двух знаков @, а областью видимости является весь класс, а не конкретный его экземпляр.
Традиционный пример использования переменных класса - подсчет числа его экземпляров. Но они могут применяться всегда, когда информации имеет смысл в контексте класса в целом, а не отдельного объекта. Другой пример приведен в листинге 11.3.
Листинг 11.3. Переменные и методы класса.
Class Metal.
@@current_temp = 70.
attr_accessor :atomic_number.
def Metal.current_temp=(x).
@@current_temp = x.
end.
def Metal.current_temp.
@@current_temp.
end.
def liquid?
@@current_temp >= @melting.
end.
def initialize(atnum, melt).
@atomic_number = atnum.
@melting = melt.
end.
End.
Aluminum = Metal.new(13, 1236).
Copper = Metal.new(29, 1982).
Gold = Metal.new(79, 1948).
Metal.current_temp = 1600.
Puts aluminum.liquid? # true.
Puts copper.liquid? # false.
Puts gold.liquid? # false.
Metal.current_temp = 2100.
Puts aluminum.liquid? # true.
Puts copper.liquid? # true.
Puts gold.liquid? # true.
Здесь переменная класса инициализируется до того, как впервые используется в методе класса. Отметим также, что мы можем обратиться к переменной класса из метода экземпляра, но обратиться к переменной экземпляра из метода класса нельзя. Немного подумав, вы поймете, что так и должно быть.
А если попытаться, что произойдет? Что если мы попробуем напечатать атрибут @atomic_number из метода Metal.current_temp? Обнаружится, что переменная вроде бы существует — никакой ошибки не возникает, — но имеет значение nil. В чем дело?
В том, что на самом деле мы обращаемся вовсе не к переменной экземпляра класса Metal, а к переменной экземпляра класса Class. (Напомним, что в Ruby Class — это класс!).
Мы столкнулись с переменной экземпляра класса (термин заимствован из языка Smalltalk). Дополнительные замечания на эту тему приводятся в разделе 11.2.4.
В листинге 11.4 иллюстрируются все аспекты этой ситуации.
Листинг 11.4. Данные класса и экземпляра.
Class MyClass.
SOME_CONST = "alpha" # Константа уровня класса.
@@var = "beta" # Переменная класса.
@var = "gamma" # Переменная экземпляра класса.
def initialize.
@var = "delta" # Переменная экземпляра.
end.
def mymethod.
puts SOME_CONST # (Константа класса.).
puts @@var # (Переменная класса.).
puts @var # (Переменная экземпляра.).
end.
def MyClass.classmeth1.
puts SOME_CONST # (Константа класса.).
puts @@var # (Переменная класса.).
puts @var # (Переменная экземпляра класса.).
end.
End.
Def MyClass.classmeth2.
puts MyClass::SOME_CONST # (Константа класса.).
# puts @@var # Ошибка: вне области видимости.
puts @var # (Переменная экземпляра класса.).
End.
Myobj = MyClass.new.
MyClass.classmeth1 # alpha, beta, gamma.
MyClass.classmeth2 # alpha, gamma.
Myobj.mymethod # alpha, beta, delta.
Следует еще сказать, что метод класса можно сделать закрытым, воспользовавшись методом private_class_method. Это аналог метода private на уровне экземпляра. См. также раздел 11.2.10.
11.1.5. Наследование суперклассу.
Можно унаследовать класс, воспользовавшись символом <:
Class Boojum < Snark.
# ...
End.
Это объявление говорит, что класс Boojum является подклассом класса Snark или — что то же самое — класс Snark является суперклассом класса Boojum. Всем известно, что каждый буюм является снарком, но не каждый снарк — буюм.
Ясно, что цель наследования — расширить или специализировать функциональность. Мы хотим получить из общего нечто более специфическое.
Попутно отметим, что во многих языках, например в C++, допускается множественное наследование (МН). В Ruby, как и в Java, и в некоторых других языках, множественного наследования нет, но наличие классов-примесей компенсирует его отсутствие (см. раздел 11.1.12).
Рассмотрим несколько более реалистичный пример. У нас есть класс Person (человек), а мы хотим создать производный от него класс Student (студент).
Определим класс Person следующим образом:
Class Person.
attr_accessor :name, :age, :sex.
def initialize(name, age, sex).
@name, @age, @sex = name, age, sex.
end.
# ...
End.
А класс Student — так:
Class Student < Person.
attr_accessor :idnum, :hours.
def initialize(name, age, sex, idnum, hours).
super(name, age, sex).
@idnum = idnum.
@hours = hours.
end.
# ...
End.
# Создать два объекта.
A = Person.new("Dave Bowman", 37, "m").
B = Student.new("Franklin Poole", 36, "m", "000-13-5031", 24).
Посмотрим внимательно, что здесь сделано. Что за super, вызываемый из метода initialize класса Student? Это просто вызов соответствующего метода родительского класса. А раз так, то ему передается три параметра (хотя наш собственный метод initialize принимает пять).
Не всегда необходимо использовать слово super подобным образом, но часто это удобно. В конце концов, атрибуты любого класса образуют надмножество множества атрибутов его родительского класса, так почему не воспользоваться для их инициализации конструктором родительского класса?
Если говорить об истинном смысле наследования, то оно, безусловно, описывает отношение «является». Студент является человеком, как и следовало ожидать. Сделаем еще три замечания:
• Каждый атрибут (и метод) родительского класса отражается в его потомках. Если в классе Person есть атрибут height, то класс Student унаследует его, а если родитель имеет метод say_hello, такой метод будет и у потомка.
• Потомок может иметь дополнительные атрибуты и методы, мы это только что видели. Поэтому создание подкласса часто еще называют расширением суперкласса.
• Потомок может переопределять любые атрибуты и методы своего родителя.
Последнее замечание подводит нас к вопросу о том, как разрешается вызов метода. Откуда я знаю, вызывается ли метод конкретного класса или его суперкласса?
Краткий ответ таков: не знаю и не интересуюсь. Если вызывается некий метод от имени объекта класса Student, то будет вызван метод, определенный в этом классе, если он существует. А если нет, вызывается метод суперкласса и так далее вверх по иерархии наследования. Мы говорим «и так далее», потому что у каждого класса (кроме Object) есть суперкласс.
А что если мы хотим вызвать метод суперкласса, но не из соответствующего метода подкласса? Можно сначала создать в подклассе синоним:
Class Student # Повторное открытие класса.
# Предполагается, что в классе Person есть метод say_hello...
alias :say_hi :say_hello.
def say_hello.
puts "Привет.".
end.
def formal_greeting.
# Поприветствовать так, как принято в суперклассе.
say_hi.
end.
End.
У наследования есть разные тонкости, которых мы здесь касаться не будем. Общий принцип мы изложили, но не пропустите следующий раздел.
11.1.6. Опрос класса объекта.
Часто возникает вопрос: «Что это за объект? Как он соотносится с данным классом?» Есть много способов получить тот или иной ответ.
Во-первых, метод экземпляра class всегда возвращает класс объекта. Применявшийся ранее синоним type объявлен устаревшим.
S = "Hello".
N = 237.
Sc = s.class # String.
Nc = n.class # Fixnum.
He думайте, будто методы class или type возвращают строку, представляющую имя класса. На самом деле возвращается экземпляр класса Class! При желании мы могли бы вызвать метод класса, определенный в этом типе, как если бы это был метод экземпляра класса Class (каковым он в действительности и является).
S2 = "some string".
Var = s2.class # String.
My_str = var.new("Hi...") # Новая строка.
Можно сравнить такую переменную с константным именем класса и выяснить, равны ли они; можно даже использовать переменную в роли суперкласса и определить на ее основе подкласс! Запутались? Просто помните, что в Ruby Class — это объект, a Object — это класс.
Иногда нужно сравнить объект с классом, чтобы понять, принадлежит ли данный объект указанному классу. Для этого служит метод instance_of?, например:
Puts (5.instance_of? Fixnum) # true.
Puts ("XYZZY".instance_of? Fixnum) # false.
Puts ("PLUGH".instance_of? String) # true.
А если нужно принять во внимание еще и отношение наследования? К вашим услугам метод kind_of? (похожий на instance_of?). У него есть синоним is_a?, что вполне естественно, ибо мы описываем классическое отношение «является».
N = 9876543210.
Flag1 = n.instance_of? Bignum # true.
Flag2 = n.kind_of? Bignum # true.
Flag3 = n.is_a? Bignum # true.
Flag3 = n.is_a? Integer # true.
Flag4 = n.is_a? Numeric # true.
Flag5 = n.is_a? Object # true.
Flag6 = n.is_a? String # false.
Flag7 = n.is_a? Array # false.
Ясно, что метод kind_of или is_a? более общий, чем instance_of?. Например, всякая собака — млекопитающее, но не всякое млекопитающее — собака.
Для новичков в Ruby приготовлен один сюрприз. Любой модуль, подмешиваемый в класс, становится субъектом отношения «является» для экземпляров этого класса. Например, в класс Array подмешан модуль Enumerable; это означает, что всякий массив является перечисляемым объектом.
X = [1, 2, 3].
Flag8 = x.kind_of? Enumerable # true.
Flag9 = x.is_a? Enumerable # true.
Для сравнения двух классов можно пользоваться также операторами сравнения. Интуитивно очевидно, что оператор «меньше» обозначает наследование суперклассу.
Flag1 = Integer < Numeric # true.
Flag2 = Integer < Object # true.
Flag3 = Object == Array # false.
Flag4 = IO >= File # true.
Flag5 = Float < Integer # nil.
В любом классе обычно определен оператор «тройного равенства» ===. Выражение class === instance истинно, если экземпляр instance принадлежит классу class. Этот оператор еще называют оператором ветвящегося равенства, потому что он неявно используется в предложении case. Дополнительную информацию о нем вы найдете в разделе 11.1.7.
Упомянем еще метод respond_to. Он используется, когда нам безразлично, какому классу принадлежит объект, но мы хотим знать, реализует ли он конкретный метод. Это рудиментарный вид получения информации о типе. (Вообще-то можно сказать, что это самая важная информация о типе.) Методу respond_to передается символ и необязательный флаг, который говорит, нужно ли включать в рассмотрение также и закрытые методы.
# Искать открытые методы.
If wumpus.respond_to?(:bite).
puts "У него есть зубы!".
Else.
puts "Давай-ка подразним его.".
End.
# Необязательный второй параметр позволяет.
# просматривать и закрытые методы.
If woozle.respond_to?(:bite,true).
puts "Вузлы кусаются!".
Else.
puts "Ага, это не кусающийся вузл.".
End.
Иногда нужно знать, является ли данный класс непосредственным родителем объекта или класса. Ответ на этот вопрос дает метод superclass класса Class.
Array_parent = Array.superclass # Object.
Fn_parent = 237.class.superclass # Integer.
Obj_parent = Object.superclass # nil.
У любого класса, кроме Object, есть суперкласс.
11.1.7. Проверка объектов на равенство.
Все животные равны, но некоторые равнее других.При написании своих классов желательно, чтобы семантика типичных операций была такой же, как у встроенных в Ruby классов. Например, если объекты класса можно упорядочивать, то имеет смысл реализовать метод <=> и подмешать модуль Comparable. Тогда к объектам вашего класса будут применимы все обычные операции сравнения.
Однако картина перестает быть такой однозначной, когда дело доходит до проверки объектов на равенство. В Ruby объекты реализуют пять разных методов для этой операции. И в ваших классах придется реализовать хотя бы некоторые из них, поэтому рассмотрим этот вопрос подробнее.
Самым главным является метод equal? (унаследованный от класса Object); он возвращает true, если вызывающий объект и параметр имеют один и тот же идентификатор объекта. Это фундаментальный аспект семантики объектов, поэтому переопределять его не следует.
Самым распространенным способом проверки на равенство является старый добрый оператор ==, который сравнивает значения вызывающего объекта и аргумента. Наверно, интуитивно это наиболее очевидный способ.
Следующим в шкале абстракции стоит метод eql? — тоже часть класса Object. (На самом деле метод eql? реализован в модуле Kernel, который подмешивается в Object.) Как и оператор ==, этот метод сравнивает значения вызывающего объекта и аргумента, но несколько более строго. Например, разные числовые объекты при сравнении с помощью == приводятся к общему типу, но метод eql? никогда не считает объекты разных типов равными.
Flag1 = (1 == 1.0) # true.
Flag2 = (1.eql?(1.0)) # false.
Метод eql? существует по одной-единственной причине: для сравнения значений ключей хэширования. Если вы хотите переопределить стандартное поведение Ruby при использовании объектов в качестве ключей хэша, то переопределите методы eql? и hash.
Любой объект реализует еще два метода сравнения. Метод === применяется для сравнения проверяемого значения в предложении case с каждым селектором: selector===target. Хотя правило на первый взгляд кажется сложным, на практике оно делает предложения case в Ruby интуитивно очевидными. Например, можно выполнить ветвление по классу объекта:
Case an_object.
when String.
puts "Это строка.".
when Numeric.
puts "Это число.".
else.
puts "Это что-то совсем другое.".
End.
Эта конструкция работает, потому что в классе Module реализован метод ===, проверяющий, принадлежит ли параметр тому же классу, что вызывающий объект (или одному из его предков). Поэтому, если an_object — это строка «cat», выражение string === an_object окажется истинным и будет выбрана первая ветвь в предложении case.
Наконец, в Ruby реализован оператор сопоставления с образцом =~. Традиционно он применяется для сопоставления строки с регулярным выражением. Но если вы найдете ему применение в других классах, то можете переопределить.
У операторов == и =~ есть противоположные формы: != и !~ соответственно. Внутри они реализованы путем обращения значения основной формы. Это означает, что если, например, вы реализовали метод ==, то метод != получаете задаром.
11.1.8. Управление доступом к методам.
В Ruby объект определяется, прежде всего, своим интерфейсом: теми методами, которые он раскрывает внешнему миру. Но при написании класса часто возникает необходимость во вспомогательных методах, вызывать которые извне класса опасно. Тут-то и приходит на помощь метод private класса Module.
Использовать его можно двумя способами. Если в теле класса или модуля вы вызовете private без параметров, то все последующие методы будут закрытыми в данном классе или модуле. Если же вы передадите ему список имен методов (в виде символов), то эти и только эти методы станут закрытыми. В листинге 11.5 показаны оба варианта.
Листинг 11.5. Закрытые методы.
Class Bank.
def open_safe.
# ...
end.
def close_safe.
# ...
end.
private :open_safe, :close_safe.
def make_withdrawal(amount).
if access_allowed.
open_safe.
get_cash(amount).
close_safe.
end.
end.
# Остальные методы закрытые.
Private.
def get_cash.
# ...
end.
def access_allowed.
# ...
end.
End.
Поскольку методы из семейства attr просто определяют методы, метод private определяет и видимость атрибутов.
Реализация метода private может показаться странной, но на самом деле она весьма хитроумна. К закрытым методам нельзя обратиться, указав вызывающий объект; они вызываются только от имени неявно подразумеваемого объекта self. То есть вызвать закрытый метод из другого объекта не удастся: просто не существует способа указать объект, от имени которого данный метод вызывается. Заодно это означает, что закрытые методы доступны подклассам того класса, в котором определены, но опять же в рамках одного объекта.
Модификатор доступа protected налагает меньше ограничений. Защищенные методы доступны только экземплярам того класса, в котором определены, и его подклассов. Для защищенного метода разрешается указывать вызывающий объект, так что к ним можно обращаться из других объектов (при условии, что вызывающий и вызываемый объекты принадлежат одному классу). Обычно защищенные методы применяются для определения методов доступа, чтобы два объекта одного типа могли взаимодействовать. В следующем примере объекты класс Person можно сравнивать по возрасту, но сам возраст недоступен вне класса Person:
Class Person.
def initialize(name, age).
@name, @age = name, age.
end.
def <=>(other).
age <=> other.age.
end.
attr_reader :name, :age.
protected :age.
End.
P1 = Person.new("fred", 31).
P2 = Person.new("agnes", 43).
Compare = (p1 <=> p2) # -1.
X = p1.age # Ошибка!
Чтобы завершить картину, модификатор public делает метод открытым. Неудивительно!..
И последнее: методы, определенные вне любого класса и модуля (то есть на верхнем уровне программы), по умолчанию закрыты. Поскольку они определены в классе Object, то видимы глобально, но обращаться к ним с указанием вызывающего объекта нельзя.
11.1.9. Копирование объектов.
Встроенные методы Object#clone и #dup порождают копию вызывающего объекта. Различаются они объемом копируемого контекста. Метод #dup копирует только само содержимое объекта, тогда как clone сохраняет и такие вещи, как синглетные классы, ассоциированные с объектом.
S1 = "cat".
Def s1.upcase.
"CaT".
End.
S1_dup = s1.dup.
S1_clone = s1.clone.
S1 #=> "cat".
S1_dup.upcase #=> "CAT" (синглетный метод не копируется).
S1_clone.upcase #=> "СаТ" (используется синглетный метод).
И dup, и clone выполняют поверхностное копирование, то есть копируют лишь содержимое самого вызывающего объекта. Если вызывающий объект содержит ссылки на другие объекты, то последние не копируются — копия будет ссылаться на те же самые объекты. Проиллюстрируем это на примере. Объект arr2 — копия arr1, поэтому изменение элемента целиком, например arr2[2], не оказывает влияния на arr1. Но исходный массив и его копия содержат ссылку на один и тот же объект String, поэтому изменение строки через arr2 приведет к такому же изменению значения, на которое ссылается arr1.
Arr1 = [ 1, "flipper", 3 ].
Arr2 = arr1.dup.
Arr2[2] = 99.
Arr2[1][2] = 'a'.
Arr1 # [1, "flapper", 3].
Arr2 # [1, "flapper", 99].
Иногда необходимо глубокое копирование, при котором копируется все дерево объектов с корнем в исходном объекте. В этом случае между оригиналом и копией гарантированно не будет никакой интерференции. Ruby не предоставляет встроенного метода для глубокого копирования, но есть приемы, позволяющие достичь желаемого результата.
Самый «чистый» способ — потребовать, чтобы классы реализовывали метод deep_copy. Он мог бы рекурсивно обходить все объекты, на которые ссылается исходный объект, и вызывать для них метод deep_copy. Необходимо было бы еще добавить метод deep_copy во все встроенные классы Ruby, которыми вы пользуетесь.
Но есть и более быстрый способ с использованием модуля Marshal. Если вы сериализуете исходный объект, представив его в виде строки, а затем загрузите в новый объект, то этот новый объект будет копией исходного.
Arr1 = [ 1, "flipper", 3 ].
Arr2 = Marshal.load(Marshal.dump(arr1)).
Arr2[2] = 99.
Arr2[1][2] = 'a'.
Arr1 # [1, "flipper", 3].
Arr2 # [1, "flapper", 99].
Обратите внимание, что изменение строки через arr2 не отразилось на строке, на которую ссылается arr1.
11.1.10. Метод initialize_copy.
При копировании объекта методом dup или clone конструктор не вызывается. Копируется вся информация о состоянии.
Но что делать, если вам такое поведение не нужно? Рассмотрим пример:
Class Document.
attr_accessor :title, :text.
attr_reader :timestamp.
def initialize(title, text).
@title, @text = title, text.
@timestamp = Time.now.
end.
End.
Doc1 = Document.new("Random Stuff",File.read("somefile")).
Sleep 300 # Немного подождем...
Doc2 = doc1.clone.
Doc1.timestamp == doc2.timestamp # true.
# Оп... временные штампы одинаковы!
При создании объекта Document с ним ассоциируется временной штамп. При копировании объекта копируется и его временной штамп. А как быть, если мы хотим запомнить время, когда было выполнено копирование?
Для этого нужно определить метод initialize_copy. Он вызывается как раз при копировании объекта. Этот метод аналогичен initialize и позволяет полностью контролировать состояние объекта.
Class Document # Определяем новый метод в классе.
def initialize_copy(other).
@timestamp = Time.now.
end.
End.
Doc3 = Document.new("More Stuff", File.read("otherfile")).
Sleep 300 # Немного подождем...
Doc4 = doc3.clone.
Doc3.timestamp == doc4.timestamp # false.
# Теперь временные штампы правильны.
Отметим, что метод initialize_copy вызывается после того, как вся информация скопирована. Поэтому мы и опустили строку:
@title, @text = other.title, other.text.
Кстати, если метод initialize_copy пуст, то поведение будет такое же, как если бы он не был определен вовсе.
11.1.11. Метод allocate.
Редко, но бывает, что нужно создать объект, не вызывая его конструктор (в обход метода initialize). Например, может статься, что состояние объекта полностью определяется методами доступа к нему; тогда не нужно вызывать метод new (который вызовет initialize), разве что вы сами захотите это сделать. Представьте, что для инициализации состояния объекта вы собираете данные по частям: начать следует с «пустого» объекта, а не получить все данные заранее, а потом вызвать конструктор.
Метод allocate появился в версии Ruby 1.8, чтобы упростить решение этой задачи. Он возвращает «чистый», еще не инициализированный объект класса.
Class Person.
attr_accessor :name, :age, :phone.
def initialize(n,a,p).
@name, @age, @phone = n, a, p.
end.
End.
P1 = Person.new("John Smith",29,"555-1234").
P2 = Person.allocate.
P p1.age # 29.
P p2.age # nil.
11.1.12. Модули.
Для использования модулей в Ruby есть две основных причины. Первая — облегчить управление пространством имен; если поместить константы и методы в модули, то будет меньше конфликтов имен. Хранящийся таким образом метод (метод модуля) вызывается с указанием имени модуля, то есть без вызывающего объекта. Точно так же вызывается и метод класса. Увидев вызовы вида File.ctime или FileTest.exist?, мы не можем определить по контексту, что File — это класс, а FileTest — модуль.
Вторая причина более интересна: мы можем использовать модуль как примесь. Примеси — это способ реализации множественного наследования, при котором наследуется только интерфейс.
Мы уже говорили о методах модуля, а как насчет методов экземпляра? Модуль — это не класс, у него не может быть экземпляров, а к методу экземпляра нельзя обратиться, не указав вызывающий объект.
Но оказывается, модуль может иметь методы экземпляра. Они становятся частью класса, который включил модуль директивой include.
Module MyMod.
def meth1.
puts "Это метод 1.".
end.
End.
Class MyClass.
include MyMod.
# ...
End.
X = MyClass.new.
X.meth1 # Это метод 1.
Здесь модуль MyMod подмешан к классу MyClass, а метод экземпляра meth1 унаследован. Вы видели также, как директива include употребляется на верхнем уровне программы; в таком случае модуль подмешивается к классу Object.
А что происходит с методами модуля, если таковые определены? Если вы думаете, что они становятся методами класса, то ошибаетесь. Методы модуля не подмешиваются.
Но если такое поведение желательно, то его можно реализовать с помощью нехитрого трюка. Существует метод append_features, который можно переопределить. Он вызывается с параметром — «целевым» классом или модулем (в который включается данный модуль). Пример приведен в листинге 11.6.
Листинг 11.6. Включение модуля с переопределенным методом append_features.
Module MyMod.
def MyMod.append_features(someClass).
def someClass.modmeth.
puts "Метод модуля (класса) ".
end.
super # Этот вызов обязателен!
end.
def meth1.
puts "Метод 1".
end.
End.
Class MyClass.
include MyMod.
def MyClass.classmeth.
puts "Метод класса".
end.
def meth2.
puts "Метод 2".
end.
End.
X = MyClass.new.
# Выводится:
MyClass.classmeth # Метод класса.
X.meth1 # Метод 1.
MyClass.modmeth # Метод модуля (класса).
X.meth2 # Метод 2.
Этот пример заслуживает детального рассмотрения. Во-первых, надо понимать, что метод append_features не просто вызывается в ходе выполнения include; на самом деле именно он и несет ответственность за включение. Поэтому-то вызов super необходим, без него оставшаяся часть модуля (в данном случае метод meth1) вообще не была бы включена.
Отметим также, что внутри тела append_features имеется определение метода. Выглядит это необычно, но работает, поскольку вложенное определение порождает синглетный метод (уровня класса или модуля). Попытка определить таким образом метод экземпляра привела бы к ошибке Nested method error (Ошибка при определении вложенного метода).
Модуль мог бы захотеть узнать, кто был инициатором примеси. Для этого тоже можно воспользоваться методом append_features, потому что класс-инициатор передается ему в качестве параметра.
Можно также подмешивать методы экземпляра модуля как методы класса. В листинге 11.7 приведен соответствующий пример.
Листинг 11.7. Методы экземпляра модуля становятся методами класса.
Module MyMod.
def meth3.
puts "Метод экземпляра модуля meth3".
puts "может стать методом класса.".
end.
End.
Class MyClass.
class << self # Здесь self - это MyClass.
include MyMod.
end.
End.
MyClass.meth3.
# Выводится:
# Метод экземпляра модуля meth3.
# может стать методом класса.
Здесь полезен метод extend. Тогда пример можно записать так:
Class MyClass.
extend MyMod.
End.
Мы все время говорим о методах. А как насчет переменных экземпляра? Конечно, модуль может иметь собственные данные экземпляра, но обычно так не делают. Впрочем, если вы решили, что без этого никак не обойтись, ничто вас не остановит.
Можно подмешивать модуль к объекту, а не классу (например, методом extend), см. по этому поводу раздел 11.2.2.
Важно понимать еще одну вещь. В вашем классе можно определить методы, которые будут вызываться из примеси. Это удивительно мощный прием, знакомый тем, кто пользовался интерфейсами в Java.
Классический пример, с которым мы уже сталкивались ранее, — подмешивание модуля Comparable и определение метода <=>. Поскольку подмешанные методы могут вызывать метод сравнения, то мы получаем операторы <, >, <= и т.д.
Другой пример — подмешивание модуля Enumerable и определение метода <=> и итератора each. Тем самым мы получаем целый ряд полезных методов: collect, sort, min, max и select.
Можно также определять и собственные модули, ведущие себя подобным образом. Возможности ограничены только вашим воображением.
11.1.13. Трансформация или преобразование объектов.
Иногда объект имеет нужный вид в нужное время, а иногда хочется преобразовать его во что-то другое или сделать вид, что он является чем-то, чем на самом деле не является. Всем известный пример — метод to_s.
Каждый объект можно тем или иным способом представить в виде строки. Но не каждый объект может успешно «прикинуться» строкой. Именно в этом и состоит различие между методами to_s и to_str. Рассмотрим этот вопрос подробнее.
При использовании метода puts или интерполяции в строку (в контексте #{...}) ожидается, что в качестве параметра будет передан объект string. Если это не так, объект просят преобразовать себя в string, посылая ему сообщение to_s. Именно здесь вы можете определить, как объект следует отобразить; просто реализуйте метод to_s в своем классе так, чтобы он возвращал подходящую строку.
Class Pet.
def initialize(name).
@name = name.
end.
# ...
def to_s.
"Pet: #@name".
end.
End.
Другие методы (например, оператор конкатенации строк +) не так требовательны, они ожидают получить нечто достаточно близкое к объекту string. В этом случае Мац решил, что интерпретатор не будет вызывать метод to_s для преобразования нестроковых аргументов, поскольку это могло бы привести к большому числу ошибок. Вместо этого вызывается более строгий метод to_str. Из всех встроенных классов только String и Exception реализуют to_str, и лишь String, Regexp и Marshal вызывают его. Увидев сообщение TypeError: Failed to convert xyz into string, можно смело сказать, что интерпретатор пытался вызвать to_str и потерпел неудачу.
Вы можете реализовать метод to_str и самостоятельно, например, если хотите, чтобы строку можно было конкатенировать с числом:
Class Numeric.
def to_str.
to_s.
end.
End.
Label = "Число " + 9 # "Число 9".
Аналогично обстоит дело и в отношении массивов. Для преобразования объекта в массив служит метод to_a, а метод to_ary вызывается, когда ожидается массив и ничего другого, например в случае множественного присваивания. Допустим, есть предложение такого вида:
А, b, с = x.
Если x — массив из трех элементов, оно будет работать ожидаемым образом. Но если это не массив, интерпретатор попытается вызвать метод to_ary для преобразования в массив. В принципе это может быть даже синглетный метод (принадлежащий конкретному объекту). На само преобразование не налагается никаких ограничений, ниже приведен пример (нереалистичный), когда строка преобразуется в массив строк:
Class String.
def to_ary.
return self.split("").
end.
End.
Str = "UFO".
A, b, с = str # ["U", "F", "O"].
Метод inspect реализует другое соглашение. Отладчики, утилиты типа irb и метод отладочной печати p вызывают inspect, чтобы преобразовать объект к виду, пригодному для вывода на печать. Если вы хотите, чтобы во время отладки объект раскрывал свое внутреннее устройство, переопределите inspect.
Есть и еще одна ситуация, когда желательно выполнять такие преобразования «за кулисами». Пользователь языка ожидает, что Fixnum можно прибавить к Float, а комплексное число Complex разделить на рациональное. Но для проектировщика языка это проблема. Если метод + класса Fixnum получает аргумент типа Float, то что он должен с ним делать? Он знает лишь, как складывать значения типа Fixnum. Для решения проблемы в Ruby реализован механизм приведения типов coerce.
Когда оператор + (к примеру) получает аргумент, которого не понимает, он пытается привести вызывающий объект и аргумент к совместимым типам, а затем значения этих типов сложить. Общий принцип использования метода coerce прямолинеен:
Class MyNumberSystem.
def +(other).
if other.kind_of?(MyNumberSystem).
result = some_calculation_between_self_and_other.
MyNumberSystem.new(result).
else.
n1, n2 = other.coerce(self).
n1 + n2.
end.
end.
End.
Метод coerce возвращает массив из двух элементов: аргумент и вызывающий объект, приведенные к совместимым типам.
В примере выше мы полагались на то, что класс аргумента умеет как-то выполнять приведение. Будь мы законопослушными гражданами, реализовали бы приведение и в собственном классе, чтобы он мог работать с числами других видов. Для этого нужно знать, с какими типами мы можем работать напрямую, и приводить объект к одному из этих типов, когда возникает необходимость. Если мы сами не знаем, как это сделать, следует спросить у родителя:
Def coerce(other).
if other.kind_of?(Float).
return other, self.to_f.
elsif other.kind_of?(Integer).
return other, self.to_i.
else.
super.
end.
End.
Конечно, чтобы этот пример работал, наш объект должен реализовывать методы to_i и to_f.
Метод coerce можно использовать для реализации автоматического преобразования строк в числа, как это делается в языке Perl:
Class String.
def coerce(n).
if self['.'].
[n, Float(self)].
else.
[n, Integer(self)].
end.
end.
End.
X = 1 + "23" # 24.
Y = 23 * "1.23" # 29.29.
Впрочем, поступать так необязательно. Однако мы настоятельно рекомендуем реализовывать метод coerce при разработке разного рода числовых классов.
11.1.14. Классы, содержащие только данные (Struct).
Иногда нужно просто сгруппировать взаимосвязанные данные, не определяя никакие специфические методы обработки. Можно для этого создать класс:
Class Address.
attr_accessor :street, :city, :state.
def initialize(street1, city, state).
@street, @city, @state = street, city, state.
end.
End.
Books = Address.new("411 Elm St", "Dallas", "TX").
Такое решение годится, но каждый раз прибегать к нему утомительно; к тому же здесь слишком много повторов. Тут-то и приходит на помощь встроенный класс Struct. Если вспомогательные методы типа attr_accessor определяют методы доступа к атрибутам, то Struct определяет целый класс, который может содержать только атрибуты. Такие классы называются структурными шаблонами.
Address = Struct.new("Address", :street, :city, :state).
Books = Address.new("411 Elm St", "Dallas", "TX").
Зачем передавать первым параметром конструктора имя создаваемой структуры и присваивать результат константе (в данном случае Address)?
При вызове Struct.new для создания нового структурного шаблона на самом деле создается новый класс внутри самого класса Struct. Этому классу присваивается имя, переданное первым параметром, а остальные параметры становятся именами его атрибутов. При желании к вновь созданному классу можно было бы получить доступ, указав пространство имен Struct:
Struct.new("Address", :street, :city, :state).
Books = Struct::Address.new("411 Elm St", "Dallas", "TX").
Создав структурный шаблон, вы вызываете его метод new для создания новых экземпляров данной конкретной структуры. Необязательно присваивать значения всем атрибутам в конструкторе. Опущенные атрибуты получат значение nil. После того как структура создана, к ее атрибутам можно обращаться с помощью обычного синтаксиса или указывая их имена в скобках в качестве индекса, как будто структура - это объект класса Hash. Более подробную информацию о классе Struct можно найти в любом справочном руководстве (например, на сайте ruby.doc.org).
Кстати, не рекомендуем создавать структуру с именем Tms, так как уже есть предопределенный класс Struct::Tms.
11.1.15. Замораживание объектов.
Иногда необходимо воспрепятствовать изменению объекта. Это позволяет сделать метод freeze (определенный в классе Object). По существу, он превращает объект в константу.
Попытка модифицировать замороженный объект приводит к исключению TypeError. В листинге 11.8 приведено два примера.
Листинг 11.8. Замораживание объекта.
Str = "Это тест. ".
Str.freeze.
Begin.
str << " He волнуйтесь." # Попытка модифицировать.
Rescue => err.
puts "#{err.class} #{err}".
End.
Arr = [1, 2, 3].
Arr.freeze.
Begin.
arr << 4 # Попытка модифицировать.
Rescue => err.
puts "#{err.class} #{err}".
End.
# Выводится:
# TypeError: can't modify frozen string.
# TypeError: can't modify frozen array.
Однако имейте в виду, что метод freeze применяется к ссылке на объект, а не к переменной! Это означает, что любая операция, приводящая к созданию нового объекта, завершится успешно. Иногда это противоречит интуиции. В примере ниже мы ожидаем, что операция += не выполнится, но все работает нормально. Дело в том, что присваивание — не вызов метода. Эта операция воздействует на переменные, а не на объекты, поэтому новый объект создается беспрепятственно. Старый объект по-прежнему заморожен, но переменная ссылается уже не на него.
Str = "counter-".
Str.freeze.
Str += "intuitive" # "counter-intuitive".
Arr = [8, 6, 7].
Arr.freeze.
Arr += [5, 3, 0, 9] # [8, 6, 7, 5, 3, 0, 9].
Почему так происходит? Предложение a += x семантически эквивалентно a = a + x. При вычислении выражения a + x создается новый объект, который затем присваивается переменной a! Все составные операторы присваивания работают подобным образом, равно как и другие методы. Всегда задавайте себе вопрос: «Что я делаю — создаю новый объект или модифицирую существующий?» И тогда поведение freeze не станет для вас сюрпризом.
Существует метод frozen?, который сообщает, заморожен ли данный объект.
Hash = { 1 => 1, 2 => 4, 3 => 9 }.
Hash.freeze.
Arr = hash.to_a.
Puts hash.frozen? # true.
Puts arr.frozen? # false.
Hash2 = hash.
Puts hash2.frozen? # true.
Как видите (на примере hash2), замораживается именно объект, а не переменная.
- 1.
- 2.
- 3.
- 4.
- 5.
- 6.
- 7.
- 8.
- 9.
- 10.
- 11.
- 12.
- 13.
- 14.
- 15.
- 16.
- 17.
- 18.
- 19.
- 20.
- 21.
- 22.
- 23.
- 24.
- 25.
- 26.
- 27.
- 28.
- 29.
- 30.
- 31.
- 32.
- 33.
- 34.
- 35.
- 36.
- 37.
- 38.
- 39.
- 40.
- 41.
- 42.
- 43.
- 44.
- 45.
- 46.
- 47.
- 48.
- 49.
- 50.
- 51.
- 52.
- 53.
- 54.
- 55.
- 56.
- 57.
- 58.
- 59.
- 60.
- 61.
- 62.
- 63.
- 64.
- 65.
- 66.
- 67.
- 68.
- 69.
- 70.
- 71.
- 72.
- 73.
- 74.
- 75.
- 76.
- 77.
- 78.
- 79.
- 80.
- 81.
- 82.
- 83.
- 84.
- 85.
- 86.
- 87.
- 88.
- 89.
- 90.
- 91.
- 92.
- 93.
- 94.
- 95.
- 96.
- 97.
- 98.
- 99.
- 100.
- 101.
- 102.
- 103.
- 104.
- 105.
- 106.
- 107.
- 108.
- 109.
- 110.
- 111.
- 112.
- 113.
- 114.
- 115.
- 116.
- 117.
- 118.
- 119.
- 120.
- 121.
- 122.
- 123.
- 124.
- 125.
- 126.
- 127.
- 128.
- 129.
- 130.
- 131.
- 132.
- 133.
- 134.
- 135.
- 136.
- 137.
- 138.
- 139.
- 140.
- 141.
- 142.
- 143.
- 144.
- 145.
- 146.
- 147.
- 148.
- 149.
- 150.
- 151.
- 152.
- 153.
- 154.
- 155.
- 156.
- 157.
- 158.
- 159.
- 160.
- 161.
- 162.
- 163.
- 164.
- 165.
- 166.
- 167.
- 168.
- 169.
- 170.
- 171.
- 172.
- 173.
- 174.
- 175.
- 176.
- 177.
- 178.
- 179.
- 180.
- 181.
- 182.
- 183.
- 184.
- 185.
- 186.
- 187.
- 188.
- 189.
- 190.
- 191.
- 192.
- 193.
- 194.
- 195.
- 196.
- 197.
- 198.
- 199.
- 200.
- 201.
- 202.
- 203.
- 204.
- 205.
- 206.
- 207.
- 208.
- 209.
- 210.
- 211.
- 212.
- 213.
- 214.
- 215.
- 216.
- 217.
- 218.
- 219.
- 220.
- 221.
- 222.
- 223.
- 224.
- 225.
- 226.
- 227.
- 228.
- 229.
- 230.
- 231.
- 232.
- 233.
- 234.
- 235.
- 236.
- 237.
- 238.
- 239.
- 240.
- 241.
- 242.
- 243.
- 244.
- 245.
- 246.
- 247.
- 248.
- 249.
- 250.
- 251.
- 252.
- 253.
- 254.
- 255.
- 256.
- 257.
- 258.
- 259.
- 260.
- 261.
- 262.
- 263.
- 264.
- 265.
- 266.
- 267.
- 268.
- 269.
- 270.
- 271.
- 272.
- 273.
- 274.
- 275.
- 276.
- 277.
- 278.
- 279.
- 280.
- 281.
- 282.
- 283.
- 284.
- 285.
- 286.
- 287.
- 288.
- 289.
- 290.
- 291.
- 292.
- 293.
- 294.
- 295.
- 296.
- 297.
- 298.
- 299.
- 300.
- 301.
- 302.
- 303.
- 304.
- 305.
- 306.
- 307.
- 308.
- 309.
- 310.
- 311.
- 312.
- 313.
- 314.
- 315.
- 316.
- 317.
- 318.
- 319.
- 320.
- 321.
- 322.
- 323.
- 324.
- 325.
- 326.
- 327.
- 328.
- 329.
- 330.
- 331.
- 332.
- 333.
- 334.
- 335.
- 336.
- 337.
- 338.
- 339.
- 340.
- 341.
- 342.
- 343.
- 344.
- 345.
- 346.
- 347.
- 348.
- 349.
- 350.
- 351.
- 352.
- 353.
- 354.
- 355.
- 356.
- 357.
- 358.
- 359.
- 360.
- 361.
- 362.
- 363.
- 364.
- 365.
- 366.
- 367.
- 368.
- 369.
- 370.
- 371.
- 372.
- 373.
- 374.
- 375.
- 376.
- 377.
- 378.
- 379.
- 380.
- 381.
- 382.
- 383.
- 384.
- 385.
- 386.
- 387.
- 388.
- 389.
- 390.
- 391.
- 392.
- 393.
- 394.
- 395.
- 396.
- 397.
- 398.
- 399.
- 400.
- 401.
- 402.
- 403.
- 404.
- 405.
- 406.
- 407.
- 408.
- 409.
- 410.
- 411.
- 412.
- 413.
- 414.
- 415.
- 416.
- 417.
- 418.
- 419.
- 420.
- 421.
- 422.
- 423.
- 424.
- 425.
- 426.
- 427.
- 428.
- 429.
- 430.
- 431.
- 432.
- 433.
- 434.
- 435.
- 436.
- 437.
- 438.
- 439.
- 440.
- 441.
- 442.
- 443.
- 444.
- 445.
- 446.
- 447.
- 448.
- 449.
- 450.
- 451.
- 452.
- 453.
- 454.
- 455.
- 456.
- 457.
- 458.
- 459.
- 460.
- 461.
- 462.
- 463.
- 464.
- 465.
- 466.
- 467.
- 468.
- 469.
- 470.
- 471.
- 472.
- 473.
- 474.
- 475.
- 476.
- 477.
- 478.
- 479.
- 480.
- 481.
- 482.
- 483.
- 484.
- 485.
- 486.
- 487.
- 488.
- 489.
- 490.
- 491.
- 492.
- 493.
- 494.
- 495.
- 496.
- 497.
- 498.
- 499.
- 500.
- 501.
- 502.
- 503.
- 504.
- 505.
- 506.
- 507.
- 508.
- 509.
- 510.
- 511.
- 512.
- 513.
- 514.
- 515.
- 516.
- 517.
- 518.
- 519.
- 520.
- 521.
- 522.
- 523.
- 524.
- 525.
- 526.
- 527.
- 528.
- 529.
- 530.
- 531.
- 532.
- 533.
- 534.
- 535.
- 536.
- 537.
- 538.
- 539.
- 540.
- 541.
- 542.
- 543.
- 544.
- 545.
- 546.
- 547.
- 548.
- 549.
- 550.
- 551.
- 552.
- 553.
- 554.
- 555.
- 556.
- 557.
- 558.
- 559.
- 560.
- 561.
- 562.
- 563.
- 564.
- 565.
- 566.
- 567.
- 568.
- 569.
- 570.
- 571.
- 572.
- 573.