com.datastax.driver.core.RemoteEndpointAwareSSLOptions Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of dse-java-driver-core Show documentation

A driver for DataStax Enterprise (DSE) and Apache Cassandra 1.2+ clusters that works exclusively with the Cassandra Query Language version 3 (CQL3) and Cassandra's binary protocol, supporting DSE-specific features such as geospatial types, DSE Graph and DSE authentication.

There is a newer version: 2.4.0

Show newest version

/*
 * Copyright (C) 2012-2017 DataStax Inc.
 *
 * This software can be used solely with DataStax Enterprise. Please consult the license at
 * http://www.datastax.com/terms/datastax-dse-driver-license-terms
 */
package com.datastax.driver.core;

import io.netty.channel.socket.SocketChannel;
import io.netty.handler.ssl.SslHandler;

import java.net.InetSocketAddress;

/**
 * Child interface to {@link SSLOptions} with the possibility to pass remote endpoint data
 * when instantiating {@link SslHandler}s.
 * 
 * This is needed when e.g. hostname verification is required.
 * See JAVA-1364 for details.
 * 

 * The reason this is a child interface is to keep {@link SSLOptions} backwards-compatible.
 * This interface may be be merged into {@link SSLOptions} in a later major release.
 *
 * @see JAVA-1364
 * @since 3.2.0
 */
public interface RemoteEndpointAwareSSLOptions extends SSLOptions {

    /**
     * Creates a new SSL handler for the given Netty channel and the given remote endpoint.
     * 

     * This gets called each time the driver opens a new connection to a Cassandra host. The newly created handler will be added
     * to the channel's pipeline to provide SSL support for the connection.
     * 
     * You don't necessarily need to implement this method directly; see the provided implementations:
     * {@link RemoteEndpointAwareJdkSSLOptions} and {@link RemoteEndpointAwareNettySSLOptions}.
     *
     * @param channel        the channel.
     * @param remoteEndpoint the remote endpoint address.
     * @return a newly-created {@link SslHandler}.
     */
    SslHandler newSSLHandler(SocketChannel channel, InetSocketAddress remoteEndpoint);

}