src/java.base/share/classes/java/security/cert/CertificateFactorySpi.java
changeset 58242 94bb65cb37d3
parent 47216 71c04702a3d5
equal deleted inserted replaced
58241:33de7752835c 58242:94bb65cb37d3
     1 /*
     1 /*
     2  * Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 1998, 2019, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
    97      * @param inStream an input stream with the certificate data.
    97      * @param inStream an input stream with the certificate data.
    98      *
    98      *
    99      * @return a certificate object initialized with the data
    99      * @return a certificate object initialized with the data
   100      * from the input stream.
   100      * from the input stream.
   101      *
   101      *
   102      * @exception CertificateException on parsing errors.
   102      * @throws    CertificateException on parsing errors.
   103      */
   103      */
   104     public abstract Certificate engineGenerateCertificate(InputStream inStream)
   104     public abstract Certificate engineGenerateCertificate(InputStream inStream)
   105         throws CertificateException;
   105         throws CertificateException;
   106 
   106 
   107     /**
   107     /**
   115      * and by default throws an {@code UnsupportedOperationException}.
   115      * and by default throws an {@code UnsupportedOperationException}.
   116      *
   116      *
   117      * @param inStream an {@code InputStream} containing the data
   117      * @param inStream an {@code InputStream} containing the data
   118      * @return a {@code CertPath} initialized with the data from the
   118      * @return a {@code CertPath} initialized with the data from the
   119      *   {@code InputStream}
   119      *   {@code InputStream}
   120      * @exception CertificateException if an exception occurs while decoding
   120      * @throws    CertificateException if an exception occurs while decoding
   121      * @exception UnsupportedOperationException if the method is not supported
   121      * @throws    UnsupportedOperationException if the method is not supported
   122      * @since 1.4
   122      * @since 1.4
   123      */
   123      */
   124     public CertPath engineGenerateCertPath(InputStream inStream)
   124     public CertPath engineGenerateCertPath(InputStream inStream)
   125         throws CertificateException
   125         throws CertificateException
   126     {
   126     {
   139      *
   139      *
   140      * @param inStream an {@code InputStream} containing the data
   140      * @param inStream an {@code InputStream} containing the data
   141      * @param encoding the encoding used for the data
   141      * @param encoding the encoding used for the data
   142      * @return a {@code CertPath} initialized with the data from the
   142      * @return a {@code CertPath} initialized with the data from the
   143      *   {@code InputStream}
   143      *   {@code InputStream}
   144      * @exception CertificateException if an exception occurs while decoding or
   144      * @throws    CertificateException if an exception occurs while decoding or
   145      *   the encoding requested is not supported
   145      *   the encoding requested is not supported
   146      * @exception UnsupportedOperationException if the method is not supported
   146      * @throws    UnsupportedOperationException if the method is not supported
   147      * @since 1.4
   147      * @since 1.4
   148      */
   148      */
   149     public CertPath engineGenerateCertPath(InputStream inStream,
   149     public CertPath engineGenerateCertPath(InputStream inStream,
   150         String encoding) throws CertificateException
   150         String encoding) throws CertificateException
   151     {
   151     {
   166      * and by default throws an {@code UnsupportedOperationException}.
   166      * and by default throws an {@code UnsupportedOperationException}.
   167      *
   167      *
   168      * @param certificates a {@code List} of {@code Certificate}s
   168      * @param certificates a {@code List} of {@code Certificate}s
   169      * @return a {@code CertPath} initialized with the supplied list of
   169      * @return a {@code CertPath} initialized with the supplied list of
   170      *   certificates
   170      *   certificates
   171      * @exception CertificateException if an exception occurs
   171      * @throws    CertificateException if an exception occurs
   172      * @exception UnsupportedOperationException if the method is not supported
   172      * @throws    UnsupportedOperationException if the method is not supported
   173      * @since 1.4
   173      * @since 1.4
   174      */
   174      */
   175     public CertPath
   175     public CertPath
   176         engineGenerateCertPath(List<? extends Certificate> certificates)
   176         engineGenerateCertPath(List<? extends Certificate> certificates)
   177         throws CertificateException
   177         throws CertificateException
   196      * existing service providers, this method cannot be {@code abstract}
   196      * existing service providers, this method cannot be {@code abstract}
   197      * and by default throws an {@code UnsupportedOperationException}.
   197      * and by default throws an {@code UnsupportedOperationException}.
   198      *
   198      *
   199      * @return an {@code Iterator} over the names of the supported
   199      * @return an {@code Iterator} over the names of the supported
   200      *         {@code CertPath} encodings (as {@code String}s)
   200      *         {@code CertPath} encodings (as {@code String}s)
   201      * @exception UnsupportedOperationException if the method is not supported
   201      * @throws    UnsupportedOperationException if the method is not supported
   202      * @since 1.4
   202      * @since 1.4
   203      */
   203      */
   204     public Iterator<String> engineGetCertPathEncodings() {
   204     public Iterator<String> engineGetCertPathEncodings() {
   205         throw new UnsupportedOperationException();
   205         throw new UnsupportedOperationException();
   206     }
   206     }
   237      *
   237      *
   238      * @return a (possibly empty) collection view of
   238      * @return a (possibly empty) collection view of
   239      * java.security.cert.Certificate objects
   239      * java.security.cert.Certificate objects
   240      * initialized with the data from the input stream.
   240      * initialized with the data from the input stream.
   241      *
   241      *
   242      * @exception CertificateException on parsing errors.
   242      * @throws    CertificateException on parsing errors.
   243      */
   243      */
   244     public abstract Collection<? extends Certificate>
   244     public abstract Collection<? extends Certificate>
   245             engineGenerateCertificates(InputStream inStream)
   245             engineGenerateCertificates(InputStream inStream)
   246             throws CertificateException;
   246             throws CertificateException;
   247 
   247 
   270      * @param inStream an input stream with the CRL data.
   270      * @param inStream an input stream with the CRL data.
   271      *
   271      *
   272      * @return a CRL object initialized with the data
   272      * @return a CRL object initialized with the data
   273      * from the input stream.
   273      * from the input stream.
   274      *
   274      *
   275      * @exception CRLException on parsing errors.
   275      * @throws    CRLException on parsing errors.
   276      */
   276      */
   277     public abstract CRL engineGenerateCRL(InputStream inStream)
   277     public abstract CRL engineGenerateCRL(InputStream inStream)
   278         throws CRLException;
   278         throws CRLException;
   279 
   279 
   280     /**
   280     /**
   306      *
   306      *
   307      * @return a (possibly empty) collection view of
   307      * @return a (possibly empty) collection view of
   308      * java.security.cert.CRL objects initialized with the data from the input
   308      * java.security.cert.CRL objects initialized with the data from the input
   309      * stream.
   309      * stream.
   310      *
   310      *
   311      * @exception CRLException on parsing errors.
   311      * @throws    CRLException on parsing errors.
   312      */
   312      */
   313     public abstract Collection<? extends CRL> engineGenerateCRLs
   313     public abstract Collection<? extends CRL> engineGenerateCRLs
   314             (InputStream inStream) throws CRLException;
   314             (InputStream inStream) throws CRLException;
   315 }
   315 }