meds processor

Построить meds-processor ? Руководство по C# и .net Core

Это идеальное место для начала изучения C# и .NET Core, создав что -то реальное с внешним видом и ощущением - скребок данных списка лекарств и защищенный веб -API REST. Этот проект предназначен для разработчиков, которые имеют умеренный опыт программирования и некоторый опыт создания веб -приложений, но они все еще не включали C# и .NET на бэкэнд.

Обновления

• 2019-12-02: Обновлено до SDK 2.2.402, очистил, вынужден ValidFrom.Year < 2019 , удаленная параллелизация анализатора из-за ситуаций блокировки файлов, немного очистил ответы API, удалил ненужный код.
• 2019-10-19: в настоящее время процессор может быть в некоторой проблеме из-за того, что новый (пятый ...) анализатор требуется в качестве новой схемы .xls (x) была опубликована на 2019 год. :-) Ах, бурократия в Хорватии, вы должны любить ее. Быстрое решение для вас, ребята, состоит в том, чтобы отфильтровать документы с помощью ValidFrom.Year < 2019 . Я буду исправлять это с помощью дополнительного анализатора (или другого исправления) и обновлять сообщения в блоге!

Построен с .NET CORE SDK?

Крестоплатформенное производство, готовое SDK, является ядра .NET Core, а версия, используемая для создания этого приложения,- "version": "2.2.402" . Вы можете найти загрузки SDK для вашей ОС здесь.

Строить, запустить и использовать?

Создайте приложение (и обеспечите подключение к Интернету для восстановления пакетов Nuget) с помощью:

 > cd src/MedsProcessor.WebAPI
MedsProcessor.WebAPI > dotnet build

Запустите приложение (и обеспечить подключение к Интернету для работы Web Scraper) на https: // localhost: 5001 с:

 > cd src/MedsProcessor.WebAPI
MedsProcessor.WebAPI > dotnet run

Теперь вы можете просмотреть веб -API через пользовательский интерфейс Swagger по адресу: https: // localhost: 5001/swagger/index.html

API веб -API с наркотиками (вы построите)?

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

Почему (я построил это)?

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

О / резюме?

Научитесь создавать веб -скребок, Downloader & Excel Parser, копая некоторые скрытые данные электронной таблицы Фонда медицинского страхования Хорватии и его основной и дополнительный список лекарств и все это, используя только C# и .NET Core (на любой современной платформе компьютерной ОС)! Core SDK .NET может быть установлен и использовать его в Windows, OSX или Linux.

С чего начать (руководство по проекту)?

Репозиторий состоит из четырех частей. Эти части являются филиалами GIT , где у каждого из них есть своя статья в блоге. Вы можете просматривать ветви здесь, на Github (выпуск отбора ветви). Я советую вам начать с прочтения блога Part/1, поскольку он будет направлять вас через создание решения самостоятельно. Вы можете использовать любой современный редактор ОС и кода.

Филиалы / детали / статьи?

• Часть/1 (Практическое .NET CORE - напишите веб -скребок, загрузчик и экстремат.

  • Захватывающий. Напугивает вас к миру C# и .NET. Устанавливает вас со всем проектом. Представляет вас .NET CORE, CLI DOTNET, в котором вы создадите приложение веб -скребка, используя библиотеку AngleSharp чтобы получить несколько удаленных HTML -страниц и извлечь некоторые ссылки.

• Часть/2 (Практическое .NET CORE - напишите скребок, Fetcher & XLS (x) Parser. Часть 2: Загрузка)

  • Самый захватывающий. Продолжается в части/1, где теперь вы будете загружать документы, к которым приводят бывшие ссылки. Документы - это электронные таблицы .xls (x), которые вы сохраните на своем дисковом диске. Вы узнаете, как использовать Task Parallel Library и асинхронные задачи задачи в ядре .NET.

• Часть/3 (Практическое .NET CORE - напишите скребок, Fetcher & .xls (x) Parser. Часть 3: Диаграмм)

  • Самый длинный и червяк. Продолжается в части/2, где вы скачали документы для электронной таблицы, которые нуждаются в анализе C# моделей. Вы научитесь использовать библиотеку SAILSING SAILSING NPOI для извлечения соответствующих данных для ваших классов моделей C#. После завершения у вас будет один набор данных преобразованных и организованных данных.

• Часть/4 (Практическое .NET CORE - напишите скребок, Fetcher & .xls (x) Parser. Часть 4: Secure Rest Web API)

  • Самый короткий и самый симпатичный, JK, самый длинный и самый сложный! Продолжается в части/3, где вы сейчас организуете приложение для веб -API с фронтом, и вводите новый код контроллера, чтобы выявить дружеский RESTFUL API, обслуживающий контент JSON для запросов клиентов, отправляемых по HTTP (ы). Вы узнаете, как дроссель, аутентификация (с JWT) и авторизуйте запросы. Кроме того, вы предоставите клиенту обзор вашего API через открытую спецификацию API с Swagger Docs на основе ваших хорошо задокументированных контроллеров и действий.

Предостережения?

Источник сильно изменился через детали. Могут быть ошибки, так как этот проект не покрывается тестами (что я мог бы рассмотреть в будущем). Часть/4 Помимо реализации веб -API входит в рефакторинг и улучшение некоторых частей, которые специально не в их лучшей форме из предыдущих частей. Сначала вы заметите, что этот документ readme.md не находится в этой окончательной форме в первых трех ветвях. Не разочаровывайтесь, скорее уведомите меня, если вы видите место для улучшения. Все должно работать так же, как и ожидалось, если вы следите за серией блогов. Кроме того, все практики, которые вы видите здесь, такие как базовый класс для ответа HTTP для переноса данных заголовка HTTP, не лучшая производство для использования. Так что да, всегда оставайся любопытным, спрашивай себя «Почему?», Переосмыслить ваш подход, а затем выполнять.

Вклад ?

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

Автор?

Ведран Мандич.

Лицензия?

MIT Лицензия