meds processor

Der Bau eines meds-processor ? Leitfaden zu C# und .NET Core

Dies ist der perfekte Ort, um C# und .NET Core zu lernen, indem Sie etwas Reales mit Aussehen und Gefühl erstellen - einen Drogenlisten -Datenschaber und eine sichere dokumentierte REST -Web -API. Dieses Projekt richtet sich an Entwickler mit moderatem Programmiererlebnis und einige Erfahrungen beim Erstellen von Web -Apps, aber C# und .NET im Backend noch nicht.

Aktualisierungen

• 2019-12-02: Aktualisiert auf SDK 2.2.402, gereinigt, erzwungen ValidFrom.Year < 2019 , Parallelisierung des Parsers aufgrund von Dateisperrsituationen entfernt und die API-Antworten ein wenig aufgeräumt und unnötiger Code entfernt.
• 2019-10-19: Der Prozessor könnte derzeit in einem kleinen Problem sein, da ein neuer (fünfter ...) Parser als neues .xls (x) -Programm für 2019 veröffentlicht wurde. Eine schnelle Lösung für euch ist, Dokumente nach einem ValidFrom.Year < 2019 herauszufiltern. Ich werde dies mit dem zusätzlichen Parser (oder anderen Fix) beheben und die Blog -Beiträge aktualisieren!

Erstellt mit .NET Core SDK?

Die plattformübergreifende Produktionsbereitschaft ist .NET CORE und die Version, mit der diese Anwendung erstellt wird, ist "version": "2.2.402" . Hier finden Sie die SDK -Downloads für Ihr Betriebssystem.

Bauen, rennen und benutzen?

Erstellen Sie die Anwendung (und sicherstellen Sie, dass die Internetkonnektivität für Nuget -Pakete wiederhergestellt werden) mit:

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

Führen Sie die Anwendung aus (und stellen Sie sicher, dass Internet -Konnektivität für Web -Schaber funktioniert) unter https: // localhost: 5001 mit:

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

Sie können jetzt die Web -API über eine Swagger -Benutzeroberfläche unter der Adresse durchsuchen : https: // localhost: 5001/swagger/index.html

Eine Drogen -Web -API (Sie werden bauen)?

Das Bild unten ist ein Screenshot der Swagger -Benutzeroberfläche, das zur Dokumentation der Web -API mit verfügbaren Endpunkten und ihren angesehenen HTTP -Methoden hergestellt wird.

Warum (ich habe das gebaut)?

Ich war irritiert von der Tatsache, dass die medizinischen Daten und Drogen des Landes in einem so unstrukturierten und unfreundlichen Nutzer -unfreundlichen Format wichtige Daten wie Medizin und Drogen. Außerdem dachte ich mir, ich bin ein bisschen verrostet mit .NET -Kern und schreibe technische Blogs.

Über / Zusammenfassung?

Erfahren Sie, um einen Web -Schaber, einen Downloader und einen Excel -Parser zu erstellen, indem Sie einige versteckte Tabellenkalkulationsdaten des Krata -Krankenversicherungsfonds und seiner primären und ergänzenden Arzneimittelliste und all dies nur durch C# und .NET CORE (auf jeder modernen Computer -OS -Plattform) durchgraben! Das .NET -Core -SDK kann unter Windows, OSX oder Linux gleich installiert und verwendet werden.

Wo starten Sie (Projektleitfaden)?

Das Repository besteht aus vier Teilen. Diese Teile sind Git -Zweige, in denen jeder von ihnen einen eigenen Blog -Beitrag hat. Sie können hier auf GitHub (der Dropdown -Down -Abzweigauswahl) Zweige durchsuchen. Ich empfehle, dass Sie mit dem Blog -Teil/1 beginnen, da Sie die Lösung selbst erstellen. Sie können jeden modernen Betriebssystem- und Code -Editor verwenden.

Zweige / Teile / Artikel?

• Teil/1 (Praktischer .net Core - Schreiben Sie einen Web -Schaber, einen Downloader & Excel -Parser. Teil 1: Schaber)

  • Der aufregende. Bootstraps Sie in die C# und .NET World. Stellt Sie das gesamte Projekt auf. Stellt Sie in .NET Core, der Dotnet -CLI, vor, in der Sie eine Web -Scraper -App mithilfe der AngleSharp -Bibliothek erstellen, um einige Remote -HTML -Seiten zu holen und einige Links zu extrahieren.

• Teil/2 (Praktischer .NET Core - Schreiben Sie einen Schaber, Fetcher & XLS (x) Parser. Teil 2: Downloader)

  • Das aufregendste. Fortsetzung von Teil/1, wo Sie jetzt die Dokumente herunterladen, zu denen die früheren Links führen. Die Dokumente sind .xls (x) -Auskalkulationen, die Sie auf Ihrem Festplattenlaufwerk speichern. Sie werden lernen, wie die Task Parallel Library nutzt und asynchronen Aufgaben in .NET Core verarbeitet.

• Teil/3 (Praktischer .NET -Kern - Schreiben Sie einen Schaber, Fetcher & .xls (x) Parser. Teil 3: Parser)

  • Die längste und Thughest. Fortsetzung von Teil/2, wo Sie Tabellenkalkulationsdocs heruntergeladen haben, die an C# -Smodellen analysieren müssen. Sie lernen, die NPOI -Tabellenkalkulationsbibliothek zu verwenden, um relevante Daten für Ihre C# -Modellklassen zu extrahieren. Nach Abschluss haben Sie einen einzelnen Datensatz mit transformierten und organisierten Daten.

• Teil/4 (Praktischer .NET Core - Schreiben Sie einen Schaber, Fetcher & .xls (x) Parser. Teil 4: Secure REST -Web -API)

  • Das kürzeste und süßeste, JK, das längste und härteste! Fortsetzung von Teil/3, wo Sie jetzt die vordere Web -API -App organisieren und einen neuen Controller -Code vorstellen, um eine freundliche Ruhestand -API zu enthüllen, die JSON -Inhalt an Kundenanfragen sendet, die über HTTP (s) gesendet werden. Sie werden lernen, wie man droselt, authentifiziert (mit JWT) und Anfragen autorisiert. Außerdem geben Sie dem Kunden einen Überblick über Ihre API über eine Open -API -Spezifikation mit Swagger -Dokumenten, die auf Ihren gut dokumentierten Controllern und Aktionen basieren.

Einschränkungen?

Die Quelle hat sich durch die Teile stark verändert. Es könnte Fehler geben, da dieses Projekt nicht durch Tests abgedeckt ist (etwas, das ich in Zukunft in Betracht ziehen könnte). Teil/4 Neben der Web -API -Implementierung wird einige Teile refactoring und verbessert, die aus früheren Teilen nicht in ihrer besten Form sind. Sie werden zunächst bemerken, dass sich dieses Dokument für das Readme.md nicht in dieser endgültigen Form in den ersten drei Zweigen befindet. Lassen Sie sich nicht entmutigen und benachrichtigen Sie mich eher, wenn Sie einen Verbesserungsort sehen. Alles sollte wie erwartet funktionieren, wenn Sie der Blog -Serie folgen. Außerdem sind alle Praktiken, die Sie hier sehen, wie eine Basisklasse für eine HTTP -Antwort, um HTTP -Header -Daten zu tragen, nicht die beste Produktion, die Sie verwenden können. Also ja, bleib immer neugierig, frag dich selbst "Warum?", Überdenken Sie Ihren Ansatz und führen Sie dann aus.

Beitrag ?

Ich bin offen für Verbesserungen, Kommentare, Probleme, Gabeln/PRs und alles von gutem Anliegen und Idee. Wir können auch Ihre Ideen und Themen im Kommentarbereich in den Blog -Postartikeln besprechen, wenn Sie dies bevorzugen.

Autor?

Vedran Mandić.

Lizenz?

MIT -Lizenz