Package com.pixelmed.database

Abstracts any underlying database support for applications using the DICOM toolkit and needing access to persistent storage of entities in the DICOM information model.

The primary class of this package is the abstract DatabaseInformationModel. It provides general facilities for connecting to the underlying database, creating tables, inserting, modifying, deleting and selecting records. In addition it provdes abstract methods for describing the types of entities mapped to records in tables and their relationships.

Concrete implementations of the DatabaseInformationModel are provided for commonly used models, including the PatientStudySeriesConcatenationInstanceModel and the StudySeriesInstanceModel.

The models make use of specialized forms of the generic com.pixelmed.dicom.DicomDictionary in order to make sure particular DICOM attributes are mapped to the correct information entity (i.e. database table) appropriate to the model in use.

Tree and table browsers and models are provided that may be used to form the basis of application specific browsers.

The following is a simple example of how a database is created, populated by one or more DICOM files, and a browser created:

public static void main(String arg[]) {
        try {
                final DatabaseInformationModel d = new PatientStudySeriesConcatenationInstanceModel("test");
                for (int j=0; j<arg.length; ++j) {
                        String fileName = arg[j];
                        DicomInputStream dfi = new DicomInputStream(new BufferedInputStream(new FileInputStream(fileName)));
                        AttributeList list = new AttributeList();
                        list.read(dfi);
                        dfi.close();
                        d.insertObject(list,fileName);
                }
                final JFrame frame = new JFrame();
                frame.setSize(400,800);
                frame.addWindowListener(new WindowAdapter() {
                        public void windowClosing(WindowEvent e) {
                                frame.dispose();
                                d.close();
                                System.exit(0);
                        }
                });
                DatabaseTreeBrowser tree = new DatabaseTreeBrowser(d,frame);
                frame.show(); 
        } catch (Exception e) {
                System.out.println(e);
                e.printStackTrace();
                System.exit(0);
        }
}

Package Specification

Related Documentation