|
49
|
1 package IMPL::Object::EventSource;
|
|
|
2 use strict;
|
|
|
3 require IMPL::Exception;
|
|
|
4 use IMPL::Class::Property;
|
|
|
5
|
|
|
6 sub CreateEvent {
|
|
|
7 my ($class,$event) = @_;
|
|
|
8
|
|
|
9 die new IMPL::Exception('A name is required for the event') unless $event;
|
|
|
10
|
|
|
11 (my $fullEventName = "$class$event") =~ s/:://g;
|
|
|
12
|
|
|
13 my $globalEventTable = new IMPL::Object::EventSource::EventTable($fullEventName);
|
|
|
14 my $propEventTable = $event.'Table';
|
|
|
15 public CreateProperty($class,$propEventTable,prop_all);
|
|
|
16 public CreateProperty($class,$event,
|
|
|
17 {
|
|
|
18 get => sub {
|
|
|
19 my $this = shift;
|
|
|
20 if (not defined wantarray and caller(1) eq $class) {
|
|
|
21 (ref $this ? $this->$propEventTable() || $globalEventTable : $globalEventTable)->Invoke($this);
|
|
|
22 } else {
|
|
|
23 if (ref $this) {
|
|
|
24 if (my $table = $this->$propEventTable()) {
|
|
|
25 return $table;
|
|
|
26 } else {
|
|
|
27 $table = new IMPL::Object::EventSource::EventTable($fullEventName,$globalEventTable);
|
|
|
28 $this->$propEventTable($table);
|
|
|
29 return $table;
|
|
|
30 }
|
|
|
31 } else {
|
|
|
32 return $globalEventTable;
|
|
|
33 }
|
|
|
34 }
|
|
|
35 },
|
|
|
36 set => sub {
|
|
|
37 (ref $_[0] ? $_[0]->$propEventTable() || $globalEventTable : $globalEventTable)->Invoke(@_);
|
|
|
38 }
|
|
|
39 }
|
|
|
40 );
|
|
|
41 }
|
|
|
42
|
|
|
43 sub CreateStaticEvent {
|
|
|
44 my ($class,$event) = @_;
|
|
|
45
|
|
|
46 die new IMPL::Exception('A name is required for the event') unless $event;
|
|
|
47
|
|
|
48 (my $fullEventName = "$class$event") =~ s/:://g;
|
|
|
49
|
|
|
50 my $globalEventTable = new IMPL::Object::EventSource::EventTable($fullEventName);
|
|
|
51
|
|
|
52 no strict 'refs';
|
|
|
53 *{"${class}::$event"} = sub {
|
|
|
54 shift;
|
|
|
55 if (not @_) {
|
|
|
56 if (not defined wantarray and caller(1) eq $class) {
|
|
|
57 $globalEventTable->Invoke($class);
|
|
|
58 } else {
|
|
|
59 return $globalEventTable;
|
|
|
60 }
|
|
|
61 } else {
|
|
|
62 $globalEventTable->Invoke($class,@_);
|
|
|
63 }
|
|
|
64 };
|
|
|
65 }
|
|
|
66
|
|
|
67 package IMPL::Object::EventSource::EventTable;
|
|
166
|
68 use parent qw(IMPL::Object);
|
|
49
|
69 use IMPL::Class::Property;
|
|
|
70 use IMPL::Class::Property::Direct;
|
|
|
71 use Scalar::Util qw(weaken);
|
|
|
72
|
|
|
73 use overload
|
|
|
74 '+=' => \&opSubscribe,
|
|
|
75 'fallback' => 1;
|
|
|
76
|
|
|
77 BEGIN {
|
|
|
78 public _direct property Name => prop_get;
|
|
|
79 public _direct property Handlers => { get => \&get_handlers };
|
|
|
80 private _direct property Next => prop_all;
|
|
|
81 private _direct property NextId => prop_all;
|
|
|
82 }
|
|
|
83
|
|
|
84 sub CTOR {
|
|
|
85 my $this = shift;
|
|
|
86
|
|
|
87 $this->{$Handlers} = {};
|
|
|
88 $this->{$Name} = shift;
|
|
|
89 $this->{$Next} = shift;
|
|
|
90 $this->{$NextId} = 1;
|
|
|
91 }
|
|
|
92
|
|
|
93 sub get_handlers {
|
|
|
94 my $this = shift;
|
|
|
95 return values %{$this->{$Handlers}};
|
|
|
96 }
|
|
|
97
|
|
|
98 sub Invoke {
|
|
|
99 my $this = shift;
|
|
|
100
|
|
|
101 my $tmp;
|
|
|
102 $tmp = $_ and local($_) or &$tmp(@_) foreach values %{$this->{$Handlers}};
|
|
|
103
|
|
|
104 $this->{$Next}->Invoke(@_) if $this->{$Next};
|
|
|
105 }
|
|
|
106
|
|
|
107 sub Subscribe {
|
|
|
108 my ($this,$consumer,$nameHandler) = @_;
|
|
|
109
|
|
|
110 my $id = $this->{$NextId} ++;
|
|
|
111
|
|
|
112 if (ref $consumer eq 'CODE') {
|
|
|
113 $this->{$Handlers}{$id} = $consumer;
|
|
|
114 } else {
|
|
|
115 $nameHandler ||= $this->Name or die new IMPL::Exception('The name for the event handler method must be specified');
|
|
|
116 my $method = $consumer->can($nameHandler) or die new IMPL::Exception('Can\'t find the event handler method',$nameHandler,$consumer);
|
|
|
117
|
|
|
118 weaken($consumer) if ref $consumer;
|
|
|
119 $this->{$Handlers}{$id} = sub {
|
|
|
120 unshift @_, $consumer;
|
|
|
121 $consumer ? goto &$method : delete $this->{$Handlers}{$id};
|
|
|
122 };
|
|
|
123 }
|
|
|
124
|
|
|
125 return $id;
|
|
|
126 }
|
|
|
127
|
|
|
128 sub Remove {
|
|
|
129 my ($this,$id) = @_;
|
|
|
130 return delete $this->{$Handlers}{$id};
|
|
|
131 }
|
|
|
132 1;
|
|
|
133
|
|
|
134 __END__
|
|
|
135 =pod
|
|
|
136 =head1 SYNOPSIS
|
|
|
137 package Foo;
|
|
166
|
138 use parent qw(IMPL::Object IMPL::Object::EventSource);
|
|
49
|
139
|
|
|
140 # declare events
|
|
|
141 __PACKAGE__->CreateEvent('OnUpdate');
|
|
|
142 __PACKAGE__->CreateStaticEvent('OnNewObject');
|
|
|
143
|
|
|
144 sub CTOR {
|
|
|
145 my $this = shift;
|
|
|
146 // rise static event
|
|
|
147 $this->OnNewObject();
|
|
|
148 }
|
|
|
149
|
|
|
150 sub Update {
|
|
|
151 my ($this,$val) = @_;
|
|
|
152
|
|
|
153 // rise object event
|
|
|
154 $this->OnUpdate($val);
|
|
|
155 }
|
|
|
156
|
|
|
157 package Bar;
|
|
|
158
|
|
|
159 // subscribe static event
|
|
|
160 Foo->OnNewObject->Subscribe(sub { warn "New $_[0] created" } );
|
|
|
161
|
|
|
162 sub LookForFoo {
|
|
|
163 my ($this,$foo) = @_;
|
|
|
164
|
|
|
165 // subscribe object event
|
|
|
166 $foo->OnUpdate->Subscribe($this,'OnFooUpdate');
|
|
|
167 }
|
|
|
168
|
|
|
169 // event handler
|
|
|
170 sub OnFooUpdate {
|
|
|
171 my ($this,$sender,$value) = @_;
|
|
|
172 }
|
|
|
173
|
|
|
174 =head1 DESCRIPTION
|
|
|
175 Позволяет объявлять и инициировать события. События делятся на статические и
|
|
|
176 локальные. Статические события объявляются для класса и при возникновении
|
|
|
177 данного события вызываются всегда все подписчики. Статические события могут быть
|
|
|
178 вызваны как для класса, так и для объекта, что приведет к одинаковым результатам.
|
|
|
179
|
|
|
180 Локальные события состоят из статической (как статические события) и локальной
|
|
|
181 части. Если подписываться на события класса, то обработчики будут вызываться при
|
|
|
182 любых вариантах инициации данного события (как у статических событий). При
|
|
|
183 подписке на события объекта, обработчик будет вызван только при возникновении
|
|
|
184 событий у данного объекта.
|
|
|
185
|
|
|
186 =head1 METHODS
|
|
|
187 =level 4
|
|
|
188 =back
|
|
|
189
|
|
|
190 =head1 EventTable
|
|
|
191
|
|
|
192 =cut
|
