CleanEngine.Shared.Extension 3.0.1-beta

CleanEngine.Shared.Extension

CleanEngine.Shared.Extension is an extension for commonly used functions and rapid development.

Extension for value types convert methods

int integerNum = "123".ToInt32();//123
double longNum = "123.456".ToDouble();//123.456
decimal roundDecimal = 123.456m.ToRound(2);//123.46
double roundDouble = 123.456d.ToRound(2);//123.46

Extension for json convert

var json = new { Id = 1, Name = "Levi" }.ToJson();//{"Id":1,"Name":"Levi"}
var obj = "{\"Id\":1,\"Name\":\"Levi\"}".ToObject<Student>();
string result = "{\"name\":\"levi\", \"age\":18}".JsonAppendNode("person", new Person(Address: "shenzhen", Count: 100));

Extension for datetime convert

string now = DateTime.Now.ToStandardString();//2024-03-27 16:32:10

Extension for string

bool isEmpty = "".IsEmpty();//true
bool isNotEmpty = "".IsNotEmpty();//false
bool isEqual = "abc".EqualsIgnoreCase("ABC");//true
bool isNumber = "123".IsNumber();//true
bool isInteger = "123.12".IsInteger();//false
bool isDateTime = "2024-03-27".IsDateTime();//true

Extension for IEnumerable

var list = new List<string>() { "abc", "efg", "ggg" };
foreach (var item in list.WithIndex<string>())
{
	var index = item.Index;//get index from collection
	var value = item.Item;
 }
var isEmpty = list.IsNullOrEmpty();//false
var isNotEmpty = list.IsNotNullOrEmpty();//true

File Helper

FilesHelper.AppendOrCreate("x:\\xxx\\xxx.txt", text);//if file not exists, create; And then write text
FilesHelper.AppendOrCreate("x:\\xxx\\xxx.txt", new List<string>() { "123", "456" }););//if file not exists, create; And then write text

Validator Helper

var isIntegerPositive = ValidatorHelper.IsIntegerPositive("-100");//false
var isEnglish = ValidatorHelper.IsEnglishCharacter("abc");//true
var isEnglishAndInteger = ValidatorHelper.IsIntegerAndEnglishCharacter("abc123");//true

HttpClient Helper

One statement for HttpGet/HttpPost (Below version v1.3.0)

//with header
var html = new HttpEngine().GetString("https://www.baidu.com", x=>x.WithHeader("Accept-Language", "zh-CN"));

//with headers
var html2 = new HttpEngine().GetString("https://www.baidu.com", x => x.WithHeaders(new
            {
                Host = "www.baidu.com",
                Connection= "keep-alive"
            }));

//response convert to Object
var obj = new HttpEngine().Post<Employee>("http://192.168.1.1", x=>x.WithBearerToken("token"));

//response convert to List
List<Employee> list = new HttpEngine().PostList<Employee>("http://192.168.1.1");

(Below v3.0.0 and Equal / above version v1.3.0)

var html = new HttpEngineBuilder().Build().PostString("https://www.baidu.com");

var result = new HttpEngineBuilder().AddRequestBody(x => x.WithObject(new
{
    password = "password",
    userCode = "user"
})).Build().PostString("http://192.168.1.1:8888/api/login");

var html = _httpEngineBuilder.AddRequestHeader(x => x.WithHeaders(new
{
    Host = "www.baidu.com",
    Connection = "keep-alive"
})).Build().GetString("https://www.baidu.com");

var result = new HttpEngineBuilder().AddRequestBody(x => x.WithObject(new
{
    password = "password",
    userCode = "user"
})).Build().PostString<TestResponse>("http://192.168.1.1:8888/api/login");

(Equal and above version v3.0.0)

(v3.0.0版本及以上)

//.net framework
var html = new HttpBuilder().PostString("https://www.baidu.com");

var httpBuilder = new HttpBuilder();
var result = new HttpBuilder().AddRequestBody(x => x.WithObject(new
{
    password = "password",
    userCode = "user"
})).PostString("http://192.168.1.1:8888/api/login");

var html = new HttpBuilder().AddRequestHeader(x => x.WithHeaders(new
{
    Host = "www.baidu.com",
    Connection = "keep-alive"
})).GetString("https://www.baidu.com");

var result = new HttpBuilder().AddRequestBody(x => x.WithObject(new
{
    password = "password",
    userCode = "user"
})).PostString<TestResponse>("http://192.168.1.1:8888/api/login");

//.net core

//.net8 demo:
//register
builder.Services.AddHttpClient();
builder.Services.AddScoped<IHttpEngineAdapter, HttpEngineAdapter>();
builder.Services.AddScoped<IHttpBuilder, HttpBuilder>();

//add adapter class for use HttpClientFactory
    public class HttpEngineAdapter : IHttpEngineAdapter
    {
        private IHttpClientFactory _httpClientFactory;
        public HttpEngineAdapter(IHttpClientFactory httpClientFactory)
        {
            _httpClientFactory = httpClientFactory;
        }

        public HttpClient CreateHttpClient(string name = null, DelegatingHandler handler = null)
        {
            if (name == null)
                return _httpClientFactory.CreateClient();
            return _httpClientFactory.CreateClient(name);
        }
    }

//DI
    [ApiController]
    [Route("[controller]")]
    public class DebugController : ControllerBase
    {
        private IHttpBuilder _httpBuilder;

        public DebugController(IHttpBuilder httpBuilder)
        {
            _httpBuilder = httpBuilder;
        }
        [HttpPost("GetHtml")]
        public async Task<string> GetHtml()
        {
            return await _httpBuilder.AddRequestHeader(x => x.WithObject(new
                {
                    PageSize = 100,
                    PageNumber = 1,
                    Condition = "Product"
                })).GetStringAsync("https://www.example.com");

        }
        [HttpPost("login")]
        public async Task<IActionResult> login()
        {
            //request by header easily
            var result = await _httpBuilder
                //.AddClientHandler(x=>x.WithClientName("system"))
                .AddRequestHeader(x=>x.WithHeader("authorization", "Bearer HereIsYourBearerToken"))
                .GetStringAsync("https://www.example.com");
            return Ok(result);
        }
    }

(Equal and above version v3.0.1)

(v3.0.1版本及以上)

var httpBuilder = new HttpBuilder();
var result = httpBuilder.AddRequestHeader(x => x.WithHeaders(new
{
    Host = "www.baidu.com",
    Connection = "keep-alive"
})).GetString("https://www.baidu.com");
var afterClear = httpBuilder.Clear().GetString("https://www.baidu.com");//Clear all settings(Headers...) before request

Snowflake Id Generator

long id = IdGenerator.DefaultInstance().NextId();//163697223064879104 Generate a snowflake id
long distributedId = new IdGenerator(1,1).NextId();//163697287460163584 Generate a distibuted snowflake id with distibuted configuration

Reflection Helper

var dept = new Department() { Id = 1, Name = "it" };
string beforValue = ReflectionHelper.SetProperty<Department>(dept, "Name", "hr");//set property by key, value

• v1.3.2 (1)增强FileHelper功能