public void RenameDeployedAttribute(Attribute attribute, string newAttributeName)
{
if (attribute is null)
{
throw new ArgumentNullException(nameof(attribute));
}
if (newAttributeName is null)
{
throw new ArgumentNullException(nameof(newAttributeName));
}
Table table = _tableService.GetTableById(tableId: attribute.TableId);
Database database = _databaseService.GetById(id: table.DatabaseId);
_sqlExecutor.Execute(
sqlConnectionString: database.ConnectionString,
sqlExpression: _attributeSqlExpressionProvider
.Rename(attribute: attribute, newValidName: newAttributeName));
}
public void DropDeployedAttribute(Attribute attribute)
{
switch (attribute)
{
case null:
throw new ArgumentNullException(nameof(attribute));
case PrimaryKey _:
case ForeignKey _:
throw new ArgumentException($"The attribute {attribute.Name} is primary or foreign key.");
}
Table table = _tableService.GetTableById(tableId: attribute.TableId);
Database database = _databaseService.GetById(id: table.DatabaseId);
_sqlExecutor.Execute(
sqlConnectionString: database.ConnectionString,
sqlExpression: _attributeSqlExpressionProvider
.Delele(attribute: attribute));
}
private static void ApiExample()
{
// API
#region 1_DATABASE
#region 1.1 Создание базы данных.
// Для содания новой базы данных (включая также сохранение её в метаданных)
// необходимо вызвать метод CreateDatabase, единственным параметром которого
// является имя новой БД.
// Имя БД должно быть уникальным, начинаться не с цифры и состоять только из
// русских или английских букв и знака подчеркивания (мин. длина - 1, макс. - 64).
// Если потенциальное имя не пройдет валидацию, будет вызвано исключение типа
// ArgumentException.
// Если переменная с именем будет содержать ссылку на null, будет вызвано
// исключение типа ArgumentNullException.
try
{
App.CreateDatabase("TempDatabase"); // Ок, если ранее бд с таким именем не создавалась
Console.WriteLine("Новая база данных успешно создана и сохранена.");
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при создании базы данных: " + e.Message);
}
#endregion
#region 1.2 Получение экземпляров БД.
// Для получения всех сохраненных ранее экземпляров БД необходимо вызвать GetAllDatabases.
// Если ранее не было создано ни одно экземпляра, будет возвращено значение NULL.
IEnumerable <Database> allDatabases = App.GetAllDatabases();
if (allDatabases != null)
{
Console.WriteLine("База метаданных содержит ранее созданные экземпляры.");
}
else
{
Console.WriteLine("База метаданных пуста.");
}
// Кроме того, для того чтобы получить ссылку на экземпляр БД, нужно вызвать GetDatabaseByName или
// GetDatabaseById с соответствующим параметром. Если соответствующей базы данных не существует,
// будет возвращено значение NULL.
const string databaseName = "TempDatabase";
Database sales = null;
try
{
sales = App.GetDatabaseByName(name: databaseName);
sales = App.GetDatabaseById(id: sales.Id);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при получении экземпляра БД. " + e.Message);
}
if (sales != null)
{
Console.WriteLine($"Получена база данных с именем {sales.Name}");
}
else
{
Console.WriteLine($"Похоже базы данных с именем {databaseName} не существует.");
}
#endregion
#region 1.3 Изменение экземпляров БД
// У существующей базы данных можно изменить только имя. Для того, чтобы сделать это,
// необходимо вызвать RenameDatabase и указать в параметре новое имя. Правила валидации и возможные
// исключительные ситуации описаны в пункте 1.1.
try
{
Console.WriteLine($"Изменение имени существующей БД {sales?.Name}..");
App.RenameDatabase(database: sales, databaseName: "TempDatabaseRenamed");
Console.WriteLine($"Существующая БД успешно переименована. Новое имя: {sales?.Name}");
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при изменении существующей БД: " + e.Message);
}
#endregion
#region 1.4 Удаление экземпляров БД
// Удалить БД можно с помощью метода RemoveDatabase. Так как каскадное удаление для
// экземпляров Link отключено, сначала удаляются все связанные с БД ссылки, а
// затем сама база данных.
if (sales != null)
{
int salesId = sales.Id; // Сохранение id для проверки удаления
Console.WriteLine("Удаление существующей БД..");
App.RemoveDatabase(database: sales);
if (App.GetDatabaseById(id: salesId) is null)
{
Console.WriteLine("Существующая база данных была успешно удалена.");
}
else
{
Console.WriteLine("Похоже, база данны еще существует...");
}
}
else
{
Console.WriteLine("База данных уже была удалена ранее.");
}
#endregion
#endregion
#region 2_TABLES
// Тестовая бд Sales для демонстрации работы с таблицами:
try
{
App.CreateDatabase("Sales");
}
catch (ArgumentException e)
{
Console.WriteLine("Database creation failure:" + e.Message);
}
sales = App.GetDatabaseByName("Sales");
#region 2.1 Создание таблиц
// Для создания таблиц необходима существующая база данных. Создание новой
// таблицы осуществляется методом AddTable, у которого в параметрах должны быть
// существующая БД и имя создаваемой таблицы. Правила валидации и возможные исключения
// для имен таблиц аналогичны правилам для имен баз данных (пункт 1.1).
// При передаче значения null в качестве любого из параметров будет вызвано исключение
// ArgumentNullException.
// При создании таблицы первичный ключ с именем Id будет создан автоматически.
try
{
App.AddTable(database: sales, name: "Users");
App.AddTable(database: sales, name: "Customers");
App.AddTable(database: sales, name: "Orders");
Console.WriteLine("Таблицы успешно созданы и добавлены.");
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при создании таблицы: " + e.Message);
}
#endregion
#region 2.2 Получение экземпляров таблиц
// Метод GetDatabaseTables служит для получения всех таблиц,
// принадлежащих какому-то определенному экземпляру БД, который передается через параметр.
// Если у базы данных нет таблиц, будет возвращено значение NULL.
// При передаче значения null в качестве лэкземпляра БД будет вызвано исключение
// ArgumentNullException.
IEnumerable <Table> databaseTables = null;
try
{
databaseTables = App.GetDatabaseTables(database: sales);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при получении экземпляров таблиц: " + e.Message);
}
if (databaseTables != null)
{
foreach (Table table in databaseTables)
{
Console.WriteLine($"База данных {sales.Name} содержит таблицу {table.Name}.");
}
}
else
{
Console.WriteLine($"База данных {sales.Name} не содержит таблиц.");
}
#endregion
#region 2.3 Получение таблиц по имени или Id
// Для получения таблицы по имени необходимо вызвать метод GetTableByName, указав БД,
// которой принадлежит таблица, а также её имя. Если талицы с таким именем нет, будет
// возвращено значение null.
// При передаче значения null в качестве любого из параметров будет вызвано исключение
// ArgumentNullException.
Table usersTable = null, customersTable = null, ordersTable = null;
try
{
usersTable = App.GetTableByName(database: sales, name: "Users");
customersTable = App.GetTableByName(database: sales, name: "Customers");
ordersTable = App.GetTableByName(database: sales, name: "Orders");
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при получении таблиц. " + e.Message);
}
if (usersTable != null &&
customersTable != null &&
ordersTable != null)
{
Console.WriteLine("Таблицы успешно получны по их именам.");
}
else
{
Console.WriteLine("Ошибка при получении таблиц по именам.");
}
// Для получения таблицы по её Id, необходимо вызвать GetTableById (передав только Id таюлицы).
if (ordersTable != null)
{
ordersTable = App.GetTableById(id: ordersTable.Id);
}
if (ordersTable != null)
{
Console.WriteLine("Таблица успешно получена по Id.");
}
else
{
Console.WriteLine("Ошибка при получении таблицы по Id.");
}
#endregion
#region 2.4 изменение таблиц
// У таблиц можно изменить имя. Правила валидации и возможные исключения описаны в 1.1.
try
{
App.RenameTable(table: usersTable, tableName: "SomeName");
}
catch (ArgumentException e)
{
Console.WriteLine($"Ошибка при изменении имени таблицы {usersTable?.Name}. " + e.Message);
}
#endregion
#region 2.5 Удаление таблиц
if (usersTable != null)
{
int tableId = usersTable.Id;
App.RemoveTable(table: usersTable);
if (App.GetTableById(id: tableId) is null)
{
Console.WriteLine("Удаление таблицы прошло успешно.");
}
else
{
Console.WriteLine("Похоже таблица не была удалена..");
}
}
else
{
Console.WriteLine("Таблица уже была удалена ранее.");
}
#endregion
#endregion
#region 3_ATTRIBUTES
#region 3.1 Добавление атрибута
// Для добавления атрибута нужно вызвать один из методов:
// AddStringAttribute, AddIntegerAttribute, AddDecimalAttribute, AddRealAttribute
// в зависимости от необходимого типа. При создании обязательно необходимо указать родительскую таблицу,
// а также уникальное имя (правила валидации и возможные исключительные ситуации в п. 1.1.).
// Остальные допустимые параметры, такие как isNullable, необязательны (если их не указать, параметры
// будут иметь значения по умолчанию).
try
{
App.AddStringAttribute(table: customersTable, name: "FirstName", isNullable: false, length: 50);
App.AddStringAttribute(table: customersTable, name: "Surname", isNullable: false, length: 70);
App.AddIntegerAttribute(table: customersTable, name: "Age");
App.AddStringAttribute(table: ordersTable, name: "ItemName", isNullable: false, length: 25);
App.AddDecimalAttribute(table: ordersTable, name: "Price", isNullable: false, precision: 8, scale: 2);
App.AddStringAttribute(table: ordersTable, name: "Other");
Console.WriteLine("Атрибуты успешно добавлены.");
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при добавлении атрибутов. " + e.Message);
}
#endregion
#region 3.2 Получение атрибута
// Для получения атрибута необходимо вызвать метод GetAttributeByName,
// указав родительскую таблицу и имя. Если такого атрибута нет, будет получено значение null.
_Attribute otherAttribute = null;
try
{
otherAttribute = App.GetAttributeByName(table: ordersTable, name: "Other");
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при получении атрибута." + e.Message);
}
if (otherAttribute != null)
{
Console.WriteLine("Атрибут успешно получен.");
}
else
{
Console.WriteLine("Ошибка при получении атрибута.");
}
// Помимо этого, можно получить все атрибуты конкретной таблицы, вызвав метод
// GetTableAttributes с параметром-таблицей.
IEnumerable <_Attribute> attributes = App.GetTableAttributes(table: ordersTable);
#endregion
#region 3.3 Изменение имени атрибута
// Правила валидации имени подобны правилам валидации для БД и описаны в 1.1.
try
{
App.RenameAttribute(attribute: otherAttribute, name: "SomeAttribute");
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при изменении имени атрибута. " + e.Message);
}
#endregion
#region 3.4 Удаление атрибута
try
{
App.RemoveAttribute(attribute: otherAttribute);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при удалении атрибута. " + e.Message);
}
#endregion
#endregion
#region 4_LINKS
#region 4.1 Добавление связи один-ко-многим
// Приложение может хранить ссылки (связи) типа один-ко-многим.
// Для создания ссылки необходимо указать главную (master) и подчиненную (slave)
// таблицы. При этом в подчиненной таблице будет создан атрибут - внешний ключ.
try
{
App.AddLink(masterTable: customersTable, slaveTable: ordersTable);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при создании связи." + e.Message);
}
#endregion
#region 4.4 Получение ссылки
Link newLink = App.GetLink(masterTable: customersTable, slaveTable: ordersTable);
#endregion
#region 4.2 Получение всех ссылок базы данных
IEnumerable <Link> salesLinks = null;
try
{
salesLinks = App.GetDatabaseLinks(database: sales);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при получении ссылок. " + e.Message);
}
#endregion
Link link = salesLinks.FirstOrDefault();
#region 4.3 Удаление ссылки
try
{
// App.RemoveLink(link);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при удалении ссылки. " + e.Message);
}
#endregion
#endregion
#region 5_DEPLOY
#region 5.1 Проверка на возможность развертывания существующей БД
// Метод проверяет, что у всех таблиц есть первичный ключ
try
{
bool deployable = App.IsDatabaseDeployable(database: sales);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при запросе возможности развертывания." + e.Message);
}
#endregion
#region 5.2 Развертывание
try
{
App.DeployDatabase(database: sales);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при развертывании. " + e.Message);
}
#endregion
#region 5.3 Проверка на наличие уже развернутой аналогичной БД
try
{
bool deployed = App.IsDatabaseDeployed(database: sales);
}
catch (ArgumentException e)
{
Console.WriteLine("ошбика при проверке возможности развертывания. " + e.Message);
}
#endregion
#region 5.4 Обновление развернутой БД
// Изменение нескольких параметров в процессе работы с БД..
App.RenameDatabase(database: sales, databaseName: "SuperSales");
App.RenameTable(table: customersTable, tableName: "SuperCustomers");
_Attribute age = App.GetAttributeByName(table: customersTable, name: "Age");
App.RenameAttribute(attribute: age, name: "SuperAge");
// Обновление
try
{
App.UpdateDeployedDatabase(database: sales);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при обновлении развернутой БД. " + e.Message);
}
#endregion
#region 5.5 Удаление развернутой БД
try
{
//App.DropDeployedDatabase(database: sales);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошибка при удалении развернутой базы данных. " + e.Message);
}
#endregion
#endregion
#region 6_CRUD
#region 6.1 Insert
// Заполнение коллекции вставляемыми данными
attributes = App.GetTableAttributes(table: customersTable);
Dictionary <_Attribute, string> values = new Dictionary <_Attribute, string>();
foreach (_Attribute attribute in attributes)
{
switch (attribute)
{
case PrimaryKey _:
case ForeignKey _:
continue;
case String a:
values[key : a] = "SomeString";
break;
case IntegerNumber i:
values[key : i] = "22";
break;
}
}
// Непосредственно вставка
int rowsAffected = -1;
try
{
rowsAffected = App.InsertData(table: customersTable, values: values);
}
catch (ArgumentException e)
{
Console.WriteLine("Ошбика при вставке значений: " + e.Message);
}
Console.WriteLine($"При вставке затронуто строк: {rowsAffected}");
#endregion
#region 6.2 Select all
IEnumerable <IDictionary <_Attribute, object> > selectResult = App.SelectAll(table: customersTable);
foreach (IDictionary <_Attribute, object> tuple in selectResult)
{
Console.WriteLine(tuple.Keys.Aggregate("Строка: ", (sum, attr) => $"{sum}, {tuple[key: attr]}"));
private void RenameAttributeButton_Click(object sender, EventArgs e)
{
if (DatabasesTree.SelectedNode != null &&
DatabasesTree.SelectedNode.Level == 2)
{
try
{
DatabaseCreationForm renameAttributeForm = new DatabaseCreationForm();
if (DatabasesTree.Nodes.Count != 0)
{
foreach (TreeNode treeviewNodes in DatabasesTree.Nodes)
{
_nodes.Add(treeviewNodes.Text);
}
}
renameAttributeForm.SetNodes(_nodes);
renameAttributeForm.SetTextboxValue(DatabasesTree.SelectedNode.Text);
renameAttributeForm.Text = @"Переименновать атрибут";
renameAttributeForm.dbNameLabel.Text = @"Введите новое название атрибута";
Database parentDatabase = _app.GetDatabaseByName(DatabasesTree.SelectedNode.Parent.Parent.Text);
Table parentTable = _app.GetTableByName(parentDatabase, DatabasesTree.SelectedNode.Parent.Text);
Attribute selectedAttribute =
_app.GetAttributeByName(parentTable, DatabasesTree.SelectedNode.Text);
if (!selectedAttribute.IsPrimaryKey && !(selectedAttribute is ForeignKey))
{
renameAttributeForm.Show();
}
else
{
MessageBox.Show(@"Нельзя переименовать уникальный идентификатор!");
}
renameAttributeForm.FormClosing += (obj, args) =>
{
if (renameAttributeForm.InputText == string.Empty)
{
return;
}
try
{
if (!selectedAttribute.IsPrimaryKey && !(selectedAttribute is ForeignKey))
{
_app.RenameAttribute(selectedAttribute, renameAttributeForm.InputText);
showDatabases();
}
else
{
MessageBox.Show(@"Нельзя переименовать уникальный идентификатор!");
}
}
catch (ArgumentException exception)
{
MessageBox.Show(exception.Message);
}
};
}
catch (NullReferenceException exception)
{
MessageBox.Show(@"Нулевая ссылка: " + exception.Message);
}
}
else
{
MessageBox.Show(@"Выберите таблицу для переименования!");
}
#endregion RenameAttributeButton
// проверить уделение связей, изменить ренейминг ID
}