compact1, compact2, compact3

java.net

Class URLPermission

java.lang.Object

java.security.Permission

java.net.URLPermission

All Implemented Interfaces:

Serializable ， Guard

public final class URLPermission
extends Permission

表示访问由给定网址定义的资源或资源集的权限，以及给定的用户可设置请求方法和请求标头集合的权限。 权限的名称是url字符串。 actions字符串是请求方法和标题的连接。 方法和标题名称的范围不受此类限制。

网址

url字符串具有以下预期结构。

  scheme : // authority [ / path ] 

方案通常是http或https，但不受此类限制。 权限被指定为：

  authority = [ userinfo @ ] hostrange [ : portrange ]
     portrange = portnumber | -portnumber | portnumber-[portnumber] | *
     hostrange = ([*.] dnsname) | IPv4address | IPv6address 

dnsname是标准的DNS主机或域名，即。 一个或多个标签用“。”分隔。 IPv4address是一个标准的文字IPv4地址和IPv6address限定如RFC 2732 。 但是，文字IPv6地址必须用'[]'字符括起来。 dnsname规范前面可以有“*”。 这意味着名称将匹配其最右域名标签与此名称相同的任何主机名。 例如，“* .oracle.com”匹配“foo.bar.oracle.com”

portrange用于指定端口号，或此限制适用于的有限或无限制的端口范围。 如果portrange不存在或无效，则如果方案为http （默认为80）或https （默认为443），则假定使用默认端口号。 其他方案没有默认值。 可以指定通配符，这意味着所有端口。

userinfo是可选的。 如果存在userinfo组件，则在创建URLPermission时将被忽略，并且不影响此类定义的任何其他方法。

路径组件包括由“/”字符分隔的路段段序列。 路径也可能是空的。 该路径以类似于FilePermission中的路径的方式指定 。 以下示例显示了三种不同的方式：

URL Examples Example url Description http://www.oracle.com/a/b/c.html A url which identifies a specific (single) resource http://www.oracle.com/a/b/* The '*' character refers to all resources in the same "directory" - in other words all resources with the same number of path components, and which only differ in the final path component, represented by the '*'. http://www.oracle.com/a/b/- The '-' character refers to all resources recursively below the preceding path (eg. http://www.oracle.com/a/b/c/d/e.html matches this example).

'*'和' - '只能在路径的最后一段中指定，并且必须是该段中唯一的字符。 构造URLPermissions时，url的任何查询或片段组件都将被忽略。

作为一个特殊情况，形式的“scheme：*”形式的URL被认为是给定方案的任何url。

url字符串的方案和权限组件被处理，而不考虑情况。 这意味着equals(Object) ， hashCode()和implies(Permission)区分相对于这些成分不敏感的。 如果权限包含文字IP地址，则该地址被标准化以进行比较。 路径组件区分大小写。

动作字符串

URLPermission的操作字符串是方法列表和请求标头列表的连接 。 这些是允许的请求方法和允许的请求头（分别）的列表。 两个列表用冒号“：”分隔，每个列表的元素都以逗号分隔。 一些例子是：

  "POST,GET,DELETE"
         "GET:X-Foo-Request,X-Bar-Request"
         "POST,GET:Header1,Header2" 

第一个示例指定了以下方法：POST，GET和DELETE，但没有请求头。 第二个示例指定一个请求方法和两个头。 第三个示例指定两个请求方法和两个头。

如果请求头列表为空，则不需要存在冒号分隔符。 动作字符串中不允许有空格。 提供给URLPermission构造函数的操作字符串不区分大小写，通过将方法名称转换为大写和标题名称到RFC2616中定义的格式（每个单词大写的小写字母）进行标准化。 任一列表都可以包含一个通配符'*'字符，分别表示所有请求方法或头。

注意。 根据使用的上下文，可以随时允许一些请求方法和标题，并且其他可能在任何时候都不被允许。 例如，HTTP协议处理程序可能不允许某些标头（如Content-Length）由应用程序代码设置，而不管有效的安全策略是否允许。

从以下版本开始：

1.8

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
URLPermission(String url) 使用给定的url字符串和无限制的方法创建一个URLPermission，并通过调用两个参数构造函数来请求头，如下所示：URLPermission（url，“*：*”）
URLPermission(String url, String actions) 从url字符串创建一个新的URLPermission，并允许给定的请求方法和用户可设置的请求头。

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object p) 如果this.getActions（）。equals（p.getActions（））和p的url等于这个url，则返回true。
String	getActions() 返回标准化方法列表和请求头列表，格式如下：
int	hashCode() 返回从动作字符串和url字符串的哈希码计算的哈希码。
boolean	implies(Permission p) 检查此URLPermission是否意味着给定的权限。

Methods inherited from class java.security.Permission

checkGuard, getName, newPermissionCollection, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

构造方法详细信息

URLPermission

public URLPermission(String url,
                     String actions)

从url字符串创建一个新的URLPermission，并允许给定的请求方法和用户可设置的请求头。 权限的名称是与其一起创建的url字符串。 只有url的方案，权限和路径组件在内部使用。 任何片段或查询组件都将被忽略。 权限操作字符串如上所述。

参数

url - url字符串

actions - 操作字符串

异常

IllegalArgumentException - 如果网址无效或动作包含空格。

URLPermission

public URLPermission(String url)

使用给定的url字符串和无限制的方法创建一个URLPermission，并通过调用两个参数构造函数来请求头，如下所示：URLPermission（url，“*：*”）

参数

url - url字符串

异常

IllegalArgumentException - 如果网址不会导致有效的URI

方法详细信息

getActions

public String getActions()

返回标准化方法列表和请求头列表，格式如下：

  "method-names : header-names" 

其中method-names是由逗号分隔的方法列表，header-names是允许的标题列表，以逗号分隔。 返回的String中没有空格。 如果标题名为空，则冒号分隔符将不存在。

Specified by:

getActions在 Permission

结果

这个权限的动作。

implies

public boolean implies(Permission p)

检查此URLPermission是否意味着给定的权限。 具体来说，按照以下顺序进行以下检查：

• 如果'p'不是URLPermission的实例，则返回false
• 如果这个方法列表中没有p的方法，并且如果这个方法列表不等于“*”，那么返回false。
• 如果任何p的头部不在此请求头列表中，并且如果此请求头列表不等于“*”，则返回false。
• 如果这个url方案不等于p的url方案返回false
• 如果这个url的具体部分是'*'返回true
• 如果由p的url hostrange定义的主机集不是这个url hostrange的一个子集，那么返回false。 例如，“* .foo.oracle.com”是“* .oracle.com”的子集。 “foo.bar.oracle.com”不是“* .foo.oracle.com”的子集
• 如果由p的url定义的portrange不是由该URL定义的portrange的子集，则返回false。
• 如果由p的url指定的路径或路径包含在由此URL指定的路径集中，则返回true
• 否则返回false

路径匹配的一些示例如下所示：

Examples of Path Matching this's path p's path match /a/b /a/b yes /a/b/* /a/b/c yes /a/b/* /a/b/c/d no /a/b/- /a/b/c/d yes /a/b/- /a/b/c/d/e yes /a/b/- /a/b/c/* yes /a/b/* /a/b/c/- no

Specified by:

implies在 Permission

参数

p - 允许检查。

结果

如果此对象隐含指定的权限，则为true，否则为false。

equals

public boolean equals(Object p)

如果this.getActions（）。equals（p.getActions（））和p的url等于这个url，则返回true。 否则返回false。

Specified by:

equals在 Permission

参数

p - 我们正在测试与此对象相等的对象。

结果

如果两个Permission对象都是等效的，则为true。

另请参见：

Object.hashCode() ， HashMap

hashCode

public int hashCode()

返回从动作字符串和url字符串的哈希码计算的哈希码。

Specified by:

hashCode在 Permission

结果

该对象的哈希码值。

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)