/[cvs]/nfo/perl/libs/Data/Mungle/Transform/Deep.pm
ViewVC logotype

Diff of /nfo/perl/libs/Data/Mungle/Transform/Deep.pm

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.5 by joko, Mon Dec 16 19:57:54 2002 UTC revision 1.21 by joko, Wed Apr 9 07:21:56 2003 UTC
# Line 1  Line 1 
1  ##############################################  ## ---------------------------------------------------------------------------
2  #  ##  $Id$
3  #  $Id$  ## ---------------------------------------------------------------------------
4  #  ##  $Log$
5  #  $Log$  ##  Revision 1.21  2003/04/09 07:21:56  joko
6  #  Revision 1.5  2002/12/16 19:57:54  joko  ##  childObj2string now inside Encode.pm, renamed to 'twingle_reference'
7  #  + option 'init'  ##
8  #  ##  Revision 1.20  2003/04/04 17:31:23  joko
9  #  Revision 1.4  2002/12/05 13:56:49  joko  ##  minor update to 'childObj2string'
10  #  - var_deref  ##
11  #  + expand - more sophisticated dereferencing with callbacks using Iterate  ##  Revision 1.19  2003/03/28 03:11:25  jonen
12  #  ##  + bugfix
13  #  Revision 1.3  2002/12/03 05:34:55  joko  ##
14  #  + bugfix: now utilizing var_utf2iso from Data::Transform::Encode  ##  Revision 1.18  2003/03/28 03:07:26  jonen
15  #  ##  + minor changes
16  #  Revision 1.2  2002/12/01 04:44:07  joko  ##
17  #  + code from Data::Transform::OO  ##  Revision 1.17  2003/03/27 15:17:07  joko
18  #  ##  namespace fixes for Data::Mungle::*
19  #  Revision 1.1  2002/11/29 04:49:20  joko  ##
20  #  + initial check-in  ##  Revision 1.16  2003/03/27 15:04:52  joko
21  #  ##  minor update: comment
22  #  Revision 1.1  2002/10/10 03:26:00  cvsjoko  ##
23  #  + new  ##  Revision 1.15  2003/02/27 14:39:48  jonen
24  #  ##  + fixed bug at _hash2object()
25  ##############################################  ##
26    ##  Revision 1.14  2003/02/22 17:13:55  jonen
27    ##  + added function 'childObject2string()' to encode 'child'-references to option related string
28    ##  + use new option at 'expand()' for replacing 'childObject2string'
29    ##
30    ##  Revision 1.13  2003/02/21 01:48:50  joko
31    ##  renamed core function
32    ##
33    ##  Revision 1.12  2003/02/20 22:45:19  joko
34    ##  fix regarding new deep_copy
35    ##
36    ##  Revision 1.11  2003/02/20 21:13:54  joko
37    ##  - removed implementation of deep_copy2 - get this from the Pitonyak namespace (now cloned to repository)
38    ##
39    ##  Revision 1.10  2003/02/20 20:48:00  joko
40    ##  - refactored lots of code to Data::Code::Ref
41    ##  + alternative 'deep_copy' implementation
42    ##
43    ##  Revision 1.9  2003/02/18 19:35:56  joko
44    ##  +- modified 'sub refexpr2perlref': now can get the $delimiter passed, too
45    ##
46    ##  Revision 1.8  2003/02/09 05:10:56  joko
47    ##  + minor update
48    ##
49    ##  Revision 1.7  2003/01/19 03:26:59  joko
50    ##  + added 'sub deep_copy'  -  refactored from libp
51    ##  + add 'sub merge'  -  exported from CPAN's 'Hash::Merge'
52    ##
53    ##  Revision 1.6  2002/12/23 11:27:53  jonen
54    ##  + changed behavior WATCH!
55    ##
56    ##  Revision 1.5  2002/12/16 19:57:54  joko
57    ##  + option 'init'
58    ##
59    ##  Revision 1.4  2002/12/05 13:56:49  joko
60    ##  - var_deref
61    ##  + expand - more sophisticated dereferencing with callbacks using Iterate
62    ##
63    ##  Revision 1.3  2002/12/03 05:34:55  joko
64    ##  + bugfix: now utilizing var_utf2iso from Data::Transform::Encode
65    ##
66    ##  Revision 1.2  2002/12/01 04:44:07  joko
67    ##  + code from Data::Transform::OO
68    ##
69    ##  Revision 1.1  2002/11/29 04:49:20  joko
70    ##  + initial check-in
71    ##
72    ##  Revision 1.1  2002/10/10 03:26:00  cvsjoko
73    ##  + new
74    ## ---------------------------------------------------------------------------
75    
76    
77  package Data::Transform::Deep;  package Data::Mungle::Transform::Deep;
78    
79  use strict;  use strict;
80  use warnings;  use warnings;
# Line 33  use warnings; Line 82  use warnings;
82  require Exporter;  require Exporter;
83  our @ISA = qw( Exporter );  our @ISA = qw( Exporter );
84  our @EXPORT_OK = qw(  our @EXPORT_OK = qw(
   &var_NumericalHashToArray  
   &var_mixin  
   &object2hash  
   &hash2object  
   &refexpr2perlref  
85    &expand    &expand
86      &deep_copy
87      &merge_to
88  );  );
89  #  &var_deref  
 #  &getStructSlotByStringyAddress  
90    
91  use attributes;  use attributes;
92  use Data::Dumper;  use Data::Dumper;
 use Data::Transform::Encode qw( var_utf2iso var2utf8 scalar2utf8 );  
 use libp qw( deep_copy );  
93  use Iterate;  use Iterate;
94    
95  sub var_NumericalHashToArray {  use Pitonyak::DeepCopy;
96    use Data::Mungle::Transform::Encode qw( latin_to_utf8 latin_to_utf8_scalar utf8_to_latin utf8_to_latin_scalar twingle_reference );
97    use Data::Mungle::Code::Ref qw( ref_slot );
98    
99    sub numhash2list {
100    my $vref = shift;    my $vref = shift;
101    #my $context = shift;    #my $context = shift;
102    if (ref $vref eq 'HASH') {    if (ref $vref eq 'HASH') {
# Line 65  sub var_NumericalHashToArray { Line 112  sub var_NumericalHashToArray {
112                }                }
113                $vref->{$_} = \@arr;                $vref->{$_} = \@arr;
114              }              }
115              var_NumericalHashToArray($vref->{$_});              numhash2list($vref->{$_});
116            }            }
117  #      } else {  #      } else {
118  #        #$vref->{$_} = scalar2iso($vref->{$_});  #        #$vref->{$_} = scalar2iso($vref->{$_});
# Line 75  sub var_NumericalHashToArray { Line 122  sub var_NumericalHashToArray {
122  }  }
123    
124    
125  sub var_deref {  # FIXME: could this be refactored using expand?
126    # btw: "expand": look at scripts@CPAN (System Administration):
127    # there is a perl make with perl
128    sub _var_deref_test {
129    my $obj = shift;    my $obj = shift;
130    my $options = shift;    my $options = shift;
131    my $result;    my $result;
# Line 114  sub var_deref { Line 164  sub var_deref {
164  }  }
165    
166    
167    # convert values in hash to utf8 (and back) to be ready for (e.g.) encapsulation in XML
168    # but still using the known latin locale stuff
169  sub expand {  sub expand {
170    
171    my $obj = shift;    my $obj = shift;
172    my $options = shift;    my $options = shift;
173    my $result;    my $result;
174    
175    if ((ref $obj) eq 'ARRAY') {    #print "ref: ", ref $obj, "\n";
176    
177      if (ref $obj eq 'ARRAY') {
178    
179      IterArray @$obj, sub {      IterArray @$obj, sub {
180        my $item;        my $item;
181        # if current item is a reference ...        # if current item is a reference ...
182        if (ref $_[0]) {        if (ref $_[0]) {
183          # ... expand structure recursively          $item = $_[0];
184          $item = expand($_[0], $options);          # if $options->{childObj2string} is TRUE or STRING don't expand referenced object,
185            # instead replace it by per option choosed string (default: o_<classname>_<ref type>_<guid> )
186            if ($item && $options->{childObj2string}) {
187              $item = twingle_reference($item);
188            } else {
189              # ... expand structure recursively
190              $item = expand($_[0], $options);
191            }
192          # destroy item via seperate callback method (a POST) if requested          # destroy item via seperate callback method (a POST) if requested
193          #$options->{cb}->{destroy}->($_[0]) if $options->{destroy};          #$options->{cb}->{destroy}->($_[0]) if $options->{destroy};
194    
# Line 136  sub expand { Line 197  sub expand {
197          #$item = deep_copy($_[0]);          #$item = deep_copy($_[0]);
198          $item = $_[0];          $item = $_[0];
199          # conversions/encodings          # conversions/encodings
200          $item = scalar2utf8($item) if ($item && $options->{utf8});          $item = latin_to_utf8_scalar($item) if ($item && $options->{utf8});
201            $item = utf8_to_latin_scalar($item) if ($item && $options->{to_latin});
202        }        }
203        #push(@{$result}, $item) if $item;   # use item only if not undef  (TODO: make configurable via $options)        #push(@{$result}, $item) if $item;   # use item only if not undef  (TODO: make configurable via $options)
204        push(@{$result}, $item);                 # use item in any case        push(@{$result}, $item);                 # use item in any case
205    
206      }      }
207    
208      } elsif (ref $obj eq 'CODE') {
209        #print Dumper($obj);
210        #exit;
211    
212    # TODO: "} elsif (ref $obj eq 'HASH') { [...] } else { croak 'could not deref blah'; }"  ???    # TODO: "} elsif (ref $obj eq 'HASH') { [...] } else { croak 'could not deref blah'; }"  ???
213    } else {    } elsif (ref $obj) {
214    
215      IterHash %$obj, sub {      IterHash %$obj, sub {
216        my $item;        my $item;
217                
218        # if current item is a reference ...        # if current item is a reference ...
219        if (ref $_[1]) {        if (ref $_[1]) {
220          # ... expand structure recursively          $item = $_[1];
221          $item = expand($_[1], $options);          # if $options->{childObj2string} is TRUE or STRING don't expand referenced object,
222            # instead replace it by per option choosed string (default: o_<classname>_<ref type>_<guid> )
223            if ($item && $options->{childObj2string} && !(ref $_[1] eq "ARRAY") && !(ref $_[1] eq "HASH")) {
224              $item = twingle_reference($item);
225            } else {
226              # ... expand structure recursively
227              $item = expand($_[1], $options);
228            }
229          # destroy item via seperate callback method (a POST) if requested          # destroy item via seperate callback method (a POST) if requested
230          #$options->{cb}->{destroy}->($_[1]) if $options->{destroy};          #$options->{cb}->{destroy}->($_[1]) if $options->{destroy};
231                
# Line 161  sub expand { Line 234  sub expand {
234          #$item = deep_copy($_[1]);          #$item = deep_copy($_[1]);
235          $item = $_[1];          $item = $_[1];
236          # conversions/encodings          # conversions/encodings
237          $item = scalar2utf8($item) if ($item && $options->{utf8});          $item = latin_to_utf8_scalar($item) if ($item && $options->{utf8});
238            $item = utf8_to_latin_scalar($item) if ($item && $options->{to_latin});
239        }        }
240        #$result->{$_[0]} = $item if $item;   # use item only if not undef  (TODO: make configurable via $options)        #$result->{$_[0]} = $item if $item;   # use item only if not undef  (TODO: make configurable via $options)
241        $result->{$_[0]} = $item;               # use item in any case        $result->{$_[0]} = $item;               # use item in any case
242      }      }
243    
244      } else {
245        #die ("not a reference!");
246        $result = $obj;
247    
248    }    }
249    
250    # convert all values to utf8 (inside complex struct)    # convert all values to utf8 (inside complex struct)
251      # now done in core-item-callbacks via Greg London's "Iterate" from CPAN      # now done in core-item-callbacks via Greg London's "Iterate" from CPAN
252      # var2utf8($result) if ($options->{utf8});      # latin_to_utf8($result) if ($options->{utf8});
253    
254    # destroy persistent object from memory to be sure to get a fresh one next time    # destroy persistent object from memory to be sure to get a fresh one next time
255    #undef $obj if $options->{destroy};    #undef $obj if $options->{destroy};
# Line 184  sub expand { Line 262  sub expand {
262    
263    
264  my @indexstack;  my @indexstack;
265  sub var_traverse_mixin_update {  sub _var_traverse_mixin_update_old {
266    my $obj = shift;    my $obj = shift;
267    my $data = shift;    my $data = shift;
268    my $bool_recursion = shift;    my $bool_recursion = shift;
# Line 228  sub var_traverse_mixin_update { Line 306  sub var_traverse_mixin_update {
306    #return $result;    #return $result;
307  }  }
308    
309  sub object2hash {  sub merge_to {
310    my $object = shift;    _hash2object(@_);
311    my $options = shift;    # TODO:
312    #my $deref = var_deref($object);    # re-implement using CPAN's "Iterate" and/or a modified Hash::Merge.
   my $deref = expand($object, $options);  
   #var2utf8($deref) if ($options->{utf8});  
   return $deref;  
313  }  }
314    
315    
316  # todo: maybe do diff(s) here sometimes!?  # todo: maybe do diff(s) here sometimes!?
317  sub hash2object {  sub _hash2object {
318    my $object = shift;    my $object = shift;
319    my $data = shift;    my $data = shift;
320    my $options = shift;    my $options = shift;
# Line 247  sub hash2object { Line 323  sub hash2object {
323        
324    # "patch" needed 'cause php passes numerical-indexed-arrays as hash-tables,    # "patch" needed 'cause php passes numerical-indexed-arrays as hash-tables,
325    # this method corrects this    # this method corrects this
326    var_NumericalHashToArray($data) if ($options->{php});    numhash2list($data) if ($options->{php});
327    
328    # utf8-conversion/-encoding (essential for I18N)    # utf8-conversion/-encoding (essential for I18N)
329    var_utf2iso($data) if ($options->{utf8});    utf8_to_latin($data) if ($options->{utf8});
330    
331    # get fresh object from database    # get fresh object from database
332    # todo:    # todo:
# Line 259  sub hash2object { Line 335  sub hash2object {
335    #my $obj = $self->getObject($oid);    #my $obj = $self->getObject($oid);
336    
337    # mix changes into fresh object and save it back    # mix changes into fresh object and save it back
338    hash2object_traverse_mixin($object, $data, 0, $options);    _hash2object_traverse_mixin($object, $data, 0, $options);
339    
340    # done in core mixin function?    # done in core mixin function?
341    #$self->{storage}->update($obj);    #$self->{storage}->update($obj);
# Line 282  sub hash2object { Line 358  sub hash2object {
358  #my @indexstack;  #my @indexstack;
359    
360  # traverse a deeply nested structure, mix in values from given hash, update underlying tangram-object  # traverse a deeply nested structure, mix in values from given hash, update underlying tangram-object
361  sub hash2object_traverse_mixin {  sub _hash2object_traverse_mixin {
362    my $object = shift;    my $object = shift;
363    my $data = shift;    my $data = shift;
364    my $bool_recursion = shift;    my $bool_recursion = shift;
# Line 300  sub hash2object_traverse_mixin { Line 376  sub hash2object_traverse_mixin {
376    # what's exactly done here? hmmm.... it works ;)    # what's exactly done here? hmmm.... it works ;)
377    # maybe a HACK: please try not to use "IntrHash"es, maybe this cannot handle them!!!    # maybe a HACK: please try not to use "IntrHash"es, maybe this cannot handle them!!!
378    # extend! check!    # extend! check!
379    if ((attributes::reftype($object) eq 'HASH') && (ref($object) ne 'HASH') && (ref($object) ne 'ARRAY')) {    
380      #print attributes::reftype($object), "\n";
381      
382      # V1
383      #if ((attributes::reftype($object) eq 'HASH') && (ref($object) ne 'HASH') && (ref($object) ne 'ARRAY')) {
384      # V2
385      my $reftype = attributes::reftype($object);
386      #print "reftype: '$reftype'", "\n";
387      if ($reftype eq 'HASH') {
388    
389  #    print STDERR "===", "reftype: ", attributes::reftype($obj), "\n";  #    print STDERR "===", "reftype: ", attributes::reftype($obj), "\n";
390                    
# Line 310  sub hash2object_traverse_mixin { Line 394  sub hash2object_traverse_mixin {
394    
395      # loop through fields of to.be.injected-data (arbitrary Perl-data-structure)      # loop through fields of to.be.injected-data (arbitrary Perl-data-structure)
396      @fields = keys %{$data} if $options->{init};      @fields = keys %{$data} if $options->{init};
397    #    @fields = keys %{$data} if $options->{mixin};
398            
399      foreach (@fields) {      foreach (@fields) {
400        push @indexstack, $_;        my $field = $_;
401          push @indexstack, $field;
402                            
403        # determine type of object        # determine type of object
404        my $ref = ref $object->{$_};        my $ref = ref $object->{$field};
405  #      print STDERR "attrname: $_  ATTRref: $ref", "\n";  #      print STDERR "attrname: $_  ATTRref: $ref", "\n";
406        if ($ref) {        if ($ref) {
407          hash2object_traverse_mixin($object->{$_}, $data, 1, $options);          _hash2object_traverse_mixin($object->{$field}, $data, 1, $options);
408        } else {        } else {
409          my $val = getStructSlotByStringyAddress($data, \@indexstack);          my $val = ref_slot($data, \@indexstack);
410          $object->{$_} = $val;                  
411    #print Dumper($options);
412            my $field_target = $field;
413            if (my $pattern = $options->{pattern_strip_key}) {
414              print "pattern: $pattern", "\n";
415              $field_target =~ s/$pattern//;
416              print "field: $field_target", "\n";
417            }
418    
419            $object->{$field_target} = $val if defined $val;
420        }        }
421        pop @indexstack;        pop @indexstack;
422      }      }
# Line 352  sub hash2object_traverse_mixin { Line 447  sub hash2object_traverse_mixin {
447        push @indexstack, $i;        push @indexstack, $i;
448        my $ref = ref $_;        my $ref = ref $_;
449  #      print STDERR "attrname: $_  ATTRref: $ref", "\n";  #      print STDERR "attrname: $_  ATTRref: $ref", "\n";
450        if ($ref && $_) {  #      if ($ref && $_) {
451          hash2object_traverse_mixin($_, $data, 1, $options);        if ($ref) {
452            _hash2object_traverse_mixin($_, $data, 1, $options);
453        } else {        } else {
454          $object->[$i] = $_;          $object->[$i] = $_ if defined $_;
455        }        }
456        pop @indexstack;        pop @indexstack;
457        $i++;        $i++;
458      }      }
459    
460    =pod
461      # object?
462      } else {
463        print "reference: ", ref $object, "\n";
464        print "reftype: ", $reftype, "\n";
465        die(__PACKAGE__ . "->_hash2object_traverse_mixin: can not handle this!");
466    =cut
467      
468    }    }
469    
470  }  }
471    
472    
473  # this function seems to do similar stuff like these below (refexpr2perlref & co.)  # ACK's go to Randal L. Schwartz <merlyn@stonehenge.com>
474  # TODO: maybe this mechanism can be replaced completely through some nice module from CPAN .... ?   ;-)  # on the website:
475  sub getStructSlotByStringyAddress {  # This text is copyright by Miller-Freeman, Inc., and is used with their permission.
476    my $var = shift;  # Further distribution or use is not permitted.
477    my $indexstack_ref = shift;  # please visit http://www.stonehenge.com/merlyn/UnixReview/col30.html
478    my @indexstack = @{$indexstack_ref};  sub deep_copy1 {
479    my $joiner = '->';    my $this = shift;
480    my @evlist;    if (not ref $this) {
481    foreach (@indexstack) {      $this;
482      my $elem;    } elsif (ref $this eq "ARRAY") {
483      if ($_ =~ m/\d+/) { $elem = "[$_]"; }      [map deep_copy1($_), @$this];
484      if ($_ =~ m/\D+/) { $elem = "{$_}"; }    } elsif (ref $this eq "HASH") {
485      push @evlist, $elem;      +{map { $_ => deep_copy1($this->{$_}) } keys %$this};
486    }    } elsif (ref $this eq "CODE") {
487    my $evstring = join($joiner, @evlist);      $this;
488    $evstring = 'return $var->' . $evstring . ';';    } else { die "deep_copy1 asks: what type is $this?" }
489    #print "ev: $evstring\n";    #} else { print "deep_copy asks: what type is $this?", "\n"; }
   return eval($evstring);  
490  }  }
491    
492    # ACK's go to Andrew Pitonyak
493  sub refexpr2perlref {  # Copyright 2002, Andrew Pitonyak (perlboy@pitonyak.org)
494    # please visit: http://www.pitonyak.org/code/perl/Pitonyak/DeepCopy.pm.html
495    my $obj = shift;  sub deep_copy {
496    my $expr = shift;    Pitonyak::DeepCopy::deep_copy(@_);
   my $callbackMap = shift;  
   
   my $value;  
   # detect for callback (code-reference)  
   if (ref($expr) eq 'CODE') {  
     $value = &$expr($obj);  
   
   } elsif ($expr =~ m/->/) {  
     # use expr as complex object reference declaration (obj->subObj->subSubObj->0->attribute)  
     (my $objPerlRefString, my $parts) = refexpr2perlref_parts($expr);  
     #print "\n", "expr: $expr";  
     #print "\n", "objPerlRefString: $objPerlRefString";  
     $value = eval('$obj' . '->' . $objPerlRefString);  
       
     # if value isn't set, try to "fallback" to callbackMap  
     # callbacks are applied this way:  
     #   take the last element of the expression parts and check if this string exists as a key in the callback-map  
     if (!$value && $callbackMap) {  
       #print Dumper($callbackMap);  
         
       # prepare needle  
       my @parts = @$parts;  
       my $count = $#parts;  
       my $needle = $parts[$count];  
   
       # prepare haystack  
       my @haystack = keys %$callbackMap;  
       if (grep($needle, @haystack)) {  
         $value = $callbackMap->{$needle}->();  
         #print "value: ", $value, "\n";  
       }  
     }  
   
   } else {  
     # use expr as simple scalar key (attributename)  
     $value = $obj->{$expr};  
   }  
             
   return $value;  
     
497  }  }
498    
499    
 sub refexpr2perlref_parts {  
   my $expr = shift;  
   
   # split expression by dereference operators first  
   my @parts_pure = split(/->/, $expr);  
   
   # wrap []'s around each part, if it consists of numeric characters only (=> numeric = array-index),  
   # use {}'s, if there are word-characters in it (=> alphanumeric = hash-key)  
   my @parts_capsule = @parts_pure;  
   map {  
     m/^\d+$/ && ($_ = "[$_]") || ($_ = "{$_}");  
   } @parts_capsule;  
   
   # join parts with dereference operators together again and return built string  
   return (join('->', @parts_capsule), \@parts_pure);  
 }  
   
500  1;  1;
501    __END__
Legend:
Removed from v.1.5  
changed lines
  Added in v.1.21
MailToCvsAdmin">MailToCvsAdmin
 ViewVC Help
Powered by ViewVC 1.1.26 RSS 2.0 feed