AdoNetShop: Твоя первая лабораторная по ADO.NET 🎓

Привет! Это учебный проект интернет-магазина. Его главная цель — показать тебе, как работает технология ADO.NET изнутри. Мы будем общаться с базой данных Microsoft SQL Server "вручную", без всяких умных прослоек вроде Entity Framework. Это нужно, чтобы ты понял самые основы.

---

📚 Немного скучной (но нужной) теории простыми словами

Что вообще такое ADO.NET?

Представь, что твоя программа (на C#) и база данных (SQL Server) говорят на разных языках и живут в разных городах. ADO.NET — это набор инструментов (переводчиков, почтальонов, телефонов), которые позволяют им общаться. Мы не используем ORM (Entity Framework), потому что ORM делает всё за тебя "под капотом". В этой лабе мы лезем под капот сами.

Зачем мы это учим?

1. Чтобы понимать, как всё работает на самом деле. Любая крутая ORM в итоге всё равно превращает свой код в команды ADO.NET.
2. Скорость и контроль. Иногда нужно написать супер-хитрый и быстрый запрос. Ручной SQL через ADO.NET даст тебе максимальную скорость.

Главные герои ADO.NET (Что нужно знать для защиты):

• 🔌 SqlConnection (Подключение): Это твой телефонный провод до базы данных. Чтобы что-то сказать базе, нужно поднять трубку (Open()), а потом обязательно положить её (Close(), или использовать конструкцию using).
• 📝 SqlCommand (Команда): Это то, что ты говоришь в трубку. Обычно это SQL-запросы (SELECT, INSERT и т.д.).
• 🛡️ SqlParameter (Параметр): Это твоя защита от злодеев. Никогда не склеивай SQL-строку плюсами (типа "SELECT * FROM Users WHERE Name = " + name). Хакерам хватит 5 минут, чтобы сломать базу через SQL-инъекцию. Мы передаем переменные только через параметры (@Name).
• 📖 SqlDataReader (Чтец данных): Представь, что база диктует тебе длиннющий список товаров по телефону. DataReader слушает и записывает строку за строкой. Он работает очень быстро, но только вперед и требует, чтобы телефонная линия (Connection) была открыта. (Это называется Connected подход).
• 📦 SqlDataAdapter и DataTable: А это другой подход. DataAdapter — это курьер. Он сам едет к базе, забирает все данные разом, привозит их тебе и кладет в коробку (DataTable в памяти компьютера). После этого он сам вешает трубку. Теперь ты можешь ковыряться в этой коробке сколько угодно, не занимая базу данных. (Это называется Disconnected подход).
• 🤝 Транзакция (SqlTransaction): Сделка по принципу "Всё или ничего". Представь перевод денег: списали у тебя, но не зачислили другу. Плохо! Транзакция гарантирует: если база начала делать заказ (создала заказ -> списала товары со склада -> добавила позиции), и вдруг свет моргнул на списании склада — она отменит всё обратно (Rollback). Если всё супер — закрепит (Commit).

---

🚀 Как запустить эту штуку на твоем компе

Чтобы проект заработал, тебе нужны две вещи: работающая база данных и запущенный код.

Шаг 1: Готовим Базу Данных

1. Убедись, что у тебя установлен Microsoft SQL Server (подойдет версия Express) и программа для управления им, например, SQL Server Management Studio (SSMS).
2. Открой папку database в этом проекте.
3. Открой SSMS и подключись к своему серверу.
4. Выполни скрипты строго по очереди:
   • ▶️ Сначала выполни код из файла 01_create_database.sql (Это создаст пустую БД).
   • ▶️ Затем 02_create_tables.sql (Создаст нужные таблички).
   • ▶️ Затем 03_insert_data.sql (Заполнит их тестовыми товарами и клиентами).

Шаг 2: Настраиваем проект

1. Открой файл AdoNetShop/appsettings.json.
2. Найди там строку ConnectionStrings -> DefaultConnection.
3. Тебе нужно сказать программе, как зовут твой SQL сервер.
   • Если у тебя обычный разработческий SQL, оставь Server=localhost.
   • Если ты ставил SQL Server Express, скорее всего тебе нужно поменять это на Server=.\\SQLEXPRESS.

Шаг 3: Запускаем!

1. Открой терминал (или командную строку) в папке AdoNetShop (там, где лежит файл .csproj).
2. Напиши команду: dotnet run
3. Должно появиться красивое консольное меню магазина.

---

👨‍🏫 Что показывать преподавателю на защите?

Препод точно спросит, где и как ты использовал ADO.NET. Вот твоя шпаргалка:

1. Как ты подключаешься к базе?
   • Покажи файл Data/DbConnectionFactory.cs. Расскажи, что строку подключения ты берешь из конфига (это хорошая практика!), а не хардкодишь в коде.
2. Как работает CRUD (Создание, Чтение, Обновление, Удаление)?
   • Открой Data/ProductRepository.cs.
   • Покажи метод GetByIdAsync. Обрати внимание на SqlCommand и то, как ты добавляешь параметры (command.Parameters.Add). Расскажи про SqlDataReader.
   • Покажи метод CreateAsync. Обрати внимание на ExecuteScalarAsync — объясни, что он нужен, чтобы база вернула тебе ID только что созданного товара.
3. Где у тебя транзакция?
   • Гордо открывай Data/OrderRepository.cs и показывай метод CreateOrderWithTransactionAsync.
   • Объясни: "Сначала мы открываем транзакцию. Потом пытаемся создать заказ и списать товары. Если хоть одного товара нет на складе, я выбрасываю ошибку, код прыгает в блок catch, и делает RollbackAsync() — отменяет всё. Если всё гладко — CommitAsync()".
   • Для эффекта: Запусти программу, нажми пункт "8" и попробуй купить 1000 ноутбуков (их столько нет). Покажи, что заказ не создался.
4. А где Disconnected подход (отсоединенная модель)?
   • Открой пункт меню "10" в запущенной программе.
   • Открой метод GetProductsTableAsync в ProductRepository.cs.
   • Покажи класс SqlDataAdapter и DataTable. Объясни, что курьер (адаптер) сам сбегал в базу, залил всё в таблицу и разорвал связь с БД.

Удачи на защите! Ты справишься! 💪