Commit | Line | Data |
0a1ec87a |
1 | package SQL::Translator::Parser::XML::SQLFairy; |
2 | |
3 | # ------------------------------------------------------------------- |
59b2ec83 |
4 | # $Id: SQLFairy.pm,v 1.5 2003-11-19 17:04:18 grommit Exp $ |
0a1ec87a |
5 | # ------------------------------------------------------------------- |
6 | # Copyright (C) 2003 Mark Addison <mark.addison@itn.co.uk>, |
7 | # |
8 | # This program is free software; you can redistribute it and/or |
9 | # modify it under the terms of the GNU General Public License as |
10 | # published by the Free Software Foundation; version 2. |
11 | # |
12 | # This program is distributed in the hope that it will be useful, but |
13 | # WITHOUT ANY WARRANTY; without even the implied warranty of |
14 | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
15 | # General Public License for more details. |
16 | # |
17 | # You should have received a copy of the GNU General Public License |
18 | # along with this program; if not, write to the Free Software |
19 | # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA |
20 | # 02111-1307 USA |
21 | # ------------------------------------------------------------------- |
22 | |
23 | =head1 NAME |
24 | |
25 | SQL::Translator::Parser::XML::SQLFairy - parser for SQL::Translator's XML |
26 | |
27 | =head1 SYNOPSIS |
28 | |
29 | use SQL::Translator; |
30 | use SQL::Translator::Parser::XML::SQLFairy; |
31 | |
32 | my $translator = SQL::Translator->new( |
33 | from => 'XML-SQLFairy', |
34 | to => 'MySQL', |
35 | filename => 'schema.xml', |
36 | show_warnings => 1, |
37 | add_drop_table => 1, |
38 | ); |
39 | |
40 | print $obj->translate; |
41 | |
42 | =head1 DESCRIPTION |
43 | |
44 | This parser handles the flavor of XML used natively by the SQLFairy |
45 | project (SQL::Translator). The XML must be in the namespace |
46 | "http://sqlfairy.sourceforge.net/sqlfairy.xml." |
47 | |
48 | To see an example of the XML translate one of your schema :) e.g. |
49 | |
e3910b4f |
50 | $ sqlt -f MySQL -t XML-SQLFairy schema.sql |
0a1ec87a |
51 | |
52 | =head2 attrib_values |
53 | |
a5e624ac |
54 | The parser will happily parse XML produced with the attrib_values arg |
55 | set. If it sees a value set as an attribute and a tag, the tag value |
56 | will override that of the attribute. |
0a1ec87a |
57 | |
58 | e.g. For the xml below the table would get the name 'bar'. |
59 | |
60 | <sqlf:table name="foo"> |
61 | <sqlf:name>foo</name> |
62 | </sqlf:table> |
63 | |
64 | =head2 default_value |
65 | |
a5e624ac |
66 | Leave the tag out all together to use the default in Schema::Field. |
67 | Use empty tags or EMPTY_STRING for a zero lenth string. NULL for an |
68 | explicit null (currently sets default_value to undef in the |
69 | Schema::Field obj). |
0a1ec87a |
70 | |
a5e624ac |
71 | <sqlf:default_value></sqlf:default_value> <!-- Empty string --> |
72 | <sqlf:default_value>EMPTY_STRING</sqlf:default_value> <!-- Empty string --> |
73 | <sqlf:default_value>NULL</sqlf:default_value> <!-- NULL --> |
0a1ec87a |
74 | |
a5e624ac |
75 | <sqlf:default_value/> <!-- Empty string BUT DON'T USE! See BUGS --> |
0a1ec87a |
76 | |
77 | =head2 ARGS |
78 | |
79 | Doesn't take any extra parser args at the moment. |
80 | |
81 | =cut |
82 | |
83 | # ------------------------------------------------------------------- |
84 | |
85 | use strict; |
86 | |
87 | use vars qw[ $DEBUG $VERSION @EXPORT_OK ]; |
59b2ec83 |
88 | $VERSION = sprintf "%d.%02d", q$Revision: 1.5 $ =~ /(\d+)\.(\d+)/; |
0a1ec87a |
89 | $DEBUG = 0 unless defined $DEBUG; |
90 | |
91 | use Data::Dumper; |
92 | use Exporter; |
93 | use base qw(Exporter); |
94 | @EXPORT_OK = qw(parse); |
95 | |
96 | use base qw/SQL::Translator::Parser/; # Doesnt do anything at the mo! |
a5e624ac |
97 | use SQL::Translator::Utils 'debug'; |
0a1ec87a |
98 | use XML::XPath; |
99 | use XML::XPath::XMLParser; |
100 | |
0a1ec87a |
101 | sub parse { |
102 | my ( $translator, $data ) = @_; |
a5e624ac |
103 | my $schema = $translator->schema; |
104 | local $DEBUG = $translator->debug; |
105 | my $xp = XML::XPath->new(xml => $data); |
0a1ec87a |
106 | |
0a1ec87a |
107 | $xp->set_namespace("sqlf", "http://sqlfairy.sourceforge.net/sqlfairy.xml"); |
108 | |
a5e624ac |
109 | # |
0a1ec87a |
110 | # Work our way through the tables |
111 | # |
112 | my @nodes = $xp->findnodes('/sqlf:schema/sqlf:table'); |
113 | for my $tblnode ( |
a5e624ac |
114 | sort { |
59b2ec83 |
115 | "".$xp->findvalue('sqlf:order|@order',$a) |
a5e624ac |
116 | <=> |
59b2ec83 |
117 | "".$xp->findvalue('sqlf:order|@order',$b) |
a5e624ac |
118 | } @nodes |
0a1ec87a |
119 | ) { |
120 | debug "Adding table:".$xp->findvalue('sqlf:name',$tblnode); |
a5e624ac |
121 | |
0a1ec87a |
122 | my $table = $schema->add_table( |
123 | get_tagfields($xp, $tblnode, "sqlf:" => qw/name order/) |
124 | ) or die $schema->error; |
125 | |
a5e624ac |
126 | # |
0a1ec87a |
127 | # Fields |
128 | # |
129 | my @nodes = $xp->findnodes('sqlf:fields/sqlf:field',$tblnode); |
130 | foreach ( |
a5e624ac |
131 | sort { |
132 | ("".$xp->findvalue('sqlf:order',$a) || 0) |
133 | <=> |
134 | ("".$xp->findvalue('sqlf:order',$b) || 0) |
135 | } @nodes |
0a1ec87a |
136 | ) { |
137 | my %fdata = get_tagfields($xp, $_, "sqlf:", |
a5e624ac |
138 | qw/name data_type size default_value is_nullable |
139 | is_auto_increment is_primary_key is_foreign_key comments/ |
140 | ); |
141 | |
142 | if ( |
143 | exists $fdata{'default_value'} and |
144 | defined $fdata{'default_value'} |
145 | ) { |
146 | if ( $fdata{'default_value'} =~ /^\s*NULL\s*$/ ) { |
147 | $fdata{'default_value'}= undef; |
0a1ec87a |
148 | } |
a5e624ac |
149 | elsif ( $fdata{'default_value'} =~ /^\s*EMPTY_STRING\s*$/ ) { |
150 | $fdata{'default_value'} = ""; |
0a1ec87a |
151 | } |
152 | } |
a5e624ac |
153 | |
19922fbc |
154 | my $field = $table->add_field( %fdata ) or die $table->error; |
a5e624ac |
155 | |
156 | $table->primary_key( $field->name ) if $fdata{'is_primary_key'}; |
157 | |
158 | # |
159 | # TODO: |
160 | # - We should be able to make the table obj spot this when |
161 | # we use add_field. |
162 | # - Deal with $field->extra |
163 | # |
0a1ec87a |
164 | } |
165 | |
a5e624ac |
166 | # |
0a1ec87a |
167 | # Constraints |
168 | # |
169 | @nodes = $xp->findnodes('sqlf:constraints/sqlf:constraint',$tblnode); |
170 | foreach (@nodes) { |
171 | my %data = get_tagfields($xp, $_, "sqlf:", |
a5e624ac |
172 | qw/name type table fields reference_fields reference_table |
173 | match_type on_delete_do on_update_do/ |
174 | ); |
19922fbc |
175 | $table->add_constraint( %data ) or die $table->error; |
0a1ec87a |
176 | } |
177 | |
a5e624ac |
178 | # |
0a1ec87a |
179 | # Indexes |
180 | # |
181 | @nodes = $xp->findnodes('sqlf:indices/sqlf:index',$tblnode); |
182 | foreach (@nodes) { |
183 | my %data = get_tagfields($xp, $_, "sqlf:", |
a5e624ac |
184 | qw/name type fields options/); |
19922fbc |
185 | $table->add_index( %data ) or die $table->error; |
0a1ec87a |
186 | } |
187 | |
188 | } # tables loop |
189 | |
19922fbc |
190 | # |
191 | # Views |
192 | # |
193 | @nodes = $xp->findnodes('/sqlf:schema/sqlf:view'); |
194 | foreach (@nodes) { |
195 | my %data = get_tagfields($xp, $_, "sqlf:", |
196 | qw/name sql fields order/ |
197 | ); |
198 | $schema->add_view( %data ) or die $schema->error; |
199 | } |
200 | |
201 | # |
202 | # Triggers |
203 | # |
204 | @nodes = $xp->findnodes('/sqlf:schema/sqlf:trigger'); |
205 | foreach (@nodes) { |
206 | my %data = get_tagfields($xp, $_, "sqlf:", |
207 | qw/name perform_action_when database_event fields on_table action order/ |
208 | ); |
209 | $schema->add_trigger( %data ) or die $schema->error; |
210 | } |
211 | |
212 | # |
213 | # Procedures |
214 | # |
215 | @nodes = $xp->findnodes('/sqlf:schema/sqlf:procedure'); |
216 | foreach (@nodes) { |
217 | my %data = get_tagfields($xp, $_, "sqlf:", |
218 | qw/name sql parameters owner comments order/ |
219 | ); |
220 | $schema->add_procedure( %data ) or die $schema->error; |
221 | } |
222 | |
0a1ec87a |
223 | return 1; |
224 | } |
225 | |
a5e624ac |
226 | # ------------------------------------------------------------------- |
227 | sub get_tagfields { |
228 | # |
0a1ec87a |
229 | # get_tagfields XPNODE, NAMESPACE => qw/TAGNAMES/; |
230 | # get_tagfields $node, "sqlf:" => qw/name type fields reference/; |
231 | # |
232 | # Returns hash of data. If a tag isn't in the file it is not in this |
233 | # hash. |
234 | # TODO Add handling of and explicit NULL value. |
a5e624ac |
235 | # |
236 | |
0a1ec87a |
237 | my ($xp, $node, @names) = @_; |
238 | my (%data, $ns); |
239 | foreach (@names) { |
240 | if ( m/:$/ ) { $ns = $_; next; } # Set def namespace |
241 | my $thisns = (s/(^.*?:)// ? $1 : $ns); |
a5e624ac |
242 | |
243 | foreach my $path ( "\@$thisns$_", "$thisns$_" ) { |
19922fbc |
244 | $data{ $_ } = "".$xp->findvalue( $path, $node ) |
a5e624ac |
245 | if $xp->exists( $path, $node ); |
246 | |
247 | debug "Got $_=".( defined $data{ $_ } ? $data{ $_ } : 'UNDEF' ); |
0a1ec87a |
248 | } |
249 | } |
a5e624ac |
250 | |
0a1ec87a |
251 | return wantarray ? %data : \%data; |
252 | } |
253 | |
254 | 1; |
255 | |
256 | # ------------------------------------------------------------------- |
257 | |
258 | =pod |
259 | |
260 | =head1 BUGS |
261 | |
262 | B<Empty Tags> e.g. <sqlf:default_value/> Will be parsed as "" and |
263 | hence also false. This is a bit counter intuative for some tags as |
264 | seeing <sqlf:is_nullable /> you might think that it was set when it |
265 | fact it wouldn't be. So for now it is safest not to use them until |
266 | their handling by the parser is defined. |
267 | |
268 | =head1 TODO |
269 | |
270 | =over 4 |
271 | |
a5e624ac |
272 | =item * |
273 | |
274 | Support sqf:options. |
275 | |
276 | =item * |
277 | |
278 | Test forign keys are parsed ok. |
279 | |
280 | =item * |
0a1ec87a |
281 | |
a5e624ac |
282 | Sort out sane handling of empty tags <foo/> vs tags with no content |
283 | <foo></foo> vs it no tag being there. |
0a1ec87a |
284 | |
a5e624ac |
285 | =item * |
0a1ec87a |
286 | |
a5e624ac |
287 | Control over defaulting of non-existant tags. |
0a1ec87a |
288 | |
289 | =back |
290 | |
291 | =head1 AUTHOR |
292 | |
293 | Mark D. Addison E<lt>mark.addison@itn.co.ukE<gt>. |
294 | |
295 | =head1 SEE ALSO |
296 | |
297 | perl(1), SQL::Translator, SQL::Translator::Producer::XML::SQLFairy, |
298 | SQL::Translator::Schema. |
299 | |
300 | =cut |