Aaron Straup Cope > Apache-XPointer-1.0 > Apache::XPointer

Download:
Apache-XPointer-1.0.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
Report a bug
Module Version: 1.0   Source   Latest Release: Apache-XPointer-1.1

NAME ^

Apache::XPointer - mod_perl handler to address XML fragments.

SYNOPSIS ^

 <Directory /foo/bar>

  <FilesMatch "\.xml$">
   SetHandler   perl-script
   PerlHandler  Apache::XPointer::XPath
  </FilesMatch>

 </Directory>

 #

 my $ua  = LWP::UserAgent->new();
 my $req = HTTP::Request->new(GET => "http://example.com/foo/bar/baz.xml");
 $req->header("Range" => qq(xmlns("x=x-urn:example")xpointer(*//x:thingy)));

 my $res = $ua->request($req);

DESCRIPTION ^

Apache::XPointer is a mod_perl handler to address XML fragments using the HTTP 1.1 Range header, as described in the paper : A Semantic Web Resource Protocol: XPointer and HTTP.

Additionally, the handler may also be configured to recognize a conventional CGI parameter as a valid range identifier.

If no 'range' property is found, then the original document is sent unaltered.

IMPORTANT ^

This package is a base class and not expected to be invoked directly. Please use one of the scheme-specific handlers instead.

SUPPPORTED SCHEMES ^

XPath

Consult Apache::XPointer::XPath

MOD_PERL COMPATIBILITY ^

This handler will work with both mod_perl 1.x and mod_perl 2.x; it works better in 1.x because it supports Apache::Request which does a better job of parsing CGI parameters.

VERSION ^

1.0

DATE ^

$Date: 2004/11/13 21:13:40 $

AUTHOR ^

Aaron Straup Cope <ascope@cpan.org>

SEE ALSO ^

http://www.mindswap.org/papers/swrp-iswc04.pdf

http://www.w3.org/TR/WD-xptr

LICENSE ^

Copyright (c) 2004 Aaron Straup Cope. All rights reserved.

This is free software, you may use it and distribute it under the same terms as Perl itself.