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
get_one_start
See "get_one_start" in POE::Filter.
get_one
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.