NAME

XML::Generator::RFC822::RDF - generate RDF/XML SAX2 events for RFC822 messages

SYNOPSIS

my $folder = Email::Folder->new($path_mbox);

while (my $msg = $folder->next_message()) {

          my $writer    = XML::SAX::Writer->new();
          my $filter    = XML::Filter::DataIndenter->new(Handler=>$writer);
          my $generator = XML::Generator::RFC822::RDF->new(Handler=>$filter);

          $generator->parse($msg);
      }

DESCRIPTION

Generate RDF/XML SAX2 events for RFC822 messages.

Messages are keyed using SHA1 digests of Message-IDs and email addresses. In the case of the latter this makes it easier to merge messages with contact data that has been serialized using XML::Generator::vCard::RDF (version 1.3+)

DOCUMENT FORMAT

+ rdf:RDF

       + rdf:Description
         @rdf:about = x-urn:ietf:params:rfc822#SHA1([MESSAGEID])
        - rfc822:To 
          @rdf:resource = http://http://xmlns.com/foaf/0.1/mbox_sha1sum#SHA1([EMAILADDRESS])
        - rfc822:From
          @rdf:resource = http://http://xmlns.com/foaf/0.1/mbox_sha1sum#SHA1([EMAILADDRESS])
        - rfc822:Cc
          @rdf:resource = http://http://xmlns.com/foaf/0.1/mbox_sha1sum#SHA1([EMAILADDRESS])
        - rfc822:Return-Path
          @rdf:resource = http://http://xmlns.com/foaf/0.1/mbox_sha1sum#SHA1([EMAILADDRESS])
        - rfc822:Delivered-To
          @rdf:resource = http://http://xmlns.com/foaf/0.1/mbox_sha1sum#SHA1([EMAILADDRESS])
        - rfc822:Reply-To
          @rdf:resource = http://http://xmlns.com/foaf/0.1/mbox_sha1sum#SHA1([EMAILADDRESS])
        - rfc822:In-Reply-To
          @rdf:resource x-urn:ietf:params:rfc822#SHA1([INREPLYTO])
        - rfc8822:References
          @rdf:resource x-urn:ietf:params:rfc822#SHA1([REFERENCES])   
        - rfc822:Date [REFORMATTED AS W3CDTF]
        - rfc822:[ALLOTHERHEADERS]    
        + rfc822:Body
          + rdf:Seq
            - rdf:li
              @rdf:resource = x-urn:ietf:params:rfc822:Body#SHA1([MESSAGEID])_[n]

       # Body/MIME parts
       # (1) or more

       + rdf:Description   
         @rdf:aboout = x-urn:ietf:params:rfc822:Body#SHA1([MESSAGEID])_[n]
         - rfc822:content-type
         - rdf:value

       # To, From, Cc, Return-Path, Delivered-To, Reply-To
       # (1) or more

       + rdf:Descripion
         @rdf:about = http://xmlns.com/foaf/0.1/mbox_sha1sum#SHA1([EMAILADDRESS])
         - vCard:FN
         - vCard:EMAIL

       # In-Reply-To, References
       # (1) or more

       + rdf:Description
         @rdf:about = x-urn:ietf:params:rfc822#SHA1([MESSAGEID]) 
         - rfc822:Message-ID

All MIME values are decoded and everything is encoded as UTF-8.

PACKAGE METHODS
__PACKAGE__->new(%args)
This method is inherited from XML::SAX::Base and returns a XML::Generator::RFC822::RDF object. Additionally, the following parameters are allowed :

• Brief Boolean.

        If true, the parser will ignore a message's body and all headers
        except : To, From, Cc, Return-Path, Delivered-To, Reply-To, Date,
        Subject

        Default is false.

OBJECT METHODS
$obj->parse(@messages)
Where @messages is one or more Email::Simple objects.

VERSION

1.1

DATE

$Date: 2004/12/22 23:21:21 $

AUTHOR

Aaron Straup Cope <ascope@cpan.org>

SEE ALSO

XML::Generator::vCard::RDF

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.