IceSSL.Plugin Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ice-compat Show documentation

Ice is a comprehensive RPC framework that helps you build distributed applications with minimal effort using familiar object-oriented idioms

The newest version!

//
// Copyright (c) ZeroC, Inc. All rights reserved.
//

package IceSSL;

/**
 * Interface that allows applications to interact with the IceSSL plug-in.
 **/
public interface Plugin extends Ice.Plugin
{
    /**
     * Establishes the SSL context. The context must be established before
     * plug-in is initialized. Therefore, the application must set
     * the property Ice.InitPlugins to zero, call
     * setContext to set the context, and finally
     * invoke PluginManager.initializePlugins().
     * 
     * If an application supplies its own SSL context, the
     * plug-in skips its normal property-based configuration.
     *
     * @param context The SSL context for the plug-in.
     **/
    void setContext(javax.net.ssl.SSLContext context);

    /**
     * Returns the SSL context. Use caution when modifying the returned
     * value: changes made to this value do not affect existing connections.
     *
     * @return The SSL context for the plug-in.
     **/
    javax.net.ssl.SSLContext getContext();

    /**
     * Establishes the certificate verifier. This must be
     * done before any connections are established.
     *
     * @param verifier The certificate verifier.
     **/
    void setCertificateVerifier(CertificateVerifier verifier);

    /**
     * Returns the certificate verifier.
     *
     * @return The certificate verifier (null if not set).
     **/
    CertificateVerifier getCertificateVerifier();

    /**
     * Establishes the password callback. This must be
     * done before the plug-in is initialized.
     *
     * @param callback The password callback.
     **/
    void setPasswordCallback(PasswordCallback callback);

    /**
     * Returns the password callback.
     *
     * @return The password callback (null if not set).
     **/
    PasswordCallback getPasswordCallback();

    /**
     * Supplies an input stream for the keystore. Calling this method
     * causes IceSSL to ignore the IceSSL.Keystore property.
     *
     * @param stream The input stream for the keystore.
     **/
    void setKeystoreStream(java.io.InputStream stream);

    /**
     * Supplies an input stream for the truststore. Calling this method
     * causes IceSSL to ignore the IceSSL.Truststore property. It is
     * legal to supply the same input stream as the one for {@link #setKeystoreStream},
     * in which case IceSSL uses the certificates contained in the keystore.
     *
     * @param stream The input stream for the truststore.
     **/
    void setTruststoreStream(java.io.InputStream stream);

    /**
     * Adds an input stream for the random number seed. You may call
     * this method multiple times if necessary.
     *
     * @param stream The input stream for the random number seed.
     **/
    void addSeedStream(java.io.InputStream stream);
}