Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SoftStoneDevelop/Gedaq
ORM Gedaq is generator for obtaining and mapping data from the database.
https://github.com/SoftStoneDevelop/Gedaq
ado-net code-generation csharp dbconnection dotnet mapping micro-orm mysql mysqlconnector netcore6 npgsql oracle-manageddataacess-core orm postgres roslyn roslyn-generator sql sqlclient
Last synced: about 1 month ago
JSON representation
ORM Gedaq is generator for obtaining and mapping data from the database.
- Host: GitHub
- URL: https://github.com/SoftStoneDevelop/Gedaq
- Owner: SoftStoneDevelop
- License: mit
- Created: 2022-09-10T04:13:08.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-08T20:56:25.000Z (about 1 year ago)
- Last Synced: 2024-08-01T22:43:37.677Z (4 months ago)
- Topics: ado-net, code-generation, csharp, dbconnection, dotnet, mapping, micro-orm, mysql, mysqlconnector, netcore6, npgsql, oracle-manageddataacess-core, orm, postgres, roslyn, roslyn-generator, sql, sqlclient
- Language: C#
- Homepage:
- Size: 1.91 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- RSCG_Examples - https://github.com/SoftStoneDevelop/Gedaq
README
Gedaq
![]()
[](https://www.nuget.org/packages/Gedaq/)
[](https://www.nuget.org/packages/Gedaq/)
[](https://github.com/SoftStoneDevelop/Gedaq/stargazers)
[](LICENSE)
Generator for obtaining and mapping data from the database.
Generates methods (synchronous and/or asynchronous):
- Creating a Command for a query
- Method of setting parameters in a Command
- Command execution, with data mapping
- Creating a QueryBatch Command
- Setting parameters in a QueryBatch Command
- Get data from a batch Command
- Receiving data from a batch of queries, with data mapping
- Getting data based on a query, with data mapping
There are versions for all of these methods (if possible):
- Query
- NonQuery
- ЕecuteScalar (return type is determined automatically at the generation stage)
It also generates methods specific to each provider, such as BinaryImport and BinaryExport in PostgreSQL.
Supported databases(see examples and documentation in the relevant DB package):
- [Npgsql](https://github.com/SoftStoneDevelop/Gedaq.Npgsql)
- [DbConnection](https://github.com/SoftStoneDevelop/Gedaq.DbConnection)
- [SqlClient](https://github.com/SoftStoneDevelop/Gedaq.SqlClient)
- [MySqlConnector](https://github.com/SoftStoneDevelop/Gedaq.MySqlConnector)
- [Oracle.ManagedDataAccess.Core](https://github.com/SoftStoneDevelop/Gedaq/issues/6)
Usage:
For example, we have a Person class:
```C#
public class Person
{
public int Id { get; set; }
public string FirstName { get; set; }
public string MiddleName { get; set; }
public string LastName { get; set; }
public Identification Identification { get; set; }
}
public class Identification
{
public int Id { get; set; }
public string TypeName { get; set; }
}
```
We just mark anywhere in the code with a special attribute (class, structure, method) that tells the analyzer to generate the code.
Let's mark the Person class itself with an attribute:
```C#
[Query(
@"
SELECT
p.id,
p.firstname,
~StartInner::Identification:id~
i.id,
i.typename,
~EndInner::Identification~
p.middlename,
p.lastname
FROM person p
LEFT JOIN identification i ON i.id = p.identification_id
WHERE p.id > $1
",
"GetAllPerson",
typeof(Person),
MethodType.Sync | MethodType.Async
),
Parametr(parametrType: typeof(int), position: 1)
]
public class Person
//...
```
Now in the code we can call the ready method:
```C#
var persons =
connection
.GetAllPerson(49999)
.ToList();
var personsAsync =
await connection
.GetAllPersonAsync(49999)
.ToListAsync();
```
[Comparison](https://github.com/SoftStoneDevelop/Gedaq.Npgsql/blob/main/Src/NpgsqlBenchmark/Benchmarks/CompareDapper.cs) with [Dapper](https://github.com/DapperLib/Dapper) and [DapperAOT](https://github.com/DapperLib/DapperAOT) of getting 50000 Person in a loop(Size is number of loop iterations) from the database:
## .NET 7 Benchmark:
| Method | Size | Mean | Ratio | Allocated | Alloc Ratio |
|------------- |----- |-----------:|------:|----------:|------------:|
| **Gedaq.Npgsql** | **10** | **445.5 ms** | **1.00** | **132.09 MB** | **1.00** |
| Dapper | 10 | 749.2 ms | 1.68 | 150.41 MB | 1.14 |
| DapperAOT | 10 | 777.5 ms | 1.75 | 150.4 MB | 1.14 |
| | | | | | |
| **Gedaq.Npgsql** | **20** | **901.9 ms** | **1.00** | **264.17 MB** | **1.00** |
| Dapper | 20 | 1,510.0 ms | 1.68 | 300.81 MB | 1.14 |
| DapperAOT | 20 | 1,505.3 ms | 1.67 | 300.81 MB | 1.14 |
| | | | | | |
| **Gedaq.Npgsql** | **30** | **1,366.2 ms** | **1.00** | **396.28 MB** | **1.00** |
| Dapper | 30 | 2,276.7 ms | 1.67 | 451.22 MB | 1.14 |
| DapperAOT | 30 | 2,279.6 ms | 1.67 | 451.22 MB | 1.14 |
But with Gedaq, we can prepare the command in advance.
```C#
var personsCmd = connection.CreateGetAllPersonCommand(prepare: true);
personsCmd.SetGetAllPersonParametrs(49999);
var persons = personsCmd.ExecuteGetAllPersonCommand().ToList();
//or
var personsCmd = await connection.CreateGetAllPersonCommandAsync(prepare: true);
personsCmd.SetGetAllPersonParametrs(49999);
var persons = await personsCmd.ExecuteGetAllPersonCommandAsync().ToListAsync();
```