|
49
|
1 package IMPL::Class::Meta;
|
|
|
2 use strict;
|
|
|
3
|
|
90
|
4 use Storable qw(dclone);
|
|
|
5
|
|
49
|
6 my %class_meta;
|
|
90
|
7 my %class_data;
|
|
49
|
8
|
|
|
9 sub set_meta {
|
|
|
10 my ($class,$meta_data) = @_;
|
|
|
11 $class = ref $class if ref $class;
|
|
|
12
|
|
|
13 # тут нельзя использовать стандартное исключение, поскольку для него используется
|
|
|
14 # класс IMPL::Object::Accessor, который наследуется от текущего класса
|
|
|
15 die "The meta_data parameter should be an object" if not ref $meta_data;
|
|
|
16
|
|
|
17 push @{$class_meta{$class}{ref $meta_data}},$meta_data;
|
|
|
18 }
|
|
|
19
|
|
|
20 sub get_meta {
|
|
|
21 my ($class,$meta_class,$predicate,$deep) = @_;
|
|
|
22 $class = ref $class if ref $class;
|
|
|
23 no strict 'refs';
|
|
|
24 my @result;
|
|
|
25
|
|
|
26 if ($deep) {
|
|
|
27 @result = map { $_->can('get_meta') ? $_->get_meta($meta_class,$predicate,$deep) : () } @{$class.'::ISA'};
|
|
|
28 }
|
|
|
29
|
|
|
30 if ($predicate) {
|
|
|
31 push @result,grep( &$predicate($_), map( @{$class_meta{$class}{$_}}, grep( $_->isa($meta_class), keys %{$class_meta{$class} || {}} ) ) );
|
|
|
32 } else {
|
|
|
33 push @result, map( @{$class_meta{$class}{$_} || []}, grep( $_->isa($meta_class), keys %{$class_meta{$class} || {}} ) );
|
|
|
34 }
|
|
|
35 wantarray ? @result : \@result;
|
|
|
36 }
|
|
|
37
|
|
90
|
38 sub class_data {
|
|
|
39 my $class = shift;
|
|
|
40 $class = ref $class || $class;
|
|
|
41
|
|
|
42 if (@_ > 1) {
|
|
|
43 my ($name,$value) = @_;
|
|
|
44 return $class_data{$class}{$name} = $value;
|
|
|
45 } else {
|
|
|
46 my ($name) = @_;
|
|
|
47
|
|
|
48 if( exists $class_data{$class}{$name} ) {
|
|
|
49 $class_data{$class}{$name};
|
|
|
50 } else {
|
|
|
51 if ( my $value = $class->_find_class_data($name) ) {
|
|
|
52 $class_data{$class}{$name} = dclone($value);
|
|
|
53 } else {
|
|
|
54 undef;
|
|
|
55 }
|
|
|
56 }
|
|
|
57 }
|
|
|
58 }
|
|
|
59
|
|
|
60 sub _find_class_data {
|
|
|
61 my ($class,$name) = @_;
|
|
|
62
|
|
|
63 no strict 'refs';
|
|
|
64
|
|
|
65 exists $class_data{$_}{$name} and return $class_data{$_}{$name} foreach @{"${class}::ISA"};
|
|
|
66
|
|
|
67 my $val;
|
|
153
|
68 $val = $_->can('_find_class_data') ? $_->_find_class_data($name) : undef and return $val foreach @{"${class}::ISA"};
|
|
90
|
69 }
|
|
49
|
70
|
|
|
71 1;
|
|
90
|
72
|
|
|
73 __END__
|
|
|
74
|
|
|
75 =pod
|
|
|
76
|
|
|
77 =head1 NAME
|
|
|
78
|
|
|
79 C<IMPL::Class::Meta> - информация хранимая на уровне класса.
|
|
|
80
|
|
|
81 =head1 SYNOPSIS
|
|
|
82
|
|
|
83 =begin code
|
|
|
84
|
|
|
85 package InfoMeta;
|
|
|
86
|
|
|
87 use base qw(IMPL::Object IMPL::Object::Autofill);
|
|
|
88 use IMPL::Class::Property;
|
|
|
89
|
|
|
90 __PACKAGE__->PassThroughArgs;
|
|
|
91
|
|
|
92 BEGIN {
|
|
|
93 public property name => prop_get | owner_set;
|
|
|
94 }
|
|
|
95
|
|
|
96 package InfoExMeta;
|
|
|
97 use base qw(InfoMeta);
|
|
|
98
|
|
|
99 __PACKAGE__->PassThroughArgs;
|
|
|
100
|
|
|
101 BEGIN {
|
|
|
102 public property description => prop_all;
|
|
|
103 }
|
|
|
104
|
|
|
105 package Foo;
|
|
|
106
|
|
|
107 __PACKAGE__->set_meta(new InfoMeta(name => 'info'));
|
|
|
108 __PACKAGE__->set_meta(new InfoExMeta(name => 'infoEx', description => 'extended info' ));
|
|
|
109
|
|
|
110 package main;
|
|
|
111
|
|
|
112 # get all InfoMeta, InfoExMeta will be included, becouse it's derived from InfoMeta
|
|
|
113 my @info = Foo->get_meta('InfoMeta'); # will get two objects, 'info' and 'infoEx';
|
|
|
114
|
|
|
115 # get all InfoExMeta meta
|
|
|
116 @info = Foo->get_meta('InfoExMeta'); # will get only 'infoEx'
|
|
|
117
|
|
|
118 # get filtered meta
|
|
|
119 @info = Foo->get_meta('InfoMeta', sub { $_->name eq 'info'} ); # will get only 'info'
|
|
|
120
|
|
|
121 =end code
|
|
|
122
|
|
|
123 =head1 DESCRIPTION
|
|
|
124
|
|
|
125 Позвоялет расширять информацию о типах (класса) при помощи метаданных, метаданными являются любые объекты,
|
|
|
126 притом выборка метаданных приоизводится по их типу (классу), что позволяет выбрать все однотипные метаданные.
|
|
|
127
|
|
|
128 Существует возможность выборки метаданных с учетом унаследованных от базовых классов
|
|
|
129
|
|
|
130 =head1 MEMBERS
|
|
|
131
|
|
|
132 =over
|
|
|
133
|
|
|
134 =item C<set_meta($meta_data)>
|
|
|
135
|
|
|
136 Добавляет метаданные C<$meta_data> к классу.
|
|
|
137
|
|
|
138 =item C<get_meta($meta_class,$predicate,$deep)>
|
|
|
139
|
|
|
140 Выбирает метаданные типа C<$meta_class> и его наследников, с возможностью фильтрации и получения
|
|
|
141 метаданных базовых классов.
|
|
|
142
|
|
|
143 =over
|
|
|
144
|
|
|
145 =item C<$meta_class>
|
|
|
146
|
|
|
147 Тип метаданных
|
|
|
148
|
|
|
149 =item C<$predicate>
|
|
|
150
|
|
|
151 Подпрограмма, которая будет вызываться для каждых найденных метаданных и на основе результата
|
|
|
152 ее выполнения метаданные будут включены в результат или нет. Получеат в качестве параметра
|
|
|
153 объект с метаданными, возвращает C<true> - включить метаданные в результа, C<false> - пропустить
|
|
|
154 метаданные как не подходящие. Также переменная C<$_> ссылается на текущий объект с метаданными.
|
|
|
155
|
|
|
156 =begin code
|
|
|
157
|
|
|
158 my @info = Foo->get_meta(
|
|
|
159 'InfoMeta',
|
|
|
160 sub { ref $_ eq 'InfoMeta'}, # exclude subclasses ('InfoExMeta')
|
|
|
161 1 # deep search
|
|
|
162 );
|
|
|
163
|
|
|
164 my @info = Foo->get_meta(
|
|
|
165 'InfoMeta',
|
|
|
166 sub {
|
|
|
167 my $item = shift;
|
|
|
168 ref $item eq 'InfoMeta' # exclude subclasses ('InfoExMeta')
|
|
|
169 },
|
|
|
170 1 # deep search
|
|
|
171 );
|
|
|
172
|
|
|
173 =end code
|
|
|
174
|
|
|
175 =item C<$deep>
|
|
|
176
|
|
|
177 Осуществлять поиск по базовым классам.
|
|
|
178
|
|
|
179 =back
|
|
|
180
|
|
|
181 =item C<class_data($name,$new_value)>
|
|
|
182
|
|
|
183 В отличии от метаданных, C<class_data> не накапливает информацию,
|
|
|
184 а хранит только один экземпляр для одного ключа C<$name>.
|
|
|
185
|
|
|
186 Если новое значение не задано, то осуществляется выборка сохраненного,
|
|
|
187 если текущий класс не имеет сохраненного значения, то оно ищется в базовых
|
|
|
188 классах, затем копия найденного значения сохраняется в текущем классе и
|
|
|
189 возвращается наружу. Это позволяет базовым классам задавать значение по-умолчанию,
|
|
|
190 которые могут быть изменены или заменены субклассами.
|
|
|
191
|
|
|
192 =begin code
|
|
|
193
|
|
|
194 package Foo;
|
|
|
195 use base qw(IMPL::Class::Meta);
|
|
|
196
|
|
|
197 __PACKAGE__->class_data( info => { version => 1 } ); # will be default for all subclasses
|
|
|
198
|
|
|
199 sub say_version {
|
|
|
200 my ($self) = @_;
|
|
|
201
|
|
111
|
202 print $self->class_data('info')->{version};
|
|
90
|
203 }
|
|
|
204
|
|
|
205 package Bar;
|
|
|
206 use base qw(Foo);
|
|
|
207
|
|
|
208 __PACKAGE__->class_data('info')->{ language } = 'English';
|
|
|
209
|
|
|
210 package main;
|
|
|
211
|
|
|
212 Foo->class_data('info')->{version} = 2;
|
|
|
213 Bar->say_version; # will print '1';
|
|
|
214 Foo->say_version; # will print '2';
|
|
|
215
|
|
|
216 =end code
|
|
|
217
|
|
|
218 =back
|
|
|
219
|
|
|
220 =cut
|
