File Coverage

blib/lib/Protocol/XMPP/ElementBase.pm

Criterion	Covered	Total	%
statement	9	25	36.0
branch			n/a
condition			n/a
subroutine	3	9	33.3
pod	6	6	100.0
total	18	40	45.0

package Protocol::XMPP::ElementBase;

use strict;
use warnings;
use parent qw{Protocol::XMPP::Base};

our $VERSION = '0.007'; ## VERSION

=head1 NAME

Protocol::XMPP::ElementBase - base class for L XML fragment handling

=head1 SYNOPSIS

=head1 DESCRIPTION

=head1 METHODS

=cut

sub new {
  my $class = shift;
  my $self = $class->SUPER::new(@_);
  $self->{data} = '';
  return $self;
}

=head2 attributes

Access the XML element attributes as key-value pairs.

=cut

sub attributes {
  my $self = shift;
  return {
    map { $_->{LocalName} => $_->{Value} } values %{$self->{element}->{Attributes}}
  };
}

=head2 parent

Accessor for the parent object, if available.

=cut

sub parent { shift->{parent} }

=head2 characters

Called when new character data is available. Appends to internal buffer.

=cut

sub characters {
  my $self = shift;
  my $data = shift;
  $self->{data} .= $data;
  $self;
}

=head2 end_element

Called when an XML element is terminated.

=cut

sub end_element {
  my $self = shift;
  $self->debug("Virtual end_element for $_[0]");
}

=head2 class_from_element

Returns a class suitable for handling the given element,
if we have one.

If we don't have a local handler, returns undef.

=cut

sub class_from_element { undef }

1;

__END__