メリット
シンプルなコーディング
高度な機能のコーディングが簡単で、データアクセスはメンテナンスコストを最小限に抑えるため、モデルに含まれています。
タイプセーフなクエリ
.NETオブジェクトは、タイプセーフでクエリ条件として使用され、SQLを検証するテスト用APIも提供されています。
柔軟なSQL生成
SQLの生成は、モデル属性の包括的なセットを介して制御しますが、必要に応じてSQLを直接コーディングできます。
柔軟なリレーション
リレーションシップは事前定義ではなくコーディングで定義するため、特定クエリ内でのみ有効です。
トランザクション指向
クエリ、アップデート、アクションを追跡でき、トランザクション管理が自動で適用されます。
超高速パフォーマンス
ADO.NET上のオーバーヘッドはほとんどなく、クエリ、アップデート、アクションは一括で実行されます。
コードスニペット
- Model
- Retrieve
- Delete
- Update
- Transaction
Generating complex SQL queries is controlled by intuitive attributes applied to the model.
namespace Appeon.SqlModelMapperDemo.Models
{
//Generates the underlying SQL query according to the attributes
[Top(1000)]
[SqlParameter("custId", typeof(int))]
[SqlParameter("stratOrderDate", typeof(DateTime))]
[SqlParameter("endOrderDate", typeof(DateTime))]
[Table("SalesOrderHeader",Schema = "Sales")]
[SqlWhere("(CustomerId = :custId) and (Orderdate Between :stratOrderDate and :endOrderDate)")]
public class SalesOrder
{
[Key]
[Identity]
public int SalesOrderID { get; set; }
[Required]
public DateTime? OrderDate { get; set; }
[Required]
public byte? Status { get; set; }
[Required]
public bool? OnlineOrderFlag { get; set; }
[SqlCompute("(isnull(N'SO'+CONVERT([nvarchar](23),[SalesOrderID]),N'*** ERROR ***'))")]
public string SalesOrderNumber { get; set; }
[Required]
public int? CustomerID { get; set; }
[SqlCompute("(isnull(([SubTotal]+[TaxAmt])+[Freight],(0)))")]
public decimal? TotalDue { get; set; }
public DateTime? ModifiedDate { get; set; }
//Nests a model and applies various attributes
[JsonIgnore]
[SetValue("$SalesOrderID", "$SalesOrderID", SetValueStrategy.Always)]
[ModelEmbedded(typeof(SalesOrderDetail), ParamValue = "$SalesOrderID",
CascadeCreate =true, CascadeDelete = true)]
public IList< salesorderdetail> OrderDetails { get; set; }
}
}
Retrieving data and loading it into the model only requires parameters – no unproductive query language is necessary.
//Retrieves multiple rows of data, loads it into the model, and then puts it into a list
_context.SqlModelMapper.Load< salesorderquery>(startDate, endDate, customerId)
.ToList();
//Retrieves a single row of data and loads it into the model
_context.SqlModelMapper.LoadByKey< salesorder>(orderId)
.FirstOrDefault();
Deleting data (including data of a master-detail) only requires a key or the model.
//Deletes data corresponding with the specified key – either a single row of data or if a nested model then the cascaded data
_context.SqlModelMapper.TrackDeleteByKey< salesorder>(orderId)
.SaveChanges()
// Deletes data corresponding with the specified model – either a single row of data or if a nested model then the cascaded data
_context.SqlModelMapper.TrackDelete(salesOrder)
.SaveChanges()
Saving data is controlled by intuitive tracking functions, with granular control whether to save the entire master-detail relationship or portion thereof (by including/excluding the appropriate TrackDetails).
//Saves data with a master-detail-detail relationship
_context.SqlModelMapper.TrackMaster(header)
.TrackDetails(o => o.SalesReasons, reasons)
.TrackDetails(o => o.Details, details);
_context.SqlModelMapper.SaveChanges();
Managing transactions is made effortless by powerful implicit capability – comprehensive tracking functions (that go way beyond tracking just the model) determine what is included.
//Tracks various models, raw SQL, and actions
_context.SqlModelMapper.TrackCreate(salesOrder)
.Track((saveContext) =>
{
//C# code block
……
}) //The C# code block will be executed when SaveChanges is called
.TrackUpdate(salesPerson)
.TrackSqlCUD(rawSql)
.SaveChanges() //Executes all tracked items in one transaction and automatically commits or rolls back
機能
Model
Modelは、データベースのカラムをマッピングし、関連するSQLを含んでいます。 ModelのSQLは、さまざまな属性に基づいて生成されるため、開発者はSQLを制御することができます。 また、ModelはModel自体をネストすることにより、親-子-孫などの複雑な関係を表すことができます。
SQLModelMapper
SQLModelMapperは、トランザクション指向のデータ操作コンポーネントです。 データベースのCRUD操作をシンプルにするオブジェクトとメソッドを提供し、トラッキングする項目に自動トランザクション管理を適用します。 また、トラッキングアイテムはパフォーマンスを向上させるために一括で実行します。
クエリ
クエリを実行し、結果をテンポラリオブジェクトにロードして処理するか、計算された結果を返します。
集計&スカラーロード
モデルで定義されたクエリを実行し、集計またはスカラー計算とともに結果を返します。
トラッキング
トランザクション管理の目的として、モデルの変更、SQL、アクションをトラッキングします。
実行
モデル、SQL、アクションでトラッキングしたすべてのデータベース操作をデータベースへ一括送信し、ModelMapperにトランザクションを管理させます。
変更の保存
トラッキングアイテム(モデルの変更、SQL、アクション)の実行により、データベースへのすべての変更を保存します。トラッキングアイテムは、パフォーマンスを向上させるために一括で実行します。
非同期
CRUD操作を非同期で実行します。
非同期クエリ
データを非同期で取得し、プレーンまたは加工して検索結果にロードします。