home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / tsw / TSW_3.4.0.exe / Apache2 / perl / Builder.pod < prev    next >
Encoding:
Text File  |  2003-08-22  |  1.0 KB  |  43 lines
  1. =head1 NAME
  2.  
  3. XML::LibXML::SAX::Builder - Building DOM trees from SAX events.
  4.  
  5.  
  6. =head1 SYNOPSIS
  7.  
  8.   my $builder = XML::LibXML::SAX::Builder->new();
  9.   
  10.   my $gen = XML::Generator::DBI->new(Handler => $builder, dbh => $dbh);
  11.   $gen->execute("SELECT * FROM Users");
  12.   
  13.   my $doc = $builder->result();
  14.  
  15.  
  16. =head1 DESCRIPTION
  17.  
  18. This is a SAX handler that generates a DOM tree from SAX events. Usage is as
  19. above. Input is accepted from any SAX1 or SAX2 event generator.
  20.  
  21. Building DOM trees from SAX events is quite easy with
  22. XML::LibXML::SAX::Builder. The class is designed as a SAX2 final handler not as
  23. a filter!
  24.  
  25. Since SAX is strictly stream oriented, you should not expect anything to return
  26. from a generator. Instead you have to ask the builder instance directly to get
  27. the document built. XML::LibXML::SAX::Builder's result() function holds the
  28. document generated from the last SAX stream.
  29.  
  30. =head1 AUTHORS
  31.  
  32. Matt Sergeant, 
  33. Christian Glahn, 
  34. =head1 VERSION
  35.  
  36. 1.56
  37.  
  38. =head1 COPYRIGHT
  39.  
  40. 2001-2002, AxKit.com Ltd; 2001-2003 Christian Glahn, All rights reserved.
  41.  
  42. =cut
  43.