The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

XML::Generator::vCard::RDF - generate RDF/XML SAX2 events for vCard 3.0

SYNOPSIS

 use XML::SAX::Writer;
 use XML::Generator::vCard::RDF;

 my $writer = XML::SAX::Writer->new();
 my $driver = XML::Generator::vCard::RDF->new(Handler=>$writer);

 $driver->parse_files("test.vcf");

DESCRIPTION

Generate RDF/XML SAX2 events for vCard 3.0

DOCUMENT FORMAT

SAX2 events map to the Representing vCard Objects in RDF/XML W3C note:

 http://www.w3.org/TR/2001/NOTE-vcard-rdf-20010222/

PACKAGE METHODS

__PACKAGE__->new(%args)

This method inherits from XML::SAX::Base

OBJECT METHODS

$pkg->parse_files(@files)

Generate SAX2 events for one, or more, vCard files.

Returns true or false.

$pkg->parse_files(@files)

PRIVATE METHODS

Private methods are documented below in case you need to subclass this package to tweak its output.

$obj->_render_doc(\@vcards)

$obj->_render_card(Text::vCard)

$obj->_render_fn(Text::vCard)

$obj->_render_n(Text::vCard)

$obj->_render_nickname(Text::vCard)

$obj->_render_photo(Text::vCard)

$obj->_render_bday(Text::vCard)

$obj->_render_adrs(Text::vCard)

$obj->_render_labels(Text::vCard)

$obj->_render_tels(Text::vCard)

$obj->_render_emails(Text::vCard)

$obj->_render_instantmessaging(Text::vCard)

$obj->_render_mailer(Text::vCard)

$obj->_render_tz(Text::vCard)

$obj->_render_geo(Text::vCard)

$obj->_render_org(Text::vCard)

$obj->_render_title(Text::vCard)

$obj->_render_role(Text::vCard)

$obj->_render_logo(Text::vCard)

$obj->_render_categories(Text::vCard)

$obj->_render_note(Text::vCard)

$self->_render_sound(Text::vCard)

$self->_render_url(Text::vCard)

$obj->_render_key(Text::vCard)

$obj->_render_custom(Text::vCard)

By default this method does nothing. It is here to be subclassed.

$obj->_im_services()

Returns a hash ref mapping an instant messaging service type to an XML element. Default is :

 {"aim"    => "foaf:aimChatID",
  "yahoo"  => "foaf:yahooChatID",
  "msn"    => "foaf:msnChatID",
  "jabber" => "foaf:JabberID",
  "icq"    => "foaf:icqChatId"}

This is called by the _render_instantmessaging method.

$obj->_namespaces()

Returns a hash reference of prefix - URI pairs.

NAMESPACES

This package generates SAX events using the following XML namespaces :

  • vCard

     http://www.w3.org/2001/vcard-rdf/3.0#
  • rdf

     http://www.w3.org/1999/02/22-rdf-syntax-ns#
  • foaf:

     http://xmlns.com/foaf/0.1/
  • geo

     http://www.w3.org/2003/01/geo/wgs84_pos#

VERSION

1.0

DATE

$Date: 2004/10/17 02:51:56 $

AUTHOR

Aaron Straup Cope <ascope@cpan.org>

SEE ALSO

Text::vCard

XML::Generator::vCard

BUGS

Please report all bugs via http://rt.cpan.org

LICENSE

Copyright (c) 2004, Aaron Straup Cope. All Rights Reserved.

This is free software, you may use it and distribute it under the same terms as Perl itself.