alluxio.util

Class URIUtils

java.lang.Object

alluxio.util.URIUtils

@ThreadSafe
public final class URIUtils
extends Object

Utility methods for working with URIs.

Field Summary

Fields

Modifier and Type	Field and Description
static char	QUERY_KEY_VALUE_SEPARATOR
static char	QUERY_SEPARATOR

Method Summary

Modifier and Type	Method and Description
static URI	appendPath(URI base, String path) Appends the given path to the given base URI.
static URI	appendPathOrDie(URI base, String path) Appends the given path to the given base URI.
static int	compare(String s1, String s2)
static boolean	equals(String s1, String s2) Checks if two (nullable) strings are equal.
static String	generateQueryString(Map<String,String> queryMap) Generates a query string from a Map of key/value pairs.
static int	hash(int hash, String s) Hashes a string for a URI hash.
static int	hashIgnoreCase(int hash, String s) Hashes a string for a URI hash, while ignoring the case.
static boolean	isLocalFilesystem(String uri)
static boolean	needsNormalization(String path) Returns true if the path requires normalization.
static Map<String,String>	parseQueryString(String query) Parses the given query string, and returns a map of the query parameters.
static int	toLower(char c)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

QUERY_SEPARATOR

public static final char QUERY_SEPARATOR

See Also:

Constant Field Values

QUERY_KEY_VALUE_SEPARATOR

public static final char QUERY_KEY_VALUE_SEPARATOR

See Also:

Constant Field Values

Method Detail

appendPath

public static URI appendPath(URI base,
                             String path)
                      throws URISyntaxException

Appends the given path to the given base URI.

Parameters:

base - the base URI

path - the path to append

Returns:

the URI resulting from appending the base and the path

Throws:

URISyntaxException - if URI syntax error is encountered

appendPathOrDie

public static URI appendPathOrDie(URI base,
                                  String path)

Appends the given path to the given base URI. It throws an RuntimeException if the inputs are malformed.

Parameters:

base - the base URI

path - the path to append

Returns:

the URI resulting from appending the base and the path

generateQueryString

@Nullable
public static String generateQueryString(Map<String,String> queryMap)

Generates a query string from a Map of key/value pairs.

Parameters:

queryMap - the map of query key/value pairs

Returns:

the generated query string, null if the input map is null or empty

parseQueryString

public static Map<String,String> parseQueryString(String query)

Parses the given query string, and returns a map of the query parameters.

Parameters:

query - the query string to parse

Returns:

the map of query keys and values

isLocalFilesystem

public static boolean isLocalFilesystem(String uri)

Parameters:

uri - a uri to check

Returns:

whether the uri represents a local filesystem UFS path

compare

public static int compare(String s1,
                          String s2)

Parameters:

s1 - first string (can be null)

s2 - second string (can be null)

Returns:

negative integer, zero, or positive integer, if the first string is less than, equal to, or greater than the second string

equals

public static boolean equals(String s1,
                             String s2)

Checks if two (nullable) strings are equal. Handles `%` codes in URIs.

Parameters:

s1 - the first string to compare (can be null)

s2 - the second string to compare (can be null)

Returns:

true if the strings are equal

toLower

public static int toLower(char c)

Parameters:

c - the character to convert

Returns:

the lowercase counterpart to the input character

needsNormalization

public static boolean needsNormalization(String path)

Returns true if the path requires normalization. A path needs normalization if it has segments of: ".", "..", or consecutive "/".

Parameters:

path - path to check

Returns:

true if the path requires normalization

hash

public static int hash(int hash,
                       String s)

Hashes a string for a URI hash. Handles octets.

Parameters:

hash - the input hash

s - the string to hash and combine with the input hash

Returns:

the resulting hash

hashIgnoreCase

public static int hashIgnoreCase(int hash,
                                 String s)

Hashes a string for a URI hash, while ignoring the case.

Parameters:

hash - the input hash

s - the string to hash and combine with the input hash

Returns:

the resulting hash