Constructor Detail

Method Detail

• isInternal

   final static Boolean isInternal(String url)

• isNotInternal

   final static Boolean isNotInternal(String url)

• getURLOrNull

   final static URL getURLOrNull(String spec)

  Creates a {@code URL} object from the {@code String} representation.

  Parameters:

  spec - the {@code String} to parse as a URL.

• isValidUrl

  @Deprecated(message = "Inappropriate name", replaceWith = @ReplaceWith(imports = {}, expression = "UrlUtils.isStandard(str)")) final static Boolean isValidUrl(String str)

  Test if the str is a standard URL.

  Parameters:

  str - The string to test

• isStandard

   final static Boolean isStandard(String str)

  Test if the str is a standard URL.

  Parameters:

  str - The string to test

• normalize

   final static URL normalize(String url, Boolean ignoreQuery)

  Normalize a url spec.

  A URL may have appended to it a "fragment", also known as a "ref" or a "reference". The fragment is indicated by the sharp sign character "#" followed by more characters. For example: http://java.sun.com/index.html#chapter1

  The fragment will be removed after the normalization. If ignoreQuery is true, the query string will be removed.

  Parameters:

  url -

  The url to normalize, a tailing argument list is allowed and will be removed

  ignoreQuery -

  If true, the result url does not contain a query string

• normalizeOrEmpty

   final static String normalizeOrEmpty(String url, Boolean ignoreQuery)

  Normalize a url spec.

  A URL may have appended to it a "fragment", also known as a "ref" or a "reference". The fragment is indicated by the sharp sign character "#" followed by more characters. For example: http://java.sun.com/index.html#chapter1

  The fragment will be removed after the normalization. If ignoreQuery is true, the query string will be removed.

  Parameters:

  url -

  The url to normalize, a tailing argument list is allowed and will be removed

  ignoreQuery -

  If true, the result url does not contain a query string

• normalizeOrNull

   final static String normalizeOrNull(String url, Boolean ignoreQuery)

  Normalize a url spec.

  A URL may have appended to it a "fragment", also known as a "ref" or a "reference". The fragment is indicated by the sharp sign character "#" followed by more characters. For example: http://java.sun.com/index.html#chapter1

  The fragment will be removed after the normalization. If ignoreQuery is true, the query string will be removed.

  Parameters:

  url -

  The url to normalize, a tailing argument list is allowed and will be removed

  ignoreQuery -

  If true, the result url does not contain a query string

• normalizeUrls

   final static List<String> normalizeUrls(Iterable<String> urls, Boolean ignoreQuery)

• splitQueryParameters

   final Map<String, String> splitQueryParameters(String url)

• getQueryParameters

   final String getQueryParameters(String url, String parameterName)

• removeQueryParameters

   final String removeQueryParameters(String url, String parameterNames)

• keepQueryParameters

   final String keepQueryParameters(String url, String parameterNames)

• resolveURL

   final static URL resolveURL(URL base, String targetUrl)

  Resolve relative URL-s and fix a java.net.URL error in handling of URLs with pure query targets.

  Parameters:

  base - base url

• splitUrlArgs

   final static Pair<String, String> splitUrlArgs(String configuredUrl)

• mergeUrlArgs

   final static String mergeUrlArgs(String url, String args)

• getUrlWithoutParameters

   final static String getUrlWithoutParameters(String url)

• normalizedUrlAndKey

   final static Pair<String, String> normalizedUrlAndKey(String originalUrl, Boolean norm)

• reverseUrl

   final static String reverseUrl(String url)

  Reverses a url's domain. This form is better for storing in hbase. Because scans within the same domain are faster.

  E.g. "http://bar.foo.com:8983/to/index.html?a=b" becomes "com.foo.bar:8983:http/to/index.html?a=b".

  Parameters:

  url - url to be reversed

• reverseUrl

   final static String reverseUrl(URL url)

  Reverses a url's domain. This form is better for storing in hbase. Because scans within the same domain are faster.

  E.g. "http://bar.foo.com:8983/to/index.html?a=b" becomes "com.foo.bar:http:8983/to/index.html?a=b".

  Parameters:

  url - url to be reversed

• reverseUrl

   final static String reverseUrl(Integer tenantId, String unreversedUrl)

  Get the reversed and tenanted format of unreversedUrl, unreversedUrl can be both tenanted or not tenanted This method might change the tenant id of the original url

  Zero tenant id means no tenant

  Parameters:

  unreversedUrl - the unreversed url, can be both tenanted or not tenanted

• reverseUrlOrEmpty

   final static String reverseUrlOrEmpty(String url)

• reverseUrlOrNull

   final static String reverseUrlOrNull(String url)

• unreverseUrl

   final static String unreverseUrl(String reversedUrl)

• unreverseUrl

   final static String unreverseUrl(Integer tenantId, String reversedUrl)

  Get unreversed and tenanted url of reversedUrl, reversedUrl can be both tenanted or not tenanted, This method might change the tenant id of the original url

  Parameters:

  tenantId - the expected tenant id of the reversedUrl

  reversedUrl - the reversed url, can be both tenanted or not tenanted

• unreverseUrlOrNull

   final static String unreverseUrlOrNull(String reversedUrl)

• getStartKey

   final static String getStartKey(Integer tenantId, String unreversedUrl)

  Get start key for tenanted table

  Parameters:

  unreversedUrl - unreversed key, which is the original url

• getStartKey

   final static String getStartKey(String unreversedUrl)

  Get start key for non-tenanted table

  Parameters:

  unreversedUrl - unreversed key, which is the original url

• getEndKey

   final static String getEndKey(String unreversedUrl)

  Get end key for non-tenanted tables

  Parameters:

  unreversedUrl - unreversed key, which is the original url

• getEndKey

   final static String getEndKey(Integer tenantId, String unreversedUrl)

  Get end key for tenanted tables

  Parameters:

  unreversedUrl - unreversed key, which is the original url

• decodeKeyLowerBound

   final static String decodeKeyLowerBound(String startKey)

  We use unicode character \u0001 to be the lower key bound, but the client usally encode the character to be a string "\\u0001" or "\\\\u0001", so we should decode them to be the right one

  Note, the character is displayed as <U></U>+0001> in some output system

  Now, we consider all the three character/string \u0001, "\\u0001", "\\\\u0001" are the lower key bound

• decodeKeyUpperBound

   final static String decodeKeyUpperBound(String endKey)

  We use unicode character \uFFFF to be the upper key bound, but the client usally encode the character to be a string "\\uFFFF" or "\\\\uFFFF", so we should decode them to be the right one

  Note, the character may display as <U></U>+FFFF> in some output system

  Now, we consider all the three character/string \uFFFF, "\\uFFFF", "\\\\uFFFF" are the upper key bound

• getReversedHost

   final static String getReversedHost(String reversedUrl)

  Given a reversed url, returns the reversed host E.g "com.foo.bar:http:8983/to/index.html?a=b" -> "com.foo.bar"

  Parameters:

  reversedUrl - Reversed url

• reverseHost

   final static String reverseHost(String hostName)

• unreverseHost

   final static String unreverseHost(String reversedHostName)

• toString

   final static String toString(CharSequence utf8)

  Convert given Utf8 instance to String and cleans out any offending "�" from the String.

  Parameters:

  utf8 - Utf8 object