Struct ClientAssociationOptions

pub struct ClientAssociationOptions<'a> { /* private fields */ }

A DICOM association builder for a client node. The final outcome is a ClientAssociation.

This is the standard way of requesting and establishing an association with another DICOM node, that one usually taking the role of a service class provider (SCP).

Example

let association = ClientAssociationOptions::new()
   .with_presentation_context("1.2.840.10008.1.1", vec!["1.2.840.10008.1.2.1", "1.2.840.10008.1.2"])
   .establish("129.168.0.5:104")?;

At least one presentation context must be specified, using the method with_presentation_context and supplying both an abstract syntax and list of transfer syntaxes.

A helper method with_abstract_syntax will include by default the transfer syntaxes Implicit VR Little Endian and Explicit VR Little Endian in the resulting presentation context.

Example

let association = ClientAssociationOptions::new()
    .with_abstract_syntax("1.2.840.10008.1.1")
    .establish("129.168.0.5:104")?;

Implementations

impl<'a> ClientAssociationOptions<'a>

pub fn new() -> Self

Create a new set of options for establishing an association.

pub fn calling_ae_title<T>(self, calling_ae_title: T) -> Self

where T: Into<Cow<'a, str>>,

Define the calling application entity title for the association, which refers to this DICOM node.

The default is THIS-SCU.

pub fn called_ae_title<T>(self, called_ae_title: T) -> Self

where T: Into<Cow<'a, str>>,

Define the called application entity title for the association, which refers to the target DICOM node.

The default is ANY-SCP. Passing an emoty string resets the AE title to the default (or to the one passed via establish_with).

pub fn with_presentation_context<T>( self, abstract_syntax_uid: T, transfer_syntax_uids: Vec<T>, ) -> Self

where T: Into<Cow<'a, str>>,

Include this presentation context in the list of proposed presentation contexts.

pub fn with_abstract_syntax<T>(self, abstract_syntax_uid: T) -> Self

where T: Into<Cow<'a, str>>,

Helper to add this abstract syntax with the default transfer syntaxes to the list of proposed presentation contexts.

pub fn max_pdu_length(self, value: u32) -> Self

Override the maximum PDU length that this application entity will admit.

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

Override strict mode: whether receiving PDUs must not surpass the negotiated maximum PDU length.

pub fn username<T>(self, username: T) -> Self

where T: Into<Cow<'a, str>>,

Sets the user identity username

pub fn password<T>(self, password: T) -> Self

where T: Into<Cow<'a, str>>,

Sets the user identity password

pub fn username_password<T, U>(self, username: T, password: U) -> Self

where T: Into<Cow<'a, str>>, U: Into<Cow<'a, str>>,

Sets the user identity username and password

pub fn kerberos_service_ticket<T>(self, kerberos_service_ticket: T) -> Self

where T: Into<Cow<'a, str>>,

Sets the user identity Kerberos service ticket

pub fn saml_assertion<T>(self, saml_assertion: T) -> Self

where T: Into<Cow<'a, str>>,

Sets the user identity SAML assertion

pub fn jwt<T>(self, jwt: T) -> Self

where T: Into<Cow<'a, str>>,

Sets the user identity JWT

pub fn establish<A: ToSocketAddrs>( self, address: A, ) -> Result<ClientAssociation>

Initiate the TCP connection to the given address and request a new DICOM association, negotiating the presentation contexts in the process.

pub fn establish_with(self, ae_address: &str) -> Result<ClientAssociation>

Initiate the TCP connection to the given address and request a new DICOM association, negotiating the presentation contexts in the process.

This method allows you to specify the called AE title alongside with the socket address. See AeAddr for more details. However, the AE title in this parameter is overridden by any called_ae_title option previously received.

Example

let association = ClientAssociationOptions::new()
    .with_abstract_syntax("1.2.840.10008.1.1")
    // called AE title in address
    .establish_with("MY-STORAGE@10.0.0.100:104")?;

pub fn read_timeout(self, timeout: Duration) -> Self

Set the read timeout for the underlying TCP socket

pub fn write_timeout(self, timeout: Duration) -> Self

Set the write timeout for the underlying TCP socket

Trait Implementations

impl<'a> Clone for ClientAssociationOptions<'a>

fn clone(&self) -> ClientAssociationOptions<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ClientAssociationOptions<'a>

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

Formats the value using the given formatter.

impl<'a> Default for ClientAssociationOptions<'a>

fn default() -> Self

Returns the “default value” for a type.