cdac.medinfo.sdk.dcm30_04.services.ups.dbhelper

Class UPSDBAgent

java.lang.Object

cdac.medinfo.sdk.dcm30_04.services.ups.dbhelper.UPSDBAgent

public class UPSDBAgent
extends java.lang.Object

Unified Procedure Step Service and SOP Classes DataBase Agent provides implementation for processing of queries on DataBase.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	checkForSubscription(java.lang.String strSOPInstance) Check for subscription for specified SOP .
static UPSDBAgent	createInstance(java.lang.String strConnectionString, java.lang.String strDriverName) Creates instance of UPSDBAgent.
boolean	find(IDataSet objIDataSet, ISingleCollection<IDataSet> objRstDataCollection) Depending on the keys in the IDataSet it finds the matching DataSets and returns status.
boolean	isSOPInstanceExist(java.lang.String strSOPInstance) Checks whether provided SOP Instance is created or not.
boolean	isTransactionUIDExist(java.lang.String strUID) Checks whether provided Transaction UID is created or not.
IDataSet	retrieveUPSInstanceInfo(ISingleCollection<ITag> objTagCollection, java.lang.String strSOPInstance) Retrieve specified Data set from Database.
IDataSet	retrieveUPSInstanceInfoForThree(ISingleCollection<ITag> objTagCollection, java.lang.String strSOPInstance) Retrieve specified Data set from Database.
IDataSet	retrieveUPSInstanceInfoForTwo(ISingleCollection<ITag> objTagCollection, java.lang.String strSOPInstance) Retrieve specified Data set from Database.
boolean	storeInstanceInfo(IDataSet objIDataSet) Stores specified Data set to Database.
boolean	storeInstanceInfoForCancle(IDataSet objIDataSet) Stores specified Data set to Database.
boolean	storeInstanceInfoForSubscription(IDataSet objIDataSet) Stores specified Data set to Database.
boolean	storeInstanceInfoForUnsubscribe(IDataSet objIDataSet) Stores specified Data set to Database.
boolean	updateSOPInstance(IDataSet objIDataSet, java.lang.String strUID) Updates a SOP Instance

Methods inherited from class java.lang.Object

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

Method Detail

createInstance

public static UPSDBAgent createInstance(java.lang.String strConnectionString,
                        java.lang.String strDriverName)
                                 throws java.sql.SQLException,
                                        java.lang.ClassNotFoundException,
                                        java.lang.InstantiationException,
                                        java.lang.IllegalAccessException

Creates instance of UPSDBAgent.

Parameters:

strConnectionString - Database Connection String

strDriverName - Database driver fully qualified name

Returns:

instance of UPSDBAgent.

Throws:

java.sql.SQLException - - thrown in case of database access error or other errors.

java.lang.ClassNotFoundException - - thrown in case failure when an application tries to load in a class.

java.lang.InstantiationException - - thrown in case failure when an application tries to create an instance of a class using the newInstance method in class Class, but the specified class object cannot be instantiated.

java.lang.IllegalAccessException - - thrown in case failure when an application tries to reflectively create an instance (other than an array), set or get a field, or invoke a method, but the currently executing method does not have access to the definition of the specified class, field, method or constructor.

storeInstanceInfo

public boolean storeInstanceInfo(IDataSet objIDataSet)
                          throws java.sql.SQLException

Stores specified Data set to Database.

Parameters:

objIDataSet - - instance of IDataSet

Returns:

true if Success, otherwise false

Throws:

java.sql.SQLException - if there is database access error or other errors.

find

public boolean find(IDataSet objIDataSet,
           ISingleCollection<IDataSet> objRstDataCollection)
             throws java.sql.SQLException

Depending on the keys in the IDataSet it finds the matching DataSets and returns status. According to the matched DataSets populate the collection taken as out parameter.

Parameters:

objIDataSet - The data set containing identifiers.

objRstDataCollection - the matched data set collection

Returns:

boolean true - if one or more matches are found false - if no matches are found.

Throws:

java.sql.SQLException - if there is database access error or other errors.

storeInstanceInfoForCancle

public boolean storeInstanceInfoForCancle(IDataSet objIDataSet)
                                   throws java.sql.SQLException

Stores specified Data set to Database.

Parameters:

objIDataSet - - instance of IDataSet

Returns:

true if Success, otherwise false

Throws:

java.sql.SQLException - if there is database access error or other errors.

isTransactionUIDExist

public boolean isTransactionUIDExist(java.lang.String strUID)
                              throws java.sql.SQLException

Checks whether provided Transaction UID is created or not.

Parameters:

strSOPInstance - value of SOP Instance UID

Returns:

boolean shows status as success or failure

Throws:

java.sql.SQLException - if sql operation fails

updateSOPInstance

public boolean updateSOPInstance(IDataSet objIDataSet,
                        java.lang.String strUID)
                          throws java.sql.SQLException

Updates a SOP Instance

Parameters:

objIDataSet - instance of Dataset

strSOPInstanceUID - value of SOPInstanceUID

Returns:

boolean - status as true or false

Throws:

java.sql.SQLException - if SQL operation fails

retrieveUPSInstanceInfo

public IDataSet retrieveUPSInstanceInfo(ISingleCollection<ITag> objTagCollection,
                               java.lang.String strSOPInstance)
                                 throws java.sql.SQLException

Retrieve specified Data set from Database.

Parameters:

objTagCollection -

strSOPInstance -

Returns:

objIDataSet

Throws:

java.sql.SQLException

isSOPInstanceExist

public boolean isSOPInstanceExist(java.lang.String strSOPInstance)
                           throws java.sql.SQLException

Checks whether provided SOP Instance is created or not.

Parameters:

strSOPInstance - value of SOP Instance UID

Returns:

boolean shows status as success or failure

Throws:

java.sql.SQLException - if sql operation fails

storeInstanceInfoForSubscription

public boolean storeInstanceInfoForSubscription(IDataSet objIDataSet)
                                         throws java.sql.SQLException

Stores specified Data set to Database.

Parameters:

objIDataSet - - instance of IDataSet

Returns:

true if Success, otherwise false

Throws:

java.sql.SQLException - if there is database access error or other errors.

storeInstanceInfoForUnsubscribe

public boolean storeInstanceInfoForUnsubscribe(IDataSet objIDataSet)
                                        throws java.sql.SQLException

Stores specified Data set to Database.

Parameters:

objIDataSet - - instance of IDataSet

Returns:

true if Success, otherwise false

Throws:

java.sql.SQLException - if there is database access error or other errors.

retrieveUPSInstanceInfoForTwo

public IDataSet retrieveUPSInstanceInfoForTwo(ISingleCollection<ITag> objTagCollection,
                                     java.lang.String strSOPInstance)
                                       throws java.sql.SQLException

Retrieve specified Data set from Database.

Parameters:

objTagCollection -

strSOPInstance -

Returns:

objIDataSet

Throws:

java.sql.SQLException

retrieveUPSInstanceInfoForThree

public IDataSet retrieveUPSInstanceInfoForThree(ISingleCollection<ITag> objTagCollection,
                                       java.lang.String strSOPInstance)
                                         throws java.sql.SQLException

Retrieve specified Data set from Database.

Parameters:

objTagCollection -

strSOPInstance -

Returns:

objIDataSet

Throws:

java.sql.SQLException

checkForSubscription

public boolean checkForSubscription(java.lang.String strSOPInstance)
                             throws java.sql.SQLException

Check for subscription for specified SOP .

Parameters:

strSOPInstance -

Returns:

true if Success, otherwise false

Throws:

java.sql.SQLException