meds processor

Membangun meds-processor ? Panduan untuk C# dan .NET Core

Ini adalah tempat yang sempurna untuk mulai belajar C# dan .NET Core dengan membangun sesuatu yang nyata dengan penampilan dan terasa - pengikis data daftar narkoba dan API Web REST terdokumentasi yang aman. Proyek ini dirancang untuk pengembang yang memiliki pengalaman pemrograman moderat dan beberapa pengalaman dalam membangun aplikasi web tetapi masih belum dikembangkan C# dan .NET di backend.

Pembaruan

• 2019-12-02: Diperbarui ke SDK 2.2.402, dibersihkan, paksa ValidFrom.Year < 2019 , menghapus paralelisasi parser karena situasi kunci file, membersihkan sedikit tanggapan API, dihapus kode yang tidak perlu.
• 2019-10-19: Prosesor mungkin dalam sedikit masalah saat ini karena fakta bahwa parser baru (kelima ...) diperlukan sebagai skema .xls (x) baru telah diterbitkan untuk 2019. :-) Ah, Burokrasi di Kroasia, Anda harus menyukainya. Perbaikan cepat untuk kalian adalah menyaring dokumen dengan ValidFrom.Year < 2019 ekspresi. Saya akan memperbaikinya dengan parser tambahan (atau perbaikan lainnya) dan memperbarui posting blog!

Dibangun dengan .NET Core SDK?

Produksi Cross-Platform Ready SDK adalah .NET Core dan versi yang digunakan untuk membangun aplikasi ini adalah "version": "2.2.402" . Anda dapat menemukan unduhan SDK untuk OS Anda di sini.

Bangun, jalankan & gunakan?

Bangun aplikasi (dan pastikan konektivitas internet untuk paket Nuget untuk dipulihkan) dengan:

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

Jalankan aplikasi (dan pastikan konektivitas internet untuk pengikis web berfungsi) di https: // localhost: 5001 dengan:

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

Anda sekarang dapat menelusuri API Web melalui UI Swagger pada alamat: https: // localhost: 5001/swagger/index.html

API Web Obat (Anda akan membangun)?

Gambar di bawah ini adalah tangkapan layar UI Swagger yang diproduksi untuk mendokumentasikan API Web dengan titik akhir yang tersedia dan metode HTTP yang dihormati.

Mengapa (saya membangun ini)?

Saya merasa kesal dengan fakta bahwa dana asuransi kesehatan negara saya menanti data penting seperti obat -obatan dan obat -obatan dalam format yang tidak terstruktur dan tidak ramah. Juga, saya pikir saya agak berkarat dengan .NET Core dan menulis blog teknis.

Tentang / ringkasan?

Belajarlah untuk membangun pengikis web, pengunduh & excel parser dengan menggali beberapa data spreadsheet yang menyembunyikan dana asuransi kesehatan Kroasia dan daftar obat utama dan tambahannya dan semua itu dengan menggunakan hanya C# dan .NET Core (pada platform OS komputer modern)! SDK inti .NET dapat diinstal dan digunakan yang sama pada Windows, OSX atau Linux.

Di mana untuk memulai (Panduan Proyek)?

Repositori terdiri dari empat bagian. Bagian -bagian itu adalah cabang git di mana masing -masing memiliki artikel posting blog mereka sendiri. Anda dapat menelusuri cabang di sini di GitHub (dropdown pilihan cabang). Saya menyarankan agar Anda mulai dengan membaca bagian blog/1 karena akan memandu Anda dengan membangun solusi sendiri. Anda dapat menggunakan OS modern dan editor kode.

Cabang / Bagian / Artikel?

• Bagian/1 (Praktis .NET Core - Tulis pengikis web, downloader & excel parser. Bagian 1: scraper)

  • Yang mendebarkan. Bootstraps Anda ke dunia C# dan .net. Mengatur Anda dengan seluruh proyek. Memperkenalkan Anda ke .NET Core, Dotnet CLI di mana Anda akan membuat aplikasi pengikis web menggunakan pustaka AngleSharp untuk mengambil beberapa halaman HTML jarak jauh dan mengekstrak beberapa tautan.

• Bagian/2 (Praktis .NET Core - Tulis Scraper, Fetcher & XLS (X) Parser. Bagian 2: Pengunduh)

  • Yang paling menarik. Berlanjut pada bagian/1 di mana sekarang Anda akan mengunduh dokumen yang ditimbulkan oleh tautan sebelumnya. Dokumennya adalah spreadsheet .xls (x) yang akan Anda simpan ke disk drive Anda. Anda akan belajar cara memanfaatkan Task Parallel Library dan memproses tugas async di .NET Core.

• Bagian/3 (Praktis .NET Core - Tulis scraper, fetcher & .xls (x) parser. Bagian 3: parser)

  • Yang terpanjang dan prughest. Berlanjut pada bagian/2 di mana Anda telah mengunduh dokumen spreadsheet yang perlu diuraikan ke model C#. Anda akan belajar menggunakan perpustakaan parsing spreadsheet NPOI untuk mengekstrak data yang relevan untuk kelas model C# Anda. Setelah menyelesaikan Anda akan memiliki satu set data data yang diubah dan terorganisir.

• Bagian/4 (Praktis .NET Core - Tulis scraper, fetcher & .xls (x) parser. Bagian 4: API web istirahat aman)

  • Yang terpendek & paling lucu, JK, yang terpanjang & terberat! Lanjutkan pada bagian/3 di mana Anda sekarang mengatur aplikasi API Web depan yang menghadap ke depan dan memperkenalkan kode pengontrol baru untuk mengekspos API REST yang ramah yang melayani konten JSON ke permintaan klien yang dikirim melalui http (s). Anda akan belajar cara mencekik, mengotentikasi (dengan JWT) dan mengesahkan permintaan. Juga, Anda akan memberi klien gambaran umum API Anda melalui spesifikasi API terbuka dengan dokumen Swagger berdasarkan pengontrol dan tindakan Anda yang terdokumentasi dengan baik.

Peringatan?

Sumber telah banyak berubah melalui bagian -bagiannya. Mungkin ada bug karena proyek ini tidak dicakup oleh tes (sesuatu yang mungkin saya pertimbangkan di masa depan). Bagian/4 Selain itu, implementasi API Web masuk ke refactoring dan meningkatkan beberapa bagian yang sengaja tidak dalam bentuk terbaik dari bagian sebelumnya. Yang pertama kali Anda perhatikan adalah bahwa dokumen ReadMe.MD ini tidak ada dalam bentuk akhir ini di tiga cabang pertama. Jangan berkecil hati, lebih baik beri tahu saya jika Anda melihat tempat untuk perbaikan. Semuanya harus berfungsi seperti yang diharapkan jika Anda mengikuti seri blog. Juga, semua praktik yang Anda lihat di sini seperti kelas dasar untuk respons HTTP untuk membawa data header HTTP bukanlah produksi terbaik untuk digunakan. Jadi ya, selalu tetap penasaran, tanyakan pada diri Anda "mengapa?", Kembali memikirkan pendekatan Anda dan kemudian jalankan.

Kontribusi?

Saya terbuka untuk perbaikan, komentar, masalah, garpu/PR dan semua yang menjadi perhatian dan ide yang baik. Kami juga dapat mendiskusikan ide dan topik Anda di bagian komentar di artikel posting blog jika Anda lebih suka itu.

Pengarang ?

Vedran Mandić.

Lisensi?

Lisensi MIT