keystorespi.html

API資料大全

</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../java/security/KeyStoreSpi.html#engineSetCertificateEntry(java.lang.String, java.security.cert.Certificate)">engineSetCertificateEntry</A></B>(<A HREF="../../java/lang/String.html">String</A>&nbsp;alias,
                          <A HREF="../../java/security/cert/Certificate.html">Certificate</A>&nbsp;cert)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Assigns the given certificate to the given alias.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../java/security/KeyStoreSpi.html#engineSetKeyEntry(java.lang.String, byte[], java.security.cert.Certificate[])">engineSetKeyEntry</A></B>(<A HREF="../../java/lang/String.html">String</A>&nbsp;alias,
                  byte[]&nbsp;key,
                  <A HREF="../../java/security/cert/Certificate.html">Certificate</A>[]&nbsp;chain)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Assigns the given key (that has already been protected) to the given
 alias.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../java/security/KeyStoreSpi.html#engineSetKeyEntry(java.lang.String, java.security.Key, char[], java.security.cert.Certificate[])">engineSetKeyEntry</A></B>(<A HREF="../../java/lang/String.html">String</A>&nbsp;alias,
                  <A HREF="../../java/security/Key.html">Key</A>&nbsp;key,
                  char[]&nbsp;password,
                  <A HREF="../../java/security/cert/Certificate.html">Certificate</A>[]&nbsp;chain)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Assigns the given key to the given alias, protecting it with the given
 password.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract &nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../java/security/KeyStoreSpi.html#engineSize()">engineSize</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Retrieves the number of entries in this keystore.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract &nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../java/security/KeyStoreSpi.html#engineStore(java.io.OutputStream, char[])">engineStore</A></B>(<A HREF="../../java/io/OutputStream.html">OutputStream</A>&nbsp;stream,
            char[]&nbsp;password)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Stores this keystore to the given output stream, and protects its
 integrity with the given password.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.<A HREF="../../java/lang/Object.html">Object</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../java/lang/Object.html#clone()">clone</A>, <A HREF="../../java/lang/Object.html#equals(java.lang.Object)">equals</A>, <A HREF="../../java/lang/Object.html#finalize()">finalize</A>, <A HREF="../../java/lang/Object.html#getClass()">getClass</A>, <A HREF="../../java/lang/Object.html#hashCode()">hashCode</A>, <A HREF="../../java/lang/Object.html#notify()">notify</A>, <A HREF="../../java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../../java/lang/Object.html#toString()">toString</A>, <A HREF="../../java/lang/Object.html#wait()">wait</A>, <A HREF="../../java/lang/Object.html#wait(long)">wait</A>, <A HREF="../../java/lang/Object.html#wait(long, int)">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="KeyStoreSpi()"><!-- --></A><H3>
KeyStoreSpi</H3>
<PRE>
public <B>KeyStoreSpi</B>()</PRE>
<DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="engineGetKey(java.lang.String, char[])"><!-- --></A><H3>
engineGetKey</H3>
<PRE>
public abstract <A HREF="../../java/security/Key.html">Key</A> <B>engineGetKey</B>(<A HREF="../../java/lang/String.html">String</A>&nbsp;alias,
                                 char[]&nbsp;password)
                          throws <A HREF="../../java/security/NoSuchAlgorithmException.html">NoSuchAlgorithmException</A>,
                                 <A HREF="../../java/security/UnrecoverableKeyException.html">UnrecoverableKeyException</A></PRE>
<DL>
<DD>Returns the key associated with the given alias, using the given
 password to recover it.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>alias</CODE> - the alias name<DD><CODE>password</CODE> - the password for recovering the key<DT><B>Returns:</B><DD>the requested key, or null if the given alias does not exist
 or does not identify a <i>key entry</i>.<DT><B>Throws:</B><DD><CODE><A HREF="../../java/security/NoSuchAlgorithmException.html">NoSuchAlgorithmException</A></CODE> - if the algorithm for recovering the
 key cannot be found<DD><CODE><A HREF="../../java/security/UnrecoverableKeyException.html">UnrecoverableKeyException</A></CODE> - if the key cannot be recovered
 (e.g., the given password is wrong).</DL>
</DD>
</DL>
<HR>

<A NAME="engineGetCertificateChain(java.lang.String)"><!-- --></A><H3>
engineGetCertificateChain</H3>
<PRE>
public abstract <A HREF="../../java/security/cert/Certificate.html">Certificate</A>[] <B>engineGetCertificateChain</B>(<A HREF="../../java/lang/String.html">String</A>&nbsp;alias)</PRE>
<DL>
<DD>Returns the certificate chain associated with the given alias.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>alias</CODE> - the alias name<DT><B>Returns:</B><DD>the certificate chain (ordered with the user's certificate first
 and the root certificate authority last), or null if the given alias
 does not exist or does not contain a certificate chain (i.e., the given
 alias identifies either a <i>trusted certificate entry</i> or a
 <i>key entry</i> without a certificate chain).</DL>
</DD>
</DL>
<HR>

<A NAME="engineGetCertificate(java.lang.String)"><!-- --></A><H3>
engineGetCertificate</H3>
<PRE>
public abstract <A HREF="../../java/security/cert/Certificate.html">Certificate</A> <B>engineGetCertificate</B>(<A HREF="../../java/lang/String.html">String</A>&nbsp;alias)</PRE>
<DL>
<DD>Returns the certificate associated with the given alias.

 <p>If the given alias name identifies a
 <i>trusted certificate entry</i>, the certificate associated with that
 entry is returned. If the given alias name identifies a
 <i>key entry</i>, the first element of the certificate chain of that
 entry is returned, or null if that entry does not have a certificate
 chain.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>alias</CODE> - the alias name<DT><B>Returns:</B><DD>the certificate, or null if the given alias does not exist or
 does not contain a certificate.</DL>
</DD>
</DL>
<HR>

<A NAME="engineGetCreationDate(java.lang.String)"><!-- --></A><H3>
engineGetCreationDate</H3>
<PRE>
public abstract <A HREF="../../java/util/Date.html">Date</A> <B>engineGetCreationDate</B>(<A HREF="../../java/lang/String.html">String</A>&nbsp;alias)</PRE>
<DL>
<DD>Returns the creation date of the entry identified by the given alias.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>alias</CODE> - the alias name<DT><B>Returns:</B><DD>the creation date of this entry, or null if the given alias does
 not exist</DL>
</DD>
</DL>
<HR>

<A NAME="engineSetKeyEntry(java.lang.String, java.security.Key, char[], java.security.cert.Certificate[])"><!-- --></A><H3>
engineSetKeyEntry</H3>
<PRE>
public abstract void <B>engineSetKeyEntry</B>(<A HREF="../../java/lang/String.html">String</A>&nbsp;alias,
                                       <A HREF="../../java/security/Key.html">Key</A>&nbsp;key,
                                       char[]&nbsp;password,
                                       <A HREF="../../java/security/cert/Certificate.html">Certificate</A>[]&nbsp;chain)
                                throws <A HREF="../../java/security/KeyStoreException.html">KeyStoreException</A></PRE>
<DL>
<DD>Assigns the given key to the given alias, protecting it with the given
 password.

 <p>If the given key is of type <code>java.security.PrivateKey</code>,
 it must be accompanied by a certificate chain certifying the
 corresponding public key.

 <p>If the given alias already exists, the keystore information
 associated with it is overridden by the given key (and possibly
 certificate chain).<DD><DL>
<DT><B>Parameters:</B><DD><CODE>alias</CODE> - the alias name<DD><CODE>key</CODE> - the key to be associated with the alias<DD><CODE>password</CODE> - the password to protect the key<DD><CODE>chain</CODE> - the certificate chain for the corresponding public
 key (only required if the given key is of type
 <code>java.security.PrivateKey</code>).<DT><B>Throws:</B><DD><CODE><A HREF="../../java/security/KeyStoreException.html">KeyStoreException</A></CODE> - if the given key cannot be protected, or
 this operation fails for some other reason</DL>
</DD>
</DL>
<HR>

<A NAME="engineSetKeyEntry(java.lang.String, byte[], java.security.cert.Certificate[])"><!-- --></A><H3>
engineSetKeyEntry</H3>
<PRE>
public abstract void <B>engineSetKeyEntry</B>(<A HREF="../../java/lang/String.html">String</A>&nbsp;alias,
                                       byte[]&nbsp;key,
                                       <A HREF="../../java/security/cert/Certificate.html">Certificate</A>[]&nbsp;chain)
                                throws <A HREF="../../java/security/KeyStoreException.html">KeyStoreException</A></PRE>
<DL>
<DD>Assigns the given key (that has already been protected) to the given
 alias.

 <p>If the protected key is of type
 <code>java.security.PrivateKey</code>,
 it must be accompanied by a certificate chain certifying the
 corresponding public key.

 <p>If the given alias already exists, the keystore information
 associated with it is overridden by the given key (and possibly
 certificate chain).<DD><DL>
<DT><B>Parameters:</B><DD><CODE>alias</CODE> - the alias name<DD><CODE>key</CODE> - the key (in protected format) to be associated with the alias<DD><CODE>chain</CODE> - the certificate chain for the corresponding public