001/*
002 * **** BEGIN LICENSE BLOCK *****
003 *  Version: MPL 1.1/GPL 2.0/LGPL 2.1
004 *
005 *  The contents of this file are subject to the Mozilla Public License Version
006 *  1.1 (the "License"); you may not use this file except in compliance with
007 *  the License. You may obtain a copy of the License at
008 *  http://www.mozilla.org/MPL/
009 *
010 *  Software distributed under the License is distributed on an "AS IS" basis,
011 *  WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
012 *  for the specific language governing rights and limitations under the
013 *  License.
014 *
015 *  The Original Code is part of dcm4che, an implementation of DICOM(TM) in
016 *  Java(TM), hosted at https://github.com/gunterze/dcm4che.
017 *
018 *  The Initial Developer of the Original Code is
019 *  Agfa Healthcare.
020 *  Portions created by the Initial Developer are Copyright (C) 2015
021 *  the Initial Developer. All Rights Reserved.
022 *
023 *  Contributor(s):
024 *  See @authors listed below
025 *
026 *  Alternatively, the contents of this file may be used under the terms of
027 *  either the GNU General Public License Version 2 or later (the "GPL"), or
028 *  the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
029 *  in which case the provisions of the GPL or the LGPL are applicable instead
030 *  of those above. If you wish to allow use of your version of this file only
031 *  under the terms of either the GPL or the LGPL, and not to allow others to
032 *  use your version of this file under the terms of the MPL, indicate your
033 *  decision by deleting the provisions above and replace them with the notice
034 *  and other provisions required by the GPL or the LGPL. If you do not delete
035 *  the provisions above, a recipient may use your version of this file under
036 *  the terms of any one of the MPL, the GPL or the LGPL.
037 *
038 *  ***** END LICENSE BLOCK *****
039 */
040package org.dcm4che3.conf.api.internal;
041
042import org.dcm4che3.conf.api.internal.ExtendedDicomConfiguration;
043import org.dcm4che3.conf.core.api.ConfigurationException;
044import org.dcm4che3.conf.core.api.Path;
045import org.dcm4che3.conf.core.api.internal.ConfigurationManager;
046import org.dcm4che3.net.Device;
047
048import java.util.Map;
049
050/**
051 * This interface is for internal use.
052 * @author Roman K
053 */
054public interface DicomConfigurationManager extends ExtendedDicomConfiguration, ConfigurationManager{
055
056    Path METADATA_ROOT_PATH = new Path("dicomConfigurationRoot","metadataRoot","versioning");
057
058    /**
059     * Remembers a weak reference to the provided device so that any subsequent call to
060     * persist or merge for this specific instance is made, an error is logged.
061     *
062     * This is a safeguard against misusing a singleton injected device and making direct modifications on it.
063     *
064     * In future, logging an error will be replaced with throwing an exception
065     * @param d
066     */
067    void preventDeviceModifications(Device d);
068
069    /**
070     * Triggers a reload of TC groups
071     */
072    void refreshTCGroups();
073
074}