Struct ClientProps 

pub struct ClientProps { /* private fields */ }

Configures settings for Client.

Implementations

impl ClientProps

pub fn new() -> Self

Creates a new ClientConfig.

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

Sets the server addr.

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

Sets the endpoint used to resolve server addresses.

Full URL (e.g. http://addr:8080/nacos/serverlist) is used as-is, only appending namespace if missing from the query string. Bare hostname (e.g. addr or addr:9090) gets default path /nacos/serverlist and port 8080.

pub fn remote_grpc_port(self, grpc_port: u16) -> Self

Sets the grpc port

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

Sets the namespace.

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

Sets the app_name.

pub fn naming_push_empty_protection( self, naming_push_empty_protection: bool, ) -> Self

Sets the naming_push_empty_protection.

pub fn naming_load_cache_at_start( self, naming_load_cache_at_start: bool, ) -> Self

Sets the naming_load_cache_at_start.

pub fn config_load_cache_at_start( self, config_load_cache_at_start: bool, ) -> Self

Sets the config_load_cache_at_start.

pub fn load_cache_at_start(self, load_cache_at_start: bool) -> Self

Sets the config_load_cache_at_start / naming_load_cache_at_start.

pub fn cache_dir(self, cache_dir: impl Into<PathBuf>) -> Self

Sets the root directory used for on-disk caches.

The module and namespace directories are appended to this path. When env_first is enabled, NACOS_CLIENT_CACHE_DIR takes precedence.

pub fn env_first(self, env_first: bool) -> Self

Sets the env_first.

pub fn labels(self, labels: HashMap<String, String>) -> Self

Sets the labels.

pub fn auth_username(self, username: impl Into<String>) -> Self

Available on crate feature auth-by-http only.

Add auth username.

pub fn auth_password(self, password: impl Into<String>) -> Self

Available on crate feature auth-by-http only.

Add auth password.

pub fn auth_ext(self, key: impl Into<String>, val: impl Into<String>) -> Self

Add auth ext params.

pub fn max_retries(self, max_retries: u32) -> Self

👎Deprecated

Sets the maximum retry attempts during initialization phase.

This value only applies to the connection initialization stage. If not set, defaults to 1 retry attempts. After successful initialization, the client will retry indefinitely during runtime to ensure fault tolerance.

Trait Implementations

impl Clone for ClientProps

fn clone(&self) -> ClientProps

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientProps

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

Formats the value using the given formatter.