Modify Interface to Query Parameters

[fhessel]

This PR changes the naming of parameter types to reflect a more common scheme. It also provides access to an iterator over the query parameters (/?foo=1&bar=2) to retrieve parameters with arbitrary names or multi-valued parameters.

New Features

• Provide access to all query parameters in ResourceParameters using an iterator:
  • Added ResourceParameters::beginQueryParameters()
  • Added ResourceParameters::endQueryParameters()
• Allow retrieving the count of query parameters:
  • Added ResourceParameters::getQueryParameterCount(bool unique)
• Allow checking and retrieving path parameters safely:
  • Added bool getPathParameter(size_t const idx, std::string &value)

Breaking Changes

As changing the interface is a breaking change as such, this PR also changes the naming of request-related parameters to be more common and comprehensible. The "URL parameters" have become "path parameters", and "request parameters" are now "query parameters" like they're called in the RFC.

• Drop ResourceParameters::getRequestParameterInt()
  • Alternative: use std::atoi(str.c_str()) (see Parameters example for details)
• Drop ResourceParameters::getUrlParameterInt()
  • Alternative: use std::atoi(str._cstr()) (see Parameters example for details)
• Rename ResourceParameter::isRequestParameterSet() to ResourceParameter::isQueryParameterSet()
• Replace std::string ResourceParameter::getRequestParameter(std::string const &name) by bool ResourceParameter::getQueryParameter(std::string const &name, std::string &val)
  • This allows to differentiate between unset and empty parameters (see Support efficient parsing of Request ResourceParameters #62)
• Rename std::string ResourceParameter::getURLParameter(std::string const &name) to std::string ResourceParameter::getPathParameter(std::string const &name)
• Rename uint8_t HTTPNode::getUrlParamCount() to size_t HTTPNode::getPathParamCount()

References

• Closes Support efficient parsing of Request ResourceParameters #62
• Closes Support multiply query ResourceParameters with same name #63