jifty::json(3pm) [debian man page]

Jifty::JSON(3pm)					User Contributed Perl Documentation					  Jifty::JSON(3pm)

NAME

       Jifty::JSON -- Wrapper around JSON

SYNOPSIS

	 use Jifty::JSON qw/decode_json encode_json/;

	 my $obj  = decode_json(q! { "x": "1", "y": "2", "z": "3" } !);
	 my $json = encode_json($obj);

DESCRIPTION

       Provides a thin wrapper around the JSON 2.xx library, which provides a frontend for JSON::XS and JSON::PP.

       This module used to wrap JSON::Syck and JSON 1.xx with special-casing for outputting JSON with single quoted values.  Single quotes make it
       easy to simply plop JSON into HTML attributes but are in violation of the JSON spec which mandates only double quoted strings.

       The old behavior is now unsupported and it is recommended that you simply HTML escape your entire blob of JSON if you are sticking it in an
       HTML attribute.	You can use Jifty->web->escape() to properly escape problematic characters for HTML.

FUNCTIONS

   decode_json JSON, [ARGUMENT HASHREF]
   encode_json JSON, [ARGUMENT HASHREF]
       These functions are just like JSON's, except that you can pass options to them like you can with JSON's "from_json" and "to_json"
       functions.

       By default they encode/decode using UTF8 (like JSON's functions of the same name), but you can turn that off by passing "utf8 => 0" in the
       options.  The allow_nonref flag is also enabled for backwards compatibility with earlier versions of this module.  It allows
       encoding/decoding of values that are not references.

       JSON is imported with the "-support_by_pp" flag in order to support all options that JSON::PP provides when using JSON::XS as the backend.
       If you are concerned with speed, be careful what options you specify as it may cause the pure Perl backend to be used.  Read "JSON::PP
       SUPPORT METHODS" in JSON for more information.

DEPRECATED FUNCTIONS

   jsonToObj JSON, [ARGUMENTS]
   objToJson JSON, [ARGUMENTS]
       These functions are deprecated and provided for backwards compatibility.  They wrap the appropriate function above, but "croak" in Carp if
       you try to set the "singlequote" option.

LICENSE

       Jifty is Copyright 2005-2010 Best Practical Solutions, LLC.  Jifty is distributed under the same terms as Perl itself.

perl v5.14.2							    2010-12-08							  Jifty::JSON(3pm)

JSON::RPC::Server::Apache2(3pm) 			User Contributed Perl Documentation			   JSON::RPC::Server::Apache2(3pm)

NAME

       JSON::RPC::Server::Apache2 - JSON-RPC sever for mod_perl2

SYNOPSIS

	# In apache conf

	PerlRequire /your/path/start.pl
	PerlModule MyApp

	<Location /jsonrpc/API>
	     SetHandler perl-script
	     PerlResponseHandler JSON::RPC::Server::Apache
	     PerlSetVar dispatch "MyApp"
	     PerlSetVar return_die_message 0
	</Location>

	#--------------------------
	# In your application class
	package MyApp;

	use base qw(JSON::RPC::Procedure); # Perl 5.6 or more than

	sub echo : Public {    # new version style. called by clients
	    # first argument is JSON::RPC::Server object.
	    return $_[1];
	}

	sub sum : Public(a:num, b:num) { # sets value into object member a, b.
	    my ($s, $obj) = @_;
	    # return a scalar value or a hashref or an arryaref.
	    return $obj->{a} + $obj->{b};
	}

	sub a_private_method : Private {
	    # ... can't be called by client
	}

	sub sum_old_style {  # old version style. taken as Public
	    my ($s, @arg) = @_;
	   return $arg[0] + $arg[1];
	}

DESCRIPTION

       Gets a client request.

       Parses its JSON data.

       Passes the server object and the object decoded from the JSON data to your procedure (method).

       Takes your returned value (scalar or arrayref or hashref).

       Sends a response.

       Well, you write your procedure code only.

METHODS

       They are inherited from the JSON::RPC::Server methods basically.  The below methods are implemented in JSON::RPC::Server::Apache2.

       new Creates new JSON::RPC::Server::Apache2 object.

       handle
	   Runs server object and returns a response.

       retrieve_json_from_post
	   retrieves a JSON request from the body in POST method.

       retrieve_json_from_get
	   In the protocol v1.1, 'GET' request method is also allowable.  it retrieves a JSON request from the query string in GET method.

       response
	   returns a response JSON data to a client.

SEE ALSO

       JSON::RPC::Server,

       JSON::RPC::Procedure,

       JSON,

       <http://json-rpc.org/wd/JSON-RPC-1-1-WD-20060807.html>,

       <http://json-rpc.org/wiki/specification>,

AUTHOR

       Makamaka Hannyaharamitu, <makamaka[at]cpan.org>

COPYRIGHT AND LICENSE

       Copyright 2007-2008 by Makamaka Hannyaharamitu

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

perl v5.10.1							    2008-09-01					   JSON::RPC::Server::Apache2(3pm)