概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

java.security.cert
類別 CertPathBuilder

java.lang.Object
  繼承者 java.security.cert.CertPathBuilder

public class CertPathBuilder
extends Object

建構證書路徑（也稱為證書鏈）的類別。

此類別使用基於提供者的架構。要創建一個 CertPathBuilder，應調用某個 static getInstance 方法、傳入所需的 CertPathBuilder 演算法名稱，或者所需的提供者名稱。

一旦創建了 CertPathBuilder 物件，則可以通過調用 build 方法並傳遞一個特定於演算法的參數集來建構證書路徑。如果成功，則在一個實作 CertPathBuilderResult 介面的物件中返回結果（包括已建構的 CertPath）。

共時存取

可保證此類別的 static 方法是執行緒安全的。多個執行緒可以共時調用此類別中定義的 static 方法，而不會產生什麼壞的影響。

但是，對於此類別所定義的非 static 方法並非如此。除非具體的提供者另行指定，否則需要共時存取單個 CertPathBuilder 實例的多個執行緒應該在它們之間實作同步並提供所需的鎖定。對於每個執行緒都操作一個不同 CertPathBuilder 實例的多個執行緒而言，則無需實作同步。

從以下版本開始：
1.4
另請參見：
CertPath

建構子摘要
protected CertPathBuilder(CertPathBuilderSpi builderSpi, Provider provider, String algorithm)
          創建一個給定演算法的 CertPathBuilder 物件，並在其中封裝給定的提供者實作（SPI 物件）。
 
方法摘要
 CertPathBuilderResult build(CertPathParameters params)
          嘗試使用指定的演算法參數集建構一個證書路徑。
 String getAlgorithm()
          返回此 CertPathBuilder 的演算法名稱。
static String getDefaultType()
          返回 Java 安全屬性檔案中所指定的預設 CertPathBuilder 型別，如果沒有此屬性，則返回字元串 "PKIX"。
static CertPathBuilder getInstance(String algorithm)
          返回實作了指定演算法的 CertPathBuilder 物件。
static CertPathBuilder getInstance(String algorithm, Provider provider)
          返回實作了指定演算法的 CertPathBuilder 物件。
static CertPathBuilder getInstance(String algorithm, String provider)
          返回實作了指定演算法的 CertPathBuilder 物件。
 Provider getProvider()
          返回此 CertPathBuilder 的提供者。
 
從類別 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

建構子詳細資訊

CertPathBuilder

protected CertPathBuilder(CertPathBuilderSpi builderSpi,
                          Provider provider,
                          String algorithm)
創建一個給定演算法的 CertPathBuilder 物件，並在其中封裝給定的提供者實作（SPI 物件）。

參數：
builderSpi - 提供者實作
provider - 提供者
algorithm - 演算法名稱
方法詳細資訊

getInstance

public static CertPathBuilder getInstance(String algorithm)
                                   throws NoSuchAlgorithmException
返回實作了指定演算法的 CertPathBuilder 物件。

此方法從首選 Provider 開始，遍歷已註冊安全提供者列表。返回一個封裝 CertPathBuilderSpi 實作的新 CertPathBuilder 物件，該實作取自第一個支持指定演算法的 Provider。

注意，已註冊提供者列表可以通過 Security.getProviders() 方法獲得。

參數：
algorithm - 所請求的 CertPathBuilder 演算法名稱。有關標準演算法名稱的資訊，請參閱 Java Certification Path API Programmer's Guide 的附錄 A。
返回：
實作了指定演算法的 CertPathBuilder 物件。
拋出：
NoSuchAlgorithmException - 如果沒有 Provider 支持指定演算法的 CertPathBuilderSpi 實作。
另請參見：
Provider

getInstance

public static CertPathBuilder getInstance(String algorithm,
                                          String provider)
                                   throws NoSuchAlgorithmException,
                                          NoSuchProviderException
返回實作了指定演算法的 CertPathBuilder 物件。

返回一個封裝 CertPathBuilderSpi 實作的新 CertPathBuilder 物件，該實作取自指定的提供者。指定的提供者必須已在安全提供者列表中註冊。

注意，已註冊提供者列表可以通過 Security.getProviders() 方法獲得。

參數：
algorithm - 所請求的 CertPathBuilder 演算法名稱。有關標準演算法名稱的資訊，請參閱 Java Certification Path API Programmer's Guide 的附錄 A。
provider - 提供者的名稱。
返回：
實作了指定演算法的 CertPathBuilder 物件。
拋出：
NoSuchAlgorithmException - 如果無法從指定提供者獲得指定演算法的 CertPathBuilderSpi 實作。
NoSuchProviderException - 如果指定提供者沒有在安全提供者列表中註冊。
IllegalArgumentException - 如果 provider 為 null 或空。
另請參見：
Provider

getInstance

public static CertPathBuilder getInstance(String algorithm,
                                          Provider provider)
                                   throws NoSuchAlgorithmException
返回實作了指定演算法的 CertPathBuilder 物件。

返回一個封裝 CertPathBuilderSpi 實作的新 CertPathBuilder 物件，該實作取自指定 Provider 物件。注意，指定的 Provider 物件無需在提供者列表中註冊。

參數：
algorithm - 所請求的 CertPathBuilder 演算法名稱。有關標準演算法名稱的資訊，請參閱 Java Certification Path API Programmer's Guide 的附錄 A。
provider - 提供者。
返回：
實作了指定演算法的 CertPathBuilder 物件
拋出：
NoSuchAlgorithmException - 如果無法從指定 Provider 物件獲得指定演算法的 CertPathBuilderSpi 實作。
IllegalArgumentException - 如果 provider 為 null。
另請參見：
Provider

getProvider

public final Provider getProvider()
返回此 CertPathBuilder 的提供者。

返回：
此 CertPathBuilder 的提供者

getAlgorithm

public final String getAlgorithm()
返回此 CertPathBuilder 的演算法名稱。

返回：
此 CertPathBuilder 的演算法名稱

build

public final CertPathBuilderResult build(CertPathParameters params)
                                  throws CertPathBuilderException,
                                         InvalidAlgorithmParameterException
嘗試使用指定的演算法參數集建構一個證書路徑。

參數：
params - 演算法參數
返回：
建構演算法的結果
拋出：
CertPathBuilderException - 如果該產生器無法建構一個滿足指定參數要求的證書路徑
InvalidAlgorithmParameterException - 如果指定的參數不適合此 CertPathBuilder

getDefaultType

public static final String getDefaultType()
返回 Java 安全屬性檔案中所指定的預設 CertPathBuilder 型別，如果沒有此屬性，則返回字元串 "PKIX"。Java 安全屬性檔案位於名為 <JAVA_HOME>/lib/security/java.security 檔案中。 <JAVA_HOME> 參考 java.home 系統屬型的值，並指定安裝 JRE 的目錄。

如果調用某個 getInstance 方法時不希望使用硬編碼 CertPathBuilder 型別，並且在使用者未指定所用 CertPathBuilder 型別的情況下希望提供預設型別的應用程序，那麼可以使用預設的 CertPathBuilder 型別。

通過將 "certpathbuilder.type" 安全屬性（在 Java 安全屬性檔案中）的值設置為所需的型別，這樣就可以更改預設的 CertPathBuilder 型別。

返回：
Java 安全屬性檔案中指定的預設 CertPathBuilder 型別，如果沒有此屬性，則返回字元串 "PKIX"。
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。