Initial Commit

database/perl/vendor/lib/SOAP/Transport/POP3.pm

@@ -0,0 +1,121 @@
+# ======================================================================
+#
+# 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