Mercurial > pub > Impl
annotate Lib/IMPL/DOM/Node.pm @ 108:c6fb6964de4c
Removed absolute modules
Updated DOM model, selectNodes can now select a complex path
Web DOM model release candidate
| author | wizard |
|---|---|
| date | Fri, 14 May 2010 16:06:06 +0400 |
| parents | 196bf443b5e1 |
| children | ddf0f037d460 |
| rev | line source |
|---|---|
| 49 | 1 package IMPL::DOM::Node; |
| 2 use strict; | |
| 3 use warnings; | |
| 4 | |
| 5 use base qw(IMPL::Object); | |
| 6 | |
| 7 use IMPL::Object::List; | |
| 8 use IMPL::Class::Property; | |
| 9 use IMPL::Class::Property::Direct; | |
| 10 use Scalar::Util qw(weaken); | |
| 11 | |
| 12 use IMPL::Exception; | |
| 13 | |
| 14 BEGIN { | |
| 15 public _direct property nodeName => prop_get; | |
| 16 public _direct property document => prop_get; | |
| 17 public _direct property isComplex => { get => \&_getIsComplex } ; | |
| 18 public _direct property nodeValue => prop_all; | |
| 102 | 19 public _direct property childNodes => { get => \&_getChildNodes }; # prop_list |
| 49 | 20 public _direct property parentNode => prop_get ; |
| 21 private _direct property _propertyMap => prop_all ; | |
| 22 } | |
| 23 | |
|
104
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
24 our %Axes = ( |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
25 parent => \&selectParent, |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
26 siblings => \&selectSiblings, |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
27 child => \&childNodes, |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
28 document => \&selectDocument |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
29 ); |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
30 |
| 49 | 31 sub CTOR { |
| 32 my ($this,%args) = @_; | |
| 33 | |
| 34 $this->{$nodeName} = delete $args{nodeName} or die new IMPL::InvalidArgumentException("A name is required"); | |
| 35 $this->{$nodeValue} = delete $args{nodeValue} if exists $args{nodeValue}; | |
| 36 if ( exists $args{document} ) { | |
| 37 $this->{$document} = delete $args{document}; | |
| 38 weaken($this->{$document}); | |
| 39 } | |
| 40 | |
| 41 $this->{$_propertyMap} = \%args; | |
| 42 } | |
| 43 | |
| 44 sub insertNode { | |
| 45 my ($this,$node,$pos) = @_; | |
| 46 | |
| 47 die new IMPL::InvalidOperationException("You can't insert the node to itselft") if $this == $node; | |
| 48 | |
| 49 $node->{$parentNode}->removeNode($node) if ($node->{$parentNode}); | |
| 50 | |
| 51 $this->childNodes->InsertAt($pos,$node); | |
| 52 | |
| 53 $node->_setParent( $this ); | |
| 54 | |
| 55 return $node; | |
| 56 } | |
| 57 | |
| 58 sub appendChild { | |
| 59 my ($this,$node) = @_; | |
| 60 | |
| 61 die new IMPL::InvalidOperationException("You can't insert the node to itselft") if $this == $node; | |
| 62 | |
| 63 $node->{$parentNode}->removeNode($node) if ($node->{$parentNode}); | |
| 64 | |
| 65 my $children = $this->childNodes; | |
| 66 $children->Append($node); | |
| 67 | |
| 68 $node->_setParent( $this ); | |
| 69 | |
| 70 return $node; | |
| 71 } | |
| 72 | |
| 73 sub appendNode { | |
| 74 goto &appendChild; | |
| 75 } | |
| 76 | |
| 77 sub appendRange { | |
| 78 my ($this,@range) = @_; | |
| 79 | |
| 80 die new IMPL::InvalidOperationException("You can't insert the node to itselft") if grep $_ == $this, @range; | |
| 81 | |
| 82 foreach my $node (@range) { | |
| 83 $node->{$parentNode}->removeNode($node) if ($node->{$parentNode}); | |
| 84 $node->_setParent( $this ); | |
| 85 } | |
| 86 | |
| 87 $this->childNodes->Append(@range); | |
| 88 | |
| 89 return $this; | |
| 90 } | |
| 91 | |
| 92 sub _getChildNodes { | |
| 93 my ($this) = @_; | |
| 94 | |
| 95 $this->{$childNodes} = new IMPL::Object::List() unless $this->{$childNodes}; | |
| 102 | 96 return wantarray ? @{ $this->{$childNodes} } : $this->{$childNodes}; |
| 49 | 97 } |
| 98 | |
| 99 sub removeNode { | |
| 100 my ($this,$node) = @_; | |
| 101 | |
| 102 if ($this == $node->{$parentNode}) { | |
| 103 $this->childNodes->RemoveItem($node); | |
| 104 $node->_setParent(undef); | |
| 105 return $node; | |
| 106 } else { | |
| 107 die new IMPL::InvalidOperationException("The specified node isn't belong to this node"); | |
| 108 } | |
| 109 } | |
| 110 | |
| 111 sub replaceNodeAt { | |
| 112 my ($this,$index,$node) = @_; | |
| 113 | |
| 114 my $nodeOld = $this->childNodes->[$index]; | |
| 115 | |
| 116 die new IMPL::InvalidOperationException("You can't insert the node to itselft") if $this == $node; | |
| 117 | |
| 118 # unlink node from previous parent | |
| 119 $node->{$parentNode}->removeNode($node) if ($node->{$parentNode}); | |
| 120 | |
| 121 # replace (or set) old node | |
| 122 $this->childNodes->[$index] = $node; | |
| 123 | |
| 124 # set new parent | |
| 125 $node->_setParent( $this ); | |
| 126 | |
| 127 # unlink old node if we have one | |
| 128 $nodeOld->_setParent(undef) if $nodeOld; | |
| 129 | |
| 130 # return old node | |
| 131 return $nodeOld; | |
| 132 } | |
| 133 | |
| 134 sub removeAt { | |
| 135 my ($this,$pos) = @_; | |
| 136 | |
| 137 if ( my $node = $this->childNodes->RemoveAt($pos) ) { | |
| 138 $node->_setParent(undef); | |
| 139 return $node; | |
| 140 } else { | |
| 141 return undef; | |
| 142 } | |
| 143 } | |
| 144 | |
| 145 sub removeLast { | |
| 146 my ($this) = @_; | |
| 147 | |
| 148 if ( my $node = $this->{$childNodes} ? $this->{$childNodes}->RemoveLast() : undef) { | |
| 149 $node->_setParent(undef); | |
| 150 return $node; | |
| 151 } else { | |
| 152 return undef; | |
| 153 } | |
| 154 } | |
| 155 | |
| 156 sub removeSelected { | |
| 157 my ($this,$query) = @_; | |
| 158 | |
| 159 my @newSet; | |
| 160 my @result; | |
| 161 | |
| 162 if (ref $query eq 'CODE') { | |
| 163 &$query($_) ? push @result, $_ : push @newSet, $_ foreach @{$this->childNodes}; | |
| 164 } elsif (defined $query) { | |
| 165 $_->nodeName eq $query ? push @result, $_ : push @newSet, $_ foreach @{$this->childNodes}; | |
| 166 } else { | |
| 167 my $children = $this->childNodes; | |
| 168 $_->_setParent(undef) foreach @$children; | |
| 169 delete $this->{$childNodes}; | |
| 170 return wantarray ? @$children : $children; | |
| 171 } | |
| 172 | |
| 173 $_->_setParent(undef) foreach @result; | |
| 174 | |
| 175 $this->{$childNodes} = @newSet ? bless \@newSet ,'IMPL::Object::List' : undef; | |
| 176 | |
| 177 return wantarray ? @result : \@result; | |
| 178 } | |
| 179 | |
|
104
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
180 sub resolveAxis { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
181 my ($this,$axis) = @_; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
182 return $Axes{$axis}->($this) |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
183 } |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
184 |
| 49 | 185 sub selectNodes { |
| 108 | 186 my $this = shift; |
| 187 my ($path) = @_; | |
| 188 | |
| 189 $path = ref $path eq 'ARRAY' ? $path : ( @_ == 1 ? $this->translatePath($path) : [@_]); | |
| 190 | |
| 191 my @set = ($this); | |
| 192 | |
| 193 while (my $query = shift @$path) { | |
| 194 @set = map $_->selectNodesAxis($query), @set; | |
| 195 } | |
| 196 | |
| 197 return wantarray ? @set : \@set; | |
| 198 } | |
| 199 | |
| 200 sub translatePath { | |
| 201 my ($this,$path) = @_; | |
| 202 | |
| 203 # TODO: Move path compilation here from IMPL::DOM::Schema::Validator::Compare | |
| 204 return [$path]; | |
| 205 } | |
| 206 | |
| 207 sub selectNodesAxis { | |
| 208 my ($this,$query,$axis) = @_; | |
|
104
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
209 |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
210 $axis ||= 'child'; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
211 |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
212 die new IMPL::InvalidOperationException('Unknown axis',$axis) unless exists $Axes{$axis}; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
213 |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
214 my $nodes = $this->resolveAxis($axis); |
| 49 | 215 |
| 216 my @result; | |
| 217 | |
| 218 if (ref $query eq 'CODE') { | |
|
104
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
219 @result = grep &$query($_), @{$nodes}; |
| 49 | 220 } elsif (ref $query eq 'ARRAY' ) { |
| 221 my %keys = map (($_,1),@$query); | |
|
104
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
222 @result = grep $keys{$_->nodeName}, @{$nodes}; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
223 } elsif (ref $query eq 'HASH') { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
224 while( my ($axis,$filter) = each %$query ) { |
| 108 | 225 push @result, $this->selectNodesAxis($filter,$axis); |
|
104
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
226 } |
| 49 | 227 } elsif (defined $query) { |
|
104
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
228 @result = grep $_->nodeName eq $query, @{$nodes}; |
| 49 | 229 } else { |
|
104
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
230 return wantarray ? @{$nodes} : $nodes; |
| 49 | 231 } |
| 232 | |
| 233 return wantarray ? @result : \@result; | |
| 234 } | |
| 235 | |
|
104
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
236 sub selectParent { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
237 my ($this) = @_; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
238 |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
239 if ($this->parentNode) { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
240 return wantarray ? $this->parentNode : [$this->parentNode]; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
241 } else { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
242 return wantarray ? () : []; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
243 } |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
244 } |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
245 |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
246 sub selectSiblings { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
247 my ($this) = @_; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
248 |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
249 if ($this->parentNode) { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
250 return $this->parentNode->selectNodes( sub { $_ != $this } ); |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
251 } else { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
252 return wantarray ? () : []; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
253 } |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
254 } |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
255 |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
256 sub selectDocument { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
257 my ($this) = @_; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
258 |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
259 if ($this->document) { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
260 return wantarray ? $this->document : [$this->document]; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
261 } else { |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
262 return wantarray ? () : []; |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
263 } |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
264 } |
|
196bf443b5e1
DOM::Schema RC0 inflators support, validation and some other things,
wizard
parents:
102
diff
changeset
|
265 |
| 49 | 266 sub firstChild { |
| 267 @_ >=2 ? $_[0]->replaceNodeAt(0,$_[1]) : $_[0]->childNodes->[0]; | |
| 268 } | |
| 269 | |
| 270 sub _getIsComplex { | |
| 271 $_[0]->childNodes->Count ? 1 : 0; | |
| 272 } | |
| 273 | |
| 274 sub _updateDocRefs { | |
| 275 my ($this) = @_; | |
| 276 | |
| 277 # this method is called by the parent node on his children, so we need no to check parent | |
| 278 $this->{$document} = $this->{$parentNode}->document; | |
| 279 | |
| 280 # prevent cyclic | |
| 281 weaken($this->{$document}) if $this->{$document}; | |
| 282 | |
| 283 $_->_updateDocRefs foreach @{$this->{$childNodes}}; | |
| 284 } | |
| 285 | |
| 286 sub _setParent { | |
| 287 my ($this,$node) = @_; | |
| 288 | |
| 289 | |
| 290 if (($node || 0) != ($this->{$parentNode} || 0)) { | |
| 291 my $newOwner; | |
| 292 if ($node) { | |
| 293 $this->{$parentNode} = $node; | |
| 294 $newOwner = $node->document || 0; | |
| 295 | |
| 296 # prevent from creating cyclicreferences | |
| 297 weaken($this->{$parentNode}); | |
| 298 | |
| 299 } else { | |
| 300 delete $this->{$parentNode}; | |
| 75 | 301 |
| 302 #keep document | |
| 303 $newOwner = $this->{$document}; | |
| 49 | 304 } |
| 305 | |
| 306 if (($this->{$document}||0) != $newOwner) { | |
| 307 $this->{$document} = $newOwner; | |
| 308 weaken($this->{$document}) if $newOwner; | |
| 309 $_->_updateDocRefs foreach @{$this->childNodes}; | |
| 310 } | |
| 311 } | |
| 312 } | |
| 313 | |
| 314 sub text { | |
| 315 my ($this) = @_; | |
| 316 | |
| 317 join ('', $this->nodeValue || '', map ($_->text || '', @{$this->childNodes})); | |
| 318 } | |
| 319 | |
| 320 sub nodeProperty { | |
| 321 my $this = shift; | |
| 322 my $name = shift; | |
| 323 | |
| 324 if (@_) { | |
| 325 # set | |
| 326 return $this->{$_propertyMap}{$name} = shift; | |
| 327 } else { | |
| 328 return $this->{$_propertyMap}{$name}; | |
| 329 } | |
| 330 } | |
| 331 | |
| 332 sub qname { | |
| 333 $_[0]->{$nodeName}; | |
| 334 } | |
| 335 | |
| 336 sub path { | |
| 337 my ($this) = @_; | |
| 338 | |
| 339 if ($this->parentNode) { | |
| 340 return $this->parentNode->path.'.'.$this->qname; | |
| 341 } else { | |
| 342 return $this->qname; | |
| 343 } | |
| 344 } | |
| 345 | |
| 346 1; | |
| 75 | 347 |
| 348 __END__ | |
| 349 | |
| 350 =pod | |
| 351 | |
| 352 =head1 NAME | |
| 353 | |
| 354 C<IMPL::DOM::Node> Элемент DOM модели | |
| 355 | |
| 356 =head1 DESCRIPTION | |
| 357 | |
| 358 Базовый узел DOM модели. От него можно наследовать другие элементы DOM модели. | |
| 359 | |
| 360 =head1 MEMBERS | |
| 361 | |
| 362 =head2 PROPERTIES | |
| 363 | |
| 364 =over | |
| 365 | |
| 366 =item C<[get] nodeName> | |
| 367 | |
| 368 Имя узла. Задается при создании. | |
| 369 | |
| 370 =item C<[get] document> | |
| 371 | |
| 372 Документ к которому принадлежит узел. Задается при поздании узла. | |
| 373 | |
| 374 =item C<[get] isComplex> | |
| 375 | |
| 376 Определяет является ли узел сложным (тоесть есть ли дети). | |
| 377 | |
| 378 C<true> - есть, C<false> - нет. | |
| 379 | |
| 380 =item C<[get,set] nodeValue> | |
| 381 | |
| 382 Значение узла, обычно простой скаляр, но ничто не мешает туда | |
| 383 устанавливать любое значение. | |
| 384 | |
| 385 =item C<[get,list] childNodes> | |
| 386 | |
| 387 Список детей, является списокм C<IMPL::Object::List>. | |
| 388 | |
| 389 =item C<[get] parentNode> | |
| 390 | |
| 391 Ссылка на родительский элемент, если таковой имеется. | |
| 392 | |
| 393 =head2 METHODS | |
| 394 | |
| 395 =cut |