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

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

NAME

       Test::JSON - Test JSON data

VERSION

       Version 0.11

SYNOPSIS

	use Test::JSON;

	is_valid_json $json,		     '... json is well formed';
	is_json       $json, $expected_json, '... and it matches what we expected';

EXPORT

       o   is_valid_json

       o   is_json

DESCRIPTION

       JavaScript Object Notation (JSON) is a lightweight data interchange format.  Test::JSON makes it easy to verify that you have built valid
       JSON and that it matches your expected output.

       See <http://www.json.org/> for more information.

TESTS

   is_valid_json
	is_valid_json $json, '... json is well formed';

       Test passes if the string passed is valid JSON.

   is_json
	is_json $json, $expected_json, '... and it matches what we expected';

       Test passes if the two JSON strings are valid JSON and evaluate to the same data structure.

       Test::Differences is used to provide easy diagnostics of why the JSON structures did not match.	For example:

	  Failed test '... and identical JSON should match'
	  in t/10testjson.t at line 14.
	+----+---------------------------+---------------------------+
	| Elt|Got			 |Expected		     |
	+----+---------------------------+---------------------------+
	|   0|{ 			 |{			     |
	|   1|	bool => '1',		 |  bool => '1',	     |
	|   2|	description => bless( {  |  description => bless( {  |
	|   3|	  value => undef	 |    value => undef	     |
	|   4|	}, 'JSON::NotString' ),  |  }, 'JSON::NotString' ),  |
	|   5|	id => '1',		 |  id => '1',		     |
	*   6|	name => 'foo'		 |  name => 'fo'	     *
	|   7|} 			 |}			     |
	+----+---------------------------+---------------------------+

AUTHOR

       Curtis "Ovid" Poe, "<ovid@cpan.org>"

BUGS

       Please report any bugs or feature requests to "bug-test-json@rt.cpan.org", or through the web interface at
       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-JSON>.  I will be notified, and then you'll automatically be notified of progress on
       your bug as I make changes.

SEE ALSO

       This test module uses JSON::Any and Test::Differences.

ACKNOWLEDGEMENTS

       The development of this module was sponsored by Kineticode, <http://www.kineticode.com/>, the leading provider of services for the
       Bricolage content management system, <http://www.bricolage.cc/>.

       Thanks to Makamaka Hannyaharamitu "makamaka@cpan.org" for a patch to make this work with JSON 2.0.

       Thanks to Stevan Little for suggesting a switch to JSON::Any.  This makes it easier for this module to work with whatever JSON module you
       have installed.

COPYRIGHT &; LICENSE
       Copyright 2005-2007 Curtis "Ovid" Poe, all rights reserved.

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

perl v5.10.1							    2009-08-09							   Test::JSON(3pm)

Check Out this Related Man Page

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)

Linux and UNIX Man Pages

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

Check Out this Related Man Page