property翻译 java_java.util.PropertyPermission翻译

java.util

Class PropertyPermission

All Implemented Interfaces:

public final class PropertyPermission

This class is for property permissions. 用于属性许可的类。

The name is the name of the property ("java.home", "os.name", etc). The naming convention follows the hierarchical property naming convention. Also, an asterisk may appear at the end of the name, following a ".", or by itself, to signify a wildcard match. For example: "java.*" or "*" is valid, "*java" or "a*b" is not valid. 名称是属性的名称(“java.home”，“os.name”，等)。命名约定符合分级属性命名约定。 而且，名称末尾可以出现星号，“.”的后面，或者只是自身，来标记通配符匹配。 例如，“java.*”或者“*”都是有效的，而“*java”或“a*b”是无效的。

The actions to be granted are passed to the constructor in a string containing a list of zero or more comma-separated keywords. The possible keywords are "read" and "write". Their meaning is defined as follows: 动作授权通过以包含一列0个或多个逗号分隔关键字的字符串传递给构造函数来完成。 可能的关键字是“read”和“write”。意义按如下定义：

read

read permission. Allows System.getProperty to be called. 读权限。允许调用System.getProperty。

write

write permission. Allows System.setProperty to be called. 写权限。允许调用System.setProperty。

The actions string is converted to lowercase before processing. 动作字符串在处理之前转换为小写。

Care should be taken before granting code permission to access certain system properties. For example, granting permission to access the "java.home" system property gives potentially malevolent code sensitive information about the system environment (the Java installation directory). Also, granting permission to access the "user.name" and "user.home" system properties gives potentially malevolent code sensitive information about the user environment (the user's account name and home directory). 在授予给代码以访问某些系统属性之前应谨慎。例如，授权访问“java.home” 系统属性可能将系统环境的敏感信息(Java安装目录)提供给了恶意代码。 而且，授权访问“user.name”和“user.home”系统属性可能提供了用户环境的敏感信息(用户帐户名和home目录)。

Constructor Summary

Creates a new PropertyPermission object with the specified name. 使用指定名称创建一个PropertyPermission对象。

Method Summary

boolean

Checks two PropertyPermission objects for equality. 检查两个PropertyPermission对象是否相等。

Returns the "canonical string representation" of the actions. 返回动作的经典字符串形式。

int

Returns the hash code value for this object. 返回当前对象的哈希码值。

boolean

Checks if this PropertyPermission object "implies" the specified permission. 检查当前PropertyPermission对象是否包含指定许可。

Returns a new PermissionCollection object for storing PropertyPermission objects. 返回一个PermissionCollection对象用于存储PropertyPermission对象。

Methods inherited from class java.security.Permission

Constructor Detail

PropertyPermission

public PropertyPermission(Stringname,Stringactions)

Creates a new PropertyPermission object with the specified name. The name is the name of the system property, and actions contains a comma-separated list of the desired actions granted on the property. Possible actions are "read" and "write". 使用指定名称创建一个PropertyPermission对象。name为系统属性的名称， actions包含对于属性授权的期望动作列表，以逗号分隔。可能的动作为“read”和“write”。

Parameters:

name - the name of the PropertyPermission. PropertyPermission的名称。

actions - the actions string. 动作字符串。

Method Detail

implies

public boolean implies(Permissionp)

Checks if this PropertyPermission object "implies" the specified permission. 检查当前PropertyPermission对象是否包含指定许可。

More specifically, this method returns true if: 具体而言，符合以下规定，方法返回true：

p is an instanceof PropertyPermission, p是一个PropertyPermission实例

p's actions are a subset of this object's actions, and p的动作是当前对象动作的子集

p's name is implied by this object's name. For example, "java.*" implies "java.home". p的名称包含在当前对象的名称里。例如：“java.*”包含了“java.home”

Parameters:

p - the permission to check against. 要检查的许可。

Returns:

true if the specified permission is implied by this object, false if not. 如果当前对象包含指定许可，返回true，否则为false。

equals

public boolean equals(Objectobj)

Checks two PropertyPermission objects for equality. Checks that obj is a PropertyPermission, and has the same name and actions as this object. 检查两个PropertyPermission对象是否相等。检查obj是否是一个PropertyPermission， 和当前对象是否有相同的名称和动作。

Parameters:

obj - the object we are testing for equality with this object. 同当前对象测试相等性的对象。

Returns:

true if obj is a PropertyPermission, and has the same name and actions as this PropertyPermission object. 如果obj是一个PropertyPermission，和当前PropertyPermission对象有相同的名称和动作，返回true。

hashCode

public int hashCode()

Returns the hash code value for this object. The hash code used is the hash code of this permissions name, that is, getName().hashCode(), where getName is from the Permission superclass. 返回当前对象的哈希码值。使用的哈希码是属性名称的哈希码，即getName().hashCode()， getName来自父类Permission。

Returns:

a hash code value for this object. 当前对象的哈希码值。

getActions

publicStringgetActions()

Returns the "canonical string representation" of the actions. That is, this method always returns present actions in the following order: read, write. For example, if this PropertyPermission object allows both write and read actions, a call to getActions will return the string "read,write". 返回动作的经典字符串形式。也就是说，该方法总是按以下顺序返回目前的动作： read, write。例如，如果当前PropertyPermission对象允许读写动作，调用getActions 将返回字符串“read,write”。

Returns:

the canonical string representation of the actions. 动作的经典字符串形式。

newPermissionCollection

publicPermissionCollectionnewPermissionCollection()

Returns a new PermissionCollection object for storing PropertyPermission objects. 返回一个PermissionCollection对象用于存储PropertyPermission对象。

Returns:

a new PermissionCollection object suitable for storing PropertyPermissions. 适合存储PropertyPermission的PermissionCollection对象。

Submit a bug or feature

For further API reference and developer documentation, see

Java 2 SDK SE Developer Documentation

. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject tolicense terms. Also see thedocumentation redistribution policy.