A simple java url string builder using StringBuilder behind the scenes.
UrlStringBuilder offers three simple behaviours, construction with a base url or not as well as the appending of paths and/or queries.
Static builder methods are provided for ease of construction.
UrlStringBuilder myUrlBuilder = UrlStringBuilder.emptyUrlBuilder()
or
UrlStringBuilder myUrlBuilder = UrlStringBuilder.basedUrlBuilder("http://trevorgowing.com")
.
Paths can be appended with or without a preceding backslash.
myUrlBuilder.appendPath("/home")
or myUrlBuilder.appendPath("home")
UrlStringBuilder takes care of appending the appropriate preceding character, either: '?' or '&'.
myUrlBuilder.appendQuery("type", "log")
and myUrlBuilder.appendQuery("date", "20170521")
When you are done building your url just call myUrlBuilder.toString()
to get your url string
"http://trevorgowing.com/home?type=log&date=20170521
.
Null and empty String parameter handling
All methods, namely: basedUrlBuilder(String baseUrl)
, appendPath(String path)
and
appendQuery(String queryName, String queryValue)
handle null
and empty
String parameters consistently.
Any null
parameters will result in an
IllegalArgumentException.
Any empty String parameters will result in nothing
being appended.