Struct dicom_ul::association::server::ServerAssociationOptions

pub struct ServerAssociationOptions<'a, A> { /* private fields */ }

A DICOM association builder for an acceptor DICOM node, often taking the role of a service class provider (SCP).

This is the standard way of negotiating and establishing an association with a requesting node. The outcome is a ServerAssociation. Unlike the ClientAssociationOptions, a value of this type can be reused for multiple connections.

Example

let scp_options = ServerAssociationOptions::new()
   .with_abstract_syntax("1.2.840.10008.1.1")
   .with_transfer_syntax("1.2.840.10008.1.2.1");

let (stream, _address) = tcp_listener.accept()?;
scp_options.establish(stream)?;

The SCP will by default accept all transfer syntaxes supported by the main transfer syntax registry, unless one or more transfer syntaxes are explicitly indicated through calls to with_transfer_syntax.

Access control logic is also available, enabling application entities to decide on whether to accept or reject the association request based on the called and calling AE titles.

• By default, the application will accept requests from anyone (AcceptAny)
• To only accept requests with a matching called AE title, add a call to accept_called_ae_title (AcceptCalledAeTitle).
• Any other policy can be implemented through the AccessControl trait.

Implementations

impl<'a> ServerAssociationOptions<'a, AcceptAny>

pub fn new() -> Self

Create a new set of options for establishing an association.

impl<'a, A> ServerAssociationOptions<'a, A>

where A: AccessControl,

pub fn accept_any(self) -> ServerAssociationOptions<'a, AcceptAny>

Change the access control policy to accept any association regardless of the specified AE titles.

This is the default behavior when the options are first created.

pub fn accept_called_ae_title( self ) -> ServerAssociationOptions<'a, AcceptCalledAeTitle>

Change the access control policy to accept an association if the called AE title matches this node’s AE title.

The default is to accept any requesting node regardless of the specified AE titles.

pub fn ae_access_control<P>( self, access_control: P ) -> ServerAssociationOptions<'a, P>

where P: AccessControl,

Change the access control policy.

The default is to accept any requesting node regardless of the specified AE titles.

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

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

Define the application entity title referring to this DICOM node.

The default is THIS-SCP.

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

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

Include this abstract syntax in the list of proposed presentation contexts.

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

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

Include this transfer syntax in each proposed presentation context.

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

Override the maximum expected PDU length.

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

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

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

Override promiscuous mode: whether to accept unknown abstract syntaxes.

pub fn establish(&self, socket: TcpStream) -> Result<ServerAssociation>

Negotiate an association with the given TCP stream.

Trait Implementations

impl<'a, A: Clone> Clone for ServerAssociationOptions<'a, A>

fn clone(&self) -> ServerAssociationOptions<'a, A>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, A: Debug> Debug for ServerAssociationOptions<'a, A>

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

Formats the value using the given formatter.

impl<'a> Default for ServerAssociationOptions<'a, AcceptAny>

fn default() -> Self

Returns the “default value” for a type.