NAME

       Mail::Milter::ContextWrapper - Perl extension for wrappering the milter context

SYNOPSIS

           use Mail::Milter::ContextWrapper;

           my $oldctx = ($ctx from callback);

           # in the connect_callback
           $oldctx->setpriv(new Mail::Milter::ContextWrapper($ctx,
               { methodname => \&methodimpl[, ...] }));

           # in all callbacks
           my $newctx = $ctx->getpriv();

           # in the close_callback
           $oldctx->setpriv(undef);

DESCRIPTION

       Mail::Milter::ContextWrapper wraps the milter context with replacement methods defined by
       the caller.  This can be used to intercept context object actions and manipulate them from
       within a Mail::Milter::Wrapper.

       Because the wrappering must occur on every callback, this implementation suggests
       embedding the wrapper inside the private data of the milter itself.  This works with
       existing milters by providing separate "setpriv" and "getpriv" methods within the wrapper
       that do not propagate up to the embedded context object.

METHODS

       new(CTX, { NAME => \&SUB[, ...] })
           Creates a Mail::Milter::ContextWrapper object.  This should be called from the
           "connect" callback and passed back to "setpriv()".

           NAMEs are names of methods to override within the wrapper.  These methods will be
           called with the wrapper as first argument (like a normal object method).

       getpriv()
           Returns a private data item set by "setpriv()".  See Sendmail::Milter for more
           information.  This implementation stores the datum in the wrapper, thus allowing the
           parent context to store a reference to the wrapper itself.

           This method cannot be overridden by the user.

       get_ctx()
           Returns the parent context object stored within this wrapper.  Typically used by
           method overrides to defer back to the real method.

           This method cannot be overridden by the user.

       get_key(NAME)
           Get a keyed data item separate from the "getpriv" private data.  This provides out-of-
           band data storage that need not clobber the single "priv" data item used by most
           milters.

       getpriv()
           Sets a private data item to be returned by "getpriv()".  See Sendmail::Milter for more
           information.  This implementation stores the datum in the wrapper, thus allowing the
           parent context to store a reference to the wrapper itself.

           This method cannot be overridden by the user.

       set_key(NAME, VALUE)
       set_key(NAME => VALUE)
           Set a keyed data item separate from the "getpriv" private data.  This provides out-of-
           band data storage that need not clobber the single "priv" data item used by most
           milters.

AUTHOR

       Todd Vierling, <tv@duh.org> <tv@pobox.com>

SEE ALSO

       Mail::Milter, Sendmail::Milter