NAME

XRI::Resolution::Lite - The Lightweight client module for XRI Resolution

VERSION

version 0.04

SYNOPSIS

  use XML::LibXML::XPathContext;
  use XRI::Resolution::Lite;

  my $r = XRI::Resolution::Lite->new;
  my $xrds = $r->resolve('=zigorou'); ### XML::LibXML::Document
  my $ctx = XML::LibXML::XPathContext->new($xrds);
  my @services = $ctx->findnodes('//Service');

METHODS

new

$args

This param must be HASH reference. Available 2 fields.

ua: (Optional) LWP::UserAgent object or its inheritance.
resolver: (Optional) URI string of XRI Proxy Resolver. If this param is omitted, using XRI Global Proxy Resolver, "http://xri.net/", as resolver.

resolve($qxri, \%params, \%media_flags)

When type parameter is substituted "application/xrds+xml" or "application/xrd+xml", the result would be returned as XML::LibXML::Document object. Substituted "text/uri-list" to type parameter, the result would be returned as url list ARRAY or ARRAYREF.

$qxri

Query XRI string. For example :

  =zigorou
  @linksafe
  @id*zigorou

$params

This param must be HASH reference. Available 3 fields. See Section 3.3 of XRI Resolution 2.0. http://docs.oasis-open.org/xri/xri-resolution/2.0/specs/cd03/xri-resolution-V2.0-cd-03.html#_Ref129424065

format: Resolution Output Format. This param would be '_xrd_r' query parameter.
type: Service Type. This param would be '_xrd_t' query parameter.
media: Service Media Type. This param would be '_xrd_m' query parameter.

$media_flags

If you want to specify flag on or off, then substitute to 1 as true, 0 as false.

https: Specifies use of HTTPS trusted resolution. default value is 0.
saml: Specifies use of SAML trusted resolution. default value is 0.
refs: Specifies whether Refs should be followed during resolution (by default they are followed), default value is 1.
sep: Specifies whether service endpoint selection should be performed. default value is 0.
nodefault_t: Specifies whether a default match on a Type service endpoint selection element is allowed. default value is 1.
nodefault_p: Specifies whether a default match on a Path service endpoint selection element is allowed. default value is 1.
nodefault_m: Specifies whether a default match on a MediaType service endpoint selection element is allowed. default value is 1.
uric: Specifies whether a resolver should automatically construct service endpoint URIs. default value is 0.
cid: Specifies whether automatic canonical ID verification should performed. default value is 1

AUTHOR

Toru Yamaguchi, <zigorou@cpan.org>

BUGS

Please report any bugs or feature requests to bug-xri-resolution-lite@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT & LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.