NAME
Badger::Codec::Chain - encode/decode data using multiple codecs
SYNOPSIS
use Badger::Codec::Chain;
# compact form
my $codec = Badger::Codec::Chain->new('storable+base64');
# explicit form
my $codec = Badger::Codec::Chain->new('storable', 'base64');
# encode/decode data using codec chain
my $enc = $codec->encode({ pi => 3.14, e => 2.718 });
my $dec = $codec->decode($encoded);
DESCRIPTION
This module implements a subclass of Badger::Codec which chains together any number of other codec modules.
METHODS
new(@codecs)
Constructor method to create a new codec chain. The codecs can be specified by name or as references to Badger::Codec objects.
# by name
my $codec = Badger::Codec::Chain->new('storable', 'base64');
# by object reference
my $codec = Badger::Codec::Chain->new(
Badger::Codec->codec('storable'),
Badger::Codec->codec('base64'),
);
You can also use the compact form where multiple codec names are separated by +
.
# compact form
my $codec = Badger::Codec::Chain->new('storable+base64');
encode($data)
Encodes the data referenced by the first argument using all the codecs in the chain.
$encoded = $codec->encode($data);
decode($html)
Decodes the encoded data passed as the first argument using all the codecs in the chain in reverse order.
$decoded = $codec->decode($encoded);
encoder()
Returns a reference to a subroutine which performs the encoding operation.
decoder()
Returns a reference to a subroutine which performs the decoding operation.
INTERNAL METHODS
coder(@coders)
Internal method to construct an encoder or decoder subroutine for a codec chain.
AUTHOR
Andy Wardley http://wardley.org/
COPYRIGHT
Copyright (C) 2005-2009 Andy Wardley. All rights reserved.