Document that uri throws.

[htmldoug]

Pull Request Checklist

• Have you read through the contributor guidelines?
• Have you signed the Typesafe CLA?
• Have you squashed your commits?
• Have you added copyright headers to new files?
• Have you checked that both Scala and Java APIs are updated?
• Have you updated the documentation for both Scala and Java sections?
• Have you added tests for any changed functionality?

Fixes

Documents the surprising behavior of #267.

Purpose

Documents that lazy val uri: URI throws.

Background Context

@marcospereira suggested in #267 (comment) that def url(url: String): StandaloneWSRequest should be tolerant of urls which include query params. I submit #288, but was not successful in getting it reviewed a second time and merged. URLs are hairy and I can understand why you may not trust the robustness of a community provided solution. #288 has been unmerged for about a year now, and marked status: backlog so I've closed it.

Instead, this PR just documents the current behavior, hopefully to prevent others from discovering it in prod as I did. I've also added a failing unit test.

References

• StandaloneWSClient.url(String) permits inconsistent states with query params #267 - original issue
• WSRequest: Normalize URL #288 - proposed solution

[htmldoug]

Closing due to lack of review.