# Package com.pixelmed.network

Classes for sending, receiving, querying and retrieving DICOM composite objects on the network, as well as supporting lower level functions.

## Package Specification

Currently the StorageSOPClassSCP supports not only the Storage Service Class as an SCP, but also contains support for the Verification Sevice Class and the Query/Retrieve Service Class as an SCP. In future this may change, and the individual service classes may be factored out seperately into individual services and assembled into user-customizable combinations. As a consequence of the current expedient approach, there is an implicit coupling between the association acceptance behavior in AssociationAcceptor.applyAbstractSyntaxSelectionPolicy() used by AssociationFactory and the implementation of the DIMSE service primitives for the corresponding SOP Classes in StorageSOPClassSCP that is probably completely inappropriate, and again is likely to be factored out in future. In particular AssociationFactory will probably in future require more explicit user control over which SOP Classes to accept or reject. Where possible the current API will be replicated on top of a more robust approach so as not to break existing code, but this is not guaranteed.

## Related Documentation

For overviews, tutorials, examples, guides, and tool documentation, please see:

- Interface Summary
  Interface | Description
  --- | ---
  AbstractSyntaxSelectionPolicy | Implementations of this interface accept or reject Presentation Contexts from a list based on their Abstract Syntax.
  PresentationContextSelectionPolicy | Implementations of this interface accept or reject Presentation Contexts from a list based on the proposed combinations of Abstract Syntax and Transfer Syntax.

- Class Summary
  Class | Description
  --- | ---
  AnyExplicitStoreFindMoveGetPresentationContextSelectionPolicy | Accept only SOP Classes for storage, query or retrieval of composite instances and verification SOP Classes with any explicit transfer syntax (whether compressed or not), also rejecting implicit VR transfer syntaxes if an explicit VR transfer syntax is offered for the same abstract syntax.
  AnyExplicitStorePresentationContextSelectionPolicy | Accept only SOP Classes for storage of composite instances and verification SOP Classes with any explicit transfer syntax (whether compressed or not), also rejecting implicit VR transfer syntaxes if an explicit VR transfer syntax is offered for the same abstract syntax.
  AnyExplicitTransferSyntaxSelectionPolicy | Accept any explicit transfer syntax (whether compressed or not), also rejecting implicit VR transfer syntaxes if an explicit VR transfer syntax is offered for the same abstract syntax.
  ApplicationEntity | This class provides a description of the parameters of a known Application Entity.
  ApplicationEntityConfigurationDialog | This class implements a dialog for users to enter DICOM AE network configuration parameters.
  ApplicationEntityMap | This class provides a list of known Application Entities, indexed by AET.
  Association |
  AssociationFactory | A factory object of static methods that can accept and initiate associations.
  AssociationOutputStream | A specialized java.io.OutputStream which buffers and fragments data which is written to it into PDUs and sends them over the supplied OutputStream which is (presumably) that of the java.net.Socket of an established `Association`.
  AssociationStatusHandler | This abstract class provides a mechanism for detecting when an Association closes.
  CEchoRequestCommandMessage |
  CEchoResponseCommandMessage |
  CFindRequestCommandMessage |
  CFindResponseCommandMessage |
  CGetRequestCommandMessage |
  CGetResponseCommandMessage |
  CMoveRequestCommandMessage |
  CMoveResponseCommandMessage |
  CompositeInstanceStoreAbstractSyntaxSelectionPolicy | Accept only SOP Classes for storage of composite instances and verification SOP Classes.
  CompositeInstanceStoreFindMoveGetAbstractSyntaxSelectionPolicy | Accept only SOP Classes for storage, query or retrieval of composite instances and verification SOP Classes.
  CompositeResponseHandler | This abstract class provides a mechanism to process each PDU of a composite response as it is received, such as for evaluating the status of the response for success.
  CStoreRequestCommandMessage |
  CStoreResponseCommandMessage |
  FindSOPClassSCU | This class implements the SCU role of C-FIND SOP Classes.
  GetSOPClassSCU | This class implements the SCU role of C-GET SOP Classes.
  IdentifierHandler | This class provides a mechanism to process each identifier response of a C-FIND as it is received.
  MessageServiceElementCommand |
  MoveSOPClassSCU | This class implements the SCU role of C-MOVE SOP Classes.
  MultipleInstanceTransferStatusHandler |
  MultipleInstanceTransferStatusHandlerWithFileName |
  NetworkApplicationConfigurationDialog | This class provides user interface for network applications to configure and test properties related to DICOM network services.
  NetworkApplicationInformation | This class encapsulates information about DICOM network devices.
  NetworkApplicationInformationFederated | This class encapsulates information about DICOM network devices federated from multiple sources.
  NetworkApplicationProperties | This class provides common support to applications requiring properties related to DICOM network services.
  NetworkConfigurationFromLDAP | This class provides utilities to automatically configure DICOM network parameters.
  NetworkConfigurationFromMulticastDNS | This class provides a dynamic registry of DICOM network parameters possibly federated from various sources.
  NetworkConfigurationSource | This abstract class provides a source of DICOM network parameters.
  NetworkDefaultValues | This class defines a number of useful defaults and constants and utilities to generate defaults.
  NetworkMediaImporter | This class is designed to support the importation of DICOM files from interchange media (such as CDs and DVDs) and their transfer over the network as C-STORE requests to a specified AE.
  NetworkUtilities | Various static methods helpful for network activities.
  PDataPDU |
  PresentationAddress |
  PresentationContext |
  PresentationContextListFactory | A factory object of static methods that can create lists of presentation contexts for initiating associations, from lists of DICOM files based on SOP Class (abstract syntax) and supported transfer syntaxes.
  PresentationDataValue |
  ProbeCapability | This class provides utilities to probe the capabilities of potential DICOM Application Entities, used for example to maintain a cache of potential C-MOVE targets.
  ReceivedDataHandler | This abstract class provides a mechanism to process each PDU as it is received on an association.
  ReceivedObjectHandler | This abstract class provides a mechanism for performing processing on a DICOM data set that has been completely received and stored in a file.
  ResponseStatus |
  SCUSCPRoleSelection |
  StorageSOPClassSCP | This class implements the SCP role of SOP Classes of the Storage Service Class, the Study Root Query Retrieve Information Model Find, Get and Move SOP Classes, and the Verification SOP Class.
  StorageSOPClassSCPDispatcher | This class waits for incoming connections and association requests for the SCP role of SOP Classes of the Storage Service Class, the Study Root Query Retrieve Information Model Find, Get and Move SOP Classes, and the Verification SOP Class.
  StorageSOPClassSCU | This class implements the SCU role of SOP Classes of the Storage Service Class.
  StorageSOPClassSCUPerformanceTest | This class implements the SCU role of SOP Classes of the Storage Service Class.
  TestSendingCommandAndDataInOnePDU | This class implements the SCU role of SOP Classes of the Storage Service Class.
  TransferSyntaxSelectionPolicy | Concrete sub-classes of this abstract class accept or reject Presentation Contexts from a list based on their Transfer Syntax.
  UnencapsulatedExplicitStoreFindMoveGetPresentationContextSelectionPolicy | Accept only SOP Classes for storage, query or retrieval of composite instances and verification SOP Classes with uncompressed or deflated or bzip but not encapsulated compressed transfer syntaxes, also rejecting implicit VR transfer syntaxes if an explicit VR transfer syntax is offered for the same abstract syntax.
  UnencapsulatedExplicitStorePresentationContextSelectionPolicy | Accept only SOP Classes for storage of composite instances and verification SOP Classes with uncompressed or deflated or bzip but not encapsulated compressed transfer syntaxes, also rejecting implicit VR transfer syntaxes if an explicit VR transfer syntax is offered for the same abstract syntax.
  UnencapsulatedExplicitTransferSyntaxSelectionPolicy | Accept only uncompressed or deflated or bzip but not encapsulated compressed transfer syntaxes, also rejecting implicit VR transfer syntaxes if an explicit VR transfer syntax is offered for the same abstract syntax.
  VerificationSOPClassSCU | This class implements the SCU role of the Verification SOP Class.

- Exception Summary
  Exception | Description
  --- | ---
  AReleaseException |
  DicomNetworkException |