Struct ServerConfig

pub struct ServerConfig {
    pub dialog: DialogConfig,
    pub auto_options_response: bool,
    pub auto_register_response: bool,
    pub domain: Option<String>,
}

Server-specific configuration

Extends DialogConfig with server-specific settings including automatic response handling, domain configuration, and server behavior options. Used by DialogServer to configure server-side SIP operations.

Examples

Basic Server Setup

use rvoip_dialog_core::api::ServerConfig;

let config = ServerConfig::new("0.0.0.0:5060".parse().unwrap())
    .with_domain("sip.example.com")
    .with_auto_options();

assert_eq!(config.domain.unwrap(), "sip.example.com");
assert!(config.auto_options_response);

Production Server Configuration

use rvoip_dialog_core::api::ServerConfig;
use std::time::Duration;

let mut config = ServerConfig::new("0.0.0.0:5060".parse().unwrap())
    .with_domain("sip.production.com")
    .with_auto_options()
    .with_auto_register();

// Customize for production load
config.dialog = config.dialog
    .with_timeout(Duration::from_secs(300))
    .with_max_dialogs(100000)
    .with_user_agent("ProductionSIP/1.0");

assert!(config.validate().is_ok());

Fields

dialog: DialogConfig

Base dialog configuration

auto_options_response: bool

Enable automatic response to OPTIONS requests

When true, the server automatically responds to OPTIONS requests with a 200 OK including supported methods. When false, OPTIONS requests are forwarded to the application for custom handling.

auto_register_response: bool

Enable automatic response to REGISTER requests

When true, the server automatically handles REGISTER requests for basic registration functionality. When false, REGISTER requests are forwarded to the application.

domain: Option<String>

Server domain name

The domain name this server represents. Used in Contact headers and for routing decisions. Should match your SIP domain.

Implementations

impl ServerConfig

pub fn new(local_address: SocketAddr) -> Self

Create a new server configuration with a local address

Creates a ServerConfig with the specified local address and sensible defaults for server operation.

Arguments

• local_address - Address to bind the server to

Returns

New ServerConfig with defaults

Examples

use rvoip_dialog_core::api::ServerConfig;

let config = ServerConfig::new("0.0.0.0:5060".parse().unwrap());
assert_eq!(config.dialog.local_address.port(), 5060);
assert!(config.auto_options_response);  // Default enabled
assert!(!config.auto_register_response); // Default disabled

pub fn with_domain(self, domain: impl Into<String>) -> Self

Set the server domain

Configures the domain name that this server represents. Used for Contact header generation and routing decisions.

Arguments

• domain - Server domain name (e.g., “sip.example.com”)

Returns

Self for method chaining

Examples

use rvoip_dialog_core::api::ServerConfig;

let config = ServerConfig::new("0.0.0.0:5060".parse().unwrap())
    .with_domain("sip.mycompany.com");

assert_eq!(config.domain.unwrap(), "sip.mycompany.com");

pub fn with_auto_options(self) -> Self

Enable automatic OPTIONS response

Configures the server to automatically respond to OPTIONS requests with a 200 OK including supported SIP methods. This is useful for capability discovery and keep-alive mechanisms.

Returns

Self for method chaining

Examples

use rvoip_dialog_core::api::ServerConfig;

let config = ServerConfig::new("0.0.0.0:5060".parse().unwrap())
    .with_auto_options();

assert!(config.auto_options_response);

pub fn with_auto_register(self) -> Self

Enable automatic REGISTER response

Configures the server to automatically handle REGISTER requests for basic SIP registration functionality. Use this for simple registrar services or disable for custom registration handling.

Returns

Self for method chaining

Examples

use rvoip_dialog_core::api::ServerConfig;

let config = ServerConfig::new("0.0.0.0:5060".parse().unwrap())
    .with_auto_register();

assert!(config.auto_register_response);

pub fn validate(&self) -> Result<(), String>

Validate the server configuration

Validates both the server-specific settings and the underlying dialog configuration to ensure everything is properly configured.

Returns

Ok(()) if valid, Err(message) if invalid

Examples

use rvoip_dialog_core::api::ServerConfig;

let config = ServerConfig::new("0.0.0.0:5060".parse().unwrap())
    .with_domain("test.com");

assert!(config.validate().is_ok());

Trait Implementations

impl Clone for ServerConfig

fn clone(&self) -> ServerConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServerConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ServerConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ServerConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<ServerConfig> for DialogManagerConfig

fn from(server_config: ServerConfig) -> Self

Converts to this type from the input type.

impl Serialize for ServerConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.