| RDF-Query documentation | Contained in the RDF-Query distribution. |
RDF::Query::Plan::Update - Executable query plan for DELETE/INSERT operations.
This document describes RDF::Query::Plan::Update version 2.907.
Beyond the methods documented below, this class inherits methods from the RDF::Query::Plan class.
new ( $delete_template, $insert_template, $pattern, \%dataset )execute ( $execution_context )nextclosedelete_templateReturns the algebra object representing the RDF template to delete.
insert_templateReturns the algebra object representing the RDF template to insert.
patternReturns the pattern plan object.
datasetReturns the dataset HASH reference.
distinctReturns true if the pattern is guaranteed to return distinct results.
orderedReturns true if the pattern is guaranteed to return ordered results.
plan_node_nameReturns the string name of this plan node, suitable for use in serialization.
plan_prototypeReturns a list of scalar identifiers for the type of the content (children) nodes of this plan node. See RDF::Query::Plan for a list of the allowable identifiers.
plan_node_dataReturns the data for this plan node that corresponds to the values described by
the signature returned by plan_prototype.
explainReturns a string serialization of the algebra appropriate for display on the command line.
graph ( $g )is_updateReturns true if the plan represents an update operation.
Gregory Todd Williams <gwilliams@cpan.org>
| RDF-Query documentation | Contained in the RDF-Query distribution. |
# RDF::Query::Plan::Update # -----------------------------------------------------------------------------
package RDF::Query::Plan::Update; use strict; use warnings; use base qw(RDF::Query::Plan); use Log::Log4perl; use Scalar::Util qw(blessed); use Time::HiRes qw(gettimeofday tv_interval); use RDF::Query::Error qw(:try); use RDF::Query::ExecutionContext; use RDF::Query::VariableBindings; ###################################################################### our ($VERSION); BEGIN { $VERSION = '2.907'; } ######################################################################
sub new { my $class = shift; my $delete = shift; my $insert = shift; my $pattern = shift; my $dataset = shift; my $self = $class->SUPER::new( $delete, $insert, $pattern, $dataset ); return $self; }
sub execute ($) { my $self = shift; my $context = shift; if ($self->state == $self->OPEN) { throw RDF::Query::Error::ExecutionError -text => "UPDATE plan can't be executed while already open"; } my $insert_template = $self->insert_template; my $delete_template = $self->delete_template; my $plan = $self->pattern; if ($self->dataset) { my $ds = $context->model->dataset_model( %{ $self->dataset } ); $context = $context->copy( model => $ds ); } $plan->execute( $context ); if ($plan->state == $self->OPEN) { my $l = Log::Log4perl->get_logger("rdf.query.plan.update"); $l->trace( "executing RDF::Query::Plan::Update" ); my @rows; while (my $row = $plan->next) { $l->trace("Update row: $row"); push(@rows, $row); } my @operations = ( [$delete_template, 'remove_statements'], [$insert_template, 'add_statement'], ); foreach my $data (@operations) { my ($template, $method) = @$data; $l->trace("UPDATE running $method"); foreach my $row (@rows) { my @triples = blessed($template) ? $template->quads : (); TRIPLE: foreach my $t (@triples) { my @nodes = $t->nodes; for my $i (0 .. $#nodes) { if ($nodes[$i]->isa('RDF::Trine::Node::Variable')) { my $name = $nodes[$i]->name; if ($method eq 'remove_statements') { if (exists($row->{ $name })) { $nodes[$i] = $row->{ $name }; } else { next TRIPLE; } } else { $nodes[$i] = $row->{ $name }; } } elsif ($nodes[$i]->isa('RDF::Trine::Node::Blank')) { my $id = $nodes[$i]->blank_identifier; unless (exists($self->[0]{blank_map}{ $id })) { if ($method eq 'remove_statements') { $self->[0]{blank_map}{ $id } = RDF::Query::Node::Variable->new(); } else { $self->[0]{blank_map}{ $id } = RDF::Query::Node::Blank->new(); } } $nodes[$i] = $self->[0]{blank_map}{ $id }; } } # my $ok = 1; foreach my $i (0 .. 3) { my $n = $nodes[ $i ]; if (not blessed($n)) { if ($i == 3) { $nodes[ $i ] = RDF::Trine::Node::Nil->new(); } else { next TRIPLE; # $nodes[ $i ] = RDF::Query::Node::Variable->new(); } # $ok = 0; # } elsif ($n->isa('RDF::Trine::Node::Variable')) { # $ok = 0; } } # next unless ($ok); my $st = (scalar(@nodes) == 4) ? RDF::Trine::Statement::Quad->new( @nodes ) : RDF::Trine::Statement->new( @nodes ); $l->trace( "$method: " . $st->as_string ); if ($method eq 'remove_statements') { $context->model->$method( $st->nodes ); } else { $context->model->$method( $st ); } } } } $self->[0]{ok} = 1; $self->state( $self->OPEN ); } else { warn "could not execute Update pattern plan"; } $self; }
sub next { my $self = shift; unless ($self->state == $self->OPEN) { throw RDF::Query::Error::ExecutionError -text => "next() cannot be called on an un-open UPDATE"; } my $l = Log::Log4perl->get_logger("rdf.query.plan.update"); $self->close(); return $self->[0]{ok}; }
sub close { my $self = shift; unless ($self->state == $self->OPEN) { throw RDF::Query::Error::ExecutionError -text => "close() cannot be called on an un-open UPDATE"; } delete $self->[0]{ok}; $self->SUPER::close(); }
sub delete_template { my $self = shift; return $self->[1]; }
sub insert_template { my $self = shift; return $self->[2]; }
sub pattern { my $self = shift; return $self->[3]; }
sub dataset { my $self = shift; return $self->[4]; }
sub distinct { return 1; }
sub ordered { return []; }
sub plan_node_name { return 'update'; }
sub plan_prototype { my $self = shift; return qw(A A P); }
sub plan_node_data { my $self = shift; return ($self->delete_template, $self->insert_template, $self->pattern); }
sub explain { my $self = shift; my $s = shift; my $count = shift; my $indent = $s x $count; my $type = $self->plan_node_name; my $string = "${indent}$type\n"; if (my $d = $self->delete_template) { $string .= "${indent}${s}delete:\n"; $string .= $d->explain( $s, $count+2 ); } if (my $i = $self->insert_template) { $string .= "${indent}${s}insert:\n"; $string .= $i->explain( $s, $count+2 ); } if (my $p = $self->pattern) { if ($p->isa('RDF::Query::Plan::Constant') and $p->is_unit) { } else { $string .= "${indent}${s}where:\n"; $string .= $p->explain( $s, $count+2 ); } } return $string; }
sub graph { my $self = shift; my $g = shift; my $label = $self->graph_labels; my $url = $self->url->uri_value; throw RDF::Query::Error::ExecutionError -text => "RDF::Query::Plan::Update->graph not implemented."; # $g->add_node( "$self", label => "delete" . $self->graph_labels ); # $g->add_node( "${self}$url", label => $url ); # $g->add_edge( "$self" => "${self}$url", label => 'url' ); # return "$self"; }
sub is_update { return 1; } 1; __END__