Java Doc for CertificateFactorySpi.java in  » 6.0-JDK-Modules » j2me » java » security » cert » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » 6.0 JDK Modules » j2me » java.security.cert 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   java.security.cert.CertificateFactorySpi

All known Subclasses:   sun.security.provider.X509Factory,
CertificateFactorySpi
abstract public class CertificateFactorySpi (Code)
This class defines the Service Provider Interface (SPI) for the CertificateFactory class. All the abstract methods in this class must be implemented by each cryptographic service provider who wishes to supply the implementation of a certificate factory for a particular certificate type, e.g., X.509.

Certificate factories are used to generate certificate, certification path (CertPath) and certificate revocation list (CRL) objects from their encodings.

A certificate factory for X.509 must return certificates that are an instance of java.security.cert.X509Certificate, and CRLs that are an instance of java.security.cert.X509CRL.
author:
   Hemma Prafullchandra
author:
   Jan Luehe
author:
   Sean Mullan
version:
   1.9, 02/02/00
See Also:   CertificateFactory
See Also:   Certificate
See Also:   X509Certificate
See Also:   CertPath
See Also:   CRL
See Also:   X509CRL
since:
   1.2





Method Summary
abstract public  CRLengineGenerateCRL(InputStream inStream)
     Generates a certificate revocation list (CRL) object and initializes it with the data read from the input stream inStream.

In order to take advantage of the specialized CRL format supported by this certificate factory, the returned CRL object can be typecast to the corresponding CRL class.

abstract public  CollectionengineGenerateCRLs(InputStream inStream)
     Returns a (possibly empty) collection view of the CRLs read from the given input stream inStream.

In order to take advantage of the specialized CRL format supported by this certificate factory, each element in the returned collection view can be typecast to the corresponding CRL class.

public  CertPathengineGenerateCertPath(InputStream inStream)
     Generates a CertPath object and initializes it with the data read from the InputStream inStream.
public  CertPathengineGenerateCertPath(InputStream inStream, String encoding)
     Generates a CertPath object and initializes it with the data read from the InputStream inStream.
public  CertPathengineGenerateCertPath(List certificates)
     Generates a CertPath object and initializes it with a List of Certificates.

The certificates supplied must be of a type supported by the CertificateFactory.

abstract public  CertificateengineGenerateCertificate(InputStream inStream)
     Generates a certificate object and initializes it with the data read from the input stream inStream.

In order to take advantage of the specialized certificate format supported by this certificate factory, the returned certificate object can be typecast to the corresponding certificate class.

abstract public  CollectionengineGenerateCertificates(InputStream inStream)
     Returns a (possibly empty) collection view of the certificates read from the given input stream inStream.

In order to take advantage of the specialized certificate format supported by this certificate factory, each element in the returned collection view can be typecast to the corresponding certificate class.

public  IteratorengineGetCertPathEncodings()
     Returns an iteration of the CertPath encodings supported by this certificate factory, with the default encoding first.



Method Detail
engineGenerateCRL
abstract public CRL engineGenerateCRL(InputStream inStream) throws CRLException(Code)
Generates a certificate revocation list (CRL) object and initializes it with the data read from the input stream inStream.

In order to take advantage of the specialized CRL format supported by this certificate factory, the returned CRL object can be typecast to the corresponding CRL class. For example, if this certificate factory implements X.509 CRLs, the returned CRL object can be typecast to the X509CRL class.

Note that if the given input stream does not support java.io.InputStream.mark(int) mark and java.io.InputStream.reset reset , this method will consume the entire input stream. Otherwise, each call to this method consumes one CRL and the read position of the input stream is positioned to the next available byte after the the inherent end-of-CRL marker. If the data in the input stream does not contain an inherent end-of-CRL marker (other than EOF) and there is trailing data after the CRL is parsed, a CRLException is thrown.
Parameters:
  inStream - an input stream with the CRL data. a CRL object initialized with the datafrom the input stream.
exception:
  CRLException - on parsing errors.




engineGenerateCRLs
abstract public Collection engineGenerateCRLs(InputStream inStream) throws CRLException(Code)
Returns a (possibly empty) collection view of the CRLs read from the given input stream inStream.

In order to take advantage of the specialized CRL format supported by this certificate factory, each element in the returned collection view can be typecast to the corresponding CRL class. For example, if this certificate factory implements X.509 CRLs, the elements in the returned collection can be typecast to the X509CRL class.

In the case of a certificate factory for X.509 CRLs, inStream may contain a single DER-encoded CRL. In addition, inStream may contain a PKCS#7 CRL set. This is a PKCS#7 SignedData object, with the only significant field being crls. In particular, the signature and the contents are ignored. This format allows multiple CRLs to be downloaded at once. If no CRLs are present, an empty collection is returned.

Note that if the given input stream does not support java.io.InputStream.mark(int) mark and java.io.InputStream.reset reset , this method will consume the entire input stream.
Parameters:
  inStream - the input stream with the CRLs. a (possibly empty) collection view ofjava.security.cert.CRL objects initialized with the data from the inputstream.
exception:
  CRLException - on parsing errors.




engineGenerateCertPath
public CertPath engineGenerateCertPath(InputStream inStream) throws CertificateException(Code)
Generates a CertPath object and initializes it with the data read from the InputStream inStream. The data is assumed to be in the default encoding.
Parameters:
  inStream - an InputStream containing the data a CertPath initialized with the data from theInputStream
exception:
  CertificateException - if an exception occurs while decoding
since:
   1.4



engineGenerateCertPath
public CertPath engineGenerateCertPath(InputStream inStream, String encoding) throws CertificateException(Code)
Generates a CertPath object and initializes it with the data read from the InputStream inStream. The data is assumed to be in the specified encoding.

This method was added to version 1.4 of the Java 2 Platform Standard Edition. In order to maintain backwards compatibility with existing service providers, this method cannot be abstract and by default throws an UnsupportedOperationException.
Parameters:
  inStream - an InputStream containing the data
Parameters:
  encoding - the encoding used for the data a CertPath initialized with the data from theInputStream
exception:
  CertificateException - if an exception occurs while decoding orthe encoding requested is not supported
exception:
  UnsupportedOperationException - if the method is not supported
since:
   1.4




engineGenerateCertPath
public CertPath engineGenerateCertPath(List certificates) throws CertificateException(Code)
Generates a CertPath object and initializes it with a List of Certificates.

The certificates supplied must be of a type supported by the CertificateFactory. They will be copied out of the supplied List object.

This method was added to version 1.4 of the Java 2 Platform Standard Edition. In order to maintain backwards compatibility with existing service providers, this method cannot be abstract and by default throws an UnsupportedOperationException.
Parameters:
  certificates - a List of Certificates a CertPath initialized with the supplied list ofcertificates
exception:
  CertificateException - if an exception occurs
exception:
  UnsupportedOperationException - if the method is not supported
since:
   1.4




engineGenerateCertificate
abstract public Certificate engineGenerateCertificate(InputStream inStream) throws CertificateException(Code)
Generates a certificate object and initializes it with the data read from the input stream inStream.

In order to take advantage of the specialized certificate format supported by this certificate factory, the returned certificate object can be typecast to the corresponding certificate class. For example, if this certificate factory implements X.509 certificates, the returned certificate object can be typecast to the X509Certificate class.

In the case of a certificate factory for X.509 certificates, the certificate provided in inStream must be DER-encoded and may be supplied in binary or printable (Base64) encoding. If the certificate is provided in Base64 encoding, it must be bounded at the beginning by -----BEGIN CERTIFICATE-----, and must be bounded at the end by -----END CERTIFICATE-----.

Note that if the given input stream does not support java.io.InputStream.mark(int) mark and java.io.InputStream.reset reset , this method will consume the entire input stream. Otherwise, each call to this method consumes one certificate and the read position of the input stream is positioned to the next available byte after the the inherent end-of-certificate marker. If the data in the input stream does not contain an inherent end-of-certificate marker (other than EOF) and there is trailing data after the certificate is parsed, a CertificateException is thrown.
Parameters:
  inStream - an input stream with the certificate data. a certificate object initialized with the datafrom the input stream.
exception:
  CertificateException - on parsing errors.




engineGenerateCertificates
abstract public Collection engineGenerateCertificates(InputStream inStream) throws CertificateException(Code)
Returns a (possibly empty) collection view of the certificates read from the given input stream inStream.

In order to take advantage of the specialized certificate format supported by this certificate factory, each element in the returned collection view can be typecast to the corresponding certificate class. For example, if this certificate factory implements X.509 certificates, the elements in the returned collection can be typecast to the X509Certificate class.

In the case of a certificate factory for X.509 certificates, inStream may contain a single DER-encoded certificate in the formats described for CertificateFactory.generateCertificate(java.io.InputStream) generateCertificate . In addition, inStream may contain a PKCS#7 certificate chain. This is a PKCS#7 SignedData object, with the only significant field being certificates. In particular, the signature and the contents are ignored. This format allows multiple certificates to be downloaded at once. If no certificates are present, an empty collection is returned.

Note that if the given input stream does not support java.io.InputStream.mark(int) mark and java.io.InputStream.reset reset , this method will consume the entire input stream.
Parameters:
  inStream - the input stream with the certificates. a (possibly empty) collection view ofjava.security.cert.Certificate objectsinitialized with the data from the input stream.
exception:
  CertificateException - on parsing errors.




engineGetCertPathEncodings
public Iterator engineGetCertPathEncodings()(Code)
Returns an iteration of the CertPath encodings supported by this certificate factory, with the default encoding first. See Appendix A in the Java Certification Path API Programmer's Guide for information about standard encoding names.

Attempts to modify the returned Iterator via its remove method result in an UnsupportedOperationException.

This method was added to version 1.4 of the Java 2 Platform Standard Edition. In order to maintain backwards compatibility with existing service providers, this method cannot be abstract and by default throws an UnsupportedOperationException. an Iterator over the names of the supportedCertPath encodings (as Strings)
exception:
  UnsupportedOperationException - if the method is not supported
since:
   1.4




Methods inherited from java.lang.Object
public boolean equals(Object obj)(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.