1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175
// 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 crate::{SocketConnection, SocketListener, SocketService};
use glib::{
prelude::*,
signal::{connect_raw, SignalHandlerId},
translate::*,
};
use std::{boxed::Box as Box_, fmt, mem::transmute};
glib::wrapper! {
/// A [`ThreadedSocketService`][crate::ThreadedSocketService] is a simple subclass of [`SocketService`][crate::SocketService]
/// that handles incoming connections by creating a worker thread and
/// dispatching the connection to it by emitting the
/// [`run`][struct@crate::ThreadedSocketService#run] signal in the new thread.
///
/// The signal handler may perform blocking IO and need not return
/// until the connection is closed.
///
/// The service is implemented using a thread pool, so there is a
/// limited amount of threads available to serve incoming requests.
/// The service automatically stops the [`SocketService`][crate::SocketService] from accepting
/// new connections when all threads are busy.
///
/// As with [`SocketService`][crate::SocketService], you may connect to [`run`][struct@crate::ThreadedSocketService#run],
/// or subclass and override the default handler.
///
/// ## Properties
///
///
/// #### `max-threads`
/// Readable | Writeable | Construct Only
/// <details><summary><h4>SocketService</h4></summary>
///
///
/// #### `active`
/// Whether the service is currently accepting connections.
///
/// Readable | Writeable | Construct
/// </details>
/// <details><summary><h4>SocketListener</h4></summary>
///
///
/// #### `listen-backlog`
/// Readable | Writeable | Construct
/// </details>
///
/// ## Signals
///
///
/// #### `run`
/// The ::run signal is emitted in a worker thread in response to an
/// incoming connection. This thread is dedicated to handling
/// `connection` and may perform blocking IO. The signal handler need
/// not return until the connection is closed.
///
///
/// <details><summary><h4>SocketService</h4></summary>
///
///
/// #### `incoming`
/// The ::incoming signal is emitted when a new incoming connection
/// to `service` needs to be handled. The handler must initiate the
/// handling of `connection`, but may not block; in essence,
/// asynchronous operations must be used.
///
/// `connection` will be unreffed once the signal handler returns,
/// so you need to ref it yourself if you are planning to use it.
///
///
/// </details>
/// <details><summary><h4>SocketListener</h4></summary>
///
///
/// #### `event`
/// Emitted when `listener`'s activity on `socket` changes state.
/// Note that when `listener` is used to listen on both IPv4 and
/// IPv6, a separate set of signals will be emitted for each, and
/// the order they happen in is undefined.
///
///
/// </details>
///
/// # Implements
///
/// [`ThreadedSocketServiceExt`][trait@crate::prelude::ThreadedSocketServiceExt], [`SocketServiceExt`][trait@crate::prelude::SocketServiceExt], [`SocketListenerExt`][trait@crate::prelude::SocketListenerExt], [`trait@glib::ObjectExt`]
#[doc(alias = "GThreadedSocketService")]
pub struct ThreadedSocketService(Object<ffi::GThreadedSocketService, ffi::GThreadedSocketServiceClass>) @extends SocketService, SocketListener;
match fn {
type_ => || ffi::g_threaded_socket_service_get_type(),
}
}
impl ThreadedSocketService {
pub const NONE: Option<&'static ThreadedSocketService> = None;
}
/// Trait containing all [`struct@ThreadedSocketService`] methods.
///
/// # Implementors
///
/// [`ThreadedSocketService`][struct@crate::ThreadedSocketService]
pub trait ThreadedSocketServiceExt: 'static {
#[doc(alias = "max-threads")]
fn max_threads(&self) -> i32;
/// The ::run signal is emitted in a worker thread in response to an
/// incoming connection. This thread is dedicated to handling
/// `connection` and may perform blocking IO. The signal handler need
/// not return until the connection is closed.
/// ## `connection`
/// a new [`SocketConnection`][crate::SocketConnection] object.
/// ## `source_object`
/// the source_object passed to [`SocketListenerExt::add_address()`][crate::prelude::SocketListenerExt::add_address()].
///
/// # Returns
///
/// [`true`] to stop further signal handlers from being called
#[doc(alias = "run")]
fn connect_run<F: Fn(&Self, &SocketConnection, Option<&glib::Object>) -> bool + 'static>(
&self,
f: F,
) -> SignalHandlerId;
}
impl<O: IsA<ThreadedSocketService>> ThreadedSocketServiceExt for O {
fn max_threads(&self) -> i32 {
glib::ObjectExt::property(self.as_ref(), "max-threads")
}
fn connect_run<F: Fn(&Self, &SocketConnection, Option<&glib::Object>) -> bool + 'static>(
&self,
f: F,
) -> SignalHandlerId {
unsafe extern "C" fn run_trampoline<
P: IsA<ThreadedSocketService>,
F: Fn(&P, &SocketConnection, Option<&glib::Object>) -> bool + 'static,
>(
this: *mut ffi::GThreadedSocketService,
connection: *mut ffi::GSocketConnection,
source_object: *mut glib::gobject_ffi::GObject,
f: glib::ffi::gpointer,
) -> glib::ffi::gboolean {
let f: &F = &*(f as *const F);
f(
ThreadedSocketService::from_glib_borrow(this).unsafe_cast_ref(),
&from_glib_borrow(connection),
Option::<glib::Object>::from_glib_borrow(source_object)
.as_ref()
.as_ref(),
)
.into_glib()
}
unsafe {
let f: Box_<F> = Box_::new(f);
connect_raw(
self.as_ptr() as *mut _,
b"run\0".as_ptr() as *const _,
Some(transmute::<_, unsafe extern "C" fn()>(
run_trampoline::<Self, F> as *const (),
)),
Box_::into_raw(f),
)
}
}
}
impl fmt::Display for ThreadedSocketService {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
f.write_str("ThreadedSocketService")
}
}