// Copyright (C) Stichting Deltares 2017. All rights reserved.
//
// This file is part of Ringtoets.
//
// Ringtoets is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program 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 General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see .
//
// All names, logos, and references to "Deltares" are registered trademarks of
// Stichting Deltares and remain full property of Stichting Deltares at all times.
// All rights reserved.
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Data.SQLite;
using System.Linq;
using Core.Common.Base.IO;
using Core.Common.IO.Exceptions;
using Core.Common.IO.Readers;
using Ringtoets.Common.IO.Properties;
using Ringtoets.HydraRing.Calculation.Data;
using Ringtoets.HydraRing.Calculation.Data.Settings;
namespace Ringtoets.Common.IO.HydraRing
{
///
/// This class is responsible for reading values from the Hydra-Ring settings database and creating
/// settings from them.
///
internal class HydraRingSettingsDatabaseReader : SqLiteDatabaseReaderBase
{
private const string calculationTechniqueIdColumn = "CalculationMethod";
private const string formStartMethodColumn = "FORM_StartMethod";
private const string formNumberOfIterationsColumn = "FORM_NIterations";
private const string formRelaxationFactorColumn = "FORM_RelaxationFactor";
private const string formEpsBetaColumn = "FORM_EpsBeta";
private const string formEpsHohColumn = "FORM_EpsHOH";
private const string formEpsZFuncColumn = "FORM_EpsZFunc";
private const string dsStartMethodColumn = "DS_StartMethod";
private const string dsMinNumberOfIterationsColumn = "DS_Min";
private const string dsMaxNumberOfIterationsColumn = "DS_Max";
private const string dsVarCoefficientColumn = "DS_VarCoefficient";
private const string niUMinColumn = "NI_UMin";
private const string niUMaxColumn = "NI_UMax";
private const string niNumberStepsColumn = "NI_NumberSteps";
private const string minColumn = "Min";
private const string maxColumn = "Max";
private const string locationIdParameterName = "@locationId";
private const string calculationTypeIdParameterName = "@calculationTypeId";
private const string mechanismIdParameterName = "@mechanismID";
private const string subMechanismIdParameterName = "@subMechanismID";
private const string timeIntegrationSchemeIdColumn = "TimeIntegrationSchemeID";
private const string locationIdColumn = "LocationID";
private readonly string designTableSettingsForLocationAndCalculationTypeQuery;
private readonly string numericSettingsForLocationMechanismAndSubMechanismQuery;
private readonly string excludedLocationsQuery;
private readonly string timeIntegrationSettingsForLocationAndCalculationTypeQuery;
///
/// Creates a new instance of .
///
/// The full path to the database file to use when reading settings.
/// Thrown when:
///
/// - The contains invalid characters.
/// - No file could be found at .
/// - Unable to open database file.
/// - The opened database doesn't have the expected schema.
///
///
public HydraRingSettingsDatabaseReader(string databaseFilePath)
: base(databaseFilePath)
{
designTableSettingsForLocationAndCalculationTypeQuery = string.Format(
"SELECT {0}, {1} FROM DesignTablesSettings WHERE LocationID = {2} AND CalculationTypeID = {3}",
minColumn,
maxColumn,
locationIdParameterName,
calculationTypeIdParameterName);
numericSettingsForLocationMechanismAndSubMechanismQuery = string.Format(
"SELECT {0}, {1}, {2}, {3}, {4}, {5}, {6}, {7}, {8}, {9}, {10}, {11}, {12}, {13} " +
"FROM NumericsSettings WHERE LocationID = {14} AND MechanismID = {15} AND SubMechanismID = {16}",
calculationTechniqueIdColumn,
formStartMethodColumn,
formNumberOfIterationsColumn,
formRelaxationFactorColumn,
formEpsBetaColumn,
formEpsHohColumn,
formEpsZFuncColumn,
dsStartMethodColumn,
dsMinNumberOfIterationsColumn,
dsMaxNumberOfIterationsColumn,
dsVarCoefficientColumn,
niUMinColumn,
niUMaxColumn,
niNumberStepsColumn,
locationIdParameterName,
mechanismIdParameterName,
subMechanismIdParameterName);
timeIntegrationSettingsForLocationAndCalculationTypeQuery = string.Format(
"SELECT {0} FROM TimeIntegrationSettings WHERE LocationID = {1} AND CalculationTypeID = {2}",
timeIntegrationSchemeIdColumn,
locationIdParameterName,
calculationTypeIdParameterName);
excludedLocationsQuery = string.Format(
"SELECT {0} FROM ExcludedLocations",
locationIdColumn);
ValidateSchema();
}
///
/// Read a design tables setting for a given location and .
///
/// The id of a hydraulic boundary location.
/// The type of the calculation to obtain the for.
/// A new containing values read from the database.
/// Thrown when is not a valid
/// value.
/// Thrown when a column that is being read doesn't
/// contain expected type.
public DesignTablesSetting ReadDesignTableSetting(long locationId, HydraRingFailureMechanismType calculationType)
{
if (!Enum.IsDefined(calculationType.GetType(), calculationType))
{
throw new InvalidEnumArgumentException("calculationType", (int) calculationType, calculationType.GetType());
}
using (IDataReader reader = CreateDesignTablesDataReader(locationId, calculationType))
{
if (MoveNext(reader))
{
try
{
return new DesignTablesSetting(
reader.Read(minColumn),
reader.Read(maxColumn));
}
catch (ConversionException)
{
throw new CriticalFileReadException(Resources.HydraRingSettingsDatabaseReader_ValidateSchema_Hydraulic_calculation_settings_database_has_invalid_schema);
}
}
}
return null;
}
///
/// Read a numerics setting for a given location and .
///
/// The id of a hydraulic boundary location.
/// The mechanism id to obtain the for.
/// The sub mechanism id to obtain the for.
/// A new containing values read from the database.
/// Thrown when a column that is being read doesn't
/// contain expected type.
public NumericsSetting ReadNumericsSetting(long locationId, int mechanismId, int subMechanismId)
{
using (IDataReader reader = CreateNumericsSettingsDataReader(locationId, mechanismId, subMechanismId))
{
if (MoveNext(reader))
{
try
{
return new NumericsSetting(
reader.Read(calculationTechniqueIdColumn),
reader.Read(formStartMethodColumn),
reader.Read(formNumberOfIterationsColumn),
reader.Read(formRelaxationFactorColumn),
reader.Read(formEpsBetaColumn),
reader.Read(formEpsHohColumn),
reader.Read(formEpsZFuncColumn),
reader.Read(dsStartMethodColumn),
reader.Read(dsMinNumberOfIterationsColumn),
reader.Read(dsMaxNumberOfIterationsColumn),
reader.Read(dsVarCoefficientColumn),
reader.Read(niUMinColumn),
reader.Read(niUMaxColumn),
reader.Read(niNumberStepsColumn));
}
catch (ConversionException)
{
throw new CriticalFileReadException(Resources.HydraRingSettingsDatabaseReader_ValidateSchema_Hydraulic_calculation_settings_database_has_invalid_schema);
}
}
}
return null;
}
///
/// Read a time integration setting for a given location and .
///
/// The id of a hydraulic boundary location.
/// The type of the calculation to obtain the for.
/// A new containing values read from the database.
/// Thrown when is not a valid
/// value.
/// Thrown when a column that is being read doesn't
/// contain expected type.
public TimeIntegrationSetting ReadTimeIntegrationSetting(long locationId, HydraRingFailureMechanismType calculationType)
{
if (!Enum.IsDefined(calculationType.GetType(), calculationType))
{
throw new InvalidEnumArgumentException("calculationType", (int) calculationType, calculationType.GetType());
}
using (IDataReader reader = CreateTimeIntegrationDataReader(locationId, calculationType))
{
if (MoveNext(reader))
{
try
{
return new TimeIntegrationSetting(
reader.Read(timeIntegrationSchemeIdColumn));
}
catch (ConversionException)
{
throw new CriticalFileReadException(Resources.HydraRingSettingsDatabaseReader_ValidateSchema_Hydraulic_calculation_settings_database_has_invalid_schema);
}
}
}
return null;
}
///
/// Reads the excluded locations (those for which no calculation is possible) from the database.
///
/// A of ids for all the excluded locations.
/// Thrown when a column that is being read doesn't
/// contain expected type.
public IEnumerable ReadExcludedLocations()
{
using (IDataReader reader = CreateExcludedLocationsDataReader())
{
while (MoveNext(reader))
{
yield return TryReadLocationIdColumn(reader);
}
}
}
///
/// Tries to read the from the .
///
/// The reader to read the column's value from.
/// The id of the location that was read from the .
/// Thrown when the
/// column contains a value of unexpected type.
private long TryReadLocationIdColumn(IDataReader reader)
{
try
{
return reader.Read(locationIdColumn);
}
catch (ConversionException)
{
throw new CriticalFileReadException(Resources.HydraRingSettingsDatabaseReader_ValidateSchema_Hydraulic_calculation_settings_database_has_invalid_schema);
}
}
///
/// Verifies that the schema of the opened settings database is valid.
///
/// Thrown when the
/// opened database doesn't have the expected schema.
private void ValidateSchema()
{
if (!ContainsRequiredTables(GetColumnDefinitions(Connection)))
{
CloseConnection();
throw new CriticalFileReadException(Resources.HydraRingSettingsDatabaseReader_ValidateSchema_Hydraulic_calculation_settings_database_has_invalid_schema);
}
}
private bool ContainsRequiredTables(List> definitions)
{
return GetValidSchema().All(definitions.Contains);
}
private IDataReader CreateDesignTablesDataReader(long locationId, HydraRingFailureMechanismType calculationType)
{
var locationParameter = new SQLiteParameter
{
DbType = DbType.Int64,
ParameterName = locationIdParameterName,
Value = locationId
};
var typeParameter = new SQLiteParameter
{
DbType = DbType.Int32,
ParameterName = calculationTypeIdParameterName,
Value = (int) calculationType
};
return CreateDataReader(
designTableSettingsForLocationAndCalculationTypeQuery,
locationParameter,
typeParameter);
}
private IDataReader CreateNumericsSettingsDataReader(long locationId, int mechanismId, int subMechanismId)
{
var locationParameter = new SQLiteParameter
{
DbType = DbType.Int64,
ParameterName = locationIdParameterName,
Value = locationId
};
var mechanismIdParameter = new SQLiteParameter
{
DbType = DbType.Int32,
ParameterName = mechanismIdParameterName,
Value = mechanismId
};
var subMechanismIdParameter = new SQLiteParameter
{
DbType = DbType.Int32,
ParameterName = subMechanismIdParameterName,
Value = subMechanismId
};
return CreateDataReader(
numericSettingsForLocationMechanismAndSubMechanismQuery,
locationParameter,
mechanismIdParameter,
subMechanismIdParameter);
}
private IDataReader CreateTimeIntegrationDataReader(long locationId, HydraRingFailureMechanismType calculationType)
{
var locationParameter = new SQLiteParameter
{
DbType = DbType.Int64,
ParameterName = locationIdParameterName,
Value = locationId
};
var typeParameter = new SQLiteParameter
{
DbType = DbType.Int32,
ParameterName = calculationTypeIdParameterName,
Value = (int) calculationType
};
return CreateDataReader(
timeIntegrationSettingsForLocationAndCalculationTypeQuery,
locationParameter,
typeParameter);
}
private IDataReader CreateExcludedLocationsDataReader()
{
return CreateDataReader(excludedLocationsQuery);
}
private List> GetValidSchema()
{
using (var validSchemaConnection = new SQLiteConnection("Data Source=:memory:"))
using (SQLiteCommand command = validSchemaConnection.CreateCommand())
{
validSchemaConnection.Open();
command.CommandText = Resources.settings_schema;
command.ExecuteNonQuery();
return GetColumnDefinitions(validSchemaConnection);
}
}
private static List> GetColumnDefinitions(SQLiteConnection connection)
{
DataTable columns = connection.GetSchema("COLUMNS");
var definitions = new List>();
for (var i = 0; i < columns.Rows.Count; i++)
{
DataRow dataRow = columns.Rows[i];
definitions.Add(
Tuple.Create(
((string) dataRow["TABLE_NAME"]).ToLower(),
((string) dataRow["COLUMN_NAME"]).ToLower()
));
}
return definitions;
}
}
}