Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>ASP.NET + MySQL — учебный помощникNew to Visual Studio Code? Get it now.
ASP.NET + MySQL — учебный помощник

ASP.NET + MySQL — учебный помощник

haouore

| (0) | Free
Docker Compose для ASP.NET и MySQL, памятка EF Scaffold и Avalonia для подготовки к ПМ.04.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

ASP.NET + MySQL — учебный помощник

Расширение для подготовки к ПМ.04: создаёт Docker Compose для API и MySQL и хранит эту памятку прямо в описании расширения. Работает без интернета; Docker-образы и NuGet-пакеты при первом использовании требуют загрузки.

Установка и использование

В VS Code: Extensions → меню «…» → Install from VSIX → выбери aspnet-mysql-study-helper-0.1.0.vsix. На Linux можно выполнить code --install-extension aspnet-mysql-study-helper-0.1.0.vsix.

Открой папку решения, нажми Ctrl+Shift+P → «Учёба: создать Docker Compose (ASP.NET + MySQL)», выбери API и порты. Или нажми правой кнопкой на .csproj API. Файлы появятся в корне выбранной workspace-папки, чтобы Docker видел проекты, на которые ссылается API. Все ProjectReference должны находиться внутри этой папки.

Создаются docker-compose.yml, Dockerfile.study, Dockerfile.study.dockerignore, DOCKER-STEPS.md. Существующие Compose и файлы генератора блокируют генерацию, чтобы не затереть настройки. Генерация запускается командой, а не автоматически при создании контейнера сторонним расширением.

Команда «Учёба: открыть памятку EF / API / Avalonia» открывает этот текст. Это же описание доступно на странице установленного расширения. Расширение не запускает команды терминала, не меняет Program.cs и не устанавливает пакеты.

Поддержаны стандартные Web SDK проекты с явным net8.0, net9.0 или net10.0. Нестандартный AssemblyName, несколько TargetFrameworks, свойства из Directory.Build.props и специальные символы в путях требуют ручной настройки. Шаблон предназначен для локальной учебной работы.

Порядок подготовки

  1. Выдели сущности, атрибуты, первичные и внешние ключи. Нарисуй связи.
  2. Запусти MySQL: docker compose up -d db. Создай нормализованные таблицы, тестовые данные и пользователей приложения.
  3. Получи Models и AppDbContext через scaffold.
  4. Подключи контекст к API. Сделай CRUD, проверку данных, вход и права.
  5. Собери API в контейнер: docker compose up -d --build.
  6. Сделай Avalonia-клиент: вход, список, поиск, добавление, редактирование, удаление, выход. Клиент обращается только к API.
  7. Проверь сценарии под каждой ролью и перезапуск контейнеров.

Нормализация на примере заказа

Не храни список товаров в одной строке и не повторяй телефон клиента в каждом заказе. Пример: Clients(Id, FullName, Phone), Orders(Id, ClientId, Date), Products(Id, Name, Price), OrderItems(OrderId, ProductId, Quantity, UnitPrice). OrderItems связывает заказ с товарами. Цена в позиции сохраняет стоимость на момент продажи.

1НФ — одно значение в ячейке, без списков. 2НФ — неключевые поля зависят от полного составного ключа. 3НФ — неключевые поля не зависят друг от друга. Выбирай decimal для денег, NOT NULL для обязательных полей, UNIQUE для логина, FK для связей. Поведение удаления связанных записей продумай заранее.

EF Core: сначала БД, затем код

Scaffold читает существующие таблицы; пустая БД не даст нужных моделей. В таблицах нужны первичные ключи. Команды ниже выполняются в папке API в Bash на Linux. Пример согласованной связки: EF Core 9 + Pomelo 9 (для .NET 8+); не смешивай EF 10 с Pomelo 9. Для уже настроенного проекта согласуй версии с его зависимостями.

dotnet add package Pomelo.EntityFrameworkCore.MySql --version 9.0.0
dotnet add package Microsoft.EntityFrameworkCore.Design --version '9.0.*'
# Один раз, если в решении ещё нет .config/dotnet-tools.json:
dotnet new tool-manifest
dotnet tool install dotnet-ef --version '9.0.*'
# Если инструмент уже установлен, используй dotnet tool update вместо install.
dotnet ef dbcontext scaffold 'Server=127.0.0.1;Port=3306;Database=examdb;User=exam;Password=exam_password' Pomelo.EntityFrameworkCore.MySql --output-dir Models --context-dir Data --context AppDbContext --no-onconfiguring

Если выбрал другой порт — возьми команду из DOCKER-STEPS.md. --no-onconfiguring не записывает строку подключения в сгенерированный контекст. Повторный scaffold с --force перезаписывает файлы: сначала сохрани изменения, собственную логику выноси в partial-классы и сервисы. Scaffold не создаёт контроллеры, авторизацию и формы Avalonia.

В Program.cs перед builder.Build() (замени namespace на свой):

using Microsoft.EntityFrameworkCore;
using MyApi.Data;

var builder = WebApplication.CreateBuilder(args);
var connection = builder.Configuration.GetConnectionString("DefaultConnection")
    ?? throw new InvalidOperationException("Нет строки подключения");
builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseMySql(connection, new MySqlServerVersion(new Version(8, 4, 0))));
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();

Это минимальный пример подключения, без авторизации. Для локального запуска API добавь в appsettings.Development.json:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=127.0.0.1;Port=3306;Database=examdb;User=exam;Password=exam_password"
  }
}

В контейнере Compose заменяет эту настройку через ConnectionStrings__DefaultConnection. Внутри API-контейнера localhost — сам API, поэтому адрес MySQL там db:3306. Avalonia на компьютере использует http://localhost:8080/. Имена контейнеров клиенту не нужны.

REST API и проверка прав

GET /api/products — список и поиск; GET /api/products/5 — одна запись; POST — создание; PUT /5 — изменение; DELETE /5 — удаление. Типичные ответы: 200, 201, 204, 400 (неверные данные), 401 (не вошёл), 403 (нет прав), 404 (не найдено), 409 (конфликт).

Применяй DTO: не принимай от клиента роль, пароль-хеш и чужой UserId как доверенные данные. Проверяй строки, диапазоны, внешние ключи и существование записи. Используй async/await и SaveChangesAsync. Возвращай DTO вместо графа EF-сущностей, чтобы не получить циклы навигационных свойств.

Авторизацию реализуй на API: пароль хешируй PasswordHasher или ASP.NET Core Identity, не храни открытым текстом. При JWT проверяй подпись, issuer, audience и срок действия; секрет держи вне исходников. Добавь AddAuthentication().AddJwtBearer(...), AddAuthorization(), затем UseAuthentication() и UseAuthorization() перед MapControllers(). На контроллерах используй [Authorize], на действиях — [Authorize(Roles = "Admin")]; вход — [AllowAnonymous]. Значения ролей должны совпадать с выданными claims.

Для роли «видит только своё» фильтруй записи по ID из проверенных claims на сервере. Скрытая кнопка в Avalonia не заменяет проверку прав API. Проверь, что пользователь не может изменить чужую запись, подменив ID в запросе.

Avalonia обращается только к API

Используй один переиспользуемый HttpClient, DTO и ViewModel. Минимальный фрагмент для авторизованного клиента:

using System.Net.Http;
using System.Net.Http.Headers;
using System.Net.Http.Json;

var http = new HttpClient { BaseAddress = new Uri("http://localhost:8080/") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
var products = await http.GetFromJsonAsync<List<ProductDto>>("api/products");

token получается от твоего endpoint входа; ProductDto должен соответствовать JSON API. Для POST/PUT используй PostAsJsonAsync/PutAsJsonAsync и проверяй StatusCode; для DELETE — DeleteAsync. Обрабатывай сетевые ошибки, 401/403 и валидацию, показывай понятное сообщение. Не используй .Result и .Wait() в UI. Список связывай с ObservableCollection, поля и команды — с ViewModel, уведомляющей об изменениях.

После входа покажи ФИО справа сверху. При выходе очисти токен, данные пользователя и списки, верни окно входа. MySQL-пароль не должен попадать в Avalonia. Для обычного настольного HttpClient CORS не требуется.

Docker: объясни каждую команду

docker compose up -d db запускает только БД. docker compose build api собирает образ API. docker compose up -d создаёт и запускает сервисы. docker compose up -d --build пересобирает API перед запуском. docker compose ps показывает состояние; docker compose logs api — логи. docker compose down убирает контейнеры и сеть, но сохраняет именованный том. docker compose down -v удаляет и данные — это сброс, а не обычная остановка.

Compose создаёт общую сеть автоматически. Healthcheck проверяет вход в examdb, а depends_on ждёт её готовности перед стартом API. Это ожидание первого запуска, а не автоматическое восстановление соединений после любой аварии БД. После изменения учётных данных YAML существующий том сохраняет старые пользователей и пароли.

Что проверить перед сдачей

  • Сущности и связи объяснимы, нет списков в столбцах, есть PK/FK.
  • Есть GET, POST, PUT, DELETE, просмотр и поиск, проверки входных данных.
  • Две роли действительно имеют разные права на API, работают ограничения «только своё».
  • Вход, ФИО, выход в окно входа работают; пароли не хранятся открыто.
  • Avalonia использует только API; API и MySQL в контейнерах и общей сети.
  • Данные сохраняются после down/up; команды сборки и запуска воспроизводимы.

Источники и разработка

  • EF Core Scaffold
  • Совместимость Pomelo
  • Порядок запуска Docker Compose
  • Упаковка расширений VS Code

Исходники — обычный JavaScript без runtime-зависимостей. Проверка: node --test test/*.test.js. Стандартная повторная упаковка при наличии Node/npm: npx @vscode/vsce package --allow-missing-repository. Расширение не опубликовано в Marketplace.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft