사용자:LOONA/API 예제(r3 Blame)

보기 RAW Blame 되돌리기 비교

 r3
-r1
LOONA
+ * 상위 문서: [[사용자:LOONA]]
 아래는 [[https://doc.theseed.io/#the-seed-engine-api|API]]를 이용해 문서의 내용을 가져오는 C# 예제 코드다. 닷넷 5.0에서 동작하는 코드의 일부를 구조를 단순화해 적은 것으로, 실제 동작하는 코드와 다를 수 있다.
 Json 파싱에 System.Text.Json을 사용했지만 당연히 Newtonsoft.Json을 사용해도 무방하다.
-r3
LOONA
+레코드 타입을 이용하기 때문에 9.0 이상 사용을 전제로 한다. 8.X 이하 버전에서 사용한다면 레코드 타입 대신 별도의 클래스를 정의하여 사용해야 한다.
-r1
LOONA
 Json Deserialize를 위해 레코드 타입을 추가한다. JsonDocument로 파싱해 RootElement로부터 Property를 가져오는 방법도 있으나 별도의 Immutable Object를 이용하는 것이 더 적절하다고 본다.
 {{{#!syntax csharp
 public record ReadDocumentPayload
 {
 #nullable enable
     [JsonPropertyName("text")]
     public string? Text { get; init; }
     [JsonPropertyName("exists")]
     public bool Exists { get; init; }
     [JsonPropertyName("token")]
     public string? Token { get; init; }
     [JsonPropertyName("status")]
     public string? Status { get; init; }
 #nullable restore
 }
 }}}
 {{{#!syntax csharp
 using System;
 using System.Threading.Tasks;
 using System.Net;
 using System.Net.Http;
 using System.Text.Json;
 namespace MyNamespace
 {
     public class MyClass
     {
         /* private  Field */
         private HttpClient _client;
         private string _baseUrl = "https://theseed.io/";
         private string _token = "My API Token";
         /* private Field */
         public void InitHttpClient()
         {
             var handler = new SocketsHttpHandler()
             {
                 AllowAutoRedirect = true,
                 AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate
             };
             this._client = new HttpClient(handler);
             this._client.DefaultRequestHeaders.Add("User-Agent", "My User Agent");
             this._client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", this._token);
         }
-r2
LOONA
+        public async Task<ReadDocumentPayload> ReadDocumentAsync(string documentName)
-r1
LOONA
+        {
             var url = this._baseUrl + "api/edit/" + documentName;
             var response = this._client.GetAsync(url);
             var body = await response.Content.ReadAsStringAsync();
             var result = JsonSerializer.Deserialize<ReadDocumentPayload>(body);
             if (!string.IsNullOrEmpty(result.Status))
                 throw new MyException(result.Status);
             if(!result.Exists)
                 throw new MyException("Document does not exist.");
             return result;
         }
     }
 }
 }}}