javax.naming.ldap
클래스 StartTlsRequest

java.lang.Object 
  |
  +--javax.naming.ldap.StartTlsRequest

모든 구현 인터페이스:

ExtendedRequest , Serializable

public class StartTlsRequest

extends Object

implements ExtendedRequest

이 클래스는 Lightweight Directory Access Protocol (v3): Extension for Transport Layer Security 에 정의되고 있는 LDAPv3 의 StartTLS 확장 요구를 구현합니다. StartTLS 의 오브젝트 식별자는 1.3. 6.1. 4.1. 1466.20037 입니다. 확장 요구의 값은 정의되고 있지 않습니다.

StartTlsRequest/StartTlsResponse 는 TLS 접속을 확립할 경우에 사용합니다. TLS 접속은 extendedOperation() 를 호출한 JNDI 문맥에 관련지을 수 있었던 기존의 LDAP 접속상에 확립됩니다. 통상, JNDI 프로그램에서는 이러한 클래스를 다음과 같이 사용합니다.

 import javax.naming.ldap. *;

 // Open an LDAP association
 LdapContext ctx = new InitialLdapContext();

 // Perform a StartTLS extended operation
 StartTlsResponse tls =
     (StartTlsResponse) ctx.extendedOperation(new StartTlsRequest());

 // Open a TLS connection (over the existing LDAP association) and get details
 // of the negotiated TLS session: cipher suite, peer certificate, etc.
 SSLSession session = tls.negotiate();

 // ... use ctx to perform protected LDAP operations

 // Close the TLS connection (revert back to the underlying LDAP association)
 tls.close();

 // ... use ctx to perform unprotected LDAP operations

 // Close the LDAP association
 ctx.close;
 

도입된 버젼:

1.4

관련 항목:

StartTlsResponse , 직렬화 된 형식

필드의 개요

static String

OID StartTLS 확장 요구에 할당할 수 있고 있는 오브젝트 식별자는 1.3. 6.1. 4.1. 1466.20037 입니다.

생성자의 개요

StartTlsRequest ()
StartTLS 확장 요구를 구축합니다.

메소드의 개요

ExtendedResponse	createExtendedResponse (String id, byte[] berValue, int offset, int length) LDAP StartTLS 확장 요구에 대응하는 확장 응답 오브젝트를 작성합니다.
byte[]	getEncodedValue () StartTLS 요구의 ASN. 1 BER 로 encode 된 값을 취득합니다.
String	getID () StartTLS 요구의 오브젝트 식별자의 캐릭터 라인을 취득합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

OID

public static final String  OID

StartTLS 확장 요구에 할당할 수 있고 있는 오브젝트 식별자는 1.3. 6.1. 4.1. 1466.20037 입니다.

관련 항목:

정수 필드치

생성자의 상세

StartTlsRequest

public StartTlsRequest()

StartTLS 확장 요구를 구축합니다.

메소드의 상세

getID

public String  getID()

StartTLS 요구의 오브젝트 식별자의 캐릭터 라인을 취득합니다.

정의:

인터페이스 ExtendedRequest 내의 getID

반환값:

오브젝트 식별자의 캐릭터 라인, 1.3. 6.1. 4.1. 1466.20037

getEncodedValue

public byte[] getEncodedValue()

StartTLS 요구의 ASN. 1 BER 로 encode 된 값을 취득합니다. StartTLS 요구에는 정의 끝난 값이 없기 때문에, 항상 null 가 돌려주어집니다.

정의:

인터페이스 ExtendedRequest 내의 getEncodedValue

반환값:

null 치

createExtendedResponse

public ExtendedResponse  createExtendedResponse(String  id,
                                               byte[] berValue,
                                               int offset,
                                               int length)
                                        throws NamingException 

LDAP StartTLS 확장 요구에 대응하는 확장 응답 오브젝트를 작성합니다.

이 결과는 인수 없음의 public constructor를 가지는 StartTlsResponse 의 구상 서브 클래스가 아니면 안됩니다.

이 메소드는 구현 클래스를 검색하기 위해서, 다음의 이름의 설정 파일을 검색합니다.

META-INF/services/javax.naming.ldap.StartTlsResponse

설정 파일 및 대응하는 구현 클래스는 호출측 thread의 문맥 클래스 로더로부터 액세스 할 수 없으면 안됩니다.

각각의 설정 파일에는 완전 지정 클래스명이 1 행에 1 개씩 지정되고 있는 리스트가 포함되어 있을 필요가 있습니다. 각각의 이름을 둘러싸는 공백 캐릭터와 탭 캐릭터, 및 공백행은 무시됩니다. 코멘트 캐릭터는 '#' (0x23)로, 행의 최초의 코멘트 캐릭터에 계속되는 캐릭터는 모두 무시됩니다. 파일은 UTF-8 로 encode 되고 있을 필요가 있습니다.

이 메소드는 설정 파일로부터 수집한 클래스명의 리스트로부터, 최초로 로드 및 인스턴스화할 수 있었던 구현 클래스의 인스턴스를 돌려줍니다. 이 메소드는 호출측 thread의 문맥 클래스 로더를 사용해 설정 파일을 검색해, 구현 클래스를 로드합니다.

상기의 방법으로 클래스가 발견되지 않았던 경우는 구현 고유의 방법으로 구현을 검색합니다. 구현이 발견되지 않았던 경우는 NamingException 가 슬로우 됩니다.

정의:

인터페이스 ExtendedRequest 내의 createExtendedResponse

파라미터:

id - 확장 응답의 오브젝트 식별자. 값은 「1.3. 6.1. 4.1. 1466.20037」또는 null 가 아니면 안된다. 이 2 개의 값은 등가인

berValue - 확장 응답의 ASN. 1 BER 로 encode 된 값. 값은 null 의 경우도 있다. 이 값은 응답치의 태그와 길이를 포함한 raw BER 바이트이다. 다만, 응답 OID 는 포함하지 않는다. StartTLS 응답은 응답치를 포함하지 않기 때문에, 이 값은 무시되는

offset - 사용하는 바이트의 개시 위치 (berValue). StartTLS 응답은 응답치를 포함하지 않기 때문에, 이 값은 무시되는

length - 사용하는 바이트수 (berValue). StartTLS 응답은 응답치를 포함하지 않기 때문에, 이 값은 무시된다

반환값:

StartTLS 확장 응답 오브젝트

예외:

NamingException - StartTLS 확장 응답 오브젝트의 작성중에 네이밍 예외가 발생했을 경우

관련 항목:

ExtendedResponse