com.opslab.web

类 UrlUtil

java.lang.Object

com.opslab.web.UrlUtil

public class UrlUtil
extends Object

URL相关的工具类 以下工具类来自开源项目jodd

Here is an example of full URL: https://jodd:ddoj@www.jodd.org:8080/file;p=1?q=2#third. It consist of:

• scheme (https)
• user (jodd)
• password (ddoj)
• host (www.jodd.org)
• port (8080)
• path (file)
• path parameter (p=1)
• query parameter (q=2)
• fragment (third)

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	UrlUtil.Builder

构造器概要

构造器

构造器和说明
UrlUtil()

方法概要

方法

限定符和类型	方法和说明
static UrlUtil.Builder	build(String path) Creates URL builder for user-friendly way of building URLs.
static UrlUtil.Builder	build(String path, boolean encodePath) Creates URL builder with given path that can be optionally encoded.
static String	decode(String url) Decodes URL elements.
static String	decode(String source, String encoding) Decodes URL elements.
static String	decodeQuery(String source) Decodes query name or value.
static String	decodeQuery(String source, String encoding) Decodes query name or value.
static String	encode(String uri)
static String	encode(String uri, String encoding) Encodes the given source URI into an encoded String.
static String	encodeFragment(String fragment)
static String	encodeFragment(String fragment, String encoding) Encodes the given URI fragment with the given encoding.
static String	encodeHost(String host)
static String	encodeHost(String host, String encoding) Encodes the given URI host with the given encoding.
static String	encodeHttpUrl(String httpUrl)
static String	encodeHttpUrl(String httpUrl, String encoding) Encodes the given HTTP URI into an encoded String.
static String	encodePath(String path)
static String	encodePath(String path, String encoding) Encodes the given URI path with the given encoding.
static String	encodePathSegment(String segment)
static String	encodePathSegment(String segment, String encoding) Encodes the given URI path segment with the given encoding.
static String	encodePort(String port)
static String	encodePort(String port, String encoding) Encodes the given URI port with the given encoding.
static String	encodeQuery(String query)
static String	encodeQuery(String query, String encoding) Encodes the given URI query with the given encoding.
static String	encodeQueryParam(String queryParam)
static String	encodeQueryParam(String queryParam, String encoding) Encodes the given URI query parameter with the given encoding.
static String	encodeScheme(String scheme)
static String	encodeScheme(String scheme, String encoding) Encodes the given URI scheme with the given encoding.
static String	encodeUserInfo(String userInfo)
static String	encodeUserInfo(String userInfo, String encoding) Encodes the given URI user info with the given encoding.
static String	getParamValue(String url, String paramName)
static Map<String,String>	httpParseQuery(String queryUri) 解析http请求URI
static Map<String,String>	parseQuery(String query, char split1, char split2, String dupLink) 解析字符串返回map键值对(例：a=1&b=2 => a=1,b=2)
static Map	print(javax.servlet.http.HttpServletRequest request) 获取HTTPrequest的请求参数
static String	removeParam(String url, String... paramNames)
static String	removeParam(String url, String paramName)
static String	setParam(String url, String paramName, String paramValue)
static String	urlJoin(URL url, String locationHeader) Example: url: http://tt.se/ Location: /start => http://tt.se/start url: http://localhost/moved_perm Location: / => http://localhost/ url: http://github.com/ Location: http://github.com/ => https://github.com/ (If the new url throws a MalformedURLException the url String representation will be returned.)

从类继承的方法 java.lang.Object

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

构造器详细资料

UrlUtil

public UrlUtil()

方法详细资料

encodeScheme

public static String encodeScheme(String scheme,
                  String encoding)

Encodes the given URI scheme with the given encoding.

encodeScheme

public static String encodeScheme(String scheme)

encodeUserInfo

public static String encodeUserInfo(String userInfo,
                    String encoding)

Encodes the given URI user info with the given encoding.

encodeUserInfo

public static String encodeUserInfo(String userInfo)

encodeHost

public static String encodeHost(String host,
                String encoding)

Encodes the given URI host with the given encoding.

encodeHost

public static String encodeHost(String host)

encodePort

public static String encodePort(String port,
                String encoding)

Encodes the given URI port with the given encoding.

encodePort

public static String encodePort(String port)

encodePath

public static String encodePath(String path,
                String encoding)

Encodes the given URI path with the given encoding.

encodePath

public static String encodePath(String path)

encodePathSegment

public static String encodePathSegment(String segment,
                       String encoding)

Encodes the given URI path segment with the given encoding.

encodePathSegment

public static String encodePathSegment(String segment)

encodeQuery

public static String encodeQuery(String query,
                 String encoding)

Encodes the given URI query with the given encoding.

encodeQuery

public static String encodeQuery(String query)

encodeQueryParam

public static String encodeQueryParam(String queryParam,
                      String encoding)

Encodes the given URI query parameter with the given encoding.

encodeQueryParam

public static String encodeQueryParam(String queryParam)

encodeFragment

public static String encodeFragment(String fragment,
                    String encoding)

Encodes the given URI fragment with the given encoding.

encodeFragment

public static String encodeFragment(String fragment)

encode

public static String encode(String uri)

另请参阅:

encode(String, String)

encode

public static String encode(String uri,
            String encoding)

Encodes the given source URI into an encoded String. All various URI components are encoded according to their respective valid character sets.

This method does not attempt to encode "=" and "&" characters in query parameter names and query parameter values because they cannot be parsed in a reliable way.

encodeHttpUrl

public static String encodeHttpUrl(String httpUrl)

另请参阅:

encodeHttpUrl(String, String)

encodeHttpUrl

public static String encodeHttpUrl(String httpUrl,
                   String encoding)

Encodes the given HTTP URI into an encoded String. All various URI components are encoded according to their respective valid character sets.

This method does not support fragments (#), as these are not supposed to be sent to the server, but retained by the client.

This method does not attempt to encode "=" and "&" characters in query parameter names and query parameter values because they cannot be parsed in a reliable way.

build

public static UrlUtil.Builder build(String path)

Creates URL builder for user-friendly way of building URLs. Provided path is parsed and encoded.

另请参阅:

build(String, boolean)

build

public static UrlUtil.Builder build(String path,
                    boolean encodePath)

Creates URL builder with given path that can be optionally encoded. Since most of the time path is valid and does not require to be encoded, use this method to gain some performance. When encoding flag is turned off, provided path is used without processing.

The purpose of builder is to help with query parameters. All other URI parts should be set previously or after the URL is built.

decode

public static String decode(String url)

Decodes URL elements.

decode

public static String decode(String source,
            String encoding)

Decodes URL elements. This method may be used for all parts of URL, except for the query parts, since it does not decode the '+' character.

另请参阅:

decodeQuery(String, String)

decodeQuery

public static String decodeQuery(String source)

Decodes query name or value.

decodeQuery

public static String decodeQuery(String source,
                 String encoding)

Decodes query name or value.

setParam

public static final String setParam(String url,
              String paramName,
              String paramValue)

getParamValue

public static final String getParamValue(String url,
                   String paramName)

removeParam

public static final String removeParam(String url,
                 String... paramNames)

removeParam

public static final String removeParam(String url,
                 String paramName)

urlJoin

public static String urlJoin(URL url,
             String locationHeader)

Example:

 url: http://tt.se/                 Location: /start              =>  http://tt.se/start
 url: http://localhost/moved_perm   Location: /                   =>  http://localhost/
 url: http://github.com/            Location: http://github.com/  =>  https://github.com/
 

 (If the new url throws a MalformedURLException the url String representation will be returned.)

print

public static Map print(javax.servlet.http.HttpServletRequest request)

获取HTTPrequest的请求参数

参数:

request - http请求

parseQuery

public static Map<String,String> parseQuery(String query,
                            char split1,
                            char split2,
                            String dupLink)

解析字符串返回map键值对(例：a=1&b=2 => a=1,b=2)

参数:

query - 源参数字符串

split1 - 键值对之间的分隔符（例：&）

split2 - key与value之间的分隔符（例：=）

dupLink - 重复参数名的参数值之间的连接符，连接后的字符串作为该参数的参数值，可为null null：不允许重复参数名出现，则靠后的参数值会覆盖掉靠前的参数值。

返回:

map

httpParseQuery

public static Map<String,String> httpParseQuery(String queryUri)

解析http请求URI

参数:

queryUri - http请求的uri