Struct ServerAssociation

pub struct ServerAssociation { /* private fields */ }

A DICOM upper level association from the perspective of an accepting application entity.

The most common operations of an established association are send and receive. Sending large P-Data fragments may be easier through the P-Data sender abstraction (see send_pdata).

When the value falls out of scope, the program will shut down the underlying TCP connection.

Implementations

impl ServerAssociation

pub fn presentation_contexts(&self) -> &[PresentationContextResult]

Obtain a view of the negotiated presentation contexts.

pub fn client_ae_title(&self) -> &str

Obtain the remote DICOM node’s application entity title.

pub fn send(&mut self, msg: &Pdu) -> Result<()>

Send a PDU message to the other intervenient.

pub fn receive(&mut self) -> Result<Pdu>

Read a PDU message from the other intervenient.

pub fn abort(self) -> Result<()>

Send a provider initiated abort message and shut down the TCP connection, terminating the association.

pub fn send_pdata( &mut self, presentation_context_id: u8, ) -> PDataWriter<&mut TcpStream>

Prepare a P-Data writer for sending one or more data item PDUs.

Returns a writer which automatically splits the inner data into separate PDUs if necessary.

pub fn receive_pdata(&mut self) -> PDataReader<&mut TcpStream>

Prepare a P-Data reader for receiving one or more data item PDUs.

Returns a reader which automatically receives more data PDUs once the bytes collected are consumed.

pub fn inner_stream(&mut self) -> &mut TcpStream

Obtain access to the inner TCP stream connected to the association acceptor.

This can be used to send the PDU in semantic fragments of the message, thus using less memory.

Note: reading and writing should be done with care to avoid inconsistencies in the association state. Do not call send and receive while not in a PDU boundary.

Trait Implementations

impl Debug for ServerAssociation

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

Formats the value using the given formatter.