git.sesse.net Git - xml-template/blob - perl-sax/XML/TemplateSAX.pm

   1 #! /usr/bin/perl
   2
   3 #
   4 # SAX version of XML::Template. Advantages over DOM: Doesn't have to load
   5 # the entire thing into memory, and you can chain filters. Disadvantages:
   6 # Slightly kludgier interface.
   7 #
   8 # Differences from the DOM version:
   9 #
  10 # - There is no process(). Instead, it works as a SAX filter, so you put it
  11 #   in the stream, usually between a parser and a writer (ie.
  12 #   parser -> XML::TemplateSAX::Handler -> writer). process_file works as
  13 #   before, but it returns a _string_, not a DOM tree.
  14 # - You can no longer insert a DOM tree. Instead, what you have is -- FIXME:
  15 #   figure out this :-)
  16 #
  17
  18 use strict;
  19 use warnings;
  20 use XML::SAX::Expat;
  21 use XML::SAX::Writer;
  22 use XML::TemplateSAX::Buffer;
  23 use XML::TemplateSAX::Cleaner;
  24 use XML::TemplateSAX::Handler;
  25
  26 package XML::TemplateSAX;
  27
  28 sub process_file {
  29         my ($filename, $obj, $clean) = @_;
  30         $clean = 1 unless (defined($clean));
  31
  32         my ($writer, $cleaner, $filter, $parser);
  33         my $str = '';
  34
  35         # FIXME: hardcoding expat = not good?
  36         $writer = XML::SAX::Writer->new(Output => \$str);
  37
  38         if ($clean) {
  39                 $cleaner = XML::TemplateSAX::Cleaner->new(Handler => $writer, Content => $obj);
  40                 $filter = XML::TemplateSAX::Handler->new(Handler => $cleaner, Content => $obj);
  41         } else {
  42                 $filter = XML::TemplateSAX::Handler->new(Handler => $writer, Content => $obj);
  43         }
  44
  45         $parser = XML::SAX::Expat->new(Handler => $filter);
  46         $parser->parse_file($filename);
  47
  48         return $str;
  49 }
  50
  51 1;