1 package SQL::Translator::Producer::Turnkey;
3 # -------------------------------------------------------------------
4 # $Id: Turnkey.pm,v 1.55 2004-07-23 01:11:23 boconnor 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.55 $ =~ /(\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');
33 $Data::Dumper::Maxdepth = 3;
42 # -------------------------------------------------------------------
44 my $log = Log::Log4perl->get_logger('SQL.Translator.Producer.Turnkey');
48 my $args = $t->producer_args;
49 my $no_comments = $t->no_comments;
50 my $baseclass = $args->{'main_pkg_name'} || $t->format_package_name('DBI');
51 my $graph = SQL::Translator::Schema::Graph->new(translator => $t,
52 baseclass => $baseclass
55 my $parser_type = (split /::/, $t->parser_type)[-1];
57 local $DEBUG = $t->debug;
60 format_fk => $t->format_fk_name,
61 format_package => $t->format_package_name,
62 format_table => $t->format_table_name,
63 template => $args->{'template'} || '',
64 baseclass => $baseclass,
65 db_dsn => $args->{'db_dsn'} || '',
66 db_user => $args->{'db_user'} || '',
67 db_pass => $args->{'db_pass'} || '',
68 db_str => $args->{'db_str'} || '',
69 parser => $t->parser_type,
70 producer => __PACKAGE__,
71 dsn => $args->{'dsn'} || sprintf( 'dbi:%s:_', $producer2dsn{ $parser_type }
72 ? $producer2dsn{ $parser_type }
80 # this code needs to move to Graph.pm
81 foreach my $node_from ($graph->node_values){
83 next unless $node_from->table->is_data or !$node_from->table->is_trivial_link;
85 foreach my $cedge ( $node_from->compoundedges ){
87 my $hyperedge = SQL::Translator::Schema::Graph::HyperEdge->new();
90 foreach my $edge ($cedge->edges){
91 if($edge->thisnode->name eq $node_from->name){
92 $hyperedge->vianode($edge->thatnode);
94 if($edge->thatnode->name ne $cedge->via->name){
95 $node_to ||= $graph->node($edge->thatnode->table->name);
98 $hyperedge->push_thisnode($edge->thisnode);
99 $hyperedge->push_thisfield($edge->thisfield);
100 $hyperedge->push_thisviafield($edge->thatfield);
103 if($edge->thisnode->name ne $cedge->via->name){
104 $node_to ||= $graph->node($edge->thisnode->table->name);
106 $hyperedge->push_thatnode($edge->thisnode);
107 $hyperedge->push_thatfield($edge->thisfield);
108 $hyperedge->push_thatviafield($edge->thatfield);
110 $log->debug($edge->thisfield->name);
111 $log->debug($edge->thatfield->name);
114 if($hyperedge->count_thisnode == 1 and $hyperedge->count_thatnode == 1){ $hyperedge->type('one2one') }
115 elsif($hyperedge->count_thisnode > 1 and $hyperedge->count_thatnode == 1){ $hyperedge->type('many2one') }
116 elsif($hyperedge->count_thisnode == 1 and $hyperedge->count_thatnode > 1){ $hyperedge->type('one2many') }
117 elsif($hyperedge->count_thisnode > 1 and $hyperedge->count_thatnode > 1){ $hyperedge->type('many2many') }
119 $log->debug($_) foreach sort keys %::SQL::Translator::Schema::Graph::HyperEdge::;
121 #node_to won't always be defined b/c of multiple edges to a single other node
122 if(defined($node_to)){
123 $log->debug($node_from->name);
124 $log->debug($node_to->name);
126 if(scalar($hyperedge->thisnode) > 1){
127 $log->debug($hyperedge->type ." via ". $hyperedge->vianode->name);
129 foreach my $thisnode ( $hyperedge->thisnode ){
130 $log->debug($thisnode->name .' '.
131 $hyperedge->thisfield_index(0)->name .' -> '.
132 $hyperedge->thisviafield_index($i)->name .' '.
133 $hyperedge->vianode->name .' '.
134 $hyperedge->thatviafield_index(0)->name .' <- '.
135 $hyperedge->thatfield_index(0)->name .' '.
136 $hyperedge->thatnode_index(0)->name ."\n"
141 #warn Dumper($hyperedge) if $hyperedge->type eq 'many2many';
142 $node_from->push_hyperedges($hyperedge);
146 $meta{"nodes"} = $graph->node;
147 return(translateForm($t, \%meta));
154 my $args = $t->producer_args;
155 my $type = $meta->{'template'};
157 my $template = Template->new({
164 $tt2 = template($type);
167 if($type eq 'atomtemplate'){
169 foreach my $node (values %{ $meta->{'nodes'} }){
171 my $param = { node => $node };
172 $template->process(\$tt2, $param, \$result) || die $template->error();
173 $result =~ s/^\s*(.+)\s*$/$1/s;
175 $result{$node->table->name} = $result;
179 $template->process(\$tt2, $meta, \$result) || die $template->error();
187 # -------------------------------------------------------------------
193 SQL::Translator::Producer::Turnkey - create Turnkey classes from schema
197 Creates output for use with the Turnkey project.
201 L<http://turnkey.sourceforge.net>.
205 Allen Day E<lt>allenday@ucla.eduE<gt>
206 Brian O\'Connor E<lt>boconnor@ucla.comE<gt>.
213 ###########################################
214 # Here documents for the tt2 templates #
215 ###########################################
219 [% MACRO printPackage(node) BLOCK %]
221 ########[% node.name | replace('Turnkey::Model::', '') %].pm########
223 package [% node.name %];
224 use base '[% node.base %]';
225 use Class::DBI::Pager;
226 no warnings qw(redefine);
228 [% node.name %]->set_up_table('[% node.table.name %]');
229 [% printPKAccessors(node.primary_key, node.table.name) %]
230 [% printHasA(node.edges, node) %]
231 [% printHasMany(node.edges, node) %]
232 [% printHasCompound(node.compoundedges, node.hyperedges, node.name) %]
233 [% #printHasFriendly(node) %]
235 [% MACRO printPKAccessors(array, name) BLOCK %]
237 # Primary key accessors
240 [% FOREACH item = array %]
241 [% IF item != "id" %]sub id { shift->[% item %] }[% END %]
242 [% IF item != name %]sub [% name %] { shift->[% item %] }[% END %]
246 [% MACRO printHasA(edges, name) BLOCK %]
247 [% FOREACH edge = edges %]
248 [% IF loop.first() %]
254 [% IF edge.type == 'import' %]
255 [% node.name %]->has_a([% edge.thisfield.name %] => '[% edge.thatnode.name %]');
256 [% IF node.has(edge.thatnode.name) < 2 %]
257 sub [% edge.thatnode.table.name %] { return shift->[% edge.thisfield.name %] }
259 sub [% format_fk(edge.thisnode.table.name,edge.thisfield.name) %] { return shift->[% edge.thisfield.name %] }
266 [% MACRO printHasMany(edges, node) BLOCK %]
267 [% FOREACH edge = edges %]
268 [% IF loop.first() %]
274 [% IF edge.type == 'export' %]
275 [% node.name %]->has_many('[% edge.thatnode.table.name %]_[% edge.thatfield.name %]', '[% edge.thatnode.name %]' => '[% edge.thatfield.name %]');
276 [% IF node.via(edge.thatnode.name) >= 1 %]
277 sub [% edge.thatnode.table.name %]_[% format_fk(edge.thatnode.table.name,edge.thatfield.name) %]s { return shift->[% edge.thatnode.table.name %]_[% edge.thatfield.name %] }
278 [% ELSIF edge.thatnode.table.is_data %]
279 [% IF node.edgecount(edge.thatnode.name) > 1 %]
280 sub [% edge.thatnode.table.name %]_[% format_fk(edge.thatnode.name,edge.thatfield.name) %]s { return shift->[% edge.thatnode.table.name %]_[% edge.thatfield.name %] }
282 sub [% edge.thatnode.table.name %]s { return shift->[% edge.thatnode.table.name %]_[% edge.thatfield.name %] }
290 [% MACRO printHasCompound(cedges,hedges,name) BLOCK %]
291 [% FOREACH cedge = cedges %]
292 [% IF loop.first() %]
297 [% FOREACH edge = cedge.edges %]
298 [% NEXT IF edge.thisnode.name != name %]
299 sub [% cedge.via.table.name %]_[% format_fk(edge.thatnode.table.name,edge.thatfield.name) %]s { return shift->[% cedge.via.table.name %]_[% edge.thatfield.name %] }
304 [% FOREACH h = hedges %]
305 [% NEXT UNLESS h.type == 'one2one' %]
306 [% IF seen == 0 ; seen = 1 %]# one2one #[% END %]
307 sub [% h.thatnode.table.name %]s { my $self = shift; return map $_->[% h.thatviafield.name %], $self->[% h.vianode.table.name %]_[% h.thisviafield.name %] }
311 [% FOREACH h = hedges %]
312 [% NEXT UNLESS h.type == 'one2many' %]
313 [% IF seen == 0 ; seen = 1 %]# one2many #[% END %]
314 [% thisnode = h.thisnode_index(0) %]
316 [% FOREACH thatnode = h.thatnode %]
317 [% NEXT UNLESS h.thisviafield_index(i).name %]
318 #[% 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 %]
319 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 %] }
325 [% FOREACH h = hedges %]
326 [% NEXT UNLESS h.type == 'many2one' %]
327 [% IF seen == 0 ; seen = 1 %]# many2one #[% END %]
329 [% FOREACH thisnode = h.thisnode %]
330 #[% 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 %]
331 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 %] }
337 [% FOREACH h = hedges %]
338 [% NEXT UNLESS h.type == 'many2many' %]
339 [% IF seen == 0 ; seen = 1 %]# many2many #[% END %]
341 [% FOREACH thisnode = h.thisnode %]
343 [% FOREACH thatnode = h.thatnode %]
344 #[% 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 %]
345 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 $_->[% h.vianode.table.name %]_[% format_fk(h.vianode,h.thatviafield_index(j).name) %]s, $self->[% h.vianode.table.name %]_[% format_fk(h.vianode,h.thisviafield_index(i).name) %]s }
353 [% MACRO printHasFriendly(node) BLOCK %]
357 #FIXME, why aren't these being generated?
360 [% MACRO printList(array) BLOCK %][% FOREACH item = array %][% item %] [% END %][% END %]
362 ########AutoDBI.pm########
363 use Turnkey::Model::DBI;
364 [% FOREACH node = nodes %]
365 use [% node.value.name %];
369 ########[% baseclass | replace('Turnkey::Model::', '') %].pm########
370 package [% baseclass %];
372 # Created by SQL::Translator::Producer::Turnkey
373 # Template used: classdbi
377 no warnings 'redefine';
378 use base qw(Class::DBI::Pg);
380 [% baseclass %]->set_db('Main', '[% db_dsn %]', '[% db_user %]', '[% db_pass %]');
381 sub search_ilike { shift->_do_search(ILIKE => [% "\@\_" %] ) }
386 foreach my $k (keys %q){
387 $t{"lower($k)"} = lc($q{$k});
389 $c->_do_search(LIKE => %t);
396 my %arg = %{shift @_};
397 $arg{'indent'} ||= 1;
399 $Data::Dumper::Maxdepth = $arg{'depth'} if defined $arg{'depth'};
400 $Data::Dumper::Indent = $arg{'indent'} if defined $arg{'indent'};
401 return(Dumper($arg{'object'}));
405 ########soap.tt2########
407 [% FOREACH node = nodes %][% node.value.name %], [%- END -%]
408 [% FOREACH node = nodes %][% printPackage(node.value) %][% END %]
413 elsif($type eq 'atom'){
416 [% # DOCUMENT START # %]
418 ########AutoAtom.pm########
419 [% FOREACH node = nodes %]
420 use [% node.value.name %];
424 [% FOREACH node = nodes %]
425 [% IF !node.value.is_trivial_link %]
427 ########[% node.value.name | replace('Turnkey::Model::', '') %].pm########
429 package Turnkey::Atom::[% node.value.name FILTER replace "Turnkey::Model::", "" %];
431 [% pname = node.value.name FILTER replace "Turnkey::Model::", "" %]
433 use base qw(Turnkey::Atom);
442 my $dbobject = shift;
444 # Assumption here that if it's not rendering on it's own dbobject
445 # then it's a list. This will be updated when AtomLists are implemented -boconnor
446 if(ref($dbobject) eq 'Turnkey::Model::[% pname %]') {
448 return(_render_record($dbobject));
450 else { return(_render_list($dbobject)); }
454 my $dbobject = shift;
460 [% FOREACH value = node.value.data_fields %]
462 $field_hash->{[% value.key %]} = $dbobject->[% value.key %]();
467 [% FOREACH value = node.value.edges %]
468 [% NEXT IF value.type != 'import' %]
469 $field_hash->{[% value.thisfield.name %]} = $dbobject->[% value.thisfield.name %]();
472 $row->{data} = $field_hash;
473 $row->{id} = $dbobject->id();
479 my $dbobject = shift;
481 my @objects = $dbobject->[% node.key %]s;
482 foreach my $object (@objects){
487 [% FOREACH value = node.value.data_fields %]
489 $field_hash->{[% value.key %]} = $object->[% value.key %]();
494 [% FOREACH value = node.value.edges %]
495 [% NEXT IF value.type != 'import' %]
496 $field_hash->{[% value.thisfield.name %]} = $object->[% value.thisfield.name %]();
499 $row->{data} = $field_hash;
500 $row->{id} = $object->id();
515 } elsif($type eq 'xml'){
517 <?xml version="1.0" encoding="UTF-8"?>
518 <!DOCTYPE Turnkey SYSTEM "Turnkey.dtd">
521 <!-- The basic layout is fixed -->
522 <container orientation="vertical" type="Container" label="RootContainer">
523 <container orientation="horizontal" type="Container" label="MiddleContainer">
524 <container align="center" class="leftbar" orientation="vertical" type="minor" label="MidLeftContainer"/>
525 <container orientation="vertical" type="major" label="MainContainer"/>
529 <!-- Atom Classes -->
530 [% FOREACH node = nodes %]
531 [% IF !node.value.is_trivial_link %]
532 <atom class="[% format_table(node.key) %]" name="[% format_table(node.key) %]" label="[% format_table(node.key) %]Atom"/>
536 <atom class="Frontpage" name="Frontpage" label="FrontpageAtom"/>
537 <atom class="Search" name="Search" label="SearchAtom"/>
538 <atom class="Userinfo" name="UserInfo" label="UserinfoAtom"/>
542 <!-- Atom Bindings -->
544 [% FOREACH focus_atom = nodes %]
545 [% IF !focus_atom.value.is_trivial_link %]
546 [% FOREACH link_atom = focus_atom.value.hyperedges %]
547 <atomatombinding from="#[% format_table(focus_atom.key) %]Atom" to="#[% format_table(link_atom.thatnode.table.name) %]Atom" label="[% format_table(focus_atom.key) %]Atom2[% format_table(link_atom.thatnode.table.name) %]Atom"/>
550 [% FOREACH link_atom = focus_atom.value.edges %]
551 [% IF link_atom.type == 'export' && previous != link_atom.thatnode.table.name && link_atom.thatnode.table.name != "" %]
552 <atomatombinding from="#[% format_table(focus_atom.key) %]Atom" to="#[% format_table(link_atom.thatnode.table.name) %]Atom" label="[% format_table(focus_atom.key) %]Atom2[% format_table(link_atom.thatnode.table.name) %]Atom"/>
553 [% previous = link_atom.thatnode.table.name %]
561 [% FOREACH focus_atom = nodes %]
562 [% IF !focus_atom.value.is_trivial_link %]
563 <layout label="[% format_table(focus_atom.key) %]">
564 [% FOREACH link_atom = focus_atom.value.hyperedges %]
565 <placement from="#MidLeftContainer" label="MidLeftContainer2[% format_table(link_atom.thatnode.table.name) %]Atom" to="#[% format_table(link_atom.thatnode.table.name) %]Atom"/>
568 [% FOREACH link_atom = focus_atom.value.edges %]
569 [% IF link_atom.type == 'export' && previous != link_atom.thatnode.table.name %]
570 <placement from="#MidLeftContainer" label="MidLeftContainer2[% format_table(link_atom.thatnode.table.name) %]Atom" to="#[% format_table(link_atom.thatnode.table.name) %]Atom"/>
571 [% previous = link_atom.thatnode.table.name %]
574 <placement from="#MainContainer" label="MainContainer2[% format_table(focus_atom.key) %]Atom" to="#[% format_table(focus_atom.key) %]Atom"/>
579 <layout label="Turnkey::Util::Frontpage">
580 <placement from="#MainContainer" label="MainContainer2AnalysisAtom" to="#FrontpageAtom"/>
582 <layout label="Turnkey::Util::Search">
583 <placement from="#MainContainer" label="MainContainer2AnalysisAtom" to="#SearchAtom"/>
585 <layout label="Turnkey::Util::Userinfo">
586 <placement from="#MainContainer" label="MainContainer2UserinfoAtom" to="#UserinfoAtom"/>
592 <uribinding uri="/db" class="Turnkey::Util::Frontpage"/>
593 <uribinding uri="/db/search" class="Turnkey::Util::Search"/>
594 <uribinding uri="/db/userinfo" class="Turnkey::Util::Userinfo"/>
598 [% FOREACH focus_atom = nodes %]
599 [% IF !focus_atom.value.is_trivial_link %]
600 <classbinding class="[% format_table(focus_atom.key) %]" plugin="#[% format_table(focus_atom.key) %]Atom" rank="0"/>
604 <classbinding class="Turnkey::Util::Frontpage" plugin="#FrontpageAtom" rank="0"/>
605 <classbinding class="Turnkey::Util::Search" plugin="#SearchAtom" rank="0"/>
606 <classbinding class="Turnkey::Util::Userinfo" plugin="#UserinfoAtom" rank="0"/>
613 } elsif($type eq 'template'){
616 [% MACRO renderpanel(panel,name,dbobject) BLOCK %]
617 <!-- begin panel: [% panel.label %] -->
618 [% FOREACH p = panel.containers %]
619 [% IF p.can_render(panel) %]
620 [% IF p.type == 'Container' %]
621 [% renderpanel(p,name,dbobject) %]
623 [% IF p.type == 'major' %]
624 <div class="middle"><div class="column-in">
626 <div class="middle-header">[% name %]</div>
628 <!-- begin atom: [% p.label %] -->
629 <table cellpadding="0" cellspacing="0" align="left" height="100%" width="100%"><!-- [% ref(atom) %] [% ref(dbobject) %] -->
630 [% renderatom(name,dbobject,p.containers[0]) %]
633 <div class="cleaner"></div>
634 [% ELSIF p.type == 'minor' %]
635 <div class="left"><div class="column-in">
636 [% FOREACH atom = p.containers %]
637 <div class="left-item">
639 [% linkname = ref(p.containers[0]) %]
640 <div class="box-header">[% atom.name | replace('Turnkey::Atom::', '') %]</div>
642 <!-- begin atom: [% p.label %] -->
643 <table cellpadding="0" cellspacing="0" align="left" height="100%" width="100%"><!-- [% ref(atom) %] [% ref(dbobject) %] -->
644 [% renderatom(name,dbobject,atom) %]
651 [% IF panel.orientation == 'vertical' %]
656 <!-- end panel: [% panel.label %] -->
659 [% BLOCK make_linked_dbobject %]
661 $stash->set(linked_dbobject => [% class %]->retrieve([% id %]));
664 [% MACRO obj2link(obj) SWITCH ref(obj) %]
669 <a href="[% obj2url(obj) %]">[% obj.name %]</a>
671 <a href="[% obj2url(obj) %]">[% obj %]</a>
674 [% MACRO obj2url(obj) SWITCH obj %]
676 /db/[% ref(obj) | replace('.+::','') %]/[% obj %]
678 <!-- the above method should be updated when additional namespaces are used -->
679 [% MACRO obj2desc(obj) SWITCH ref(obj) %]
689 [% MACRO renderatom(name, dbobject, atom) SWITCH name %]
690 [- FOREACH node = nodes -]
691 [- IF !node.value.is_trivial_link -]
692 [% CASE '[- format_table(node.key) -]' %]
693 [% INCLUDE [- node.key -].tt2 %]
697 [% renderlist(atom.render(dbobject)) %]
699 [% MACRO renderlist(lstArr) BLOCK %]
700 <div class="left-item"><ul>
701 [% FOREACH item = lstArr %]
702 [% class = ref(atom) | replace('::Atom::', '::Model::') %]
704 [% PROCESS make_linked_dbobject %]
705 <li class="minorfocus">[% obj2link(linked_dbobject) %]</li>
711 } elsif($type eq 'atomtemplate') {
714 [-- IF !node.is_trivial_link --]
715 [% records = atom.render(dbobject) %]
717 [% IF atom.focus == "yes" %]
718 [% FOREACH record = records %]
719 [% fields = record.data %]
721 [- FOREACH field = node.data_fields -]
722 [- IF field != "1" -]
723 <tr><td class="dbfieldname">[- field.key -]</td><td class="dbfieldvalue">[% obj2link(fields.[- field.key -]) %]</td></tr>
726 [- FOREACH field = node.edges -]
727 [- NEXT IF field.type != 'import' -]
728 <tr><td class="dbfieldname">[- field.thisfield.name -]</td><td class="dbfieldvalue">[% obj2link(fields.[- field.thisfield.name -]) %]</td></tr>
730 [% IF (rowcount > 1) %] <tr><td colspan="2"><hr></td></tr> [% END %]
731 [% rowcount = rowcount + 1 %]
736 [% FOREACH record = atom.render(dbobject) %]
737 [% class = ref(atom) | replace('::Atom::', '::Model::') %]
738 [% id = record.id #needed by make_linked_dbobject macro %]
739 [% PROCESS make_linked_dbobject %]
740 <li class="minorfocus">[% obj2link(linked_dbobject) %]</li>