cdac.medinfo.sdk.dcm30_04.services.cget.scp

Class CGetSCP

java.lang.Object

cdac.medinfo.sdk.dcm30_04.services.scp.commons.SCP

cdac.medinfo.sdk.dcm30_04.services.cget.scp.CGetSCP

All Implemented Interfaces:

IAsyncReceiver, IProcessHandler

public class CGetSCP
extends SCP
implements IAsyncReceiver

The C-GET service is used by a DIMSE-service-user to match and retrieve a set of Attributes against the Attributes of a set of composite SOP Instances maintained by a peer DIMSE-service-user. This class implements functioning of CGet service provider. This is a singleton class.

Field Summary

Fields inherited from class cdac.medinfo.sdk.dcm30_04.services.scp.commons.SCP

objClientSession

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes all the currently executing sessions gracefully.
static CGetSCP	createInstance() This method returns new object of C-Get SCP.
static CGetSCP	createInstance(ClientSession objClientSession) Static method to create instance of CGet SCP.
IDataSource	getDataSource() Retrieves instance of IDataSource
int	getNoOfRemainingResponses() Returns count of number of remaining responses.
void	onAssociateReceive(ClientSession objClientSession) This method notifies when Association Request, Associate Release Request or Abort is received from one of the SCUs.
void	onClose(ClientSession objClientSession) Closes client Session.
void	onConnect(ClientSession objClientSession) This method notifies when a new client connection is requested.
void	onResponseReceive(DicomMessage response) This method is call backed when Response is received.
void	onServiceRequest(ClientSession objClientSession) This method notifies when a service related request is received.
CGetRSP	processRequest(DicomMessage objDicomMessage) It implements processing of a CGet Request.
void	setDataSource(IDataSource objIDataSource) Sets instance of DataSource which works as a DataSource to retrieve.
void	start(java.lang.String strAETitle, int port) This method will Start the C-Get Server on the local host at the port specified.
void	start(java.lang.String strAETitle, java.lang.String strIP, int port) This method will Start the C-Get Server at the IP and Port specified.
void	stopListening() Stops accepting new connection's from SCU's and continue to process already connected clients.

Methods inherited from class cdac.medinfo.sdk.dcm30_04.services.scp.commons.SCP

onException

Methods inherited from class java.lang.Object

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

Method Detail

createInstance

public static CGetSCP createInstance(ClientSession objClientSession)

Static method to create instance of CGet SCP.

Parameters:

objClientSession - instance of Client session.

Returns:

CGetSCP instance of CGetSCP.

createInstance

public static CGetSCP createInstance()

This method returns new object of C-Get SCP.

Returns:

CGetSCP - object of CGet SCP.

start

public void start(java.lang.String strAETitle,
         java.lang.String strIP,
         int port)
           throws java.io.IOException

This method will Start the C-Get Server at the IP and Port specified. This method is to start stand alone C-Get SCP.

Parameters:

strAETitle - calling AE title for this service provider..

strIP - IP at which C-Get Server has to be started.

port - at which C-Get Server has to be started.

Throws:

java.io.IOException - throws IOException if IO operation fails.

start

public void start(java.lang.String strAETitle,
         int port)
           throws java.io.IOException

This method will Start the C-Get Server on the local host at the port specified. This method is to start stand alone C-Get SCP.

Parameters:

strAETitle - calling AE title for this service provider..

port - at which C-Get Server has to be started at local host.

Throws:

java.io.IOException - throws IOException if IO operation fails.

getDataSource

public IDataSource getDataSource()

Retrieves instance of IDataSource

Returns:

IDataSource instance of IDataSource.

setDataSource

public void setDataSource(IDataSource objIDataSource)

Sets instance of DataSource which works as a DataSource to retrieve.

Parameters:

objIDataSource - instance of IDataSource

processRequest

public CGetRSP processRequest(DicomMessage objDicomMessage)

It implements processing of a CGet Request. According to the matches found for query sends pending response and returns final CGet Response.

Specified by:

processRequest in class SCP

Parameters:

objDicomMessage - instance of DicomMessage..

Returns:

CGetRSP instance of CGet Response.

onConnect

public void onConnect(ClientSession objClientSession)

This method notifies when a new client connection is requested. A decision is to be made whether to accept or reject the connection.

Specified by:

onConnect in interface IProcessHandler

Parameters:

objClientSession - object of Client Session.

onAssociateReceive

public void onAssociateReceive(ClientSession objClientSession)

This method notifies when Association Request, Associate Release Request or Abort is received from one of the SCUs. If Association Request is received, Create Association Negotiator which negotiates the request with the existing default association and creates an AgreedAssociation which contains the negotiated association values. AssociationNegotiator returns the Association Response as AssociateAC when request is accepted or returns AssociateRJ is none of the values in Association Request are acceptable. If Associate Release Request is received, Create a Associate Release Response and send the response to the SCU using the respective ClientSession. If Abort is received, An Abort response must be generated and sent using ClientSession

Specified by:

onAssociateReceive in interface IProcessHandler

Parameters:

objClientSession - object of client session.

See Also:

cdac.medinfo.sdk.dcm30_04.services.scp.commons.ProcessHandler#processAssociation(cdac.medinfo.sdk.dcm30_04.services.scp.commons.ClientSession, cdac.medinfo.sdk.dcm30_04.services.dicomnetcommons.EnumPDUType)

onServiceRequest

public void onServiceRequest(ClientSession objClientSession)
                      throws java.io.IOException

This method notifies when a service related request is received. For Example, If C-Get-RQ is received, Create CGetSCP using the ClientSession. Process the request which will search for the matches and sends the matching data set. Perform C-Store Operation with the Application entity specified in the request. Sends Pending and final Response to the C-Get SCP using the ClientSession.

Specified by:

onServiceRequest in interface IProcessHandler

Parameters:

objClientSession - object of client session.

Throws:

java.io.IOException - Signals that an I/O exception has occurred.

getNoOfRemainingResponses

public int getNoOfRemainingResponses()

Description copied from interface: IAsyncReceiver

Returns count of number of remaining responses.

Specified by:

getNoOfRemainingResponses in interface IAsyncReceiver

Returns:

int

onResponseReceive

public void onResponseReceive(DicomMessage response)
                       throws java.io.IOException

This method is call backed when Response is received.

Specified by:

onResponseReceive in interface IAsyncReceiver

Parameters:

response - Response received.

Throws:

java.io.IOException - Signals that an I/O exception has occurred.

onClose

public void onClose(ClientSession objClientSession)

Closes client Session.

Specified by:

onClose in interface IProcessHandler

Parameters:

objClientSession - Object of Client Session.

stopListening

public void stopListening()

Stops accepting new connection's from SCU's and continue to process already connected clients.

close

public void close()

Closes all the currently executing sessions gracefully.