rust-sdk/_index.md at 8bf6013eeecff57dc19a87165be08c18413788ef

3.0 KiB

Raw Blame History

type	title	linkTitle	weight	description	no_list
docs	Getting started with the Dapr client Rust SDK	Client	20000	How to get up and running with the Dapr Rust SDK	true

The Dapr client package allows you to interact with other Dapr applications from a Rust application.

{{% alert title="Note" color="primary" %}} The Dapr Rust-SDK is currently in Alpha. Work is underway to bring it to a stable release and will likely involve breaking changes. {{% /alert %}}

Prerequisites

[Dapr CLI]({{< ref install-dapr-cli.md >}}) installed
Initialized [Dapr environment]({{< ref install-dapr-selfhost.md >}})
Rust installed

Import the client package

Add Dapr to your cargo.toml

[dependencies]
# Other dependencies
dapr = "0.16.0"

You can either reference dapr::Client or bind the full path to a new name as follows:

use dapr::Client as DaprClient;

Instantiating the Dapr client

let addr = "https://127.0.0.1".to_string();

let mut client = dapr::Client::<dapr::client::TonicClient>::connect(addr,
port).await?;

Building blocks

The Rust SDK allows you to interface with the [Dapr building blocks]({{< ref building-blocks >}}).

Service Invocation (gRPC)

To invoke a specific method on another service running with Dapr sidecar, the Dapr client provides two options:

Invoke a (gRPC) service

let response = client
    .invoke_service("service-to-invoke", "method-to-invoke", Some(data))
    .await
    .unwrap();

For a full guide on service invocation, visit [How-To: Invoke a service]({{< ref howto-invoke-discover-services.md >}}).

State Management

The Dapr Client provides access to these state management methods: save_state , get_state, delete_state that can be used like so:

let store_name = String::from("statestore");

let key = String::from("hello");
let val = String::from("world").into_bytes();

// save key-value pair in the state store
client
    .save_state(store_name, key, val, None, None, None)
    .await?;

let get_response = client
    .get_state("statestore", "hello", None)
    .await?;

// delete a value from the state store
client
    .delete_state("statestore", "hello", None)
    .await?;

Multiple states can be sent with the save_bulk_states method.

For a full guide on state management, visit [How-To: Save & get state]({{< ref howto-get-save-state.md >}}).

Publish Messages

To publish data onto a topic, the Dapr client provides a simple method:

let pubsub_name = "pubsub-name".to_string();
let pubsub_topic = "topic-name".to_string();
let pubsub_content_type = "text/plain".to_string();

let data = "content".to_string().into_bytes();
client
    .publish_event(pubsub_name, pubsub_topic, pubsub_content_type, data, None)
    .await?;

For a full guide on pub/sub, visit [How-To: Publish & subscribe]({{< ref howto-publish-subscribe.md >}}).

Rust SDK Examples

3.0 KiB Raw Blame History