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，和对于一个给定的用户可设置请求方法、请求报头。该权限的名称是URL字符串。的行动字符串是一个级联的请求方法和标题。方法和头名称的范围不受此类的限制。

URL

该网址具有如下预期结构。

方案：/ /权威[路径]

方案通常是HTTP或HTTPS，但该类不限。权威指定为：

权威= [登录] [循环]：portrange @portrange =端口| -端口|端口- [端口] | *寄主范围=（[×] DnsName）| | IPv6 IPv4地址

DnsName是一个标准的DNS主机名或域名，即一个或多个标签之间用“。”。IPv4地址是IPv4地址，IPv6标准文字地址是定义在 RFC 2732。字面的IPv6地址必须然而，被封闭在“[ ]”字符。DnsName规格可以冠以“×”。这意味着这个名字会匹配任何主机名的域名标签最右边这个名字一样。例如，“*。甲骨文。com”与“foo。酒吧。甲骨文。com”

portrange用于指定一个端口号，或有界或无界港口本许可适用范围。如果portrange缺失或无效，则默认端口号是假设如果方案被http（默认为80）或https（默认为443）。没有默认的假设为其他计划。通配符可以指定这意味着所有的端口。

用户信息是可选的。用户信息部分如果存在，是忽视创造一个urlpermission时，对这类定义的任何其他方法没有效果。

的路径组件包括一个序列的路径段，用“/”字符分隔。路径也可能是空的。路径是FilePermission以类似的方式来指定的路径。有三种不同的方式作为下面的例子显示：

URL Examples

Example url	描述
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).

“*”和“-”可能只在一条路径的最后一段中指定，必须是该段中的唯一字符。任何查询或片段组成的URL被忽略在构建urlpermissions。

作为一个特殊的情况下，形式的网址，“计划：*”被接受意味着任何给定的计划的网址。

的方案和URL字符串的权威组件是不考虑案件的处理。这意味着equals(Object)，hashCode()和implies(Permission)是区分大小写的关于这些成分。如果权威包含文字的IP地址，然后地址是归一化的比较。路径组件是区分大小写的。

动作字符串

一个urlpermission动作字符串是一个级联的方法列表和请求标头列表。这些是允许的请求方法的列表和允许的请求的请求头（分别）。这两个列表是由一个“结”分隔的：“每个列表的字符和元素都是逗号分隔的”。一些例子：

“后，得到，删除”“：x-foo-request，x-bar-request”“后，得到：header1，header2”

第一个实例的指定方法后，被删除，但没有请求报头。第二个示例指定一个请求方法和两个标题。第三个示例指定两个请求方法和两个标题。

如果请求头列表是空的，则不存在“结肠分离器”。在操作字符串中不允许有空格。到urlpermission构造函数提供的动作字符串不区分大小写和归一化转换方法的名称和标题名称的大写形式定义RFC2616（小写首字母每个单词首字母大写）。任何一个列表都可以包含一个“*”字符，它表示所有请求的方法或标题。

注。根据使用的上下文，一些请求的方法和头文件可能被允许在任何时间，和其他人可能不被允许在任何时间。例如，HTTP协议处理程序可能禁止某些标题等内容的长度被设置由应用程序代码，无论在力量的安全政策，允许它。

从以下版本开始：

一点八

另请参见：

Serialized Form

构造方法摘要

构造方法

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

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object p) 如果返回true，这。getactions()。等于（P. getactions()）和P的URL的URL等于这。
String	getActions() 返回规范化的方法列表和请求头列表，在窗体中：
int	hashCode() 返回一个hashCode从操作字符串和URL字符串的hashcode计算。
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

Constructor Detail

URLPermission

public URLPermission(String url,
                     String actions)

创建一个新urlpermission URL字符串并允许给定的请求的方法和用户可设置的请求头。权限的名称是它创建的网址字符串。只有在内部使用了该方案的方案、权限和路径组件。忽略任何片段或查询组件。权限操作字符串是指定的以上。

参数

url - URL字符串

actions -动作字符串

异常

IllegalArgumentException -如果行动包含空格的URL无效或。

URLPermission

public URLPermission(String url)

创建一个与给定的URL字符串和不受限制的方法和请求头通过调用两参数的构造函数为urlpermission如下：urlpermission（URL，“* *”）

参数

url - URL字符串

异常

IllegalArgumentException如果网址不在有效的 URI结果

方法详细信息

getActions

public String getActions()

返回列表和归一化方法请求标头列表的形式：

“方法名称：头名称”

在方法名称是用逗号和头名称分离方法列表是以逗号分隔的列表允许头。返回的字符串中没有空格。如果头名称是空的，那么将不存在结肠分离器。

Specified by:

getActions 方法重写，继承类 Permission

结果

本许可的行为。

implies

public boolean implies(Permission p)

如果这个检查urlpermission意味着允许。具体来说，以下的检查如以下序列：

• 如果“P”不是一个实例urlpermission返回false
• 如果P的方法中的任何一个都不在这个方法列表中，如果这个方法列表不等于“*”，则返回假。
• 如果P的标题中的任何一个都不在这个请求的标题列表中，如果这是请求头列表不等于“*”，那么返回错误。
• 如果这个网址方案不等于P的网址方案返回假
• 如果这个计划的特定部分的网址是“*”返回真实
• 如果P的循环定义的URL主机组不是这个网址然后返回循环的一个子集。例如，“*。foo。Oracle .com”是“*的一个子集。甲骨文。com”。”foo。酒吧。甲骨文。com”不是“*的一个子集。foo。甲骨文。com”
• 如果P的URL定义的portrange不是这样的URL定义的一个子集portrange然后返回false。
• 如果P的网址指定的路径或路径包含在指定的路径集合中，则返回真实的路径
• 否则，返回错误

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

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的权限检查。

结果

如果此对象所暗示的指定权限，则为假如果不是。

equals

public boolean equals(Object p)

如果返回true，这。getactions()。等于（P. getactions()）和P的URL的URL等于这。否则返回假。

Specified by:

equals 方法重写，继承类 Permission

参数

p对象--我们为这个对象相等性测试。

结果

如果两个权限对象都是等效的。

另请参见：

Object.hashCode()， HashMap

hashCode

public int hashCode()

返回一个hashCode从操作字符串和URL字符串的hashcode计算。

Specified by:

hashCode 方法重写，继承类 Permission

结果

此对象的哈希代码值。

另请参见：

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