Raw content of BioMart::Formatter::HTML# $Id: HTML.pm,v 1.9 2008/04/09 12:52:34 syed Exp $
#
# BioMart module for BioMart::Formatter::HTML
#
# You may distribute this module under the same terms as perl
# itself.
# POD documentation - main docs before the code.
=head1 NAME
BioMart::Formatter::HTML
=head1 SYNOPSIS
The HTML Formatter returns data formatted into a HTML table
for a BioMart query's ResultTable
=head1 DESCRIPTION
When given a BioMart::ResultTable containing the results of
a BioMart::Query the HTML Formatter will return HTML formatted tabular
output. The getDisplayNames and getFooterText can be used to return
appropiately formatted headers and footers respectively. If hyperlink
templates are defined for the attributes in the Dataset's ConfigurationTree
then appropiate hyperlinks will be calculated for each cell of the table.
Addition of any extra attributes to the Query that may be required for this
hyperlink formatting is handled in this Formatter
=head1 AUTHOR - Syed Haider, Damian Smedley, Gudmundur Thorisson
=head1 CONTACT
This module is part of the BioMart project
http://www.biomart.org
Questions can be posted to the mart-dev mailing list:
mart-dev@ebi.ac.uk
=head1 METHODS
=cut
package BioMart::Formatter::HTML;
use strict;
use warnings;
use Readonly;
# Extends BioMart::FormatterI
use base qw(BioMart::FormatterI);
# HTML templates
my $current_rowcount = 0; # keep track of number of rows printed out
Readonly my $FOOTER_TMPL => qq{
};
Readonly my $HEADER_TMPL => q{
%s
};
Readonly my $ROW_START_TMPL1 => qq{
\n};
Readonly my $ROW_START_TMPL2 => qq{
\n};
Readonly my $HEADERFIELD_TMPL1 => qq{
%s
\n};
Readonly my $HEADERFIELD_TMPL2 => qq{
%s
\n};
Readonly my $NORMALFIELD_TMPL1 => qq{
%s
\n};
Readonly my $ROW_END_TMPL => qq{
\n};
sub _new {
my ($self) = @_;
$self->SUPER::_new();
}
sub processQuery {
my ($self, $query) = @_;
$self->set('original_attributes',[@{$query->getAllAttributes()}])
if ($query->getAllAttributes());
$query = $self->setHTMLAttributes($query);
$self->set('query',$query);
return $query;
}
sub nextRow {
my $self = shift;
my $rtable = $self->get('result_table');
# print the data with urls if available
my $new_row;
my $row = $rtable->nextRow;
if (!$row){
return;
}
map { $_ = q{} unless defined ($_); } @$row;
my $attribute_positions = $self->get('attribute_positions');
my $attribute_url_positions = $self->get('attribute_url_positions');
my $attribute_url = $self->get('attribute_url');
#my $dataset1_end = $self->get('dataset1_end');
for (my $i = 0; $i < @{$attribute_positions}; $i++){
# superscripting for emma mart
$$row[$$attribute_positions[$i]] =~ s/\<(.*)\>/$1<\/span>/;
if ($$attribute_url[$i]){
my @url_data = map {$$row[$_]} @{$$attribute_url_positions[$i]};
my $url_string = sprintf($$attribute_url[$i],@url_data);
push @{$new_row}, ''.
$$row[$$attribute_positions[$i]]."";
}
else{
push @{$new_row},$$row[$$attribute_positions[$i]];
}
}
$current_rowcount++;
my $fields_string = '';
map{ $fields_string .= sprintf ($NORMALFIELD_TMPL1, defined ($_) ? $_ : ''); } @{$new_row};
return ($current_rowcount % 2 == 0 ? $ROW_START_TMPL1 : $ROW_START_TMPL2)
. $fields_string
. $ROW_END_TMPL;
}
sub getDisplayNames {
my $self = shift;
my $original_attributes = $self->get('original_attributes');
my $dataset1_end = $self->get('dataset1_end');
my $query = $self->get('query');
my $registry = $query->getRegistry;
my $final_dataset_order = $query->finalDatasetOrder;
my @attribute_display_names;
my @original_dataset_attributes;
foreach my $dataset(reverse @$final_dataset_order){
foreach (@{$original_attributes}){
push @original_dataset_attributes,$_
if ($_->dataSetName eq $dataset);
}
}
foreach my $original_attribute(@original_dataset_attributes){
push @attribute_display_names, $original_attribute->displayName;
}
# print the display names
my $header_string = sprintf $HEADER_TMPL, '';
$header_string .= $ROW_START_TMPL1;
# map{ $header_string .=
# sprintf $HEADERFIELD_TMPL, $_ } @attribute_display_names;
map{ $header_string .= sprintf $HEADERFIELD_TMPL1, $_ } @attribute_display_names[0..$dataset1_end];
map{ $header_string .= sprintf $HEADERFIELD_TMPL2, $_ } @attribute_display_names[$dataset1_end+1..@attribute_display_names-1];
$header_string .= $ROW_END_TMPL;
return $header_string;
}
# Override empty-string returning method in superclass, to return proper
# table- and document-closing tags (to keep HTML valid).
sub getFooterText {
return q{