NAME

Search::QS - A converter between query string URI and search query

VERSION

version 0.04

SYNOPSIS

  use Search::QS;

  my $qs = new Search::QS;
  # parse query_string
  $qs->parse_qs($qs);
  # reconvert object to query_string
  print $qs->to_qs;

DESCRIPTION

This module converts a query string like This

  http://www.example.com?flt[Name]=Foo

into perl objects which rappresent a search.

In "filters()" there are all flt (filter) elements.

In "options()" there are query options like limit, start and sorting.

METHODS

filters()

Return an instance of Search::QS::Filters

options()

Return an instance of Search::QS::Options

parse($perl_struct)

$perl_struct is an HASHREF which represents a query string like the one returned by "url_params_mixed" in URI::Encode. It parses the $perl_struct and fills related objects in "filters()" and "options()"

to_qs()

Return a query string which represents current state of filters() and options() elements

Examples

Here some Examples.

?flt[Name]=Foo

should be converted into

  Name = 'Foo'

?flt[Name]=Foo%&flt[Name]=$op:like

should be converted into

  Name like 'Foo%'

?flt[age]=5&flt[age]=9&flt[Name]=Foo

should be converted into

  (age = 5 OR age = 9) AND (Name = Foo)

?flt[FirstName]=Foo&flt[FirstName]=$or:1&flt[LastName]=Bar&flt[LastName]=$or:1

should be converted into

  ( (FirstName = Foo) OR (LastName = Bar) )

?flt[c:one]=1&flt[c:one]=$and:1&flt[d:one]=2&flt[d:one]=$and:1&flt[c:two]=2&flt[c:two]=$and:2&flt[d:two]=3&flt[d:two]=$op:!=&flt[d:two]=$and:2&flt[d:three]=10

should be converted into

  (d = 10) AND  ( (c = 1) AND (d = 2) )  OR  ( (c = 2) AND (d != 3) )

SEE ALSO

Search::QS::Filters, Search::QS::Filter, Search::QS::Options

AUTHOR

Emiliano Bruni <info@ebruni.it>

COPYRIGHT AND LICENSE

This software is copyright (c) 2019 by Emiliano Bruni.

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

cpanm Search::QS

perl -MCPAN -e shell
install Search::QS