Archer.Extension

NUGET package | UITC每個專案都會用的方法獨立出來放這

.Net version

.NET Standard 2.0

Using

using Archer.Extension

IdentityHelper

自然人與法人身分識別工具

function name	paramter type	return type	description
DetermineEntityType	string	EntityType	判斷身分證號或統一編號屬於自然人還是法人
IsValidNationalId	string	bool	驗證台灣身分證號格式及檢查碼
IsValidBusinessRegistrationNumber	string	bool	驗證台灣統一編號格式及檢查碼

EntityType enum:

• NaturalPerson (自然人)
• LegalEntity (法人)
• Unknown (未知或無效)

extension methods:

string nationalId = "A123456789";
string businessId = "53212539";

// 使用extension methods
bool isNatural = nationalId.IsNaturalPerson();
bool isLegal = businessId.IsLegalEntity();
EntityType type = nationalId.GetEntityType();
bool validNationalId = nationalId.IsValidNationalId();
bool validBusinessId = businessId.IsValidBusinessNumber();

// 使用靜態方法
EntityType type2 = IdentityHelper.DetermineEntityType("A123456789");
bool valid = IdentityHelper.IsValidNationalId("A123456789");

Security helper

an encrypting and decryting helper

function name	paramter type	return type
EncryptConn	string	string
DecryptConn	string	string
GetMd5Hash	string	string
GetSha256Hash	string	byte[]

example:

string _keyConn = "keyConn";
string _ivConn = "ivConn";
string _keyData = "keyData";
string _ivData = "ivData";

SecurityHelper helper = new SecurityHelper(_keyConn, _ivConn, _keyData, _ivData);

string connectionString = "connection string";

string encryptedConnectionString = helper.EncryptConn(connectionString);
string decryptedConnectionString = helper.DecryptConn(encryptedConnectionString);

JwtHelper

function name	paramter type	return type	description
GenerateToken	object	Exception?	Generate token by token model
ValidateToken	string	bool	validate token

DatabaseHelper

function name	paramter type	return type	description
CreateConnectionBy	string, DatabaseTypeEnum	IDbConnection	create IDbConnection by connection string

WatermarkHelper

命名空間: Archer.Extension.Images

function	name	description
AddWatermarkToImages	給圖片增加浮水印
RemoveWatermark	[實驗性功能] 移除浮水印

給圖片增加浮水印

using Archer.Extension.Images;

string base64Image = string.Empty;
using (FileStream fs = new FileStream(@"D:\暫時\IMG_0123.jpg", FileMode.Open, FileAccess.Read))
{
    byte[] buffer = new byte[fs.Length];
    fs.Read(buffer, 0, buffer.Length);

    base64Image = Convert.ToBase64String(buffer);
}

WatermarkHelper watermarkHelper = new WatermarkHelper();

string[] watermarkImages = watermarkHelper.AddWatermarkToImages(new string[] { base64Image },
    "想按摩師傅的小腿肚，嘿嘿嘿",
    new Font(FontFamily.GenericSerif, 50, FontStyle.Bold, GraphicsUnit.Pixel),
    Color.FromArgb(127, 0, 153, 153),
    WatermarkPosition.MiddleCenter);

移除浮水印

// 浮水印顏色
Color watermarkColor = Color.FromArgb(127, 0, 153, 153);

// 顏色相似度閾值
int threshold = 100;

string removedResult = watermarkHelper.RemoveWatermark(watermarkImages[0], watermarkColor, threshold);

byte[] buffer2 = Convert.FromBase64String(removedResult);

using (FileStream fs2 = new FileStream($@"D:\暫時\IMG_0123_watermarked_removedResult.jpg", FileMode.Create, FileAccess.Write))
{
    fs2.Write(buffer2, 0, buffer2.Length);
}

Extension method

Some useful extension method

function name	paramter type	return type
ThrowIfNull	object	Exception?
GetDescription	Enum	string
IsNaturalPerson	string	bool
IsLegalEntity	string	bool
GetEntityType	string	EntityType
IsValidNationalId	string	bool
IsValidBusinessNumber	string	bool

example:

users.ThrowIfNull(nameof(users));

// 自然人法人判斷
string id = "A123456789";
bool isNatural = id.IsNaturalPerson();  // True
EntityType type = id.GetEntityType();   // EntityType.NaturalPerson