1# ======================================================================
2#
3# Copyright (C) 2000-2004 Paul Kulchenko (paulclinger@yahoo.com)
4# SOAP::Lite is free software; you can redistribute it
5# and/or modify it under the same terms as Perl itself.
6#
7# $Id: POP3.pm,v 1.1 2004/10/16 17:45:17 byrnereese Exp $
8#
9# ======================================================================
10
11__END__
12
13=head1 NAME
14
15SOAP::Transport::POP3 - Server side POP3 support for SOAP::Lite
16
17=head1 SYNOPSIS
18
19  use SOAP::Transport::POP3;
20
21  my $server = SOAP::Transport::POP3::Server
22    -> new('pop://pop.mail.server')
23    # if you want to have all in one place
24    # -> new('pop://user:password@pop.mail.server')
25    # or, if you have server that supports MD5 protected passwords
26    # -> new('pop://user:password;AUTH=+APOP@pop.mail.server')
27    # specify list of objects-by-reference here
28    -> objects_by_reference(qw(My::PersistentIterator My::SessionIterator My::Chat))
29    # specify path to My/Examples.pm here
30    -> dispatch_to('/Your/Path/To/Deployed/Modules', 'Module::Name', 'Module::method')
31  ;
32  # you don't need to use next line if you specified your password in new()
33  $server->login('user' => 'password') or die "Can't authenticate to POP3 server\n";
34
35  # handle will return number of processed mails
36  # you can organize loop if you want
37  do { $server->handle } while sleep 10;
38
39  # you may also call $server->quit explicitly to purge deleted messages
40
41=head1 DESCRIPTION
42
43=head1 COPYRIGHT
44
45Copyright (C) 2000-2001 Paul Kulchenko. All rights reserved.
46
47This library is free software; you can redistribute it and/or modify
48it under the same terms as Perl itself.
49
50=head1 AUTHOR
51
52Paul Kulchenko (paulclinger@yahoo.com)
53
54=cut
55