NAME

AxKit2::Processor - AxKit's core XML processing engine

DESCRIPTION

The Processor is provided to the xmlresponse hook in order to facilitate transforming XML prior to being output to the browser. A typical XSLT example might look like this:

  sub hook_xmlresponse {
    my ($self, $input) = @_;
    
    # $input is a AxKit2::Processor object
    
    my $stylesheet = './myfirstplugin/stylesheets/default.xsl';
    my $out = $input->transform(XSLT($stylesheet));
    
    # $out is also an AxKit2::Processor object
    
    return OK, $out;
  }

API

`CLASS->new( CLIENT, PATH [, INPUT [, OUTPUT]] )`

Normally you would not need to call the constructor - this is done for you.

`$obj->path`

Returns the path to the object being requested. Normally the same as the request filename.

This method returns the input DOM if there was one. This may be useful for a transformer to know - for example XSP will need to recompile its code if there was an input DOM because it implies XSP -> XSP.

Normally you would just access the input DOM via $obj->dom.

`$obj->client`

The AxKit2::Connection object for this request.

`$obj->dom( [ INPUT ] )`

Get/set the DOM for whatever is being transformed. Auto-generates a DOM if there wasn't one already stored in the input.

See XML::LibXML::Document for the DOM API.

`$obj->output()`

Sends the transformation result to the browser. You do not need to call this as it is performed by AxKit when you return (OK, PROCESSOR) from your xmlresponse hook.

`$obj->transform( LIST )`

Performs the transformations specified in LIST. The transform method is extremely flexible in how it will accept this list of transformations.

The following are all equivalent:

As strings:

  $input->transform(qw(
            XSP
            XSLT(/path/to/stylesheet.xsl)
            XSLT(/path/to/xml2html.xsl)
            ));

Via helper functions:

  $input->transform(
        XSP()
     => XSLT("/path/to/stylesheet.xsl")
     => XSLT("/path/to/xml2html.xsl")
     );

By constructing transformers directly:

  $input->transform(
        AxKit2::Transformer::XSP->new(),
        AxKit2::Transformer::XSLT->new("/path/to/stylesheet.xsl"),
        AxKit2::Transformer::XSLT->new("/path/to/xml2html.xsl"),
    );

Note that XSLT() can take a list of key/value pairs to pass to the stylesheet as parameters. Unlike AxKit1 the stylesheet does NOT automatically get access to all the querystring parameters - you have to explicitly pass these in.

CPAN RT