java.security.cert
類別 CertStoreSpi

java.lang.Object
  java.security.cert.CertStoreSpi

public abstract class CertStoreSpi
extends Object

CertStore 類別的服務提供者介面 (SPI)。所有 CertStore 實作必須包括一個類別（SPI 類別），該類別擴展此類別 (CertStoreSpi) 、提供一個具有單個 CertStoreParameters 型別參數的建構子，並實作其所有方法。通常，只應通過 CertStore 類別來存取此類別的實例。有關細節，請參閱 Java Cryptography Architecture。

共時存取

所有 CertStoreSpi 物件的公共方法必須是執行緒安全的。也就是說，多個執行緒在單個 CertStoreSpi 物件（或多個物件）上共時調用這些方法而不會產生壞的影響。例如，這就允許 CertPathBuilder 搜尋 CRL 的同時搜尋其他的證書。

簡單的 CertStoreSpi 實作可能會確保執行緒安全性，方法是向其 engineGetCertificates 和 engineGetCRLs 方法添加 synchronized 關鍵字。更複雜的實作可能允許真正共時的存取。

從以下版本開始：

1.4

建構子摘要

CertStoreSpi(CertStoreParameters params)
唯一的建構子。

方法摘要

abstract Collection<? extends Certificate>	engineGetCertificates(CertSelector selector) 返回與指定選擇器比對的 Certificate 的 Collection。
abstract Collection<? extends CRL>	engineGetCRLs(CRLSelector selector) 返回與指定選擇器比對的 CRL 的 Collection。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

CertStoreSpi

public CertStoreSpi(CertStoreParameters params)
             throws InvalidAlgorithmParameterException

唯一的建構子。

參數：

params - 初始化參數（可以為 null）

拋出：

InvalidAlgorithmParameterException - 如果初始化參數不適合此 CertStoreSpi

方法詳細資訊

engineGetCertificates

public abstract Collection<? extends Certificate> engineGetCertificates(CertSelector selector)
                                                                 throws CertStoreException

返回與指定選擇器比對的 Certificate 的 Collection。如果沒有與此選擇器比對的 Certificate，則返回一個空 Collection。

對於某些 CertStore 型別，得到的 Collection 可能不包含與該選擇器比對的所有 Certificate。例如，LDAP CertStore 可能不搜尋目錄中的所有項。相反，它可能只搜尋那些很可能包含正要尋找的 Certificate 的項。

如果未提供一個套件括了用於尋找證書的具體標準的非 null CertSelector，則某些 CertStore 實作（特別是 LDAP CertStore）可能拋出 CertStoreException。發佈方和/或主體名稱是特別有用的標準。

參數：

selector - 用於選擇應該返回哪些 Certificate 的 CertSelector。指定 null 返回所有的 Certificate（如果受支持的話）。

返回：

與指定選擇器比對的 Certificate 的 Collection（不會為 null）

拋出：

CertStoreException - 如果出現異常

engineGetCRLs

public abstract Collection<? extends CRL> engineGetCRLs(CRLSelector selector)
                                                 throws CertStoreException

返回與指定選擇器比對的 CRL 的 Collection。如果沒有與此選擇器比對的 CRL，則返回一個空 Collection。

對於某些 CertStore 型別，得到的 Collection 可能不包含與該選擇器比對的所有 CRL。例如，LDAP CertStore 可能不搜尋目錄中的所有項。相反，它可能只搜尋那些很可能包含正要尋找的 CRL 的項。

如果未提供一個套件括了用於尋找 CRL 的具體標準的非 null CRLSelector，則某些 CertStore 實作（特別是 LDAP CertStore）可能拋出 CertStoreException。發佈方名稱和/或要檢查的證書特別有用。

參數：

selector - 用於選擇應該返回哪些 CRL 的 CRLSelector。指定 null 返回所有的 CRL（如果受支持的話）。

返回：

與指定選擇器比對的 CRL 的 Collection（不會為 null）

拋出：

CertStoreException - 如果出現異常