URLUtil (feilong-core 2.0.3 API create by feilong)

java.lang.Object
- com.feilong.core.net.URLUtil

```
public final class URLUtil
extends Object
```
URL 工具类.
URL组成部分:

URL 的长度上限
URL 的最大长度是多少？W3C 的 HTTP 协议并没有限定; 然而经过试验,不同浏览器和 Web 服务器有不同的约定:
- IE 长度上限是 2083 字节,其中纯路径部分不能超过 2048 字节.
- Firefox 地址栏中超过 65536 字符后就不再显示.
- Safari 测试到 80000 字符还工作得好好的.
- Opera 测试到 190000 字符还工作得好好的.
Web 服务器:
- Apache Web 服务器在接收到大约 4000 字符长的 URL 时候产生 "413 Entity Too Large" 错误.
- IIS 默认接收的最大 URL 是 16384 字符.
Since:

1.2.1

Author:

feilong

Method Summary

Methods
Modifier and Type	Method and Description
`static String`	`getUnionUrl(URL context, String spec)` 获取联合url,通过在指定的上下文中对给定的 spec 进行解析创建 URL,新的 URL 从给定的上下文 URL 和 spec 参数创建.
`static InputStream`	`openStream(URL url)` 打开当前`url`的连接,并且读取返回 `InputStream`.
`static URI`	`toURI(URL url)` 将 `URL`转成 `URI`.
`static URL`	`toURL(String spec)` 将字符串 `spec` 转成 `URL`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - toURL
```
public static URL toURL(String spec)
```
    将字符串 spec 转成 URL.
    该方法特点:
    处理 check exception,转成 uncheck exception
    
    如果使用new URL 出现异常,会尝试使用 toFileURL(String)
    注意:
    如果直接调用 URL.URL(String) 方法,如果是文件路径, 比如
    
    String spec = "C:/Users/feilong/feilong/train/新员工/warmReminder/20160704141057.html"; URL newURL = new URL(spec);
    会抛出异常,
    Caused by: java.net.MalformedURLException: unknown protocol: c at java.net.URL.<init>(URL.java:593) at java.net.URL.<init>(URL.java:483) at java.net.URL.<init>(URL.java:432) ... 24 more
    此时 ,你需要修改成
    String spec = "file://C:/Users/feilong/feilong/train/新员工/warmReminder/20160704141057.html"; URL newURL = new URL(spec);
    也就是说,此方法必须要有协议支持 (file URI scheme),如果你是文件需要转成 url的话,建议直接调用 toFileURL(String)
    Parameters:
    spec - the String to parse as a URL.
    
    Returns:
    如果 spec 是null,抛出 NullPointerException
    如果 spec 是blank,抛出 IllegalArgumentException
    Since:
    
    1.8.0
    
    See Also:
    URL.URL(String), "org.apache.cxf.common.util.StringUtils#getURL(String)", "org.springframework.util.ResourceUtils#getURL(String)", File_URI_scheme, "org.apache.xml.resolver.readers.TextCatalogReader#readCatalog(Catalog, String)", Creating a URL
  - toURI
```
public static URI toURI(URL url)
```
    将 URL转成 URI.
    
    Parameters:
    url - the url
    
    Returns:
    如果 url 是null,返回null
    Since:
    
    1.2.2, 1.8.7 如果 null==url,返回null
    
    See Also:
    "org.springframework.util.ResourceUtils#toURI(URL)", URL.toURI()
  - openStream
```
public static InputStream openStream(URL url)
```
    打开当前url的连接,并且读取返回 InputStream.
    这个方法是以下方法的简写
```
 url.openConnection().getInputStream()
 
```
    Parameters:
    url - the url
    
    Returns:
    如果 url 是null,返回 null
    Since:
    
    1.9.2
    
    See Also:
    URL.openStream()
  - getUnionUrl
```
public static String getUnionUrl(URL context,
                 String spec)
```
    获取联合url,通过在指定的上下文中对给定的 spec 进行解析创建 URL,新的 URL 从给定的上下文 URL 和 spec 参数创建.
    网站地址拼接,请使用这个method
    
    示例:
    URL url = new URL("http://www.exiaoshuo.com/jinyiyexing/"); URIUtil.getUnionUrl(url, "/jinyiyexing/1173348/") = http://www.exiaoshuo.com/jinyiyexing/1173348/
    Parameters:
    context - 要解析规范的上下文
    spec - the String to parse as a URL.
    
    Returns:
    如果 spec 是null,抛出 NullPointerException
    如果 spec 是blank,抛出 IllegalArgumentException
    Since:
    
    1.4.0

Class URLUtil

URL组成部分:

URL 的长度上限

Method Summary

Methods inherited from class java.lang.Object

Method Detail

toURL

该方法特点:

注意:

toURI

openStream

getUnionUrl

示例: