java.security
類別 IdentityScope

java.lang.Object
  java.security.Identity
      java.security.IdentityScope

所有已實作的介面：

Serializable, Principal

已過時。 此類別不再被使用。其功能已經由 java.security.KeyStore、java.security.cert 套件和 java.security.Principal 取代。

@Deprecated
public abstract class IdentityScope
extends Identity

此類別表示身份的作用域。它本身也是 Identity，因此有名稱和作用域。它也可以選擇有一個公鑰和關聯的證書。

IdentityScope 可以包括各種型別的 Identity 物件，包括 Signer。全部類別型的 Identity 物件都可以使用相同的方法獲取、添加和刪除。注意，對於在各種型別的 Identity 上的各種操作，不同型別的身份作用域將應用不同的策略，這是可能的，實際上也期望如此。

密鑰和身份是一對一的映射關係，在每個作用域內一個密鑰只能有一個副本。例如，假定 Acme Software, Inc 是使用者已知的軟體發行人。假定它是一個 Identity，也就是說，它有公鑰和關聯的證書集合。它在某個作用域內使用名稱 "Acme Software" 命名。該作用域內沒有其他指定 Identity 具有相同的公鑰。當然，也沒有相同的名稱。

另請參見：

Identity, Signer, Principal, Key, 序列化表格

建構子摘要

protected	IdentityScope() 已過時。 此建構子只用於序列化，不能被子類別使用。
	IdentityScope(String name) 已過時。 建構具有指定名稱的新身份作用域。
	IdentityScope(String name, IdentityScope scope) 已過時。 建構具有指定名稱和作用域的新身份作用域。

方法摘要

abstract void	addIdentity(Identity identity) 已過時。 向此身份作用域添加一個身份。
Identity	getIdentity(Principal principal) 已過時。 獲取名稱與指定的主體相同的身份。
abstract Identity	getIdentity(PublicKey key) 已過時。 獲取具有指定公鑰的身份。
abstract Identity	getIdentity(String name) 已過時。 返回此作用域內具有指定名稱的身份（如果有的話）。
static IdentityScope	getSystemScope() 已過時。 返回系統的身份作用域。
abstract Enumeration<Identity>	identities() 已過時。 返回此身份作用域內所有身份的列舉。
abstract void	removeIdentity(Identity identity) 已過時。 從此身份作用作用域移除一個身份。
protected static void	setSystemScope(IdentityScope scope) 已過時。 設置系統的身份作用域。
abstract int	size() 已過時。 返回此身份作用域內身份的數目。
String	toString() 已過時。 返回此身份作用域的字元串表示形式，包括其名稱、作用域名稱和此身份作用域中身份的數目。

從類別 java.security.Identity 繼承的方法

addCertificate, certificates, equals, getInfo, getName, getPublicKey, getScope, hashCode, identityEquals, removeCertificate, setInfo, setPublicKey, toString

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

IdentityScope

protected IdentityScope()

已過時。

此建構子只用於序列化，不能被子類別使用。

IdentityScope

public IdentityScope(String name)

已過時。

建構具有指定名稱的新身份作用域。

參數：

name - 作用域名稱。

IdentityScope

public IdentityScope(String name,
                     IdentityScope scope)
              throws KeyManagementException

已過時。

建構具有指定名稱和作用域的新身份作用域。

參數：

name - 作用域名稱。

scope - 新身份作用域的作用域。

拋出：

KeyManagementException - 在此作用域內已經存在一個具有相同名稱的 Identity。

方法詳細資訊

getSystemScope

public static IdentityScope getSystemScope()

已過時。

返回系統的身份作用域。

返回：

系統的身份作用域。

另請參見：

setSystemScope(java.security.IdentityScope)

setSystemScope

protected static void setSystemScope(IdentityScope scope)

已過時。

設置系統的身份作用域。

首先，如果存在安全管理器，則用 "setSystemScope" 作為參數調用其 checkSecurityAccess 方法，以查看它是否可以設置身份作用域。

參數：

scope - 要設置的作用域。

拋出：

SecurityException - 如果安全管理器存在並且其 checkSecurityAccess 方法不允許設置身份作用域。

另請參見：

getSystemScope(), SecurityManager.checkSecurityAccess(java.lang.String)

size

public abstract int size()

已過時。

返回此身份作用域內身份的數目。

返回：

此身份作用域內身份的數目。

getIdentity

public abstract Identity getIdentity(String name)

已過時。

返回此作用域內具有指定名稱的身份（如果有的話）。

參數：

name - 要獲取的身份的名稱。

返回：

名稱為 name 的身份，如果在此作用域內沒有名稱為 name 的身份，則返回 null。

getIdentity

public Identity getIdentity(Principal principal)

已過時。

獲取名稱與指定的主體相同的身份。（註：Identity 實作 Principal。）

參數：

principal - 相應於要獲取的身份的主體。

返回：

名稱與指定的主體相同的身份，如果在此作用域內沒有具有該名稱的身份，則返回 null。

getIdentity

public abstract Identity getIdentity(PublicKey key)

已過時。

獲取具有指定公鑰的身份。

參數：

key - 要返回的身份的公鑰。

返回：

具有給定密鑰的身份，如果此作用域內沒有具有該密鑰的身份，則返回 null。

addIdentity

public abstract void addIdentity(Identity identity)
                          throws KeyManagementException

已過時。

向此身份作用域添加一個身份。

參數：

identity - 要添加的身份。

拋出：

KeyManagementException - 如果身份是無效的、出現了名稱衝突、另一個身份與要添加的身份有相同的公鑰，或者出現其他異常

removeIdentity

public abstract void removeIdentity(Identity identity)
                             throws KeyManagementException

已過時。

從此身份作用作用域移除一個身份。

參數：

identity - 要移除的身份。

拋出：

KeyManagementException - 如果身份丟失或出現其他的異常。

identities

public abstract Enumeration<Identity> identities()

已過時。

返回此身份作用域內所有身份的列舉。

返回：

此身份作用域內所有身份的列舉。

toString

public String toString()

已過時。

返回此身份作用域的字元串表示形式，包括其名稱、作用域名稱和此身份作用域中身份的數目。

指定者：

介面 Principal 中的 toString

覆寫：

類別 Identity 中的 toString

返回：

此身份作用域的字元串表示形式。

另請參見：

SecurityManager.checkSecurityAccess(java.lang.String)