cdac.medinfo.sdk.dcm30_04.services.association

Class DefaultAssociation

java.lang.Object

cdac.medinfo.sdk.dcm30_04.services.association.DefaultAssociation

public class DefaultAssociation
extends java.lang.Object

The Class implements the Default settings of Association. Default Association can be populated either manually or with default values provided by SDK DefaultAssociation specifies the configuration which would be referred while creating association.

Constructor Summary

Constructors

Constructor and Description
DefaultAssociation(java.lang.String strCallingAETitle) Constructor to initialize object using given calling AE Title.
DefaultAssociation(java.lang.String calledAETitle, java.lang.String callingAETitle, short ProcVersion, java.lang.String strAppContextName, ISingleCollection<RQPresContext> objRQPresContextCollection, RQUserInfo objRQUserInfo) Constructor to initialize object using given parameters.

Method Summary

Methods

Modifier and Type	Method and Description
void	addDefTransferSyntax(java.lang.String strTS) Adds the Transfer Syntax value in List
void	addPresContext(RQPresContext objRQPresContext) Adds the entry for RQPresContext
boolean	changeSupportedTS(EnumSOPClassUIDs enumSOPClassUIDs, ISingleCollection<java.lang.String> objTSList) Replaces the transfer syntax list for a RQPresContext which contains provided SOPClassUID as AbstractSyntax.
java.lang.String	getAppContextName() Retrieves Application context name .
AssociateRQ	getAssociationRQ(java.lang.String strRequestedAETitle) Retrieves the Association RQ.
AssociateRQ	getAssociationRQ(java.lang.String strRequestedAETitle, IPairedCollection<EnumSOPClassUIDs,ISingleCollection<java.lang.String>> objPresContextList) Retrieves the Association RQ.
java.lang.String	getCalledAETitle() Retrieves Destination DICOM Application Name .
java.lang.String	getCallingAETitle() Retrieves Source DICOM Application Name .
ISingleCollection<java.lang.String>	getDefTransferSyntaxList() Retrieves list of supported transfer syntax for Abstract Syntax.
short	getProtocolVersion() Gets the protocol version.
RQPresContext	getRQPresContext(EnumSOPClassUIDs enumSOPClassUIDs) Retrieves the RQPresContext which contains provided SOPClassUID as AbstractSyntax.
ISingleCollection<RQPresContext>	getRQPresContextCollection() This method gets the Presentation Context collection.
RQUserInfo	getRQUserInfo() This method gets the User Info.
boolean	isAssociationLoaded() Returns the status of DefaultAssociation whether it is loaded or not.
void	loadAssociation(EnumServiceType[] enumServiceTypes) Populates the DefaultAsasociation with default values if default fields have not been initialized.
void	loadAssociation(EnumSOPClassUIDs[] arrenumSOPClassUID) Populates the DefaultAsasociation with default values if default fields have not been initialized.
void	loadAssociation(ISingleCollection<RQPresContext> objRQPresContextList) Populates the DefaultAsasociation with default values if default fields have not been initialized.
void	setAppContextName(java.lang.String strAppContextName) Sets Application context name .
void	setCalledAETitle(java.lang.String strCalledAETitle) Sets Destination DICOM Application Name .
void	setCallingAETitle(java.lang.String strCallingAETitle) Sets Source DICOM Application Name .
void	setDefTransferSyntaxList(ISingleCollection<java.lang.String> objDefTransferSyntaxList) Sets list of supported transfer syntax for Abstract Syntax.
void	setProtocolVersion(short protocolVersion) Sets the protocol version.
void	setRQPresContext(ISingleCollection<RQPresContext> objRQPresContext) Sets the RQ presentation context collection.
void	setUserInfoItem(RQUserInfo objRQUserInfo) Sets the user info item.
boolean	validate() Validates the Default Association for mandatory attributes.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultAssociation

public DefaultAssociation(java.lang.String calledAETitle,
                  java.lang.String callingAETitle,
                  short ProcVersion,
                  java.lang.String strAppContextName,
                  ISingleCollection<RQPresContext> objRQPresContextCollection,
                  RQUserInfo objRQUserInfo)

Constructor to initialize object using given parameters.

Parameters:

calledAETitle - String value of Destination DICOM Application Name

callingAETitle - String value of source DICOM Application Name

ProcVersion - short value of Dicom Protocol version.

strAppContextName - String value of Application context name.

objRQPresContextCollection - collection of Presentation Context

objRQUserInfo - object of User Info.

DefaultAssociation

public DefaultAssociation(java.lang.String strCallingAETitle)

Constructor to initialize object using given calling AE Title.

Parameters:

strAETitle - value of calling AE Title

Method Detail

getDefTransferSyntaxList

public ISingleCollection<java.lang.String> getDefTransferSyntaxList()

Retrieves list of supported transfer syntax for Abstract Syntax.

Returns:

ISingleCollection collection of supported transfer syntax

setDefTransferSyntaxList

public void setDefTransferSyntaxList(ISingleCollection<java.lang.String> objDefTransferSyntaxList)

Sets list of supported transfer syntax for Abstract Syntax.

Parameters:

objDefTransferSyntaxList - collection of supported transfer syntax

addDefTransferSyntax

public void addDefTransferSyntax(java.lang.String strTS)

Adds the Transfer Syntax value in List

Parameters:

strTS - value of Transfer Syntax

isAssociationLoaded

public boolean isAssociationLoaded()

Returns the status of DefaultAssociation whether it is loaded or not.

Returns:

boolean - true , if association is loaded false, if association is not loaded

validate

public boolean validate()
                 throws InvalidAssociationPrimitiveException

Validates the Default Association for mandatory attributes. Generates log for missing or invalid attributes and throws exception accordingly.

Returns:

boolean - shows status as true or false.

Throws:

InvalidAssociationPrimitiveException - if any mandatory attribute is missing or invalid.

loadAssociation

public void loadAssociation(ISingleCollection<RQPresContext> objRQPresContextList)
                     throws AssociationLoadFailedException

Populates the DefaultAsasociation with default values if default fields have not been initialized. Populates the supported RQPresContext list with given parameter.

Parameters:

objRQPresContextList - collection of RQPresContext.

Throws:

AssociationLoadFailedException

loadAssociation

public void loadAssociation(EnumSOPClassUIDs[] arrenumSOPClassUID)
                     throws AssociationLoadFailedException

Populates the DefaultAsasociation with default values if default fields have not been initialized. Populates the supported RQPresContext list only for provided SOP Class UIDs.

Parameters:

arrenumSOPClassUID - array of SOP Class UID

Throws:

AssociationLoadFailedException

loadAssociation

public void loadAssociation(EnumServiceType[] enumServiceTypes)
                     throws AssociationLoadFailedException

Populates the DefaultAsasociation with default values if default fields have not been initialized. Populates the supported RQPresContext list for all SOP Class UIDs available in libs directory for given services

Parameters:

enumServiceTypes - array of services type

Throws:

AssociationLoadFailedException

changeSupportedTS

public boolean changeSupportedTS(EnumSOPClassUIDs enumSOPClassUIDs,
                        ISingleCollection<java.lang.String> objTSList)

Replaces the transfer syntax list for a RQPresContext which contains provided SOPClassUID as AbstractSyntax. If programmer wants to specify a list of transfer syntaxes(which may be different from default support) for a particular abstratct syntax, he/she can make this change through this method. It returns true if modification made successfully else false.

Parameters:

enumSOPClassUIDs - enum value for abstract syntax

objTSList - list of transfer syntax

Returns:

boolean shows status as true or false.

getRQPresContext

public RQPresContext getRQPresContext(EnumSOPClassUIDs enumSOPClassUIDs)

Retrieves the RQPresContext which contains provided SOPClassUID as AbstractSyntax.

Parameters:

enumSOPClassUIDs - enum value for abstract syntax

Returns:

RQPresContext instance of RQPresContext

addPresContext

public void addPresContext(RQPresContext objRQPresContext)

Adds the entry for RQPresContext

Parameters:

objRQPresContext - instance of RQPresContext

getCalledAETitle

public java.lang.String getCalledAETitle()

Retrieves Destination DICOM Application Name .

Returns:

String - value of Destination DICOM Application Name

setCalledAETitle

public void setCalledAETitle(java.lang.String strCalledAETitle)

Sets Destination DICOM Application Name .

Parameters:

strCalledAETitle - the Destination DICOM Application Name .

getCallingAETitle

public java.lang.String getCallingAETitle()

Retrieves Source DICOM Application Name .

Returns:

String - value of Source DICOM Application Name.

setCallingAETitle

public void setCallingAETitle(java.lang.String strCallingAETitle)

Sets Source DICOM Application Name .

Parameters:

strCallingAETitle - Source DICOM Application Name .

getAppContextName

public java.lang.String getAppContextName()

Retrieves Application context name .

Returns:

String - String value of Application context name.

setAppContextName

public void setAppContextName(java.lang.String strAppContextName)

Sets Application context name .

Parameters:

strAppContextName - String value of Application context name .

getRQPresContextCollection

public ISingleCollection<RQPresContext> getRQPresContextCollection()

This method gets the Presentation Context collection.

Returns:

ISingleCollection - Presentation Context collection

setRQPresContext

public void setRQPresContext(ISingleCollection<RQPresContext> objRQPresContext)

Sets the RQ presentation context collection.

Parameters:

objRQPresContext - Presentation Context collection

getRQUserInfo

public RQUserInfo getRQUserInfo()

This method gets the User Info.

Returns:

RQUserInfo - object of User info

setUserInfoItem

public void setUserInfoItem(RQUserInfo objRQUserInfo)

Sets the user info item.

Parameters:

objRQUserInfo - the user info item.

getProtocolVersion

public short getProtocolVersion()

Gets the protocol version.

Returns:

short - value of the protocol version

setProtocolVersion

public void setProtocolVersion(short protocolVersion)

Sets the protocol version.

Parameters:

protocolVersion - short value of protocol version.

getAssociationRQ

public AssociateRQ getAssociationRQ(java.lang.String strRequestedAETitle)
                             throws AssociationLoadFailedException

Retrieves the Association RQ. It validates the Default Association. If Default Association is not loaded or contains invalid entry then it generates exception.

Parameters:

strRequestedAETitle - AE title of service provider

Returns:

AssociateRQ - the default association request.

Throws:

AssociationLoadFailedException - if DefaultAssociation is invalid or PresContextList size exceeds then 66.

getAssociationRQ

public AssociateRQ getAssociationRQ(java.lang.String strRequestedAETitle,
                           IPairedCollection<EnumSOPClassUIDs,ISingleCollection<java.lang.String>> objPresContextList)
                             throws AssociationLoadFailedException

Retrieves the Association RQ. If Default Association is not loaded then it will be loaded for default values and It generates RequestPresentationContext list by provided collection of SOPClass UID and Transfer Syntax.

Parameters:

strRequestedAETitle - AE title of service provider

objPresContextList - collection of Abstact syntax and corresponding transfer syntax list.

Returns:

AssociateRQ - the default association request.

Throws:

AssociationLoadFailedException