meds processor

بناء meds-processor ؟ دليل C# و .NET Core

هذا هو المكان المثالي للبدء في تعلم C# و .NET Core من خلال بناء شيء حقيقي مع المظهر ويشعر به - مكشطة بيانات قائمة الأدوية وواجهة برمجة تطبيقات الويب الموثقة آمنة. تم تصميم هذا المشروع للمطورين الذين لديهم خبرة معتدلة في البرمجة وبعض الخبرة في بناء تطبيقات الويب ولكنهم لم يظلوا مشفرين على 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

قم بتشغيل التطبيق (وتأكد من اتصال الإنترنت من أجل عمل مكشطة الويب) على https: // localhost: 5001 مع:

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

يمكنك الآن تصفح واجهة برمجة تطبيقات الويب عبر واجهة مستخدم Swagger على العنوان: https: // localhost: 5001/swagger/index.html

واجهة برمجة تطبيقات Web Drugs (ستقوم ببناء)؟

الصورة أدناه عبارة عن لقطة شاشة من واجهة المستخدم Swagger التي يتم إنتاجها لتوثيق واجهة برمجة تطبيقات الويب بنقاط النهاية المتاحة وطرق HTTP المحترمة.

لماذا (قمت ببناء هذا)؟

لقد شعرت بالغضب من حقيقة أن صناديق التأمين الصحي في بلدي يهم بيانات مهمة مثل الطب والعقاقير بتنسيق غير منظم وغير ودي. أيضًا ، اعتقدت أنني صدئ بعض الشيء مع .NET Core وكتابة المدونات الفنية.

حول / ملخص؟

تعلم كيفية إنشاء مكشطة ويب ومواقع تنزيل و Excel من خلال البحث في بعض بيانات جدول البيانات المخفي لصندوق التأمين الصحي في كرواتيا وقائمة الأدوية الأساسية والتكميلية وكل ذلك باستخدام C# و .NET Core فقط (على أي منصة OS الكمبيوتر الحديثة)! يمكن تثبيت .NET Core SDK واستخدامه على نظام Windows أو OSX أو Linux.

من أين تبدأ (دليل المشروع)؟

يتكون المستودع من أربعة أجزاء. هذه الأجزاء هي فروع GIT حيث يوجد كل واحد منها في مقالة نشر مدونة خاصة بها. يمكنك تصفح الفروع هنا على GitHub (منسدل اختيار الفرع). أنصحك ببدء قراءة جزء المدونة/1 لأنها ستوجهك من خلال إنشاء الحل بنفسك. يمكنك استخدام أي محرر نظام التشغيل والرمز الحديث.

الفروع / الأجزاء / المقالات؟

• الجزء/1 (عملي .NET Core - اكتب مكشطة الويب ، تنزيل و Excel Parser. الجزء 1: مكشطة)

  • المثيرة. Bootstraps لك إلى عالم C# و .NET. يضعك مع المشروع بأكمله. يقدم لك .NET Core ، Dotnet CLI حيث ستقوم بإنشاء تطبيق مكشطة الويب باستخدام مكتبة AngleSharp لجلب بعض صفحات HTML عن بُعد واستخراج بعض الروابط.

• الجزء/2 (عملي .NET CORE - اكتب مكشطة ، Fotcher & XLS (X) PARSER. الجزء 2: التنزيل)

  • الأكثر إثارة. يستمر في الجزء/1 حيث ستقوم الآن بتنزيل المستندات التي تؤدي إليها الروابط السابقة. المستندات هي جداول بيانات .xls (x) التي ستحفظها على محرك الأقراص. سوف تتعلم كيفية استخدام Task Parallel Library ومعالجة المهام ASYNC في .NET CORE.

• الجزء/3 (العملي .NET Core - اكتب مكشطة ، Fotcher & .xls (x) محلل. الجزء 3: محلل)

  • الأطول والثغرة. يستمر في الجزء/2 حيث قمت بتنزيل مستندات جدول البيانات التي تحتاج إلى تحليل في نماذج C#. سوف تتعلم استخدام مكتبة تحليل جداول بيانات NPOI لاستخراج البيانات ذات الصلة لفئات طراز C#. عند الانتهاء ، سيكون لديك مجموعة بيانات واحدة من البيانات المحولة والمنظمة.

• الجزء/4 (عملي .NET CORE - اكتب مكشطة ، Fotcher & .xls (x) محلل. الجزء 4: آمنة ويب API)

  • أقصر وأفضل ، JK ، الأطول والأصعب! يستمر في الجزء/3 حيث تقوم الآن بتنظيم تطبيق واجهة برمجة تطبيقات المواجهة الأمامية وتقديم رمز تحكم جديد لفضح واجهة برمجة تطبيقات ودية لخدمة JSON لطلبات العميل المرسلة عبر http (s). سوف تتعلم كيفية الخنق ، والمصادقة (مع JWT) وترخيص الطلبات. أيضًا ، ستمنح العميل نظرة عامة على واجهة برمجة التطبيقات الخاصة بك من خلال مواصفات API مفتوحة مع مستندات Swagger بناءً على وحدات التحكم والإجراءات الموثقة جيدًا.

تحذيرات؟

لقد تغير المصدر كثيرًا من خلال الأجزاء. قد يكون هناك أخطاء لأن هذا المشروع لا يتم تغطيته باختبارات (شيء قد أعتبره في المستقبل). الجزء/4 إلى جانب تطبيق API على الويب يذهب إلى إعادة إنشاء وتحسين بعض الأجزاء التي لا تعرضها عن قصد في أفضل حالاتها من الأجزاء السابقة. ما ستلاحظه أولاً هو أن وثيقة readMe.md ليست في هذا النموذج النهائي في الفروع الثلاثة الأولى. لا تشعر بالإحباط ، بل أبلغني إذا رأيت مكانًا للتحسين. يجب أن يعمل كل شيء كما هو متوقع إذا اتبعت سلسلة المدونة. أيضًا ، جميع الممارسات التي تراها هنا مثل فئة أساسية لاستجابة HTTP لحمل بيانات رأس HTTP ليست أفضل إنتاج لاستخدام شيء. لذا ، نعم ، ابق دائمًا فضوليًا ، اسأل نفسك "لماذا؟" ، أعد التفكير في منهجك ثم تنفذ.

مساهمة ؟

أنا منفتح على التحسينات والتعليقات والقضايا والشوك/PRS وكل ما يثير القلق والفكرة الجيدة. يمكننا أيضًا مناقشة أفكارك ومواضيعك في قسم التعليقات في مقالات نشر المدونة إذا كنت تفضل ذلك.

مؤلف ؟

فيدران مانديتش.

رخصة ؟

رخصة معهد ماساتشوستس للتكنولوجيا