Penzle.Net

Penzle .NET SDK

Penzle .net SDK는 개발자가 Penzle 컨텐츠 제공 및 컨텐츠 관리 API와 쉽게 통합 할 수있는 라이브러리입니다. 이 SDK는 Penzle 플랫폼에서 컨텐츠를 작성, 업데이트 및 검색하려는 .NET 개발자를 위해 설계되었습니다.

시작하기

Penzle .NET SDK를 설치하려면 다음 옵션을 사용할 수 있습니다.

• 패키지 관리자 콘솔에서 다음 명령을 실행하십시오.

 Install-Package Penzle.Net

• 명령 줄에서 다음 .NET CLI 명령을 실행하십시오.

 dotnet add <your project> package Penzle.Net

용법

Penzle API에서 컨텐츠를 검색하려면 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 API에서 데이터를 검색 할 수 있습니다.

    // 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 } " ) ;
    }

개발자를위한 "방법"접근 방식으로 작성된 The.net 7 Console Project에서 전체 예제를 찾을 수 있습니다. Console 애플리케이션에서 다양한 방법을 사용하는 방법에 대한 모든 예를 보려면 Penzle.net.gettingStarted를 방문하십시오.

관리 API

Penzle 프로젝트에서 데이터를 작성, 업데이트 또는 삭제하려면 Penzle Management API를 사용해야합니다. Penzle .NET SDK는 관리 API와 상호 작용하는 데 사용할 수있는 ManagementPenzleClient 클래스를 제공합니다.

   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]으로 이메일을 보내 주시기 바랍니다.

우리는 당신의 의견을 기다리고 있습니다!

기부금

우리는이 도서관에 대한 기여를 환영합니다. 기고에 관심이 있으시면 기고 파일을 읽고 시작하는 방법에 대한 자세한 내용은 참조하십시오.