Penzle.Net

PENZLE .NET SDK

Penzle .NET SDK เป็นห้องสมุดที่ช่วยให้นักพัฒนาสามารถรวมเข้ากับการส่งเนื้อหา Penzle และ APIs การจัดการเนื้อหาได้อย่างง่ายดาย SDK นี้ออกแบบมาสำหรับนักพัฒนา. NET ที่ต้องการสร้างอัปเดตและดึงเนื้อหาจากแพลตฟอร์ม Penzle

เริ่มต้น

ในการติดตั้ง Penzle .NET SDK คุณสามารถใช้ตัวเลือกต่อไปนี้:

• เรียกใช้คำสั่งต่อไปนี้ในคอนโซลแพ็คเกจ Manager:

 Install-Package Penzle.Net

• เรียกใช้คำสั่ง. NET CLI ต่อไปนี้ในบรรทัดคำสั่ง:

 dotnet add <your project> package Penzle.Net

การใช้งาน

ในการดึงเนื้อหาจาก Penzle APIs คุณจะใช้คลาส DeliveryPenzleClient คลาสนี้มีวิธีการดึงเนื้อหาจาก Penzle Delivery API คุณจะใช้คลาส ManagementPenzleClient เพื่อสร้างอัปเดตและลบเนื้อหา

คุณสามารถใช้ไคลเอนต์ที่มี DI/IOC หรือไม่มี DI/IOC

ไม่มี di/ioc

   var client = DeliveryPenzleClient
          . Factory
          (
              apiDeliveryKey : "<delivery_api_key>" ,
              ( api ) =>
              {
                  api . Environment = "<environment_name>" ;
                  api . Project = "<project_name>" ;
              }
          ) ;

ด้วย di/ioc

    public void ConfigureServices ( IServiceCollection services )
    {
	    services . AddPenzleClient ( Configuration ) ;
    } 

    public class HomeController
    {
	    private IDeliveryPenzleClient client ;

	    public HomeController ( IDeliveryPenzleClient deliveryPenzleClient )
	    {
		    client = deliveryPenzleClient ;
	    }
    } 

การดึงข้อมูล

หลังจากสร้างไคลเอนต์ Penzle คุณสามารถดึงข้อมูลจาก Penzle APIs:

    // Retrieving a single entry by ID
    var entry = await client . Entry . GetEntry < Author > ( < author_id > ) ;
  
    Console . WriteLine ( entry . Summary ) ; // => Penzle author.
    Console . WriteLine ( entry . Age ) ; // => 27.
  

สร้างโมเดลประเภทที่แข็งแกร่งที่เข้ากันได้กับเทมเพลตข้อมูลของคุณก่อนที่จะทำอย่างอื่น

 public sealed class Author
{
    public string Summary { get ; set ; }
    public int Age { get ; set ; }
}

หากคุณต้องการข้อมูลระบบของรายการให้เพิ่มคุณสมบัติ EntrySystem ในชั้นเรียน

 public sealed class Author
{
    public EntrySystem System { get ; init ; }
    public string Summary { get ; set ; }
    public int Age { get ; set ; }
}

คอล GetEntries กลับมาของวัตถุที่พิมพ์อย่างรุนแรงขึ้นอยู่กับประเภทเนื้อหาที่คุณกำหนดไว้ในโครงการ Penzle ของคุณ คุณสามารถใช้ LINQ เพื่อกรองเรียงลำดับและแปลงเนื้อหาก่อนที่จะส่งคืน

    // Use query builder to define request parameters.
    var query = QueryEntryBuilder . New
                . Where ( x => x . Summary . Contains ( "J" ) && x . Age >= 30 )
                . OrderBy ( x => x . Id )
                . Select ( x => new { x . Id , x . FirstName } ) ;
        
    var entries = await client . Entry . GetEntries < Author > ( query : query ) ;

  // Print the entries to the console.
    foreach ( var entry in entries )
    {
        // Print the entry system fields.
        Console . WriteLine ( value : $ "Summary { entry . Summary } " ) ;
        Console . WriteLine ( value : $ "Age: { entry . Age } " ) ;
    }

คุณสามารถค้นหาตัวอย่างที่สมบูรณ์ในโครงการคอนโซล NET 7 ซึ่งเขียนด้วยวิธีการ "วิธีการ" สำหรับนักพัฒนา เยี่ยมชม penzle.net.gettingstarted เพื่อดูตัวอย่างทั้งหมดของวิธีการใช้วิธีการต่าง ๆ ในแอปพลิเคชันคอนโซล

API การจัดการ

ในการสร้างอัปเดตหรือลบข้อมูลในโครงการ Penzle ของคุณคุณจะต้องใช้ Penzle Management API Penzle .NET SDK จัดเตรียมคลาส ManagementPenzleClient ที่คุณสามารถใช้ในการโต้ตอบกับ API การจัดการ:

   var client = ManagementPenzleClient
          . Factory
          (
              apiManagementKey : "<management_api_key>"
          ) ; 

    // Create a new instance of the form entry.
    var author = new Author
    {
        Summary = "David Smith" ,
        Age = 20 ,
    } ;

    // Create a new instance of the entry.
    var medicalReleaseId = await client . Entry . CreateEntry ( author , CancellationToken . None ) ; 

เอกสาร SDK

เอกสาร SDK อย่างเป็นทางการให้ข้อมูลโดยละเอียดเกี่ยวกับคลาสและวิธีการต่างๆที่มีอยู่ใน SDK โปรดติดตามเอกสารสำหรับรายละเอียดเพิ่มเติม

ใบอนุญาต

SDK นี้เปิดตัวภายใต้ใบอนุญาต MIT

เอื้อมมือมาหาเรา

เรายินดีต้อนรับข้อเสนอแนะรายงานข้อผิดพลาดและคำขอคุณสมบัติ

หากคุณต้องการความช่วยเหลือเกี่ยวกับห้องสมุดนี้โปรดติดต่อฝ่ายสนับสนุนผู้ขาย

นอกจากนี้คุณยังสามารถเปิดปัญหาเกี่ยวกับที่เก็บ GitHub หรือส่งคำขอดึงพร้อมการปรับปรุงรหัส

หากคุณมีคำถามหรือคำแนะนำใด ๆ โปรดอย่าลังเลที่จะติดต่อเราโดยส่งอีเมลไปที่ [email protected]

เรารอคอยที่จะได้ยินจากคุณ!

ผลงาน

เรายินดีต้อนรับการมีส่วนร่วมในห้องสมุดนี้ หากคุณสนใจที่จะมีส่วนร่วมโปรดอ่านไฟล์ที่มีส่วนร่วมสำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการเริ่มต้น