JavaTM 2
Platform
Std.  Ed.  v1. 4.0

java.security
인터페이스 Certificate


추천 되고 있지 않습니다.  Java 2 플랫폼에서는 증명서를 취급하는 새로운 패키지가 작성되었습니다. 이 Certificate 인터페이스의 사용은 추천 되지 않습니다. 새로운 패키지에의 원활한 이행을 위해서(때문에) 남아 있습니다.

public interface Certificate

다양한 신원 증명서를 관리하는 abstract 메소드로부터 구성되는 인터페이스입니다. 신원 증명서란, 공개열쇠가 다른 있는 주체의 것임을 주체가 프로텍션하기 위한의 것입니다 (주체와는 개인 유저, 그룹, 회사등의 엔티티를 나타내는 것).

이 인터페이스는 특히, 형식은 다르지만 중요한 공통의 용도를 가지는 원가요소의, 공통의 추상화를 의도한 것입니다. 예를 들어, X. 509 증명서, PGP 증명서등의 다른 종류의 증명서는 일반적인 증명서 기능을 공유합니다 (이러한 증명서는 encode 및 복호화 될 필요가 있습니다). 또, 공개열쇠, 열쇠를 소유하는 주체, 공개열쇠가 지정의 주체의 것임을 프로텍션하는 프로텍션자등의 정보도 공유합니다. X. 509 증명서와 PGP 증명서의 각 구현은 그 형식, 및 저장되고 있는 그 외의 정보의 종류나 양이 차이가 나도, 양쪽 모두 이 Certificate 인터페이스를 이용할 수가 있습니다.

중요: 이 인터페이스는 어느 일반적인 용도를 공유하는 오브젝트를 카탈로그화하거나 그룹화 하거나 하는데 유효합니다. 또, 그것 자신의 시멘틱스는 가지고 있지 않습니다. 특히 Certificate 오브젝트는 바인딩의 타당성에 대해서는 아무것도 규정하고 있습니다. 증명서를 검증해, 그 타당성을 확인하는 것은 이 인터페이스를 구현하는 어플리케이션이 실시하지 않으면 안됩니다.

관련 항목:
Certificate

메소드의 개요
 void decode (InputStream  stream)
          추천 되고 있지 않습니다.  입력 스트림으로부터 증명서를 복호화(decode) 합니다.
 void encode (OutputStream  stream)
          추천 되고 있지 않습니다.  decode 메소드에 의해 복호화(decode) 할 수 있는 형식에서, 증명서를 출력 스트림에 encode 합니다.
 String getFormat ()
          추천 되고 있지 않습니다.  코드 형식의 이름을 돌려줍니다.
 Principal getGuarantor ()
          추천 되고 있지 않습니다.  증명서의 프로텍션자, 즉 그 증명서에 관련하는 공개열쇠가 같은 보증서에 관련하는 주체의 것임을 프로텍션하는 주체를 돌려줍니다.
 Principal getPrincipal ()
          추천 되고 있지 않습니다.  프로텍션자에 의해 프로텍션되는 주체와 열쇠의 페어중 주체를 돌려줍니다.
 PublicKey getPublicKey ()
          추천 되고 있지 않습니다.  프로텍션자에 의해 프로텍션되는 주체와 열쇠의 페어중 열쇠를 돌려줍니다.
 String toString (boolean detailed)
          추천 되고 있지 않습니다.  증명서의 내용을 나타내는 캐릭터 라인을 돌려줍니다.
 

메소드의 상세

getGuarantor

public Principal  getGuarantor()
추천 되고 있지 않습니다.  
증명서의 프로텍션자, 즉 그 증명서에 관련하는 공개열쇠가 같은 보증서에 관련하는 주체의 것임을 프로텍션하는 주체를 돌려줍니다. X. 509 증명서의 경우, 증명서의 주체는 통상, 인증국 (United States Postal Service 나 Verisign, Inc. 등)입니다.

반환값:
주체와 열쇠의 바인딩을 프로텍션하는 증명서의 프로텍션자

getPrincipal

public Principal  getPrincipal()
추천 되고 있지 않습니다.  
프로텍션자에 의해 프로텍션되는 주체와 열쇠의 페어중 주체를 돌려줍니다.

반환값:
이 증명서가 바인드 되고 있는 주체

getPublicKey

public PublicKey  getPublicKey()
추천 되고 있지 않습니다.  
프로텍션자에 의해 프로텍션되는 주체와 열쇠의 페어중 열쇠를 돌려줍니다.

반환값:
이 증명서가 특정의 주체에 소속하는 것을 증명하는 공개열쇠

encode

public void encode(OutputStream  stream)
            throws KeyException ,
                   IOException 
추천 되고 있지 않습니다.  
decode 메소드에 의해 복호화(decode) 할 수 있는 형식에서, 증명서를 출력 스트림에 encode 합니다.

파라미터:
stream - 증명서를 encode 하는 출력 스트림
예외:
KeyException - 증명서가 올바르게 초기화되지 않는 경우, 혹은 데이터가 없는등의 경우
IOException - 증명서를 출력 스트림에 encode 해 출력하려고 하고 있을 때에 스트림 예외가 발생했을 경우
관련 항목:
decode(java.io.InputStream) , getFormat()

decode

public void decode(InputStream  stream)
            throws KeyException ,
                   IOException 
추천 되고 있지 않습니다.  
입력 스트림으로부터 증명서를 복호화(decode) 합니다. 형식은 getFormat 가 돌려준 것으로,encode 가 생성한 것일 필요가 있습니다.

파라미터:
stream - 복호화(decode) 하는 데이타를 뽑기 시작하는 입력 스트림
예외:
KeyException - 증명서가 올바르게 초기화되지 않는 경우, 혹은 데이터가 없는등의 경우
IOException - 입력 스트림으로부터 encode 된 증명서를 입력하려고 하고 있을 때에 예외가 발생했을 경우
관련 항목:
encode(java.io.OutputStream) , getFormat()

getFormat

public String  getFormat()
추천 되고 있지 않습니다.  
코드 형식의 이름을 돌려줍니다. 이것은 적절한 파서를 발견하기 위한 힌트로서 사용합니다. 파서는 X. 509, PGP 등을 생각됩니다. 이 코드는 encode 메소드와 decode 메소드에 의해 작성되고 인식되는 형식입니다.

반환값:
코드 형식의 이름

toString

public String  toString(boolean detailed)
추천 되고 있지 않습니다.  
증명서의 내용을 나타내는 캐릭터 라인을 돌려줍니다.

파라미터:
detailed - 증명서의 상세 정보를 줄지 어떨지
반환값:
증명서의 내용을 나타내는 캐릭터 라인

JavaTM 2
Platform
Std.  Ed.  v1. 4.0

버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.