public class MCtransferSyntaxList extends java.lang.Object implements java.lang.Iterable<MCtransferSyntax>
When an association is being negotiated, the association requester offers a list of presentation contexts that the application entity is willing to support. Each context represents a DICOM service and includes a list of transfer syntaxes supported by the application for that service.
Instances of this class are used when creating proposed context lists (MCproposedContext
)
for requesting an association.
Instances of this class can be used by multiple threads concurrently.
Constructor and Description |
---|
MCtransferSyntaxList()
Initializes a transfer syntax list containing all non-encapsulated syntaxes (the default
transfer syntax list).
|
MCtransferSyntaxList(MCtransferSyntax[] syntaxes)
Initializes a transfer syntax list with the provided array of transfer syntaxes.
|
MCtransferSyntaxList(java.lang.String name)
Initializes a transfer syntax list with configured values.
|
MCtransferSyntaxList(java.lang.String name,
MCtransferSyntax[] syntaxes)
Initializes a transfer syntax list with the provided array of transfer syntaxes.
|
Modifier and Type | Method and Description |
---|---|
void |
dispose()
Disposes native resources associated with this transfer syntax list.
|
java.lang.String |
getName()
Gets the name of this transfer syntax list.
|
java.util.Iterator<MCtransferSyntax> |
iterator() |
int |
size()
Gets the number of transfer syntaxes in this list.
|
public MCtransferSyntaxList()
MCexception
- If the toolkit is not initialized or if a system error occurs.public MCtransferSyntaxList(java.lang.String name)
This constructor loads the list of syntaxes from the application profile configuration file (mergecom.app).
name
- The name of a configured transfer syntax list.MCexception
- If the toolkit is not initialized, if the toolkit fails to load the configuration or if
the name parameter is invalid.public MCtransferSyntaxList(java.lang.String name, MCtransferSyntax[] syntaxes)
name
- The name to be associated wit the new transfer syntax list.syntaxes
- The array of transfer syntaxes for this list.MCexception
- If the toolkit is not initialized or if one of the parameters
is invalid.public MCtransferSyntaxList(MCtransferSyntax[] syntaxes)
The toolkit will assign a unique name for the new transfer syntax list.
syntaxes
- The array of transfer syntaxes for this list.MCexception
- If the toolkit is not initialized or if the parameter is invalid.public java.lang.String getName()
public void dispose()
This method addresses memory consumption issues for special use cases when a large number of different transfer syntax lists are created by the application. In a normal scenario an application creates only a limited number of transfer syntax lists which are used in a few context lists. In such cases disposal of transfer syntax lists is not a concern since the memory used by them does not grow over time and automatic disposal on library release is acceptable.
public java.util.Iterator<MCtransferSyntax> iterator()
iterator
in interface java.lang.Iterable<MCtransferSyntax>
public int size()