1 package SQL::Translator::Producer::Turnkey;
3 # -------------------------------------------------------------------
4 # $Id: Turnkey.pm,v 1.34 2004-04-06 00:27:02 allenday Exp $
5 # -------------------------------------------------------------------
6 # Copyright (C) 2002-4 SQLFairy Authors
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.
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.
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
21 # -------------------------------------------------------------------
24 use vars qw[ $VERSION $DEBUG ];
25 $VERSION = sprintf "%d.%02d", q$Revision: 1.34 $ =~ /(\d+)\.(\d+)/;
26 $DEBUG = 1 unless defined $DEBUG;
28 use SQL::Translator::Schema::Constants;
29 use SQL::Translator::Schema::Graph;
30 use SQL::Translator::Schema::Graph::HyperEdge;
31 use Log::Log4perl; Log::Log4perl::init('/etc/log4perl.conf');
41 # -------------------------------------------------------------------
43 my $log = Log::Log4perl->get_logger('SQL.Translator.Producer.Turnkey');
47 my $args = $t->producer_args;
48 my $no_comments = $t->no_comments;
49 my $baseclass = $args->{'main_pkg_name'} || $t->format_package_name('DBI');
50 my $graph = SQL::Translator::Schema::Graph->new(translator => $t,
51 baseclass => $baseclass
54 my $parser_type = (split /::/, $t->parser_type)[-1];
56 local $DEBUG = $t->debug;
59 format_fk => $t->format_fk_name,
60 format_package => $t->format_package_name,
61 format_table => $t->format_table_name,
62 template => $args->{'template'} || '',
63 baseclass => $baseclass,
64 db_dsn => $args->{'db_dsn'} || '',
65 db_user => $args->{'db_user'} || '',
66 db_pass => $args->{'db_pass'} || '',
67 db_str => $args->{'db_str'} || '',
68 parser => $t->parser_type,
69 producer => __PACKAGE__,
70 dsn => $args->{'dsn'} || sprintf( 'dbi:%s:_', $producer2dsn{ $parser_type }
71 ? $producer2dsn{ $parser_type }
79 foreach my $node_from ($graph->node_values){
81 next unless $node_from->table->is_data or !$node_from->table->is_trivial_link;
83 foreach my $cedge ( $node_from->compoundedges ){
85 my $hyperedge = SQL::Translator::Schema::Graph::HyperEdge->new();
88 foreach my $edge ($cedge->edges){
89 if($edge->thisnode->name eq $node_from->name){
90 $hyperedge->vianode($edge->thatnode);
92 if($edge->thatnode->name ne $cedge->via->name){
93 $node_to ||= $graph->node($edge->thatnode->table->name);
96 $hyperedge->push_thisnode($edge->thisnode);
97 $hyperedge->push_thisfield($edge->thisfield);
98 $hyperedge->push_thisviafield($edge->thatfield);
101 if($edge->thisnode->name ne $cedge->via->name){
102 $node_to ||= $graph->node($edge->thisnode->table->name);
104 $hyperedge->push_thatnode($edge->thisnode);
105 $hyperedge->push_thatfield($edge->thisfield);
106 $hyperedge->push_thatviafield($edge->thatfield);
108 $log->debug($edge->thisfield->name);
109 $log->debug($edge->thatfield->name);
112 if($hyperedge->count_thisnode == 1 and $hyperedge->count_thatnode == 1){ $hyperedge->type('one2one') }
113 elsif($hyperedge->count_thisnode > 1 and $hyperedge->count_thatnode == 1){ $hyperedge->type('many2one') }
114 elsif($hyperedge->count_thisnode == 1 and $hyperedge->count_thatnode > 1){ $hyperedge->type('one2many') }
115 elsif($hyperedge->count_thisnode > 1 and $hyperedge->count_thatnode > 1){ $hyperedge->type('many2many') }
117 $log->debug($_) foreach sort keys %::SQL::Translator::Schema::Graph::HyperEdge::;
119 #node_to won't always be defined b/c of multiple edges to a single other node
120 if(defined($node_to)){
121 $log->debug($node_from->name);
122 $log->debug($node_to->name);
124 if(scalar($hyperedge->thisnode) > 1){
125 $log->debug($hyperedge->type ." via ". $hyperedge->vianode->name);
127 foreach my $thisnode ( $hyperedge->thisnode ){
128 $log->debug($thisnode->name .' '.
129 $hyperedge->thisfield_index(0)->name .' -> '.
130 $hyperedge->thisviafield_index($i)->name .' '.
131 $hyperedge->vianode->name .' '.
132 $hyperedge->thatviafield_index(0)->name .' <- '.
133 $hyperedge->thatfield_index(0)->name .' '.
134 $hyperedge->thatnode_index(0)->name ."\n"
139 $node_from->push_hyperedges($hyperedge);
143 $meta{"nodes"} = $graph->node;
144 return(translateForm($t, \%meta));
151 $meta->{_dumper} = \&_dumper;
153 my $args = $t->producer_args;
154 my $type = $meta->{'template'};
156 my $template = Template->new({
163 $tt2 = template($type);
166 if($type eq 'atomtemplate'){
168 foreach my $node (values %{ $meta->{'nodes'} }){
170 my $param = { node => $node };
171 $template->process(\$tt2, $param, \$result) || die $template->error();
172 $result =~ s/^\s*(.+)\s*$/$1/s;
174 $result{$node->table->name} = $result;
178 $template->process(\$tt2, $meta, \$result) || die $template->error();
188 my $d = Data::Dumper($s);
195 # -------------------------------------------------------------------
201 SQL::Translator::Producer::Turnkey - create Turnkey classes from schema
205 Creates output for use with the Turnkey project.
209 L<http://turnkey.sourceforge.net>.
213 Allen Day E<lt>allenday@ucla.eduE<gt>
214 Brian O\'Connor E<lt>brian.oconnor@excite.comE<gt>.
221 ###########################################
222 # Here documents for the tt2 templates #
223 ###########################################
227 [% MACRO printPackage(node) BLOCK %]
228 # --------------------------------------------
230 package [% node.name %];
231 use base '[% node.base %]';
232 use Class::DBI::Pager;
234 [% node.name %]->set_up_table('[% node.table.name %]');
235 [% printPKAccessors(node.primary_key, node.table.name) %]
236 [% printHasA(node.edges, node) %]
237 [% printHasMany(node.edges, node) %]
238 [% printHasCompound(node.compoundedges, node.hyperedges, node.name) %]
239 [% #printHasFriendly(node) %]
244 [% MACRO printPKAccessors(array, name) BLOCK %]
246 # Primary key accessors
249 [% FOREACH item = array %]
250 [% IF item != "id" %]sub id { shift->[% item %] }[% END %]
251 [% IF item != name %]sub [% name %] { shift->[% item %] }[% END %]
256 [% MACRO printHasA(edges, name) BLOCK %]
261 [% FOREACH edge = edges %]
262 [% IF edge.type == 'import' %]
263 [% node.name %]->has_a([% edge.thisfield.name %] => '[% edge.thatnode.name %]');
264 [% IF node.has(edge.thatnode.name) < 2 %]
265 sub [% edge.thatnode.table.name %] { return shift->[% edge.thisfield.name %] }
267 sub [% format_fk(edge.thisnode.table.name,edge.thisfield.name) %] { return shift->[% edge.thisfield.name %] }
275 [% MACRO printHasMany(edges, node) BLOCK %]
280 [% FOREACH edge = edges %]
281 [% IF edge.type == 'export' %]
282 [% node.name %]->has_many('[% edge.thatnode.table.name %]_[% edge.thatfield.name %]', '[% edge.thatnode.name %]' => '[% edge.thatfield.name %]');
283 [% IF node.via(edge.thatnode.name) >= 1 %]
284 sub [% edge.thatnode.table.name %]_[% format_fk(edge.thatnode.table.name,edge.thatfield.name) %]s { return shift->[% edge.thatnode.table.name %]_[% edge.thatfield.name %] }
285 [% ELSIF edge.thatnode.table.is_data %]
286 [% IF node.edgecount(edge.thatnode.name) > 1 %]
287 sub [% edge.thatnode.table.name %]_[% format_fk(edge.thatnode.name,edge.thatfield.name) %]s { return shift->[% edge.thatnode.table.name %]_[% edge.thatfield.name %] }
289 sub [% edge.thatnode.table.name %]s { return shift->[% edge.thatnode.table.name %]_[% edge.thatfield.name %] }
298 [% MACRO printHasCompound(cedges,hedges,name) BLOCK %]
302 [% FOREACH cedge = cedges %]
303 [% FOREACH edge = cedge.edges %]
304 [% NEXT IF edge.thisnode.name != name %]
305 sub [% cedge.via.table.name %]_[% format_fk(edge.thatnode.table.name,edge.thatfield.name) %]s { return shift->[% cedge.via.table.name %]_[% edge.thatfield.name %] }
309 [% FOREACH h = hedges %]
310 ########## [% h.type %] ##########
311 [% IF h.type == 'one2one' %]
312 sub [% h.thatnode.table.name %]s { my \$self = shift; return map \$_->[% h.thatviafield.name %], \$self->[% h.vianode.table.name %]_[% h.thisviafield.name %] }
314 [% ELSIF h.type == 'one2many' %]
315 [% thisnode = h.thisnode_index(0) %]
317 [% FOREACH thatnode = h.thatnode %]
318 [% NEXT UNLESS h.thisviafield_index(i).name %]
319 #[% thisnode.name %]::[% h.thisfield_index(0).name %] -> [% h.vianode.name %]::[% h.thisviafield_index(i).name %] ... [% h.vianode.name %]::[% h.thatviafield_index(0).name %] <- [% h.thatnode_index(0).name %]::[% h.thatfield_index(0).name %]
320 sub [% h.vianode.table.name %]_[% format_fk(h.vianode,h.thatviafield_index(0).name) %]s { my \$self = shift; return map \$_->[% h.thatviafield_index(0).name %], \$self->[% h.vianode.table.name %]_[% h.thisviafield_index(i).name %] }
324 [% ELSIF h.type == 'many2one' %]
326 [% FOREACH thisnode = h.thisnode %]
327 #[% thisnode.name %]::[% h.thisfield_index(0).name %] -> [% h.vianode.name %]::[% h.thisviafield_index(i).name %] ... [% h.vianode.name %]::[% h.thatviafield_index(0).name %] <- [% h.thatnode_index(0).name %]::[% h.thatfield_index(0).name %]
328 sub [% h.vianode.table.name %]_[% format_fk(h.vianode,h.thisviafield_index(i).name) %]_[% format_fk(h.vianode,h.thatviafield_index(0).name) %]s { my \$self = shift; return map \$_->[% h.thatviafield_index(0).name %], \$self->[% h.vianode.table.name %]_[% h.thisviafield_index(i).name %] }
333 [% ELSIF h.type == 'many2many' %]
335 [% FOREACH thisnode = h.thisnode %]
337 [% FOREACH thatnode = h.thatnode %]
338 #[% thisnode.name %]::[% h.thisfield_index(i).name %] -> [% h.vianode.name %]::[% h.thisviafield_index(i).name %] ... [% h.vianode.name %]::[% h.thatviafield_index(j).name %] <- [% h.thatnode_index(j).name %]::[% h.thatfield_index(j).name %]
339 sub [% h.vianode.table.name %]_[% format_fk(h.vianode,h.thisviafield_index(i).name) %]_[% format_fk(h.vianode,h.thatviafield_index(j).name) %]s { my \$self = shift; return map \$_->[% %], \$self->[% %] }
350 [% MACRO printHasFriendly(node) BLOCK %]
357 [% MACRO printList(array) BLOCK %][% FOREACH item = array %][% item %] [% END %][% END %]
358 package [% baseclass %];
360 # Created by SQL::Translator::Producer::Turnkey
361 # Template used: classdbi
364 no warnings 'redefine';
365 use base qw(Class::DBI::Pg);
367 [% baseclass %]->set_db('Main', '[% db_dsn %]', '[% db_user %]', '[% db_pass %]', {AutoCommit=>1});
368 sub search_ilike { shift->_do_search(ILIKE => [% "\@\_" %] ) }
371 [% FOREACH node = nodes %]
372 [% printPackage(node.value) %]
378 elsif($type eq 'atom'){
381 [% ###### DOCUMENT START ###### %]
383 [% FOREACH node = nodes %]
384 [% IF !node.value.is_trivial_link %]
386 ##############################################
388 package Turnkey::Atom::[% node.value.name FILTER replace "Turnkey::Model::", "" %];
390 [% pname = node.value.name FILTER replace "Turnkey::Model::", "" %]
392 use base qw(Turnkey::Atom);
401 my $dbobject = shift;
403 # Assumption here that if it's not rendering on it's own dbobject
404 # then it's a list. This will be updated when AtomLists are implemented -boconnor
405 if(ref($dbobject) eq 'Turnkey::Model::[% pname %]') {
407 return(_render_record($dbobject));
409 else { return(_render_list($dbobject)); }
413 my $dbobject = shift;
419 [% FOREACH value = node.value.data_fields %]
421 $field_hash->{[% value %]} = $dbobject->[% value %]();
426 [% FOREACH value = node.value.edges %]
427 [% NEXT IF value.type != 'import' %]
428 $field_hash->{[% value.thisfield.name %]} = $dbobject->[% value.thisfield.name %]();
431 $row->{data} = $field_hash;
432 $row->{id} = $dbobject->id();
438 my $dbobject = shift;
440 my @objects = $dbobject->[% node.key %]s;
441 foreach my $object (@objects){
446 [% FOREACH value = node.value.data_fields %]
448 $field_hash->{[% value %]} = $object->[% value %]();
453 [% FOREACH value = node.value.edges %]
454 [% NEXT IF value.type != 'import' %]
455 $field_hash->{[% value.thisfield.name %]} = $object->[% value.thisfield.name %]();
458 $row->{data} = $field_hash;
459 $row->{id} = $object->id();
474 } elsif($type eq 'xml'){
476 <?xml version="1.0" encoding="UTF-8"?>
477 <!DOCTYPE Turnkey SYSTEM "Turnkey.dtd">
480 <!-- The basic layout is fixed -->
481 <container bgcolor="#FFFFFF" cellpadding="0" cellspacing="0" height="90%" orientation="vertical" type="root" width="100%" xlink:label="RootContainer">
482 <container cellpadding="3" cellspacing="0" orientation="horizontal" type="container" height="100%" width="100%" xlink:label="MiddleContainer">
483 <container align="center" cellpadding="2" cellspacing="0" class="leftbar" orientation="vertical" type="minor" width="0%" xlink:label="MidLeftContainer"/>
484 <container cellpadding="0" cellspacing="0" orientation="vertical" width="100%" type="major" xlink:label="MainContainer"/>
488 <!-- Atom Classes -->
489 [% FOREACH node = nodes %]
490 [% IF !node.value.is_trivial_link %]
491 <atom class="[% format_table(node.key) %]" name="[% format_table(node.key) %]" xlink:label="[% format_table(node.key) %]Atom"/>
495 <!-- Atom Bindings -->
497 [% FOREACH focus_atom = nodes %]
498 [% IF !focus_atom.value.is_trivial_link %]
499 [% FOREACH link_atom = focus_atom.value.hyperedges %]
500 <atomatombinding xlink:from="#[% format_table(focus_atom.key) %]Atom" xlink:to="#[% format_table(link_atom.thatnode.table.name) %]Atom" xlink:label="[% format_table(focus_atom.key) %]Atom2[% format_table(link_atom.thatnode.table.name) %]Atom"/>
503 [% FOREACH link_atom = focus_atom.value.edges %]
504 [% IF link_atom.type == 'export' && previous != link_atom.thatnode.table.name && link_atom.thatnode.table.name != "" %]
505 <atomatombinding xlink:from="#[% format_table(focus_atom.key) %]Atom" xlink:to="#[% format_table(link_atom.thatnode.table.name) %]Atom" xlink:label="[% format_table(focus_atom.key) %]Atom2[% format_table(link_atom.thatnode.table.name) %]Atom"/>
506 [% previous = link_atom.thatnode.table.name %]
514 [% FOREACH focus_atom = nodes %]
515 [% IF !focus_atom.value.is_trivial_link %]
516 <layout xlink:label="[% format_table(focus_atom.key) %]">
517 [% FOREACH link_atom = focus_atom.value.hyperedges %]
518 <placement xlink:from="#MidLeftContainer" xlink:label="MidLeftContainer2[% format_table(link_atom.thatnode.table.name) %]Atom" xlink:to="#[% format_table(link_atom.thatnode.table.name) %]Atom"/>
521 [% FOREACH link_atom = focus_atom.value.edges %]
522 [% IF link_atom.type == 'export' && previous != link_atom.thatnode.table.name %]
523 <placement xlink:from="#MidLeftContainer" xlink:label="MidLeftContainer2[% format_table(link_atom.thatnode.table.name) %]Atom" xlink:to="#[% format_table(link_atom.thatnode.table.name) %]Atom"/>
524 [% previous = link_atom.thatnode.table.name %]
527 <placement xlink:from="#MainContainer" xlink:label="MainContainer2[% format_table(focus_atom.key) %]Atom" xlink:to="#[% format_table(focus_atom.key) %]Atom"/>
534 <uribinding uri="/" class="Turnkey::Util::Frontpage"/>
538 [% FOREACH focus_atom = nodes %]
539 [% IF !focus_atom.value.is_trivial_link %]
540 <classbinding class="[% format_table(focus_atom.key) %]" plugin="#[% format_table(focus_atom.key) %]Atom" rank="0"/>
548 } elsif($type eq 'template'){
551 [% MACRO renderpanel(panel,dbobject) BLOCK %]
552 <!-- begin panel: [% panel.label %] -->
553 <table border="0" width="[% panel.width %]" height="[% panel.height %]" bgcolor="[% panel.bgcolor %]" valign="top" cellpadding="[% panel.cellpadding %]" cellspacing="[% panel.cellspacing %]" align="[% panel.align %]" valign="[% panel.valign %]">
555 [% FOREACH p = panel.containers %]
556 [% IF p.can_render(panel) %]
557 <td valign="top" class="[% p.class %]" align="[% panel.align %]" height="[% p.height || 1 %]" width="[% p.width %]">
558 [% IF p.type == 'Container' %]
559 [% renderpanel(p,dbobject) %]
561 <table cellpadding="0" cellspacing="0" align="left" height="100%" width="100%">
563 <tr class="dbtabletitle" height="1">
564 <td class="dbtabletitle">[% p.name %][% IF panel.type == 'major' %]: [% dbobject.name %][% END %]</td>
565 <td align="right" width="0"></td>
568 <tr><td colspan="2" class="dbtablerow">
569 <!-- begin atom: [% p.label %] -->
570 <table cellpadding="0" cellspacing="0" align="left" height="100%" width="100%"><!-- [% ref(atom) %] [% ref(dbobject) %] -->
571 [% renderatom(p,dbobject) %] <!-- used to be renderplugin(p,panel) -->
576 [% IF panel.orientation == 'vertical' %]
583 <!-- end panel: [% panel.label %] -->
585 [% BLOCK make_linked_dbobject %]
587 $stash->set(linked_dbobject => [% class %]->retrieve([% id %]));
590 [% MACRO obj2link(obj) SWITCH ref(obj) %]
595 <a href="[% obj2url(obj) %]">[% obj.name %]</a>
597 <a href="[% obj2url(obj) %]">[% obj %]</a>
600 [% MACRO obj2url(obj) SWITCH obj %]
602 /[% ref(obj) | replace('.+::','') %]/[% obj %]
604 [% MACRO obj2desc(obj) SWITCH ref(obj) %]
614 [% MACRO renderatom(atom, dbobject) SWITCH atom.name %]
615 [- FOREACH node = nodes -]
616 [- IF !node.value.is_trivial_link -]
617 [% CASE '[- format_table(node.key) -]' %]
618 [% INCLUDE [- node.key -].tt2 %]
622 [% renderlist(atom.render(dbobject)) %]
624 [% MACRO renderlist(lstArr) BLOCK %]
626 [% FOREACH item = lstArr %]
627 [% class = ref(atom) | replace('::Atom::', '::Model::') %]
629 [% PROCESS make_linked_dbobject %]
630 <li class="minorfocus">[% obj2link(linked_dbobject) %]</li>
636 } elsif($type eq 'atomtemplate') {
639 [-- IF !node.is_trivial_link --]
641 [% IF atom.focus == "yes" %]
642 [- FOREACH field = node.data_fields -]
643 [- IF field != "1" -]
644 <tr><td class="dbfieldname">[- field -]</td><td class="dbfieldvalue">[% obj2link(dbobject.[- field -]) %]</td></tr>
647 [- FOREACH field = node.edges -]
648 [- NEXT IF field.type != 'import' -]
649 <tr><td class="dbfieldname">[- field.thisfield.name -]</td><td class="dbfieldvalue">[% obj2link(fields.[- field.thisfield.name -]) %]</td></tr>
651 [% IF (rowcount > 1) %] <tr><td colspan="2"><hr></td></tr> [% END %]
652 [% rowcount = rowcount + 1 %]
655 [% FOREACH record = atom.render(dbobject) %]
656 [% class = ref(atom) | replace('::Atom::', '::Model::') %]
657 [% id = record.id #needed by make_linked_dbobject macro %]
658 [% PROCESS make_linked_dbobject %]
659 <li class="minorfocus">[% obj2link(linked_dbobject) %]</li>