The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

POE::Filter::Postfix - Postfix (MTA) text attribute communication

VERSION

version 0.003

DESCRIPTION

This filter translates between hashrefs and the key-value attribute protocols that the Postfix MTA uses for its internal communications.

Unless you're doing something complicated, you can probably use POE::Component::Server::Postfix instead of this module.

Don't use this module directly. See POE::Filter::Postfix::Null, POE::Filter::Postfix::Base64, and POE::Filter::Postfix::Plain instead.

METHODS

new

Return a new POE::Filter::Postfix.

Call this on a subclass, not on POE::Filter::Postfix directly.

clone

See "clone" in POE::Filter.

get_one_start

See "get_one_start" in POE::Filter.

get_one

See "get_one" in POE::Filter.

get_pending

See "get_pending" in POE::Filter.

decode_key

decode_value

After parsing keys and values, these methods are called to decode them. See POE::Filter::Postfix::Base64 for an example.

The default is to pass keys and values through unchanged.

You do not need to call these methods by hand; get_one calls them automatically.

put

See "put" in POE::Filter.

encode_key

encode_value

Before packing keys and values into a string, these methods are called to encode them. See POE::Filter::Postfix::Base64 for an example.

The default is to pass keys and values through unchanged.

You do not need to call these methods by hand; put calls them automatically.

attribute_separator

attribute_terminator

request_terminator

These methods must be overridden by subclasses.

Each returns a string that will be used to parse and construct requests.

See existing subclasses for examples.

AUTHOR

  Hans Dieter Pearcey <hdp@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2008 by Hans Dieter Pearcey.

This is free software; you can redistribute it and/or modify it under the same terms as perl itself.