ServiceProviderEndpoint Download - ServiceProviderEndpoint Source Code Download

ServiceProviderEndpoint

فئات أخرى

1.0.0

تنزيل

ServiceProviderEndPoint

iserviceprovider webapi نهاية نقطة نهاية لتطوير أسرع وأسهل.

الاستخدام

إذا كنت قد قمت بالفعل بتسجيل الخدمات في المجموعة وترغب في إعطاء الوصول إليها عبر HTTP ، فما عليك سوى تعيين نقطة نهاية عالمية مثل هذا:

 app . MapServiceProvider ( "services" , builder . Services ) ;
app . Run ( ) ;

الآن يمكنك إرسال طلبات البريد/الحصول على خدماتك ، مثل:

 GET /services/IYourService/SomeMethod?args=["arg1","arg2","arg3"]

or

POST /services/IYourService/SomeMethod
Content-Type: application/json
["arg1","arg2","arg3"]

الأدوية

طلب مثال مع الأدوية:

 GET /services/IYourService/SomeGenericMethod(Int32)?args=[111,222,333]

الطلبات استخدام تدوين عنوان URL للأنواع. على سبيل المثال ، فإن القاموس (array-array (int32)) يعادل القاموس <string ، int []> .

اكتب صب

إذا كانت طريقتك تحتوي على وسيط نوع الكائن مثل:

 Task < int > ExampleMethod ( object data , CancellationToken cancellationToken ) ;

ثم تحتاج إلى إضافة نوع المصطلح كمعلمة إضافية للطلب:

 GET /services/IYourService/ExampleMethod/List(String)?args=[["list_item1","list_item2","list_item3"]]

تدفقات الملفات

للتنزيل ، يكفي أن تقوم الطريقة بإرجاع كائن دفق:

 Task < Stream > SomeDownloadMethod ( string a , string b , string c , CancellationToken cancellationToken ) ;

سيكون طلب التنزيل هكذا:

 GET /services/IYourService/SomeDownloadMethod?args=["argA","argB","argC"]

للتحميل ، يجب أن تحتوي الطريقة على وسيطة لتيار النوع (لا يهم الموضع):

 Task SomeUploadMethod ( Stream stream , string a , string b , string c , CancellationToken cancellationToken ) ;

طلب التحميل:

 POST /services/IYourService/SomeUploadMethod?args=["argA","argB","argC"]
Content-Type: application/octet-stream
<SomeFileData>

مثال JavaScript:

 let file = document . getElementById ( 'some-input' ) . files [ 0 ] ;
let response = await fetch ( '/services/IYourService/SomeUploadMethod?args=' + encodeURIComponent ( JSON . stringify ( [ "argA" , "argB" , "argC" ] ) ) , {
  method : 'POST' ,
  headers : { 'content-type' : file . type || 'application/octet-stream' } ,
  body : file ,
} ) ;

حماية

إذا كنت لا ترغب في نشر جميع الخدمات في المجموعة ، فما عليك سوى إضافة مرشح:

 app . MapServiceProvider ( "services" , builder . Services
  . Where ( x => x . ServiceType . Namespace . StartsWith ( "Example" ) ) ) ;

إذا كان هناك حاجة إلى التفويض ، فسيتم إضافته بواسطة الطريقة القياسية لـ IendPointConventionBuilder:

 app . MapServiceProvider ( "services" , builder . Services )
  . RequireAuthorization ( ) ;

يمكن إضافة أمان الأساليب عبر موظفي الخبر:

 builder . Services . AddScoped < IExampleService , ExampleService > ( ) ;
builder . Services . Decorate < IExampleService , SecureExampleService > ( ) ;

.NET عميل

للاتصال بأجهزة واجهة برمجة التطبيقات من تطبيق .NET آخر ، استخدم عميلًا موجودًا:

 using ServiceProviderEndpoint . Client ;

using var client = new SpeClient ( "https://localhost:7149/services" ) ;

var result = await client
  . GetService < IYourService > ( )
  . SomeMethod ( "arg1" , "arg2" , "arg3" ) ;