Class URIUtil
- java.lang.Object
-
- org.apache.commons.httpclient.util.URIUtil
-
@Deprecated public class URIUtil extends Object
Deprecated.Jakarta Commons HttpClient 3.x is deprecated in the Jenkins project. It is not recommended to use it in any new code. Instead, use HTTP client API plugins as a dependency in your code. E.g. Apache HttpComponents Client API 4.x Plugin or Async HTTP Client Plugin.
-
-
Constructor Summary
Constructors Constructor Description URIUtil()
Deprecated.
-
Method Summary
All Methods Static Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static String
decode(String escaped)
Deprecated.Unescape and decode a given string regarded as an escaped string with the default protocol charset.static String
decode(String escaped, String charset)
Deprecated.Unescape and decode a given string regarded as an escaped string.static String
encode(String unescaped, BitSet allowed)
Deprecated.Escape and encode a given string with allowed characters not to be escaped and the default protocol charset.static String
encode(String unescaped, BitSet allowed, String charset)
Deprecated.Escape and encode a given string with allowed characters not to be escaped and a given charset.static String
encodeAll(String unescaped)
Deprecated.Get the all escaped and encoded string with the default protocl charset.static String
encodeAll(String unescaped, String charset)
Deprecated.Get the all escaped and encoded string with a given charset.static String
encodePath(String unescaped)
Deprecated.Escape and encode a string regarded as the path component of an URI with the default protocol charset.static String
encodePath(String unescaped, String charset)
Deprecated.Escape and encode a string regarded as the path component of an URI with a given charset.static String
encodePathQuery(String unescaped)
Deprecated.Escape and encode a string regarded as the path and query components of an URI with the default protocol charset.static String
encodePathQuery(String unescaped, String charset)
Deprecated.Escape and encode a string regarded as the path and query components of an URI with a given charset.static String
encodeQuery(String unescaped)
Deprecated.Escape and encode a string regarded as the query component of an URI with the default protocol charset.static String
encodeQuery(String unescaped, String charset)
Deprecated.Escape and encode a string regarded as the query component of an URI with a given charset.static String
encodeWithinAuthority(String unescaped)
Deprecated.Escape and encode a string regarded as within the authority component of an URI with the default protocol charset.static String
encodeWithinAuthority(String unescaped, String charset)
Deprecated.Escape and encode a string regarded as within the authority component of an URI with a given charset.static String
encodeWithinPath(String unescaped)
Deprecated.Escape and encode a string regarded as within the path component of an URI with the default protocol charset.static String
encodeWithinPath(String unescaped, String charset)
Deprecated.Escape and encode a string regarded as within the path component of an URI with a given charset.static String
encodeWithinQuery(String unescaped)
Deprecated.Escape and encode a string regarded as within the query component of an URI with the default protocol charset.static String
encodeWithinQuery(String unescaped, String charset)
Deprecated.Escape and encode a string regarded as within the query component of an URI with a given charset.static String
getFromPath(String uri)
Deprecated.Get the path of an URI and its rest part.static String
getName(String uri)
Deprecated.Get the basename of an URI.static String
getPath(String uri)
Deprecated.Get the path of an URI.static String
getPathQuery(String uri)
Deprecated.Get the path and query of an URI.static String
getQuery(String uri)
Deprecated.Get the query of an URI.
-
-
-
Method Detail
-
getName
public static String getName(String uri)
Deprecated.Get the basename of an URI. It's possibly an empty string.- Parameters:
uri
- a string regarded an URI- Returns:
- the basename string; an empty string if the path ends with slash
-
getQuery
public static String getQuery(String uri)
Deprecated.Get the query of an URI.- Parameters:
uri
- a string regarded an URI- Returns:
- the query string;
null
if empty or undefined
-
getPath
public static String getPath(String uri)
Deprecated.Get the path of an URI.- Parameters:
uri
- a string regarded an URI- Returns:
- the path string
-
getPathQuery
public static String getPathQuery(String uri)
Deprecated.Get the path and query of an URI.- Parameters:
uri
- a string regarded an URI- Returns:
- the path and query string
-
getFromPath
public static String getFromPath(String uri)
Deprecated.Get the path of an URI and its rest part.- Parameters:
uri
- a string regarded an URI- Returns:
- the string from the path part
-
encodeAll
public static String encodeAll(String unescaped) throws URIException
Deprecated.Get the all escaped and encoded string with the default protocl charset. It's the same function to useencode(String unescaped, Bitset empty, URI.getDefaultProtocolCharset())
.- Parameters:
unescaped
- an unescaped string- Returns:
- the escaped string
- Throws:
URIException
- if the default protocol charset is not supported- See Also:
URI.getDefaultProtocolCharset()
,encode(java.lang.String, java.util.BitSet)
-
encodeAll
public static String encodeAll(String unescaped, String charset) throws URIException
Deprecated.Get the all escaped and encoded string with a given charset. It's the same function to useencode(String unescaped, Bitset empty, String charset)
.- Parameters:
unescaped
- an unescaped stringcharset
- the charset- Returns:
- the escaped string
- Throws:
URIException
- if the charset is not supported- See Also:
encode(java.lang.String, java.util.BitSet)
-
encodeWithinAuthority
public static String encodeWithinAuthority(String unescaped) throws URIException
Deprecated.Escape and encode a string regarded as within the authority component of an URI with the default protocol charset. Within the authority component, the characters ";", ":", "@", "?", and "/" are reserved.- Parameters:
unescaped
- an unescaped string- Returns:
- the escaped string
- Throws:
URIException
- if the default protocol charset is not supported- See Also:
URI.getDefaultProtocolCharset()
,encode(java.lang.String, java.util.BitSet)
-
encodeWithinAuthority
public static String encodeWithinAuthority(String unescaped, String charset) throws URIException
Deprecated.Escape and encode a string regarded as within the authority component of an URI with a given charset. Within the authority component, the characters ";", ":", "@", "?", and "/" are reserved.- Parameters:
unescaped
- an unescaped stringcharset
- the charset- Returns:
- the escaped string
- Throws:
URIException
- if the charset is not supported- See Also:
encode(java.lang.String, java.util.BitSet)
-
encodePathQuery
public static String encodePathQuery(String unescaped) throws URIException
Deprecated.Escape and encode a string regarded as the path and query components of an URI with the default protocol charset.- Parameters:
unescaped
- an unescaped string- Returns:
- the escaped string
- Throws:
URIException
- if the default protocol charset is not supported- See Also:
URI.getDefaultProtocolCharset()
,encode(java.lang.String, java.util.BitSet)
-
encodePathQuery
public static String encodePathQuery(String unescaped, String charset) throws URIException
Deprecated.Escape and encode a string regarded as the path and query components of an URI with a given charset.- Parameters:
unescaped
- an unescaped stringcharset
- the charset- Returns:
- the escaped string
- Throws:
URIException
- if the charset is not supported- See Also:
encode(java.lang.String, java.util.BitSet)
-
encodeWithinPath
public static String encodeWithinPath(String unescaped) throws URIException
Deprecated.Escape and encode a string regarded as within the path component of an URI with the default protocol charset. The path may consist of a sequence of path segments separated by a single slash "/" character. Within a path segment, the characters "/", ";", "=", and "?" are reserved.- Parameters:
unescaped
- an unescaped string- Returns:
- the escaped string
- Throws:
URIException
- if the default protocol charset is not supported- See Also:
URI.getDefaultProtocolCharset()
,encode(java.lang.String, java.util.BitSet)
-
encodeWithinPath
public static String encodeWithinPath(String unescaped, String charset) throws URIException
Deprecated.Escape and encode a string regarded as within the path component of an URI with a given charset. The path may consist of a sequence of path segments separated by a single slash "/" character. Within a path segment, the characters "/", ";", "=", and "?" are reserved.- Parameters:
unescaped
- an unescaped stringcharset
- the charset- Returns:
- the escaped string
- Throws:
URIException
- if the charset is not supported- See Also:
encode(java.lang.String, java.util.BitSet)
-
encodePath
public static String encodePath(String unescaped) throws URIException
Deprecated.Escape and encode a string regarded as the path component of an URI with the default protocol charset.- Parameters:
unescaped
- an unescaped string- Returns:
- the escaped string
- Throws:
URIException
- if the default protocol charset is not supported- See Also:
URI.getDefaultProtocolCharset()
,encode(java.lang.String, java.util.BitSet)
-
encodePath
public static String encodePath(String unescaped, String charset) throws URIException
Deprecated.Escape and encode a string regarded as the path component of an URI with a given charset.- Parameters:
unescaped
- an unescaped stringcharset
- the charset- Returns:
- the escaped string
- Throws:
URIException
- if the charset is not supported- See Also:
encode(java.lang.String, java.util.BitSet)
-
encodeWithinQuery
public static String encodeWithinQuery(String unescaped) throws URIException
Deprecated.Escape and encode a string regarded as within the query component of an URI with the default protocol charset. When a query comprise the name and value pairs, it is used in order to encode each name and value string. The reserved special characters within a query component are being included in encoding the query.- Parameters:
unescaped
- an unescaped string- Returns:
- the escaped string
- Throws:
URIException
- if the default protocol charset is not supported- See Also:
URI.getDefaultProtocolCharset()
,encode(java.lang.String, java.util.BitSet)
-
encodeWithinQuery
public static String encodeWithinQuery(String unescaped, String charset) throws URIException
Deprecated.Escape and encode a string regarded as within the query component of an URI with a given charset. When a query comprise the name and value pairs, it is used in order to encode each name and value string. The reserved special characters within a query component are being included in encoding the query.- Parameters:
unescaped
- an unescaped stringcharset
- the charset- Returns:
- the escaped string
- Throws:
URIException
- if the charset is not supported- See Also:
encode(java.lang.String, java.util.BitSet)
-
encodeQuery
public static String encodeQuery(String unescaped) throws URIException
Deprecated.Escape and encode a string regarded as the query component of an URI with the default protocol charset. When a query string is not misunderstood the reserved special characters ("&", "=", "+", ",", and "$") within a query component, this method is recommended to use in encoding the whole query.- Parameters:
unescaped
- an unescaped string- Returns:
- the escaped string
- Throws:
URIException
- if the default protocol charset is not supported- See Also:
URI.getDefaultProtocolCharset()
,encode(java.lang.String, java.util.BitSet)
-
encodeQuery
public static String encodeQuery(String unescaped, String charset) throws URIException
Deprecated.Escape and encode a string regarded as the query component of an URI with a given charset. When a query string is not misunderstood the reserved special characters ("&", "=", "+", ",", and "$") within a query component, this method is recommended to use in encoding the whole query.- Parameters:
unescaped
- an unescaped stringcharset
- the charset- Returns:
- the escaped string
- Throws:
URIException
- if the charset is not supported- See Also:
encode(java.lang.String, java.util.BitSet)
-
encode
public static String encode(String unescaped, BitSet allowed) throws URIException
Deprecated.Escape and encode a given string with allowed characters not to be escaped and the default protocol charset.- Parameters:
unescaped
- a stringallowed
- allowed characters not to be escaped- Returns:
- the escaped string
- Throws:
URIException
- if the default protocol charset is not supported- See Also:
URI.getDefaultProtocolCharset()
-
encode
public static String encode(String unescaped, BitSet allowed, String charset) throws URIException
Deprecated.Escape and encode a given string with allowed characters not to be escaped and a given charset.- Parameters:
unescaped
- a stringallowed
- allowed characters not to be escapedcharset
- the charset- Returns:
- the escaped string
- Throws:
URIException
-
decode
public static String decode(String escaped) throws URIException
Deprecated.Unescape and decode a given string regarded as an escaped string with the default protocol charset.- Parameters:
escaped
- a string- Returns:
- the unescaped string
- Throws:
URIException
- if the string cannot be decoded (invalid)- See Also:
URI.getDefaultProtocolCharset()
-
decode
public static String decode(String escaped, String charset) throws URIException
Deprecated.Unescape and decode a given string regarded as an escaped string.- Parameters:
escaped
- a stringcharset
- the charset- Returns:
- the unescaped string
- Throws:
URIException
- if the charset is not supported- See Also:
URIUtil.Coder.decode(char[], java.lang.String)
-
-