Struct Client 

pub struct Client<K> { /* private fields */ }

Client for managing top-level entities on a VTN, i.e., programs and VENs.

Can be used to implement both, the VEN and the business logic.

If using the VTN of this project with the built-in OAuth authentication provider, the Client also allows managing the users.

Implementations

impl Client<VirtualEndNode>

pub async fn create_ven( &self, ven: VenVenRequest, ) -> Result<VenClient<VirtualEndNode>, Error>

Create a new VEN entity at the VTN.

impl Client<BusinessLogic>

pub async fn create_ven( &self, ven: BlVenRequest, ) -> Result<VenClient<BusinessLogic>, Error>

Create a new VEN entity at the VTN.

impl<K: ClientKind> Client<K>

pub fn with_url(base_url: Url, auth: Option<ClientCredentials>) -> Self

Create a new client for a VTN located at the specified URL.

This assumes that the VTN also works as an OAuth provider and exposes an API endpoint at <base_url>/auth/token to retrieve a token. If you want to use another OAuth provider, please use Self::with_details.

pub fn with_details( vtn_base_url: Url, oauth_base_url: Url, client: Client, auth: Option<ClientCredentials>, ) -> Self

Create a new client with more details than Self::with_url.

It allows specifying a reqwest::Client instead of the default one. This allows configuring proxy settings, timeouts, etc.

Additionally, it allows for a separate oauth_base_url, which is relevant if you don’t want or cannot rely on an OAuth provider at the default URL.

pub fn with_http_client( vtn_base_url: Url, oauth_base_url: Url, client: Box<dyn HttpClient + Send + Sync>, auth: Option<ClientCredentials>, ) -> Self

Create a new client with anything that implements the HttpClient trait.

This is mainly helpful for the integration tests and should most likely not be used for other purposes. Please use Client::with_details for detailed HTTP client configuration.

pub async fn create_program( &self, program_content: ProgramRequest, ) -> Result<ProgramClient<K>, Error>

Create a new program on the VTN.

pub async fn get_programs( &self, filter: Filter<'_, impl AsRef<str>>, pagination: PaginationOptions, ) -> Result<Vec<ProgramClient<K>>, Error>

Lowlevel operation that gets a list of programs from the VTN with the given query parameters

pub async fn get_program_list( &self, filter: Filter<'_, impl AsRef<str> + Clone>, ) -> Result<Vec<ProgramClient<K>>, Error>

Get all programs from the VTN with the given query parameters

It automatically tries to iterate pages where necessary.

pub async fn get_program_by_id( &self, id: &ProgramId, ) -> Result<ProgramClient<K>, Error>

Get a program by id

pub async fn get_events( &self, program_id: Option<&ProgramId>, filter: Filter<'_, impl AsRef<str>>, pagination: PaginationOptions, ) -> Result<Vec<EventClient<K>>, Error>

Low-level operation that gets a list of events from the VTN with the given query parameters

To automatically iterate pages, use self.get_event_list

pub async fn get_event_list( &self, program_id: Option<&ProgramId>, filter: Filter<'_, impl AsRef<str> + Clone>, ) -> Result<Vec<EventClient<K>>, Error>

Get all events from the VTN with the given query parameters.

It automatically tries to iterate pages where necessary.

pub async fn get_event_by_id( &self, id: &EventId, ) -> Result<EventClient<K>, Error>

Get an event by id

pub async fn get_ven_list( &self, filter: Filter<'_, impl AsRef<str> + Clone>, ) -> Result<Vec<VenClient<K>>, Error>

Get all VENs from the VTN with the given query parameters.

The client automatically tries to iterate pages where necessary.

pub async fn get_ven_by_id(&self, id: &VenId) -> Result<VenClient<K>, Error>

Get VEN by id from VTN

pub async fn get_ven_by_name(&self, name: &str) -> Result<VenClient<K>, Error>

Get VEN by name from VTN. According to the spec, a ven_name must be unique for the whole VTN instance.

Trait Implementations

impl<K: Clone> Clone for Client<K>

fn clone(&self) -> Client<K>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<K: Debug> Debug for Client<K>

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

Formats the value using the given formatter.