Mercurial > pub > Impl
annotate Lib/IMPL/Class/Meta.pm @ 315:77df11605d3a
code cleanup
author | cin |
---|---|
date | Tue, 07 May 2013 02:19:24 +0400 |
parents | c6d0f889ef87 |
children | 7c784144d2f1 |
rev | line source |
---|---|
49 | 1 package IMPL::Class::Meta; |
2 use strict; | |
3 | |
279 | 4 use Carp qw(carp confess); |
173 | 5 use IMPL::clone qw(clone); |
90 | 6 |
49 | 7 my %class_meta; |
90 | 8 my %class_data; |
49 | 9 |
209 | 10 sub SetMeta { |
49 | 11 my ($class,$meta_data) = @_; |
279 | 12 $class = ref $class || $class; |
49 | 13 |
180 | 14 # тут нельзя использовать стандартное исключение, поскольку для него используется |
15 # класс IMPL::Object::Accessor, который наследуется от текущего класса | |
279 | 16 confess "The meta_data parameter should be an object" if not ref $meta_data; |
49 | 17 |
18 push @{$class_meta{$class}{ref $meta_data}},$meta_data; | |
19 } | |
20 | |
209 | 21 sub set_meta { |
22 goto &SetMeta; | |
23 } | |
24 | |
25 sub GetMeta { | |
49 | 26 my ($class,$meta_class,$predicate,$deep) = @_; |
27 $class = ref $class if ref $class; | |
28 no strict 'refs'; | |
29 my @result; | |
30 | |
31 if ($deep) { | |
280 | 32 @result = map { $_->can('GetMeta') ? $_->GetMeta($meta_class,$predicate,$deep) : () } @{$class.'::ISA'}; |
49 | 33 } |
34 | |
35 if ($predicate) { | |
36 push @result,grep( &$predicate($_), map( @{$class_meta{$class}{$_}}, grep( $_->isa($meta_class), keys %{$class_meta{$class} || {}} ) ) ); | |
37 } else { | |
38 push @result, map( @{$class_meta{$class}{$_} || []}, grep( $_->isa($meta_class), keys %{$class_meta{$class} || {}} ) ); | |
39 } | |
40 wantarray ? @result : \@result; | |
41 } | |
42 | |
209 | 43 sub get_meta { |
44 goto &GetMeta; | |
45 } | |
46 | |
90 | 47 sub class_data { |
194 | 48 my $class = shift; |
49 $class = ref $class || $class; | |
50 | |
209 | 51 carp 'The method is obsolete, use static_accessor($name,$value,\'clone\') instead'; |
52 | |
194 | 53 if (@_ > 1) { |
54 my ($name,$value) = @_; | |
55 return $class_data{$class}{$name} = $value; | |
56 } else { | |
57 my ($name) = @_; | |
58 | |
59 if( exists $class_data{$class}{$name} ) { | |
60 $class_data{$class}{$name}; | |
61 } else { | |
62 if ( my $value = $class->_find_class_data($name) ) { | |
63 $class_data{$class}{$name} = clone($value); | |
64 } else { | |
65 undef; | |
66 } | |
67 } | |
68 } | |
90 | 69 } |
70 | |
163 | 71 sub static_accessor { |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
72 my ($class,$name,$value,$inherit) = @_; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
73 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
74 $inherit ||= 'inherit'; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
75 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
76 my $method = "static_accessor_$inherit"; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
77 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
78 return $class->$method($name,$value); |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
79 } |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
80 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
81 sub static_accessor_clone { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
82 my ($class,$name,$value) = @_; |
194 | 83 $class = ref $class || $class; |
84 | |
85 no strict 'refs'; | |
86 | |
87 *{"${class}::${name}"} = sub { | |
209 | 88 my $self = shift; |
89 | |
230 | 90 $self = ref $self || $self; |
91 | |
209 | 92 if (@_ > 0) { |
194 | 93 if ($class ne $self) { |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
94 $self->static_accessor_clone( $name => $_[0] ); # define own class data |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
95 } else { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
96 $value = $_[0]; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
97 } |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
98 } else { |
230 | 99 return $self ne $class |
100 ? $self->static_accessor_clone($name => clone($value)) | |
101 : $value; | |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
102 } |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
103 }; |
230 | 104 return $value; |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
105 }; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
106 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
107 sub static_accessor_inherit { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
108 my ($class,$name,$value) = @_; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
109 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
110 no strict 'refs'; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
111 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
112 *{"${class}::$name"} = sub { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
113 my $self = shift; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
114 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
115 if (@_ > 0) { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
116 $self = ref $self || $self; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
117 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
118 if ($class ne $self) { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
119 $self->static_accessor_inherit( $name => $_[0] ); # define own class data |
194 | 120 } else { |
121 $value = $_[0]; | |
122 } | |
123 } else { | |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
124 $value ; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
125 } |
230 | 126 }; |
127 return $value; | |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
128 } |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
129 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
130 sub static_accessor_own { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
131 my ($class,$name,$value) = @_; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
132 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
133 no strict 'refs'; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
134 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
135 *{"${class}::$name"} = sub { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
136 my $self = shift; |
263 | 137 $self = ref $self || $self; |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
138 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
139 if ($class ne $self) { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
140 if (@_ > 0) { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
141 $self->static_accessor_own( $name => $_[0] ); # define own class data |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
142 } else { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
143 return; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
144 } |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
145 } else { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
146 if ( @_ > 0 ) { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
147 $value = $_[0]; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
148 } else { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
149 return $value; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
150 } |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
151 } |
230 | 152 }; |
153 | |
154 return $value; | |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
155 } |
163 | 156 |
90 | 157 sub _find_class_data { |
194 | 158 my ($class,$name) = @_; |
159 | |
160 no strict 'refs'; | |
161 | |
162 exists $class_data{$_}{$name} and return $class_data{$_}{$name} foreach @{"${class}::ISA"}; | |
163 | |
164 my $val; | |
165 $val = $_->can('_find_class_data') ? $_->_find_class_data($name) : undef and return $val foreach @{"${class}::ISA"}; | |
90 | 166 } |
49 | 167 |
168 1; | |
90 | 169 |
170 __END__ | |
171 | |
172 =pod | |
173 | |
174 =head1 NAME | |
175 | |
180 | 176 C<IMPL::Class::Meta> - информация хранимая на уровне класса. |
90 | 177 |
178 =head1 SYNOPSIS | |
179 | |
180 =begin code | |
181 | |
182 package InfoMeta; | |
183 | |
165 | 184 use parent qw(IMPL::Object IMPL::Object::Autofill); |
90 | 185 use IMPL::Class::Property; |
186 | |
187 __PACKAGE__->PassThroughArgs; | |
188 | |
189 BEGIN { | |
194 | 190 public property name => prop_get | owner_set; |
90 | 191 } |
192 | |
193 package InfoExMeta; | |
165 | 194 use parent qw(InfoMeta); |
90 | 195 |
196 __PACKAGE__->PassThroughArgs; | |
197 | |
198 BEGIN { | |
194 | 199 public property description => prop_all; |
90 | 200 } |
201 | |
202 package Foo; | |
203 | |
204 __PACKAGE__->set_meta(new InfoMeta(name => 'info')); | |
205 __PACKAGE__->set_meta(new InfoExMeta(name => 'infoEx', description => 'extended info' )); | |
206 | |
207 package main; | |
208 | |
209 # get all InfoMeta, InfoExMeta will be included, becouse it's derived from InfoMeta | |
210 my @info = Foo->get_meta('InfoMeta'); # will get two objects, 'info' and 'infoEx'; | |
211 | |
212 # get all InfoExMeta meta | |
213 @info = Foo->get_meta('InfoExMeta'); # will get only 'infoEx' | |
214 | |
215 # get filtered meta | |
216 @info = Foo->get_meta('InfoMeta', sub { $_->name eq 'info'} ); # will get only 'info' | |
217 | |
218 =end code | |
219 | |
220 =head1 DESCRIPTION | |
221 | |
180 | 222 Позвоялет расширять информацию о типах (класса) при помощи метаданных, метаданными являются любые объекты, |
223 притом выборка метаданных приоизводится по их типу (классу), что позволяет выбрать все однотипные метаданные. | |
90 | 224 |
180 | 225 Существует возможность выборки метаданных с учетом унаследованных от базовых классов |
90 | 226 |
227 =head1 MEMBERS | |
228 | |
209 | 229 =head2 C<set_meta($meta_data)> |
90 | 230 |
180 | 231 Добавляет метаданные C<$meta_data> к классу. |
90 | 232 |
209 | 233 =head2 C<get_meta($meta_class,$predicate,$deep)> |
90 | 234 |
180 | 235 Выбирает метаданные типа C<$meta_class> и его наследников, с возможностью фильтрации и получения |
236 метаданных базовых классов. | |
90 | 237 |
238 =over | |
239 | |
240 =item C<$meta_class> | |
241 | |
180 | 242 Тип метаданных |
90 | 243 |
244 =item C<$predicate> | |
245 | |
180 | 246 Подпрограмма, которая будет вызываться для каждых найденных метаданных и на основе результата |
247 ее выполнения метаданные будут включены в результат или нет. Получеат в качестве параметра | |
248 объект с метаданными, возвращает C<true> - включить метаданные в результа, C<false> - пропустить | |
249 метаданные как не подходящие. Также переменная C<$_> ссылается на текущий объект с метаданными. | |
90 | 250 |
251 =begin code | |
252 | |
253 my @info = Foo->get_meta( | |
194 | 254 'InfoMeta', |
255 sub { ref $_ eq 'InfoMeta'}, # exclude subclasses ('InfoExMeta') | |
256 1 # deep search | |
90 | 257 ); |
258 | |
259 my @info = Foo->get_meta( | |
194 | 260 'InfoMeta', |
261 sub { | |
262 my $item = shift; | |
263 ref $item eq 'InfoMeta' # exclude subclasses ('InfoExMeta') | |
264 }, | |
265 1 # deep search | |
90 | 266 ); |
267 | |
268 =end code | |
269 | |
270 =item C<$deep> | |
271 | |
180 | 272 Осуществлять поиск по базовым классам. |
90 | 273 |
274 =back | |
275 | |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
276 =head2 C<static_accessor($name[,$value[,$inherit]])> |
163 | 277 |
180 | 278 Создает статическое свойство с именем C<$name> и начальным значением C<$value>. |
163 | 279 |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
280 Параметр C<$inherit> контролирует то, как наследуются значения. |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
281 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
282 =over |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
283 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
284 =item * C<inherit> |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
285 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
286 По умолчанию. Означает, что если для класса не определено значение, оно будет |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
287 получено от родителя. |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
288 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
289 =item * C<clone> |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
290 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
291 Если для класса не определено значение, то оно будет клонировано из |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
292 родительского значения при первом обращении. Полезно, когда родитель задает |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
293 значение по-умолчанию, которое разделяется между несколькими потомками, |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
294 которые модифицирю само значение (например значением является ссылка на хеш, |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
295 а потомки добавляют или меняют значения в этом хеше). |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
296 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
297 =item * C<own> |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
298 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
299 Каждый класс имеет свое собственное значение не зависящее от того, что было |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
300 у предка. Начальное значение для этого статического свойства C<undef>. |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
301 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
302 =back |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
303 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
304 Данный метод является заглушкой, он передает управление |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
305 C<static_accessor_inherit>, C<static_accessor_clone>, C<static_accessor_own> |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
306 соответственно. Эти методы можно вызывать явно |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
307 C<static_accessor_*($name[,$value])>. |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
308 |
163 | 309 |
310 =begin code | |
311 | |
312 package Foo; | |
165 | 313 use parent qw(IMPL::Class::Meta); |
163 | 314 |
315 __PACKAGE__->static_accessor( info => { version => 1 } ); | |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
316 __PACKAGE__->static_accessor( mappings => { toString => \&ToString }, 'clone' ); |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
317 __PACKAGE__->static_accessor( _instance => undef, 'own' ); |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
318 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
319 sub ToString { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
320 "[object Foo]"; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
321 } |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
322 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
323 sub default { |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
324 my ($self) = @_; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
325 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
326 $self = ref $self || $self; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
327 return $self->_instance ? $self->_instance : $self->_instance($self->new()); |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
328 } |
163 | 329 |
330 package Bar; | |
165 | 331 use parent qw(Foo); |
163 | 332 |
229
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
333 __PACKAGE__->info({language => 'English', version => 2}); # will define own 'info' but will loose original data. |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
334 __PACKAGE__->mappings->{sayHello} = \&SayHello; # will not affect Foo->mappings; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
335 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
336 package main; |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
337 |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
338 my $foo = Foo->default; # will be a Foo object |
47f77e6409f7
heavily reworked the resource model of the web application:
sergey
parents:
209
diff
changeset
|
339 my $bar = Bar->default; # will be a Bar object |
163 | 340 |
341 =end code | |
90 | 342 |
343 =cut |