Struct SzEnvironmentCore

pub struct SzEnvironmentCore {
    is_destroyed: Arc<AtomicBool>,
    is_initialized: Arc<AtomicBool>,
    module_name: String,
    ini_params: String,
    verbose_logging: bool,
}

Core implementation of the SzEnvironment trait

This struct manages the lifecycle of the Senzing environment and serves as a factory for obtaining instances of other SDK components.

Fields

is_destroyed: Arc<AtomicBool>

is_initialized: Arc<AtomicBool>

module_name: String

ini_params: String

verbose_logging: bool

Implementations

impl SzEnvironmentCore

pub fn new( module_name: &str, ini_params: &str, verbose_logging: bool, ) -> SzResult<Self>

Creates a new SzEnvironment instance

Arguments

• module_name - Name of the module for logging purposes
• ini_params - JSON string containing initialization parameters
• verbose_logging - Whether to enable verbose logging

pub fn new_default() -> SzResult<Self>

Creates a new SzEnvironment instance with default parameters

pub fn get_instance( module_name: &str, ini_params: &str, verbose_logging: bool, ) -> SzResult<Arc<Self>>

Gets or creates the global singleton SzEnvironmentCore instance

This method ensures that only one SzEnvironmentCore instance exists per process, which is required by the Senzing SDK.

Arguments

• module_name - Name of the module for logging purposes
• ini_params - JSON string containing initialization parameters
• verbose_logging - Whether to enable verbose logging

pub fn get_existing_instance() -> SzResult<Arc<Self>>

Gets the existing global singleton SzEnvironmentCore instance

This method returns the existing singleton instance without creating a new one. It will return an error if no instance has been created yet.

Returns

Returns the existing singleton instance or an error if none exists.

pub fn try_get_instance() -> Option<Arc<Self>>

Gets the global singleton instance if it exists

Returns None if no instance has been created yet.

pub fn destroy_global_instance() -> SzResult<()>

Destroys the global singleton instance

This allows a new instance to be created with different parameters.

pub fn get_ini_params(&self) -> &str

Get the initialization parameters used by this environment

pub fn get_verbose_logging(&self) -> bool

Get the verbose logging setting used by this environment

fn ensure_initialized(&self) -> SzResult<()>

Ensures Sz_init has been called - should be called before any engine operations

This method is thread-safe and will only call Sz_init once.

Trait Implementations

impl Drop for SzEnvironmentCore

fn drop(&mut self)

Executes the destructor for this type.

impl SzEnvironment for SzEnvironmentCore

fn destroy(&mut self) -> SzResult<()>

Destroys the environment and releases all resources

fn is_destroyed(&self) -> bool

Checks if the environment has been destroyed

fn reinitialize(&self, config_id: ConfigId) -> SzResult<()>

Reinitializes the environment with a specific configuration Note: Sz_reinit is thread-safe, so this doesn’t require a mutable reference

fn get_active_config_id(&self) -> SzResult<ConfigId>

Gets the currently active configuration ID

fn get_product(&self) -> SzResult<Box<dyn SzProduct>>

Gets the product interface instance

fn get_engine(&self) -> SzResult<Box<dyn SzEngine>>

Gets the engine interface instance

fn get_config_manager(&self) -> SzResult<Box<dyn SzConfigManager>>

Gets the configuration manager interface instance

fn get_diagnostic(&self) -> SzResult<Box<dyn SzDiagnostic>>

Gets the diagnostic interface instance