NAME¶
RDF::vCard::Importer - import RDF data from vCard format
SYNOPSIS¶
use RDF::vCard;
use RDF::TrineShortcuts qw':all';
my $importer = RDF::vCard::Importer->new;
print $_
foreach $importer->import_file('contacts.vcf');
print rdf_string($importer->model => 'RDFXML');
DESCRIPTION¶
This module reads vCards and writes RDF.
Constructor¶
- •
- "new(%options)"
Returns a new RDF::vCard::Importer object and initialises it.
The only valid option currently is ua which can be set to an
LWP::UserAgent for those rare occasions that the Importer needs to fetch
stuff from the Web.
Methods¶
- •
- "init"
Reinitialise the importer. Forgets any cards that have already been
imported.
- •
- "model"
Return an RDF::Trine::Model containing data for all cards that have been
imported since the importer was last initialised.
- •
- "import_file($filename, %options)"
Imports vCard data from a file on the file system.
The data is added to the importer's model (and can be retrieved using the
"model" method).
This function returns a list of RDF::vCard::Entity objects, so it's also
possible to access the data that way.
There is currently only one supported option: "lang" which takes
an ISO language code indicating the default language of text within the
vCard data.
- •
- "import_fh($filehandle, %options)"
As per "import_file", but operates on a file handle.
- •
- "import_string($string, %options)"
As per "import_file", but operates on vCard data in a string.
- •
- "import_url($url)"
As per "import_file", but fetches vCard data from a Web address.
Sends an HTTP Accept header of:
text/directory;profile=vCard,
text/vcard,
text/x-vcard,
text/directory;q=0.1
vCard 3.0 should be supported fairly completely. Some vCard 4.0 constructs will
also work.
Much of the heavy lifting is performed by Text::vFile::asData, so this module
may be affected by bugs in that distribution.
RDF Output¶
Output uses the newer of the 2010 revision of the W3C's vCard vocabulary
http://www.w3.org/Submission/vcard-rdf/
<
http://www.w3.org/Submission/vcard-rdf/>. (Note that even though this
was revised in 2010, the term URIs include "2006" in them.)
Some extensions from the namespace <
http://buzzword.org.uk/rdf/vcardx#>
are also output.
The AGENT property is currently omitted from output. This will be added in a
later version.
SEE ALSO¶
RDF::vCard.
http://www.w3.org/Submission/vcard-rdf/
<
http://www.w3.org/Submission/vcard-rdf/>.
<
http://www.perlrdf.org/>.
AUTHOR¶
Toby Inkster <tobyink@cpan.org>.
COPYRIGHT¶
Copyright 2011 Toby Inkster
This library is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.