REST::Neo4p::ParseStream - Parse Neo4j REST responses on the fly
Not for human consumption. This module is ignored by the Neo4j::Driver-based agent.
This module helps REST::Neo4p exploit the Neo4j server's chunked transfer encoding of its JSON REST responses. It is based on the fast JSON::XS incremental parser and MJD's Higher Order Perl ideas as implemented in HOP::Stream.
The goal is to be able to pull in objects from the server stream as soon as they are available. In practice, this means specifically finding and incrementally processing the potentially large arrays of objects that are returned from cypher queries, transaction queries, and batch requests.
Because of inconsistencies among the Neo4j response formats for each of these functions, this module does a significant amount of "hand-parsing". Currently the code will not be very robust to changes in those response formats. If you find your query handling is breaking with a new server version, make a ticket. In the meantime, you should be able to keep things going (albeit more slowly) by turning off streaming at the agent:
use REST::Neo4p; REST::Neo4p->agent->no_stream; ...
REST::Neo4p, REST::Neo4p::Query, REST::Neo4p::Batch, HOP::Stream, "INCREMENTAL PARSING" in JSON::XS.
Mark A. Jensen CPAN ID: MAJENSEN majensen -at- cpan -dot- org
Copyright (c) 2012-2022 Mark A. Jensen. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install REST::Neo4p, copy and paste the appropriate command in to your terminal.
cpanm
cpanm REST::Neo4p
CPAN shell
perl -MCPAN -e shell install REST::Neo4p
For more information on module installation, please visit the detailed CPAN module installation guide.