7 |
# $Id$ |
# $Id$ |
8 |
# |
# |
9 |
# $Log$ |
# $Log$ |
10 |
|
# Revision 1.8 2003/06/06 04:01:52 joko |
11 |
|
# just write to STDERR in debug mode |
12 |
|
# |
13 |
|
# Revision 1.7 2003/05/13 09:32:22 joko |
14 |
|
# minor update to pod |
15 |
|
# |
16 |
|
# Revision 1.6 2003/05/07 03:11:28 joko |
17 |
|
# updated pod: new section "References", added item to "Todo" section |
18 |
|
# |
19 |
|
# Revision 1.5 2003/05/06 14:24:06 joko |
20 |
|
# doesn't use Carp any more |
21 |
|
# updated pod |
22 |
|
# attempt to rewrite xml to make it more human readable using helper modules from CPAN (node indentation, etc.) |
23 |
|
# |
24 |
# Revision 1.4 2003/05/01 23:40:32 joko |
# Revision 1.4 2003/05/01 23:40:32 joko |
25 |
# minor update: commented debugging part |
# minor update: commented debugging part |
26 |
# |
# |
39 |
|
|
40 |
=head1 NAME |
=head1 NAME |
41 |
|
|
42 |
XML::XUpdate::XSLT - A perl module for updating xml documents using XUpdate via XSLT. |
XML::XUpdate::XSLT - A perl module for updating xml documents using XUpdate via XSLT. |
43 |
|
|
44 |
|
|
45 |
=head3 Overview |
=head3 Overview |
51 |
xupdate - Process XUpdate commands against an XML document. |
xupdate - Process XUpdate commands against an XML document. |
52 |
|
|
53 |
|
|
54 |
=head3 Their implementations differ: |
=head4 Their implementations differ: |
55 |
|
|
56 |
1. xupdate (by Petr Pajas) uses ... |
1. xupdate (by Petr Pajas) uses ... |
57 |
XML::XUpdate::LibXML - Simple implementation of XUpdate format |
XML::XUpdate::LibXML - Simple implementation of XUpdate format |
66 |
2. This xupdate attempts to implement the XUpdate specs using XSLT only. |
2. This xupdate attempts to implement the XUpdate specs using XSLT only. |
67 |
|
|
68 |
|
|
69 |
=head3 Yet another xupdate - facts in short: |
=head4 Yet another xupdate - facts in short: |
70 |
|
|
71 |
S: It would be nice to have a pure perl thingy which does (almost) the same stuff.... |
S: It would be nice to have a pure perl thingy which does (almost) the same stuff.... |
72 |
|
|
77 |
|
|
78 |
Q: Can we mimic/use the interface of the - already established - 'xupdate' program??? |
Q: Can we mimic/use the interface of the - already established - 'xupdate' program??? |
79 |
|
|
80 |
Q: Should we follow the CRUD path first? (CRUD means: Create, Retrieve, Update, Delete) |
Q: Should we follow the CRUD path first? |
81 |
|
(CRUD is the acronym for the datastore action primitives: Create, Retrieve, Update, Delete) |
82 |
S?: Proposal: XML::XUpdate::XSLT::API uses XML::XUpdate::XSLT::CRUD |
S?: Proposal: XML::XUpdate::XSLT::API uses XML::XUpdate::XSLT::CRUD |
83 |
|
|
84 |
|
|
85 |
=head4 Todo |
=head3 References |
86 |
|
|
87 |
|
- XUpdate: |
88 |
|
Requirements: http://www.xmldb.org/xupdate/xupdate-req.html |
89 |
|
Working Draft: http://www.xmldb.org/xupdate/xupdate-wd.html |
90 |
|
- XML API: |
91 |
|
- XML::XUpdate::LibXML: http://search.cpan.org/author/PAJAS/XML-XUpdate-LibXML-0.4.0/lib/XML/XUpdate/LibXML.pm |
92 |
|
- XSL / XSLT: |
93 |
|
http://www.w3.org/TR/xslt |
94 |
|
http://www.xsl-rp.de/ |
95 |
|
http://xml.klute-thiemann.de/w3c-de/REC-xslt-20020318/ |
96 |
|
http://xmlxslt.sourceforge.net/ |
97 |
|
- misc pointers: |
98 |
|
"Re: Modify XML documents": http://aspn.activestate.com/ASPN/Mail/Message/perl-xml/1265431 |
99 |
|
XSL Extensions: http://xmlsoft.org/XSLT/extensions.html |
100 |
|
EXSLT: http://www.exslt.org/set/functions/difference/index.html |
101 |
|
"how to insert element at required position in document tree?": http://p2p.wrox.com/archive/xslt/2001-06/98.asp |
102 |
|
XML APIs for Databases: http://www.javaworld.com/javaworld/jw-01-2000/jw-01-dbxml.html |
103 |
|
|
104 |
|
|
105 |
|
=head3 Todo |
106 |
|
|
107 |
o What about proper encoding? (ISO-8859-1 or UTF-8) |
o What about proper encoding? (ISO-8859-1 or UTF-8) |
108 |
o Is it possible to create the required "xsl_template.xml" at runtime via XSL itself? |
o Is it possible to create the required "xsl_template.xml" at runtime via XSL itself? |
109 |
o Cache contents of external files (*.xml). Performance! |
o Cache contents of external files (*.xml). Performance! |
110 |
|
o Can exception / error-code handling be improved somehow? |
111 |
|
Esp.: It would be interesting, if the XUpdate payload actually could be applied, or not... |
112 |
|
o Conditional processing: <xupdate:if>, etc. |
113 |
|
|
114 |
|
|
115 |
=cut |
=cut |
122 |
use strict; |
use strict; |
123 |
use warnings; |
use warnings; |
124 |
|
|
|
use XML::XSLT 0.41; |
|
|
use Carp; |
|
|
use File::Basename; |
|
125 |
use Data::Dumper; |
use Data::Dumper; |
126 |
|
use File::Basename; |
127 |
|
use XML::XSLT 0.41; |
128 |
|
use XML::XUpdate::Rewrite; |
129 |
|
|
130 |
# Namespace constants |
# Namespace constants |
131 |
|
|
194 |
} |
} |
195 |
|
|
196 |
# First, translate the xupdate payload to xsl. |
# First, translate the xupdate payload to xsl. |
197 |
# FIXME: do DOM only! |
# FIXME: do DOM only! (don't use "->toString") |
198 |
sub _calculate { |
sub _calculate { |
199 |
my $self = shift; |
my $self = shift; |
200 |
$self->{XSLT_ENGINE_PREP} = XML::XSLT->new( |
$self->{XSLT_ENGINE_PREP} = XML::XSLT->new( |
213 |
my $self = shift; |
my $self = shift; |
214 |
|
|
215 |
# debug - print the calculated xsl on STDERR |
# debug - print the calculated xsl on STDERR |
216 |
#print STDERR $self->get_stylesheet("_worker"), "\n"; |
print STDERR $self->get_stylesheet("_worker"), "\n" if $self->{DEBUG}; |
217 |
|
|
218 |
#return; |
#return; |
219 |
$self->{XSLT_ENGINE_LIVE} = XML::XSLT->new( |
$self->{XSLT_ENGINE_LIVE} = XML::XSLT->new( |
228 |
|
|
229 |
sub toString { |
sub toString { |
230 |
my $self = shift; |
my $self = shift; |
231 |
return $self->{XML}->{result}; |
|
232 |
|
# use rest of argument list as hash of option values |
233 |
|
my $options = {@_}; |
234 |
|
|
235 |
|
# short circuit - just return what we have - don't modify anything |
236 |
|
return $self->{XML}->{result} unless $options and $options->{rewrite}; |
237 |
|
|
238 |
|
# Rewrite the xml document with certain engine to desired style. |
239 |
|
# 'engine' defaults to "XMLParser" if not specified. |
240 |
|
my $rewrite = XML::XUpdate::Rewrite->new( style => $options->{mode}, engine => $options->{using} ); |
241 |
|
$rewrite->set_document( $self->{XML}->{result} ); |
242 |
|
# TODO: Implement a configurable fallback here to return the un-rewritten payload if desired. |
243 |
|
$rewrite->process() or die(__PACKAGE__ . ": Error while rewriting XML document."); |
244 |
|
return $rewrite->get_document(); |
245 |
} |
} |
246 |
|
|
247 |
|
|
248 |
###################################################################### |
###################################################################### |
249 |
# AUXILIARY METHODS |
# AUXILIARY METHODS |
250 |
|
|
251 |
# Argument parsing (with backwards compatibility hook). |
# Argument list parsing. |
252 |
|
# ... from XML::XUpdate::LibXML (w/o backwards compatibility hook). |
253 |
|
# Could this make up a Class::AutoFill::__read_arglist which transparently |
254 |
|
# makes object attributes from constructor arguments in a configurable way? |
255 |
sub __parse_args { |
sub __parse_args { |
256 |
my $self = shift; |
my $self = shift; |
257 |
my %args; |
my %args; |
258 |
|
|
259 |
if(@_ % 2 ) { |
if ( @_ % 2 ) { |
260 |
$args{dummy} = shift; |
$args{dummy} = shift; |
261 |
%args = (%args, @_); |
%args = (%args, @_); |
262 |
} else { |
} else { |
282 |
if (! -e $filename) { |
if (! -e $filename) { |
283 |
$filename = dirname(__FILE__) . "/$filename"; |
$filename = dirname(__FILE__) . "/$filename"; |
284 |
if (! -e $filename) { |
if (! -e $filename) { |
285 |
croak("File $filename does not exist."); |
die("File $filename does not exist."); |
286 |
} |
} |
287 |
} |
} |
288 |
|
|