122 lines
3.5 KiB
Perl
122 lines
3.5 KiB
Perl
# ======================================================================
|
|
#
|
|
# Copyright (C) 2000-2001 Paul Kulchenko (paulclinger@yahoo.com)
|
|
# SOAP::Lite is free software; you can redistribute it
|
|
# and/or modify it under the same terms as Perl itself.
|
|
#
|
|
# ======================================================================
|
|
|
|
package SOAP::Transport::POP3;
|
|
|
|
use strict;
|
|
|
|
our $VERSION = '1.27'; # VERSION
|
|
|
|
use Net::POP3;
|
|
use URI;
|
|
|
|
# ======================================================================
|
|
|
|
package SOAP::Transport::POP3::Server;
|
|
|
|
use Carp ();
|
|
use vars qw(@ISA $AUTOLOAD);
|
|
@ISA = qw(SOAP::Server);
|
|
|
|
sub DESTROY { my $self = shift; $self->quit if $self->{_pop3server} }
|
|
|
|
sub new {
|
|
my $class = shift;
|
|
return $class if ref $class;
|
|
|
|
my $address = shift;
|
|
Carp::carp "URLs without 'pop://' scheme are deprecated. Still continue"
|
|
if $address =~ s!^(pop://)?!pop://!i && !$1;
|
|
my $server = URI->new($address);
|
|
my $self = $class->SUPER::new(@_);
|
|
$self->{_pop3server} = Net::POP3->new($server->host_port)
|
|
or Carp::croak "Can't connect to '@{[$server->host_port]}': $!";
|
|
my $method = ! $server->auth || $server->auth eq '*'
|
|
? 'login'
|
|
: $server->auth eq '+APOP'
|
|
? 'apop'
|
|
: Carp::croak "Unsupported authentication scheme '@{[$server->auth]}'";
|
|
$self->{_pop3server}->$method( split m{:}, $server->user() )
|
|
or Carp::croak "Can't authenticate to '@{[$server->host_port]}' with '$method' method"
|
|
if defined $server->user;
|
|
return $self;
|
|
}
|
|
|
|
sub AUTOLOAD {
|
|
my $method = substr($AUTOLOAD, rindex($AUTOLOAD, '::') + 2);
|
|
return if $method eq 'DESTROY';
|
|
|
|
no strict 'refs';
|
|
*$AUTOLOAD = sub { shift->{_pop3server}->$method(@_) };
|
|
goto &$AUTOLOAD;
|
|
}
|
|
|
|
sub handle {
|
|
my $self = shift->new;
|
|
my $messages = $self->list or return;
|
|
# fixes [ 1.17700 ] POP3 Processes Messages Out of Order
|
|
foreach my $msgid (sort { $a <=> $b } (keys(%{$messages}) ) ) {
|
|
# foreach my $msgid (keys %$messages) {
|
|
$self->SUPER::handle(join '', @{$self->get($msgid)});
|
|
} continue {
|
|
$self->delete($msgid);
|
|
}
|
|
return scalar keys %$messages;
|
|
}
|
|
|
|
sub make_fault { return }
|
|
|
|
# ======================================================================
|
|
|
|
1;
|
|
|
|
__END__
|
|
|
|
=head1 NAME
|
|
|
|
SOAP::Transport::POP3 - Server side POP3 support for SOAP::Lite
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
use SOAP::Transport::POP3;
|
|
|
|
my $server = SOAP::Transport::POP3::Server
|
|
-> new('pop://pop.mail.server')
|
|
# if you want to have all in one place
|
|
# -> new('pop://user:password@pop.mail.server')
|
|
# or, if you have server that supports MD5 protected passwords
|
|
# -> new('pop://user:password;AUTH=+APOP@pop.mail.server')
|
|
# specify list of objects-by-reference here
|
|
-> objects_by_reference(qw(My::PersistentIterator My::SessionIterator My::Chat))
|
|
# specify path to My/Examples.pm here
|
|
-> dispatch_to('/Your/Path/To/Deployed/Modules', 'Module::Name', 'Module::method')
|
|
;
|
|
# you don't need to use next line if you specified your password in new()
|
|
$server->login('user' => 'password') or die "Can't authenticate to POP3 server\n";
|
|
|
|
# handle will return number of processed mails
|
|
# you can organize loop if you want
|
|
do { $server->handle } while sleep 10;
|
|
|
|
# you may also call $server->quit explicitly to purge deleted messages
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright (C) 2000-2001 Paul Kulchenko. All rights reserved.
|
|
|
|
This library is free software; you can redistribute it and/or modify
|
|
it under the same terms as Perl itself.
|
|
|
|
=head1 AUTHOR
|
|
|
|
Paul Kulchenko (paulclinger@yahoo.com)
|
|
|
|
=cut
|