ITCC Library

Общее описание

Библиотека общего назначения (на самом деле, несколько библиотек) для решения следующих задач:

• Быстрое написание серверов для приложений (быстрого написания, а не серверов :) )
• Простая работа с клиентской частью HTTP
• Простая работа с геокодерами
• Красивые логи
• Упрощение некоторых операций при работе с WPF

Компоненты

Папки, название которых не заканчивается на "Testing", являются компонентами библиотеки. Описание интерфейсов библиотек лежит в README в папках. Везде в описаниях опущен модификатор public, поскольку вещи, не входящие в интерфейс, явно не описываются.

ITCC.Geocoding

Классы для работы с геокодерами Яндекса и Google. Интересные классы:

• ITCC.Geocoding.Geocoder.cs

ITCC.HTTP.API

Библиотека для декларативного описания и автоматической проверки контрактов сетевого API. Изначально предназначена для работы с HTTP. Интересные классы:

• ITCC.HTTP.API.ViewChecker
• ITCC.HTTP.API.Attributes.ApiViewAttribute
• ITCC.HTTP.API.Attributes.ApiContractAttribute
• ITCC.HTTP.API.Utils.Either<TFirst, TSecond>

ITCC.HTTP.API.Documentation

Библиотека для автоматической генерации документации на основе аннотаций методов API из ITCC.HTTP.API

ITCC.HTTP.Client

Реализация HTTP-клиентов. Интересные классы:

• ITCC.HTTP.Client.RegularClient
• ITCC.HTTP.Client.StaticClient

ITCC.HTTP.Common

Маленькая общая часть реализации HTTP

ITCC.HTTP.Server

HTTP-сервер для быстрого развертывания приложений. Поддерживает дополнительную функциональность (работа со статичными файлами, предобработка контента). Интересные классы:

• ITCC.HTTP.Server.Core.StaticServer<TAccount>
• ITCC.HTTP.Server.Core.HttpServerConfiguration

ITCC.HTTP.Server.Testing

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

• Произвольные директории со статикой
• Настройка порта
• Настройка количества рабочих потоков
• Настройка уровня лога и вида (консоль/файлы)
• HTTP/HTTPS (сертификат создается)
• gzip
• Препроцессинг изображений
• statistics
• ping (json/xml)

ITCC.HTTP.SslConfigUtil.Console

Консольное приложение для генерации и установки TLS-сертификатов

ITCC.HTTP.SslConfigUtil.Core

Библиотека для генерации и установки TLS-сертификатов. Интегрирована в ITCC.HTTP.Server, но может использоваться и самостоятельно. Интересные классы:

• ITCC.HTTP.SslConfigUtil.Core.Binder
• ITCC.HTTP.SslConfigUtil.Core.CertificateController

ITCC.HTTP.SslConfigUtil.GUI

WPF-приложение для генерации и установки TLS-сертификатов

ITCC.Logging.Core

Логгирование. Система подписчик-получатель с возможностью добавления получателей. Надо просто реализовать интерфейс ILogReceiver. Собирается везде. Интересные классы:

• ITCC.Logging.Core.Logger

ITCC.Logging.Reader.Core

Библиотека для парсинга логов, генерируемых ITCC.Logging.Core.Logger

ITCC.Logging.Reader.WPF

Настольное приложения для отображения логов, генерируемых ITCC.Logging.Core.Logger

ITCC.Logging.Windows

Различные реализации логов для .Net 4.6. Интересные классы:

• ITCC.Logging.Loggers.ColouredConsoleLogger
• ITCC.Logging.Loggers.BufferedFileLogger
• ITCC.Logging.Loggers.SystemEventLogger
• ITCC.Logging.Loggers.EmailLogger

ITCC.UI

Библиотека классов для использования в GUI-приложениях на WPF, UWP и Xamarin Forms. Интересные классы:

• ITCC.UI.Commands.AsyncCommand
• ITCC.UI.Loggers.ObservableLogger
• ITCC.UI.Utils.ObservableRingBuffer

ITCC.WPF

Маленькие полезные классы для работы с WPF. Включает, в том числе, работу с ITCC.Logging из WPF и специальное окошко LogWindow для вывода логов. Интересные классы:

• ITCC.WPF.Credentials.CredentialManager
• ITCC.WPF.Windows.LogWindow
• ITCC.WPF.Utils.DataGridHelper
• ITCC.WPF.Utils.ScrollViewerExtensions

Подключение

Клонирование

git clone https://github.com/OPEXGroup/ITCC.Library.git

Подключение в качестве подмодуля

git submodule add https://github.com/OPEXGroup/ITCC.Library.git

Потом, для подключения после клонирования родительского проекта

git submodule init
git submodule update

Замечания по сборке

Собирается из Visual Studio 2017. Целевая среда:

• .Net 4.5 для всех
• .Net 4.6 и netstandard 1.3 для проектов ITCC.Logging.Core, ITCC.HTTP.Common ITCC.HTTP.API и ITCC.UI