класс Class
Расширяет любой Class, чтобы включить метод json_creatable?.
Классы в Ruby — это объекты первого класса — каждый является экземпляром класса Class.
Обычно вы создаёте новый класс, используя:
class Name # some code describing the class behavior end
Когда создаётся новый класс, инициализируется объект типа Class и присваивается глобальной константе (в данном случае Имя).
Когда вызывается Name.new для создания нового объекта, метод new в классе Class выполняется по умолчанию. Это можно продемонстрировать, переопределив new в классе Class:
class Class
alias old_new new
def new(*args)
print "Creating a new ", self.name, "\n"
old_new(*args)
end
end
class Name
end
n = Name.new
выводит:
Creating a new Name
Классы, модули и объекты взаимосвязаны. На следующей диаграмме вертикальные стрелки представляют наследование, а скобки — метаклассы. Все метаклассы являются экземплярами класса `Class`.
+---------+ +-...
| | |
BasicObject-----|-->(BasicObject)-------|-...
^ | ^ |
| | | |
Object---------|----->(Object)---------|-...
^ | ^ |
| | | |
+-------+ | +--------+ |
| | | | | |
| Module-|---------|--->(Module)-|-...
| ^ | | ^ |
| | | | | |
| Class-|---------|---->(Class)-|-...
| ^ | | ^ |
| +---+ | +----+
| |
obj--->OtherClass---------->(OtherClass)-----------... Публичные методы класса
static VALUE
rb_class_initialize(int argc, VALUE *argv, VALUE klass)
{
VALUE super;
if (RCLASS_SUPER(klass) != 0 || klass == rb_cBasicObject) {
rb_raise(rb_eTypeError, "already initialized class");
}
if (rb_check_arity(argc, 0, 1) == 0) {
super = rb_cObject;
}
else {
super = argv[0];
rb_check_inheritable(super);
if (super != rb_cBasicObject && !RCLASS_SUPER(super)) {
rb_raise(rb_eTypeError, "can't inherit uninitialized class");
}
}
RCLASS_SET_SUPER(klass, super);
rb_make_metaclass(klass, RBASIC(super)->klass);
rb_class_inherited(super, klass);
rb_mod_initialize(klass);
return klass;
} Создаёт новый анонимный (без имени) класс с заданным суперклассом (или Object, если параметр не задан). Вы можете дать классу имя, присвоив объект класса константе.
Если задан блок, он передаётся объекту класса, и блок вычисляется в контексте этого класса, как class_eval.
fred = Class.new do
def meth1
"hello"
end
def meth2
"bye"
end
end
a = fred.new #=> #<#<Class:0x100381890>:0x100376b98>
a.meth1 #=> "hello"
a.meth2 #=> "bye"
Присвойте классу константу (имя, начинающееся с заглавной буквы), если хотите рассматривать его как обычный класс.
Публичные методы экземпляра
static VALUE
rb_class_alloc_m(VALUE klass)
{
rb_alloc_func_t allocator = class_get_alloc_func(klass);
if (!rb_obj_respond_to(klass, rb_intern("allocate"), 1)) {
rb_raise(rb_eTypeError, "calling %"PRIsVALUE".allocate is prohibited",
klass);
}
return class_call_alloc_func(allocator, klass);
} Выделяет место для нового объекта класса класса class и не вызывает метод initialize для нового экземпляра. Возвращаемый объект должен быть экземпляром class.
klass = Class.new do
def initialize(*args)
@initialized = true
end
def initialized?
@initialized || false
end
end
klass.allocate.initialized? #=> false
# File ext/json/lib/json/common.rb, line 453 def json_creatable? respond_to?(:json_create) end
Возвращает true, если этот класс может использоваться для создания экземпляра из сериализованной JSON строки. Класс должен реализовывать метод класса json_create, который ожидает хеш в качестве первого параметра. Хеш должен содержать необходимые данные.
static VALUE
rb_class_s_new(int argc, const VALUE *argv, VALUE klass)
{
VALUE obj;
obj = rb_class_alloc(klass);
rb_obj_call_init_kw(obj, argc, argv, RB_PASS_CALLED_KEYWORDS);
return obj;
} Вызывает allocate для создания нового объекта класса класса class, а затем вызывает метод initialize этого объекта, передавая ему args. Это метод, который в конечном итоге вызывается всякий раз, когда объект создаётся с помощью .new.
VALUE
rb_class_superclass(VALUE klass)
{
VALUE super = RCLASS_SUPER(klass);
if (!super) {
if (klass == rb_cBasicObject) return Qnil;
rb_raise(rb_eTypeError, "uninitialized class");
}
while (RB_TYPE_P(super, T_ICLASS)) {
super = RCLASS_SUPER(super);
}
if (!super) {
return Qnil;
}
return super;
} Возвращает суперкласс class или nil.
File.superclass #=> IO IO.superclass #=> Object Object.superclass #=> BasicObject class Foo; end class Bar < Foo; end Bar.superclass #=> Foo
Возвращает nil, когда у данного класса нет родительского класса:
BasicObject.superclass #=> nil
Приватные методы экземпляра
static VALUE
rb_obj_dummy1(VALUE _x, VALUE _y)
{
return rb_obj_dummy();
} Обратный вызов, вызываемый всякий раз, когда создаётся подкласс текущего класса.
Пример:
class Foo
def self.inherited(subclass)
puts "New subclass: #{subclass}"
end
end
class Bar < Foo
end
class Baz < Bar
end
выводит:
New subclass: Bar New subclass: Baz
Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.