Как работают B-tree наглядно

👉 @KodBlog

Понимание, почему Type.FullName может возвращать null в .NET

Недавно коллега спросил интересную вещь: почему Type.FullName в некоторых случаях возвращает null? Хотя кажется, что метод должен всегда отдавать строку, сигнатура намекает на исключения:

public abstract string? FullName { get; }

На первый взгляд это может показаться странным, но есть конкретные ситуации, когда рантайм .NET просто не может сформировать валидное полное имя типа. Ниже два основных случая, когда Type.FullName возвращает null.

1. Открытые дженерики

Если создать дженерик с несвязанными (unbound) параметрами:

var list = typeof(IList<>);
var dict = typeof(IDictionary<,>);
var listOfDictionaries = list.MakeGenericType(dict); // IList<IDictionary<,>>
Assert.Null(listOfDictionaries.FullName);

Здесь тип неполный, его параметры не конкретизированы, поэтому нормальное FullName создать невозможно.

2. Function Pointers

Функциональные указатели, появившиеся в C# 9, тоже отдают null в FullName:

var functionPointerType = typeof(delegate*<int, void>);
Assert.Null(functionPointerType.FullName);

В обоих случаях поведение задумано и соответствует спецификации: если тип не может быть корректно представлен в виде имени, FullName будет null.

👉 @KodBlog

Есть разработчик, который провалил собеседование, потому что не знал, как работают блокировки в C#.

Задача была вроде обычная: API конвертации валют + кэш. Но при большом количестве параллельных запросов возникал риск cache stampede. Он попытался решить это через lock, но метод был async. А lock с async-await не работает. Логично: никто не гарантирует, какой поток завершит выполнение.

Правильный вариант в таких случаях — асинхронные примитивы синхронизации вроде SemaphoreSlim, Semaphore, Mutex или Monitor.

Два базовых правила при работе с таким кодом:

1. Использовать timeout
2. Освобождать блокировку в try-finally

И напоследок хороший вопрос:

как реализовать блокировку на уровне базы данных?

🚬

Кому интересно — ответ

👉 @KodBlog

Вот упрощённая схема потока service discovery в .NET Aspire

1. Определить API-сервис
2. Frontend ссылается на API-сервис
3. Внедрить URL API в настройки приложения
4. Создать HTTP-клиент
5. Получить URL из настроек приложения
6. https://api-service

А вот и полная картина

👉 @KodBlog

VS Code выкатывает новую фичу в терминале, и это просто имба.

Если нужно выполнить команду, но ты не помнишь синтаксис или точный аргумент, больше не надо гуглить или вспоминать по памяти. Достаточно нажать Ctrl+i прямо в терминале. Вылезет компактное окно с чатом.

Дальше всё просто: пишешь нормальным человеческим языком, что хочешь сделать. VS Code сам определит нужную команду и выполнит её.

👉 @KodBlog

Используем insteadOf в Git для Замены HTTPS-адресов на SSH

При работе с Git-репозиториями вы часто сталкиваетесь с URL-адресами в формате HTTPS, особенно при клонировании из GitHub, GitLab или других хостинг-провайдеров. Однако, если вы предпочитаете использовать SSH для аутентификации (что часто удобнее с аутентификацией по ключам), ручное изменение URL-адресов может быть утомительным. Кроме того, это может быть ещё сложнее при работе с субмодулями.

Конфигурационная опция Git insteadOf предлагает элегантное решение, автоматически переписывая URL-адреса «на лету»:

git config --global url."[email protected]:".insteadOf "https://github.com/"
git config --global url."[email protected]:".insteadOf "https://gitlab.com/"
git config --global url."[email protected]:".insteadOf "https://bitbucket.org/"

Вы также можете настроить более конкретную проверку и выбрать только определённые репозитории или сервисы. Например, если вы хотите заменить HTTPS-адреса некоторых репозиториев, вы можете сделать следующее:

git config --global url."[email protected]:username/".insteadOf "https://github.com/username/"

После настройки Git будет автоматически переписывать URL:

# Следующая команда
git clone https://github.com/user/repo.git

# Станет эквивалентной
git clone [email protected]:user/repo.git

Перезапись происходит прозрачно. Вы по-прежнему можете использовать HTTPS-адреса в командах, документации или при копировании из веб-интерфейсов.

Ещё один вариант использования insteadOf — добавление аутентификации к URL. Например, если вы хотите использовать определённого пользователя для всех запросов Git, вы можете сделать следующее:

git config --global url."https://<token>@github.com/".insteadOf "https://github.com/"

👉 @KodBlog

Удаление пробелов в .NET: что быстрее

На Хабре вышло сравнение разных способов убрать пробелы из строки в .NET: Replace, Regex, Split+Concat, StringBuilder, буферы и stackalloc. Тестировали на .NET 3.1, .NET 8 и .NET 10.

Результаты:

- stackalloc и буферный подход оказались самыми быстрыми
- StringBuilder почти не отстаёт
- Split+Concat работает шустро, но жрет память
- у Regex в .NET 10 заметно выросла производительность

Автор напоминает, результат зависит от реальных данных, так что лучше тестировать под свой кейс.

Подробнее тут: habr.com/ru/companies/skbkontur/articles/970178/

👉 @KodBlog

Один разработчик поделился экспериментом: он пересмотрел видео tsoding про работу с PPM-форматом и повторил всё на C#. При этом отметил, что реализация на C выглядит куда компактнее, но сама идея остаётся простой и понятной.

PPM выбран ради простоты. Формат состоит из текстового заголовка с описанием параметров изображения, а дальше идут байты по три штуки на пиксель, которые задают RGB.

Для динамики он сгенерировал 60 изображений, а затем собрал их в видео через ffmpeg. На каждом шаге узор немного смещался, и в результате получилась анимация движущейся шахматной сетки.

Классная мини-задача. Очень советую.

Производительность не была для меня целью, поэтому я не обращал на это внимания.

👉 @KodBlog

Как сделать API-эндпоинты быстрее в 426 раз
(подсказка: дело не в кешe)

Когда разработчики видят медленный API, первая реакция: лечить всё кешем.

Но это ошибка в базовом понимании:
кеш не фиксит тормоза, если корень проблемы в кривых запросах к базе.

Поэтому первый шаг к масштабируемой системе — пофиксить её, а не обклеить кешами.

Небольшой эксперимент:

есть веб-API с одним эндпоинтом /products

До оптимизации:

Обработано запросов: 378
Средний RPS: 11.01
Средняя длительность запроса: ~4 секунды

После оптимизации:

Обработано запросов: 140 331
Средний RPS: 4 689.36
Средняя длительность запроса: 10.69 мс

Сначала фикси доступ к данным.
Потом уже используй кеш, чтобы масштабироваться, а не выживать.

👉 @KodBlog

Использование выражений коллекций для своих типов

В C# 12 появились выражения коллекций — упрощённый синтаксис для инициализации коллекций:

int[] numbers = [1, 2, 3, 4, 5];
List<string> names = ["Alice", "Bob", "Charlie"];

Такой синтаксис отлично работает со стандартными коллекциями, но что делать с собственными типами? Здесь пригодится атрибут CollectionBuilderAttribute, который позволяет подключить этот новый синтаксис к пользовательским коллекциям.

Пользовательские коллекции

Допустим, у вас есть свой тип коллекции:

public class MyCollection<T>
{
private readonly List<T> _items;

public MyCollection(ReadOnlySpan<T> items) =>
_items = [.. items];

public IEnumerator<T> GetEnumerator()
=> _items.GetEnumerator();

// другие члены…
}

Раньше вы не могли использовать выражения коллекций с таким типом. Приходилось писать по-старинке:

var myCol =
new MyCollection<int>(new[] { 1, 2, 3, 4, 5 });

Или так (что сути почти не меняет):

var myCol =
new MyCollection<int>([1, 2, 3, 4, 5]);

Не особо изящно.

Атрибут CollectionBuilderAttribute решает проблему, подсказывая компилятору, как собирать вашу коллекцию из выражения коллекции:

[CollectionBuilder(typeof(MyCollectionBuilder),
nameof(MyCollectionBuilder.Create))]
public class MyCollection<T>
{
//…
}

public static class MyCollectionBuilder
{
public static MyCollection<T>
Create<T>(ReadOnlySpan<T> items)
=> new([..items]);
}
Теперь можно писать так:
MyCollection<int> myCol = [1, 2, 3, 4, 5];

Компилятор сам вызовет метод Create и передаст ему элементы.

Как это работает

Атрибут принимает два параметра:

Тип построителя — класс, в котором находится фабричный метод (typeof(MyCollectionBuilder));

Имя метода — имя статического метода, создающего объект коллекции ("Create").

Метод построителя должен:

- быть статическим;
- принимать ReadOnlySpan<T> (предпочтительно) или T[];
- возвращать экземпляр вашей коллекции;
- иметь параметры типов, совпадающие с параметрами коллекции.

Замечание: коллекция должна иметь «тип итерации», то есть метод GetEnumerator(), который возвращает IEnumerator или IEnumerator<T>. Можно реализовать IEnumerable / IEnumerable<T>, либо просто добавить метод GetEnumerator() вручную.

Когда все условия выполнены, компилятор сможет генерировать нужный код и создавать вашу коллекцию максимально эффективно.

👉 @KodBlog

Вот моё любимое правило в .editorconfig:

-> Правила именования для async-методов и полей

Задайте понятные правила именования для приватных полей, async-методов, интерфейсов и так далее.

Зачем? это убирает путаницу при работе с async-API и делает намерения очевидными.

Если кто не в курсе:

.editorconfig — это обычный текстовый конфиг, который сообщает вашему редактору или IDE, как форматировать и оформлять код, чтобы весь проект выглядел одинаково, независимо от личных настроек каждого разработчика.

Он работает во многих языках и IDE (Visual Studio, VS Code, JetBrains Rider и прочих), а в .NET особенно полезен, потому что встроен в Roslyn-анализаторы и настройки стиля кода.

👉 @KodBlog

Это расширение для Chrome очень полезно для тех, кто сидит на GitHub.

Называется SimRepo. Оно показывает похожие репозитории для любого репо, который ты открываешь.

Просто устанавливаешь расширение, и оно автоматически срабатывает каждый раз, когда ты заходишь в любой репозиторий.

👉 @KodBlog

Сжатие запросов HttpClient с помощью GZIP

Если отправляешь большие файлы во внешний API, логично сжимать их перед отправкой. Но наивная реализация легко убивает память.

Проблемный вариант

Сжатие происходит полностью в MemoryStream, а потом уже уходит в запрос:

internal async ValueTask<HttpRequestMessage>
 CreateRequest(Uri uri, Stream source)
{
  var outStream = new MemoryStream();
  await using (var zip = 
   new GZipStream(outStream, 
    CompressionMode.Compress,
    leaveOpen: true))
   {
     await source.CopyToAsync(zip);
     zip.Close();
   }
   outStream.Position = 0;

   var request = new HttpRequestMessage(
    HttpMethod.Post, uri)
   {
     Content = new StreamContent(outStream)
   };
   request.Content.Headers.ContentEncoding.Add("gzip");
   return request;
}

Использование:

var uri = new Uri("https://my.api/endpoint");
var file = File.OpenRead("largefile.txt");
var request = await CreateRequest(uri, file);
await httpClient.SendAsync(request);

Работает нормально, пока не начинаешь слать много запросов.
Вся gzip-копия каждый раз полностью живет в памяти.

Правильное решение: сжатие на лету

public class GzipContent : HttpContent
{
  private readonly Stream _source;

  public GzipContent(Stream source)
  {
    _source = source;
    Headers.ContentEncoding.Add("gzip");
  }

  protected override async Task 
   SerializeToStreamAsync(
    Stream stream,
    TransportContext? context)
  {
    await using var zip = 
     new GZipStream(stream,
      CompressionMode.Compress,
      leaveOpen: true);
    await _source.CopyToAsync(zip);
  }

  protected override bool
   TryComputeLength(out long length)
  {
    length = -1;
    return false;
  }
}

Переделываем CreateRequest:

internal ValueTask<HttpRequestMessage>
 CreateRequest(Uri uri, Stream source)
{
  return ValueTask.FromResult(
   new HttpRequestMessage(HttpMethod.Post, uri)
  {
    Content = new GzipContent(source)
  });
}

Использование остается тем же, а память больше не пухнет.

Производительность (.NET 10)

По времени почти без разницы,
а вот по памяти разница огромная:

| File | Method| Mean   | Ratio| Allocated| Alc Rat |
|-----:|-------|-------:|-----:|---------:|--------:|
|   7KB| Memory| 633.3us|  1.00|    6.35KB|     1.00|
|   7KB| Gzip  | 603.5us|  0.96|    4.77KB|     0.75|
| 200KB| Memory| 8.025ms|  1.00|  508.52KB|    1.000|
| 200KB| Gzip  | 7.260ms|  0.90|    4.74KB|    0.009|
|   3MB| Memory| 94.97ms|  1.00| 8189.99KB|    1.000|
|   3MB| Gzip  | 86.02ms|  0.91|    4.82KB|    0.001|

Чем больше файл, тем сильнее эффект.

PS: .NET API может автоматически распаковывать запросы. Достаточно добавить соответствующее промежуточное ПО:

builder.Services.AddRequestDecompression();

// …

app.UseRequestDecompression();

👉 @KodBlog

Синтаксическое сжатие строк даёт больше вертикального пространства в редакторе. Строки без букв и цифр сжимаются на 25%, благодаря чему на экране помещается больше кода без потери читаемости.

Скоро в Visual Studio.

👉 @KodBlog

Используем COPY для Экспорта/Импорта Данных в PostgreSQL

В PostgreSQL есть функция COPY, которая позволяет эффективно выполнять массовый импорт и экспорт данных в таблицу и из неё. Обычно это гораздо быстрее, чем работать через INSERT или SELECT.

В .NET провайдер Npgsql поддерживает три режима работы с COPY: бинарный, текстовый и бинарный необработанный.

1. Бинарный

В этом режиме вы используете API для чтения и записи строк и полей, которые Npgsql кодирует и декодирует. После завершения нужно вызвать метод Complete() для сохранения данных; иначе операция будет отменена при освобождении объекта записи (важно учитывать при возникновении исключений).

// Импорт в таблицу с 2 полями (string, int)
using (var writer = conn.BeginBinaryImport(
 "COPY my_table (field1, field2) FROM STDIN (FORMAT BINARY)"))
{
  writer.WriteRow("Row1", 123);
  writer.WriteRow("Row2", 123);

  writer.Complete();
}

// Экспорт из таблицы с 2 полями
using (var rdr = conn.BeginBinaryExport(
 "COPY my_table (field1, field2) TO STDOUT (FORMAT BINARY)"))
{
  rdr.StartRow();
  Console.WriteLine(rdr.Read<string>());
  Console.WriteLine(rdr.Read<int>(NpgsqlDbType.Smallint));

  rdr.StartRow();
  rdr.Skip();            // пропустить поле
  Console.WriteLine(rdr.IsNull); // проверить на NULL
  Console.WriteLine(rdr.Read<int>());

  rdr.StartRow();
  // StartRow() вернёт -1, если данных больше нет
}

2. Текстовый

Данные передаются в текстовом или CSV-формате PostgreSQL. Пользователь самостоятельно форматирует строки или CSV, Npgsql лишь предоставляет методы для чтения и записи текста. Этот режим менее эффективен, чем бинарный, но удобен, если данные уже есть в CSV и высокая производительность не критична.

using (var writer = conn.BeginTextImport(
 "COPY my_table (field1, field2) FROM STDIN"))
{
  writer.Write("HELLO\t1\n");
  writer.Write("GOODBYE\t2\n");
}

using (var reader = conn.BeginTextExport(
 "COPY my_table (field1, field2) TO STDOUT"))
{
  Console.WriteLine(reader.ReadLine());
  Console.WriteLine(reader.ReadLine());
}

3. Бинарный необработанный

Данные передаются в двоичном формате без кодирования/декодирования Npgsql — это просто поток байтов .NET. Подходит для обработки больших объёмов или восстановления таблицы. Если нужно работать с отдельными значениями, используйте обычный бинарный режим.

int len;
var data = new byte[10000];

// Экспорт table1 в массив
using (var inStream = conn.BeginRawBinaryCopy(
 "COPY table1 TO STDOUT (FORMAT BINARY)"))
{
  len = inStream.Read(data, 0, data.Length); // реально читать блоками
}

// Импорт в table2
using (var outStream = conn.BeginRawBinaryCopy(
 "COPY table2 FROM STDIN (FORMAT BINARY)"))
{
  outStream.Write(data, 0, len);
}

Импорт можно отменить в любой момент, если освободить (Dispose) объект NpgsqlBinaryImporter до вызова Complete(). Экспорт отменяется вызовом метода Cancel().

👉 @KodBlog

Вышла подробная статья о том, как быстро прикрутить LLM к существующему ASP.NET API через Semantic Kernel.

Показан полный путь от создания Azure OpenAI ресурса и деплоя модели до сборки чат-ассистента с автогенерацией вызовов функций через Swagger, хранением контекста в EF Core и оркестрацией через KernelFactory.

Автор отдельно разбирает, как корректная OpenAPI-документация напрямую влияет на точность вызовов функций агентом, и где остаются реальные риски по безопасности и интеграции.

👉 @KodBlog

Этот трюк с GitHub PR надо знать

Просто добавь “0” перед словом “github” в URL любого Pull Request, и у тебя откроется полноценный PR-вьювер, который подсвечивает каждую строку diff’а цветом в зависимости от того, сколько внимания от человека она, скорее всего, требует.

Он ищет не только баги. Он подсвечивает всё, что заслуживает второго взгляда: захардкоженные секреты, странные крипторежимы, подозрительную логику или грязный код.

Очень полезный способ быстрее проводить code review и находить то, что обычно легко пропустить.

👉 @KodBlog

Для тех, кто только начинает разбираться в программировании и собирает себе рабочую среду, на GitHub есть полезная подборка Awesome Uses

Это большая коллекция реальных сетапов разработчиков со всего мира с поддержкой фронтенда, бэкенда, веба и мобильной разработки, удобным просмотром через веб-страницу и фильтрацией по языкам и странам

Где подробно показывают, какое железо, софт, редакторы, плагины и терминалы используют в работе, при этом проект живой, регулярно обновляется и позволяет отправить собственную конфигурацию.

👉 @KodBlog