// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

use gio_sys;
use glib;
use glib::object::Cast;
use glib::object::IsA;
use glib::signal::connect_raw;
use glib::signal::SignalHandlerId;
use glib::translate::*;
use glib_sys;
use std::boxed::Box as Box_;
use std::fmt;
use std::mem::transmute;
use std::ptr;
use IOStream;
use SocketConnectable;
use TlsCertificateFlags;
use TlsConnection;

glib_wrapper! {
    /// `TlsClientConnection` is the client-side subclass of
    /// `TlsConnection`, representing a client-side TLS connection.
    ///
    /// # Implements
    ///
    /// [`TlsClientConnectionExt`](trait.TlsClientConnectionExt.html), [`TlsConnectionExt`](trait.TlsConnectionExt.html), [`IOStreamExt`](trait.IOStreamExt.html), [`glib::object::ObjectExt`](../glib/object/trait.ObjectExt.html)
    pub struct TlsClientConnection(Interface<gio_sys::GTlsClientConnection>) @requires TlsConnection, IOStream;

    match fn {
        get_type => || gio_sys::g_tls_client_connection_get_type(),
    }
}

impl TlsClientConnection {
    /// Creates a new `TlsClientConnection` wrapping `base_io_stream` (which
    /// must have pollable input and output streams) which is assumed to
    /// communicate with the server identified by `server_identity`.
    ///
    /// See the documentation for `TlsConnection:base-io-stream` for restrictions
    /// on when application code can run operations on the `base_io_stream` after
    /// this function has returned.
    /// ## `base_io_stream`
    /// the `IOStream` to wrap
    /// ## `server_identity`
    /// the expected identity of the server
    ///
    /// # Returns
    ///
    /// the new
    /// `TlsClientConnection`, or `None` on error
    pub fn new<P: IsA<IOStream>, Q: IsA<SocketConnectable>>(
        base_io_stream: &P,
        server_identity: Option<&Q>,
    ) -> Result<TlsClientConnection, glib::Error> {
        unsafe {
            let mut error = ptr::null_mut();
            let ret = gio_sys::g_tls_client_connection_new(
                base_io_stream.as_ref().to_glib_none().0,
                server_identity.map(|p| p.as_ref()).to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            }
        }
    }
}

pub const NONE_TLS_CLIENT_CONNECTION: Option<&TlsClientConnection> = None;

/// Trait containing all `TlsClientConnection` methods.
///
/// # Implementors
///
/// [`TlsClientConnection`](struct.TlsClientConnection.html)
pub trait TlsClientConnectionExt: 'static {
    /// Copies session state from one connection to another. This is
    /// not normally needed, but may be used when the same session
    /// needs to be used between different endpoints as is required
    /// by some protocols such as FTP over TLS. `source` should have
    /// already completed a handshake, and `self` should not have
    /// completed a handshake.
    ///
    /// Feature: `v2_46`
    ///
    /// ## `source`
    /// a `TlsClientConnection`
    #[cfg(any(feature = "v2_46", feature = "dox"))]
    fn copy_session_state<P: IsA<TlsClientConnection>>(&self, source: &P);

    //fn get_accepted_cas(&self) -> /*Ignored*/Vec<glib::ByteArray>;

    /// Gets `self`'s expected server identity
    ///
    /// # Returns
    ///
    /// a `SocketConnectable` describing the
    /// expected server identity, or `None` if the expected identity is not
    /// known.
    fn get_server_identity(&self) -> Option<SocketConnectable>;

    /// Gets whether `self` will force the lowest-supported TLS protocol
    /// version rather than attempt to negotiate the highest mutually-
    /// supported version of TLS; see `TlsClientConnection::set_use_ssl3`.
    ///
    /// # Deprecated since 2.56
    ///
    /// SSL 3.0 is insecure, and this function does not
    /// actually indicate whether it is enabled.
    ///
    /// # Returns
    ///
    /// whether `self` will use the lowest-supported TLS protocol version
    #[cfg_attr(feature = "v2_56", deprecated)]
    fn get_use_ssl3(&self) -> bool;

    /// Gets `self`'s validation flags
    ///
    /// # Returns
    ///
    /// the validation flags
    fn get_validation_flags(&self) -> TlsCertificateFlags;

    /// Sets `self`'s expected server identity, which is used both to tell
    /// servers on virtual hosts which certificate to present, and also
    /// to let `self` know what name to look for in the certificate when
    /// performing `TlsCertificateFlags::BadIdentity` validation, if enabled.
    /// ## `identity`
    /// a `SocketConnectable` describing the expected server identity
    fn set_server_identity<P: IsA<SocketConnectable>>(&self, identity: &P);

    /// Since 2.42.1, if `use_ssl3` is `true`, this forces `self` to use the
    /// lowest-supported TLS protocol version rather than trying to properly
    /// negotiate the highest mutually-supported protocol version with the
    /// peer. Be aware that SSL 3.0 is generally disabled by the
    /// `TlsBackend`, so the lowest-supported protocol version is probably
    /// not SSL 3.0.
    ///
    /// Since 2.58, this may additionally cause an RFC 7507 fallback SCSV to
    /// be sent to the server, causing modern TLS servers to immediately
    /// terminate the connection. You should generally only use this function
    /// if you need to connect to broken servers that exhibit TLS protocol
    /// version intolerance, and when an initial attempt to connect to a
    /// server normally has already failed.
    ///
    /// # Deprecated since 2.56
    ///
    /// SSL 3.0 is insecure, and this function does not
    /// generally enable or disable it, despite its name.
    /// ## `use_ssl3`
    /// whether to use the lowest-supported protocol version
    #[cfg_attr(feature = "v2_56", deprecated)]
    fn set_use_ssl3(&self, use_ssl3: bool);

    /// Sets `self`'s validation flags, to override the default set of
    /// checks performed when validating a server certificate. By default,
    /// `TlsCertificateFlags::ValidateAll` is used.
    /// ## `flags`
    /// the `TlsCertificateFlags` to use
    fn set_validation_flags(&self, flags: TlsCertificateFlags);

    fn connect_property_accepted_cas_notify<F: Fn(&Self) + 'static>(&self, f: F)
        -> SignalHandlerId;

    fn connect_property_server_identity_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;

    #[cfg_attr(feature = "v2_56", deprecated)]
    fn connect_property_use_ssl3_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;

    fn connect_property_validation_flags_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId;
}

impl<O: IsA<TlsClientConnection>> TlsClientConnectionExt for O {
    #[cfg(any(feature = "v2_46", feature = "dox"))]
    fn copy_session_state<P: IsA<TlsClientConnection>>(&self, source: &P) {
        unsafe {
            gio_sys::g_tls_client_connection_copy_session_state(
                self.as_ref().to_glib_none().0,
                source.as_ref().to_glib_none().0,
            );
        }
    }

    //fn get_accepted_cas(&self) -> /*Ignored*/Vec<glib::ByteArray> {
    //    unsafe { TODO: call gio_sys:g_tls_client_connection_get_accepted_cas() }
    //}

    fn get_server_identity(&self) -> Option<SocketConnectable> {
        unsafe {
            from_glib_none(gio_sys::g_tls_client_connection_get_server_identity(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_use_ssl3(&self) -> bool {
        unsafe {
            from_glib(gio_sys::g_tls_client_connection_get_use_ssl3(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_validation_flags(&self) -> TlsCertificateFlags {
        unsafe {
            from_glib(gio_sys::g_tls_client_connection_get_validation_flags(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn set_server_identity<P: IsA<SocketConnectable>>(&self, identity: &P) {
        unsafe {
            gio_sys::g_tls_client_connection_set_server_identity(
                self.as_ref().to_glib_none().0,
                identity.as_ref().to_glib_none().0,
            );
        }
    }

    fn set_use_ssl3(&self, use_ssl3: bool) {
        unsafe {
            gio_sys::g_tls_client_connection_set_use_ssl3(
                self.as_ref().to_glib_none().0,
                use_ssl3.to_glib(),
            );
        }
    }

    fn set_validation_flags(&self, flags: TlsCertificateFlags) {
        unsafe {
            gio_sys::g_tls_client_connection_set_validation_flags(
                self.as_ref().to_glib_none().0,
                flags.to_glib(),
            );
        }
    }

    fn connect_property_accepted_cas_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_accepted_cas_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut gio_sys::GTlsClientConnection,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) where
            P: IsA<TlsClientConnection>,
        {
            let f: &F = &*(f as *const F);
            f(&TlsClientConnection::from_glib_borrow(this).unsafe_cast())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::accepted-cas\0".as_ptr() as *const _,
                Some(transmute(
                    notify_accepted_cas_trampoline::<Self, F> as usize,
                )),
                Box_::into_raw(f),
            )
        }
    }

    fn connect_property_server_identity_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_server_identity_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut gio_sys::GTlsClientConnection,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) where
            P: IsA<TlsClientConnection>,
        {
            let f: &F = &*(f as *const F);
            f(&TlsClientConnection::from_glib_borrow(this).unsafe_cast())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::server-identity\0".as_ptr() as *const _,
                Some(transmute(
                    notify_server_identity_trampoline::<Self, F> as usize,
                )),
                Box_::into_raw(f),
            )
        }
    }

    fn connect_property_use_ssl3_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_use_ssl3_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut gio_sys::GTlsClientConnection,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) where
            P: IsA<TlsClientConnection>,
        {
            let f: &F = &*(f as *const F);
            f(&TlsClientConnection::from_glib_borrow(this).unsafe_cast())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::use-ssl3\0".as_ptr() as *const _,
                Some(transmute(notify_use_ssl3_trampoline::<Self, F> as usize)),
                Box_::into_raw(f),
            )
        }
    }

    fn connect_property_validation_flags_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_validation_flags_trampoline<P, F: Fn(&P) + 'static>(
            this: *mut gio_sys::GTlsClientConnection,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) where
            P: IsA<TlsClientConnection>,
        {
            let f: &F = &*(f as *const F);
            f(&TlsClientConnection::from_glib_borrow(this).unsafe_cast())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::validation-flags\0".as_ptr() as *const _,
                Some(transmute(
                    notify_validation_flags_trampoline::<Self, F> as usize,
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl fmt::Display for TlsClientConnection {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "TlsClientConnection")
    }
}