uiddictionary.cs

Open Dicom source code C#

/*
   
    openDICOM.NET openDICOM# 0.1.1

    openDICOM# provides a library for DICOM related development on Mono.
    Copyright (C) 2006-2007  Albert Gnandt

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA


    $Id: UidDictionary.cs 75 2007-03-31 19:13:28Z agnandt $
*/
using System;
using System.IO;
using System.Collections;
using System.Xml;
using System.Text.RegularExpressions;
using openDicom.DataStructure;
using openDicom.Encoding;


namespace openDicom.Registry
{

    /// <summary>
    ///     UID (Unique Identifier) dictionary. This class represents the
    ///     registry of DICOM UIDs.
    /// </summary>
    public class UidDictionary: IDicomDictionary
    {   
        private Hashtable hashTable = new Hashtable(198);

        private static UidDictionary global = null;
        /// <summary>
        ///     The global UID dictionary instance. Normally, the
        ///     first loaded UID dictionary is assigned as this
        ///     instance, automatically.
        /// </summary>
        public static UidDictionary Global
        {
            get
            {
                if (global == null || global.IsEmpty)
                    throw new DicomException(
                        "No global UID dictionary available." +
                        "Possibly it has not been initialized or is empty.");
                else
                    return global;
            }

            set
            {            
                if (value == null || value.IsEmpty)
                    throw new DicomException(
                        "UidDictionary.Global is null or empty.");
                else
                    global = value;
            }
        }

        /// <summary>
        ///     Access UID dictionary instance as array. DICOM
        ///     UIDs are used for indexing.
        /// </summary>
        public UidDictionaryEntry this[Uid index]
        {
            get 
            {
                if (index != null)
                    return (UidDictionaryEntry) hashTable[index.ToString()];
                else
                    throw new DicomException("index is null.",
                        "UidDictionary[index]");
            }
        }

        /// <summary>
        ///     Returns the count of dictionary entries.
        /// </summary>
        public int Count
        {
            get { return hashTable.Count; }
        }
        
        /// <summary>
        ///     Returns whether a dictionary does not contain entries.
        /// </summary>
        public bool IsEmpty
        {
            get { return Count == 0; }
        }

        private static readonly string fileComment = 
            "This file was automatically generated by the openDICOM.NET " +
            "class library.";


        /// <summary>
        ///     Creates a new empty UID dictionary instance.
        /// </summary>
        public UidDictionary() {}

        /// <summary>
        ///     Creates a new UID dictionary instance and fills it
        ///     with entries from the specified UID dictionary file
        ///     of specified file format.
        /// </summary>
        public UidDictionary(string fileName, DictionaryFileFormat fileFormat)
        {
            LoadFrom(fileName, fileFormat);
        }

        private void LoadFromBinary(StreamReader streamReader)
        {
            BinaryReader binaryReader = new BinaryReader(streamReader.BaseStream);
            while (streamReader.BaseStream.Position < streamReader.BaseStream.Length)
            {
                try
                {
                    int length = binaryReader.ReadInt32();
                    byte[] buffer = new byte[length];
                    binaryReader.Read(buffer, 0, length);
                    string stringUid = ByteConvert.ToString(buffer, 
                        CharacterRepertoire.Ascii);
                    Uid uid = new Uid(stringUid);
                    length = binaryReader.ReadInt32();
                    buffer = new byte[length];
                    binaryReader.Read(buffer, 0, length);
                    string name = ByteConvert.ToString(buffer, 
                        CharacterRepertoire.Ascii);
                    int intType = binaryReader.ReadInt32();
                    UidType type = (UidType) UidType.ToObject(typeof(UidType), 
                        intType);
                    bool retired = binaryReader.ReadBoolean();
                    UidDictionaryEntry entry = 
                        new UidDictionaryEntry(uid, name, type, retired);
                    Add(entry);
                }
                catch (Exception e)
                {
                    throw new DicomException("Wrong entry before index " +
                        streamReader.BaseStream.Position + ": " + e.Message);
                }
            }
        }

        private void LoadFromProperty(TextReader textReader)
        {
            string line = textReader.ReadLine();
            int lineNumber = 1;
            string[] result = null;
            while (line != null)
            {
                string lineWithoutSpaces = line.Replace(" ", null);
                if ( ! lineWithoutSpaces.StartsWith("#") && 
                    ! lineWithoutSpaces.Equals(""))
                {
                    if (Regex.IsMatch(lineWithoutSpaces, 
                        "^[0-9\\.]+=[^,]+,[^,]+(,RET)?$"))
                    {
                        result = line.Split('=');
                        string uid = result[0];
                        result = result[1].Split(',');
                        string retired = (result.Length == 3) ? "RET" : null;
                        try
                        {
                            UidDictionaryEntry entry = 
                                new UidDictionaryEntry(uid,
                                    result[0].Trim(), result[1].Trim(), 
                                    retired);
                            Add(entry);
                        }
                        catch (Exception e)
                        {
                            throw new DicomException("Wrong entry in line " +
                                lineNumber.ToString() + ": " + e.Message);
                        }
                    }
                    else
                        throw new DicomException("Wrong entry in line " +
                            lineNumber.ToString() + ".");
                }
                line = textReader.ReadLine();
                lineNumber++;
            }            
        }

        private void LoadFromCsv(TextReader textReader)
        {
            string line = textReader.ReadLine();
            int lineNumber = 1;
            string[] result = null;
            while (line != null)
            {
                string lineWithoutSpaces = line.Replace(" ", null);
                if ( ! lineWithoutSpaces.StartsWith("#") && 
                    ! lineWithoutSpaces.Equals(""))
                {
                    if (Regex.IsMatch(lineWithoutSpaces, 
                        "^[0-9\\.]+;[^;]+;[^;]+(;RET)?$"))
                    {
                        result = line.Split(';');
                        string uid = result[0];
                        string retired = (result.Length == 4) ? "RET" : null;
                        try
                        {
                            UidDictionaryEntry entry = 
                                new UidDictionaryEntry(uid, 
                                    result[1].Trim(), result[2].Trim(), 
                                    retired);
                            Add(entry);
                        }
                        catch (Exception e)
                        {
                            throw new DicomException("Wrong entry in line " +
                                lineNumber.ToString() + ": " + e.Message);
                        }
                    }
                    else
                        throw new DicomException("Wrong entry in line " +
                            lineNumber.ToString() + ".");
                }