Struct Server 

pub struct Server { /* private fields */ }

Represents the high-level server controller responsible for loading configuration, applying custom setup, and running the application.

This structure encapsulates CLI arguments, server settings, and an optional configuration callback for the Actix-Web service.

Implementations

impl Server

pub fn global() -> Result<&'static (dyn GlobalServer + Send + Sync)>

Returns a reference to the globally initialized Server.

Examples

use rust_microservice::Server;

let server = Server::global();

pub fn global_server() -> Option<&'static Server>

Returns a reference to the globally initialized Server, if it exists.

This function provides access to the global server instance managed through the GlobalServer trait.

Examples

use rust_microservice::Server;

let server = Server::global_server();

pub fn set_global(server: Server)

Sets the global Server instance.

This function should be called exactly once, typically during application startup.

Examples

use rust_microservice::Server;

let server = Server::new("0.1.3".to_string(), None);
Server::set_global(server);

pub fn new(app_version: String, banner: Option<String>) -> Self

Creates a new empty Server instance with no configuration loaded.

Useful as the starting point for building and initializing the server lifecycle.

pub async fn new_with_settings(settings: Settings) -> Result<Self>

pub async fn init(self) -> Result<Self>

Loads CLI arguments and resolves the application configuration.

This method parses command-line arguments, attempts to load the server settings, and stores both inside the Server instance. Panics if configuration loading fails.

Returns

The updated Server instance.

pub fn configure(self, fnconfig: Option<fn(&mut ServiceConfig)>) -> Self

Applies a custom Actix-Web configuration callback to the server.

This allows the application to register routes or middlewares before the server is executed.

Parameters

• fnconfig: Optional function used to configure ServiceConfig.

Returns

The updated Server instance.

pub async fn intialize_database(self) -> Result<Self>

Initializes the database connections using the previously loaded settings.

This method creates and initializes all required database connections, including the BigQuery client, based on the application settings. It must be called after the settings have been loaded.

Behavior

• Validates that the application settings are available.
• Instantiates the ServerDatabase using the provided settings.
• Stores the initialized database instance in the application state.
• Retrieves and logs the list of available BigQuery tables.

Panics

This method will panic if:

• The settings have not been loaded before calling this method.

Returns

Returns Self with the database field initialized.

Example

use rust_microservice::Server;

async fn start_server() -> rust_microservice::Result<(), String> {
    let server = Server::new("0.1.3".to_string(), None)
        .init()
        .await
        .map_err(|e|e.to_string())?
        .intialize_database()
        .await
        .map_err(|e|e.to_string())?;

    Ok(())
}

pub async fn run(&self)

Executes the server using the previously loaded settings and CLI input.

If both arguments and settings are available, this method delegates execution to the CLI dispatcher, starting the server workflow.

Trait Implementations

impl Clone for Server

fn clone(&self) -> Server

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Server

Default implementation for the Server structure.

fn default() -> Self

Returns a default instance of the Server structure.

This method is used to provide a default instance of the server when no configuration is provided.

Returns

A default instance of the Server structure.