NAME RDF::KV - Embed RDF linked data in plain old HTML forms VERSION Version 0.07 SYNOPSIS my $kv = RDF::KV->new( subject => $uri, # ordinarily the Request-URI graph => $graphuri, # URI for the default graph namespaces => $ns, # default namespace prefix map callback => \&rewrite, # form-results-rewriting callback ); # Processes a hashref-of-parameters, like found in Catalyst or # Plack::Request. This call will ignore obviously non-matching # keys, but will croak on botched attempts to use the protocol. my $patch = eval { $kv->process($params) }; if ($@) { # return 409 Conflict ... } # add/remove statements from the graph $patch->apply($model); DESCRIPTION This module provides a reference implementation for the RDF-KV protocol <http://doriantaylor.com/rdf-kv>. The objective of this protocol is to convey RDF linked data from a web browser to a web server using no mechanism beyond conventional "application/x-www-form-urlencoded" HTML forms. The overarching purpose is to facilitate the development of linked data applications by making the apparatus of JavaScript an *optional*, rather than a *mandatory*, consideration. This protocol implementation works by culling key-value pairs denoted in a prescribed syntax from POSTed form input (parsed by something like CGI, Plack::Request or Catalyst), and then stitching them together to create a patch object which is then applied to an RDF::Trine::Model graph. METHODS new Instantiate the object. The following parameters are also (read-only) accessors. subject This is the default subject URI (or blank node). graph This is the default graph URI. namespaces This URI::NamespaceMap object will enable URI abbreviation through the use of CURIEs in form input. callback Supply a callback function that will be applied to subject and object values, for instance to rewrite a URI. The return value of this function must be understood by "add_this" in RDF::KV::Patch. process \%CONTENT Process form content and return an RDF::KV::Patch object. This is the only significant method. CAVEATS BYOS == Bring Your Own Security. AUTHOR Dorian Taylor, "<dorian at cpan.org>" BUGS Please report any bugs or feature requests to "bug-rdf-kv at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=RDF-KV>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. SUPPORT You can find documentation for this module with the perldoc command. perldoc RDF::KV You can also look for information at: * RT: CPAN's request tracker (report bugs here) <http://rt.cpan.org/NoAuth/Bugs.html?Dist=RDF-KV> * AnnoCPAN: Annotated CPAN documentation <http://annocpan.org/dist/RDF-KV> * CPAN Ratings <http://cpanratings.perl.org/d/RDF-KV> * Search CPAN <http://search.cpan.org/dist/RDF-KV/> SEE ALSO RDF::KV::Patch URI::BNode RDF::Trine LICENSE AND COPYRIGHT Copyright 2013 Dorian Taylor. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at <http://www.apache.org/licenses/LICENSE-2.0>. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.