#nullable enable
using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;
namespace UVC.Data
{
///
/// HTTP 요청 파이프라인 정보를 관리하는 클래스입니다.
/// 요청 URL, 메서드, 헤더, 본문과 같은 HTTP 요청 정보 및
/// 반복 실행, 재시도, 데이터 매핑 등 파이프라인 동작을 구성합니다.
///
///
/// 이 클래스는 파이프라인 빌더 패턴을 사용하여 HTTP 요청 설정을 구성할 수 있도록 합니다.
/// 각 설정 메서드는 체이닝을 통해 유연하게 요청을 정의할 수 있습니다.
///
///
///
/// var pipelineInfo = new HttpPipeLineInfo("https://api.example.com/data", "GET")
/// .setDataMapper(new DataMapper(dataMask))
/// .setSuccessHandler(data => Console.WriteLine(data)) // 성공 핸들러 예시
/// .setFailHandler(errorData => Console.Error.WriteLine(errorData)) // 실패 핸들러 예시
/// .setRetry(5, 2000)
/// .setRepeat(true, 10, 5000);
///
///
public class HttpPipeLineInfo
{
private string _url;
private string _method;
private Dictionary? _headers = null;
private string? _body = null;
private Action? _successhandler = null; //요청 성공 시 호출될 내부 핸들러입니다.
private Action? _failhandler = null; //요청 실패 시 호출될 내부 핸들러입니다.
private bool _repeat = false; // 반복 실행 여부
private int _repeatCount = 0; // 반복 횟수, 0은 무한 반복
private int _repeatInterval = 1000; // 반복 간격 (ms)
private DataMapper? _dataMapper = null; // 데이터 매퍼
private HttpResponseMask _responseMask = new HttpResponseMask(); // response 데이터 성공 여부와 데이터를 구분하는 마스크
private int _maxRetryCount = 3;
private int _retryDelay = 1000; // 밀리초
private bool _updatedDataOnly = false; // 업데이트된 데이터만 받을 여부
///
/// 요청을 보낼 URL 주소
///
public string Url => _url;
///
/// HTTP 요청 메서드 (GET, POST 등)
///
public string Method => _method;
///
/// HTTP 요청 헤더
///
public Dictionary? Headers => _headers;
///
/// HTTP 요청 본문
///
public string? Body => _body;
///
/// 요청 성공 시 호출될 핸들러
///
public Action? SuccessHandler => _successhandler;
///
/// 요청 실패 시 호출될 핸들러
///
public Action? FailHandler => _failhandler;
///
/// 반복 실행 여부
///
public bool Repeat => _repeat;
///
/// 반복 횟수, 0은 무한 반복
///
public int RepeatCount => _repeatCount;
///
/// 반복 간격 (ms)
///
public int RepeatInterval => _repeatInterval;
///
/// 데이터 매퍼 객체
///
public DataMapper? DataMapper => _dataMapper;
///
/// HTTP 응답의 성공 여부를 확인하고, 성공 시 실제 데이터 페이로드를 추출하는 데 사용되는 입니다.
/// 이 객체에 정의된 규칙에 따라 원시 응답 문자열이 처리됩니다.
///
public HttpResponseMask ResponseMask => _responseMask;
///
/// 최대 재시도 횟수
///
public int MaxRetryCount => _maxRetryCount;
///
/// 재시도 간격 (ms)
///
public int RetryDelay => _retryDelay;
///
/// 업데이트된 데이터만 받을 여부 (true로 설정하면, 데이터가 변경된 경우에만 핸들러가 호출됩니다)
///
public bool UpdatedDataOnly => _updatedDataOnly;
///
/// HttpPipeLineInfo 클래스의 새 인스턴스를 초기화합니다.
///
/// HTTP 요청을 보낼 URL
/// HTTP 요청 메서드 (기본값: "post")
/// HTTP 요청 헤더 (선택사항)
/// HTTP 요청 본문 (선택사항)
public HttpPipeLineInfo(string url, string method = "post", Dictionary? headers = null, string? body = null)
{
_url = url;
_method = method;
_headers = headers;
_body = body;
}
///
/// HTTP 요청 응답을 처리할 데이터 매퍼를 설정합니다.
/// 데이터 매퍼는 HTTP 응답을 IDataObject로 변환하는 역할을 합니다.
///
/// 사용할 데이터 매퍼 객체
/// 현재 HttpPipeLineInfo 인스턴스 (메서드 체이닝용)
public HttpPipeLineInfo setDataMapper(DataMapper dataMapper)
{
_dataMapper = dataMapper;
return this;
}
///
/// HTTP 파이프라인에 적용할 ResponseMask를 설정하고 업데이트된 파이프라인 구성을 반환합니다.
///
/// HTTP response에 적용할 입니다.
/// 지정된 response 마스크가 적용된 업데이트된 인스턴스입니다.
public HttpPipeLineInfo setResponseMask(HttpResponseMask responseMask)
{
_responseMask = responseMask;
return this;
}
///
/// HTTP 요청이 완료된 후 호출될 핸들러를 설정합니다.
/// 변경 된 데이터는 IDataObject로 전달됩니다.
/// UpdatedDataOnly=true일 경우 변경 된 데이터가 없으면 호출 되지 않습니다.
///
/// 응답 데이터를 처리할 콜백 함수
/// 현재 HttpPipeLineInfo 인스턴스 (메서드 체이닝용)
public HttpPipeLineInfo setSuccessHandler(Action? handler)
{
_successhandler = handler;
return this;
}
///
/// HTTP 요청이 실패했을 때 호출될 핸들러를 설정합니다.
/// 실패 정보 또는 관련 데이터가 string 형태로 전달될 수 있습니다.
///
/// 실패 정보를 처리할 콜백 함수입니다. 실패 시 관련 데이터를 인자로 받습니다.
/// 현재 HttpPipeLineInfo 인스턴스 (메서드 체이닝용)
public HttpPipeLineInfo setFailHandler(Action? handler)
{
_failhandler = handler;
return this;
}
///
/// HTTP 요청 실패 시 재시도 정책을 설정합니다.
///
/// 최대 재시도 횟수 (기본값: 3)
/// 재시도 간 대기 시간(밀리초) (기본값: 1000)
/// 현재 HttpPipeLineInfo 인스턴스 (메서드 체이닝용)
public HttpPipeLineInfo setRetry(int maxRetryCount = 3, int retryDelay = 1000)
{
_maxRetryCount = maxRetryCount;
_retryDelay = retryDelay;
return this;
}
///
/// HTTP 요청의 반복 실행 설정을 구성합니다.
///
/// 반복 실행 여부
/// 반복 횟수 (0은 무한 반복) (기본값: 0)
/// 반복 실행 간 대기 시간(밀리초) (기본값: 1000)
/// 변경된 데이터만 처리할지 여부 (기본값: true)
/// 현재 HttpPipeLineInfo 인스턴스 (메서드 체이닝용)
///
/// 반복 요청 시 updatedDataOnly가 true인 경우, 서버 응답에서 데이터가 변경된 경우에만 핸들러가 호출됩니다.
/// 이는 불필요한 데이터 처리를 방지하고 성능을 향상시키는 데 도움이 됩니다.
///
///
///
/// // 5초마다 10번 반복 요청, 변경된 데이터만 처리
/// var pipelineInfo = new HttpPipeLineInfo("https://api.example.com/data", "GET")
/// .setHandler(data => ProcessData(data))
/// .setRepeat(true, 10, 5000, true);
///
/// // 3초마다 무한 반복, 모든 응답 데이터 처리
/// var pipelineInfo = new HttpPipeLineInfo("https://api.example.com/status", "GET")
/// .setHandler(data => UpdateStatus(data))
/// .setRepeat(true, 0, 3000, false);
///
///
public HttpPipeLineInfo setRepeat(bool repeat, int count = 0, int interval = 1000, bool updatedDataOnly = true)
{
_repeat = repeat;
_repeatCount = count;
_repeatInterval = interval;
_updatedDataOnly = updatedDataOnly; // true로 설정하면, 데이터가 변경된 경우에만 핸들러가 호출됩니다.
return this;
}
}
}