本文来自:http://fluentdata.codeplex.com/wikipage?title=Fluency&referringTitle=Home

Documentation  Fluency

This contribution is an attempt to speedup the development of domain layer in bottom to top model with FluentData. This means you already have the Database created and you need a quick way to write the Entity wrapers and common CURD operations. The goal of fluency is to provide T4 templates to generate a domain layer which has very minimal learning curve and very simple to use. At the moment Fluency supports the Table Data Gateway pattern which is very simple to understand and use.

How to use Fluency Templates?

The recommended way to use Fluency Template is by using TextTransform.exe tool. This is a command-line tool that you can use to transform a text template. When you call TextTransform.exe, you specify the name of a text template file as an argument. TextTransform.exe calls the text transformation engine and processes the text template. This tool accepts optional parameters in case your template requires some parameters which is the case with the template you will be using. TextTransform.exe is located in the following directory:

\Program Files\Common Files\Microsoft Shared\TextTemplating\10.0 
or
\Program Files\Common Files\Microsoft Shared\TextTemplating\11.0 

depending upon which version of visual studio you have. Also depending upon if you are using 64bit OS you may need to look under Program Files(X86) for the above location.

Adding new external tool

First of all you need to locate the TextTransform.exe as explained above. For my install since I am using Visual Studio 2010(32bit) on 64bit windows the location of TextTransform.exe is following
C:\Program Files (x86)\Common Files\Microsoft Shared\TextTemplating\10.0\TextTransform.exe

Now we have to do the following steps in order to add a new external tool under Visual Studio Tools menu.

  1. Copy Fluency folder from Contributions and move it under your Solution folder.
  2. Open Visual Studio and go to Tools -> External Tools menu and click Add button. This will add a blank external tool.
  3. In Title textbox enter Fluency while in Command textbox enter the full path to TextTransform.exe which in my case is C:\Program Files (x86)\Common Files\Microsoft Shared\TextTemplating\10.0\TextTransform.exe
  4. Now place following text in Arguments textbox
$(SolutionDir)\Fluency\TableDataGateway.tt -out  $(SolutionDir)/Entities.Generated.cs -a !!ns!MyDomain -a !!cs!Server=YOUR_SERVER_NAME;Database=MyDb;Trusted_Connection=true -a !!csn!MyDb
  • Here $(SolutionDir)\Fluency\TableDataGateway.tt is the path to template under your solution folder.
  • -out $(SolutionDir)/Entities.Generated.cs tells the path and name of generated file in your solution folder.
  • -a !!ns!MyDomain tells the template about namespace for generated code where !!ns is parameter name and !MyDomain tells value which is MyDomain.
  • -a !!cs!Server=YOUR_SERVER_NAME;Database=MyDb;Trusted_Connection=true tells the database connection string from where template has to generate the code.
  • Lastly -a !!csn!MyDb tells the name of connection string in web.config which will be used by generated code when opening a database connection. In this case connection string name is MyDb you will replace this with what ever is yours.

Now click OK button and new external tool will be added to your Tools menu. Finally open your Solution in Visual Studio and then go to Tools menu and click on Fluency. It will open a dialogue box just click on OK button and it will generate the code under you solutoin folder! Now that template is configured you can always regenerate your code in few clicks.

Understanding the generated code !!

There will be two classes generated for every table in database. First one will be entity class which will contain fields corrosponding to Database table. The second will be Gateway class which will contain common method for CURD operations. Lets suppose we have a table called Product in Database with following schema

        CREATE TABLE [dbo].[Product](
[Id] [int] IDENTITY(1,1) NOT NULL,
[Name] [nvarchar](256) NOT NULL,
[Price] [decimal](18, 2) NOT NULL,
[Sku] [nvarchar](256) NULL,
[Description] [nvarchar](max) NULL,
[ManufacturerId] [int] NULL,
[CreatedOn] [datetime] NULL,
[ModifiedOn] [datetime] NULL
CONSTRAINT [PK_Product] PRIMARY KEY CLUSTERED ([Id] ASC))

The code generated for product table will consist of following two classes

        /// <summary>
/// Product entity class
/// </summary>
public partial class Product
{
public int Id { get; set; }
public string Name { get; set; }
public decimal Price { get; set; }
public string Sku { get; set; }
public string Description { get; set; }
public int ManufacturerId { get; set; }
public DateTime CreatedOn { get; set; }
public DateTime ModifiedOn { get; set; }
} /// <summary>
/// Product gateway class
/// </summary>
public partial class ProductGateway
{
private static IDbContext Context()
{
return new DbContext().ConnectionStringName("MyDb",
new SqlServerProvider());
} public static Product Select(int id)
{
using(var context = Context())
{
return context.Sql(" SELECT * FROM Product WHERE Id = @id ")
.Parameter("id", id)
.QuerySingle<Product>();
}
} public static List<Product> SelectAll()
{
return SelectAll(string.Empty);
} public static List<Product> SelectAll(string sortExpression)
{
return SelectAll(0, 0, sortExpression);
} public static List<Product> SelectAll(int startRowIndex, int maximumRows, string sortExpression)
{
using (var context = Context())
{
var select = context.Select<Product>(" * ")
.From(" Product "); if (maximumRows > 0)
{
if (startRowIndex == 0)
startRowIndex = 1; select.Paging(startRowIndex, maximumRows);
} if (!string.IsNullOrEmpty(sortExpression))
select.OrderBy(sortExpression); return select.QueryMany();
}
} public static int CountAll()
{
using (var context = Context())
{
return context.Sql(" SELECT COUNT(*) FROM Product ")
.QuerySingle<int>();
}
} public static List<Product> SelectByManufacturer(int manufacturerId)
{
return SelectByManufacturer(manufacturerId, string.Empty);
} public static List<Product> SelectByManufacturer(int manufacturerId, string sortExpression)
{
return SelectByManufacturer(manufacturerId, 0, 0, sortExpression);
} public static List<Product> SelectByManufacturer(int manufacturerId, int startRowIndex, int maximumRows, string sortExpression)
{
using (var context = Context())
{
var select = context.Select<Product>(" * ")
.From(" Product ")
.Where(" ManufacturerId = @manufacturerid ")
.Parameter("manufacturerid", manufacturerId); if (maximumRows > 0)
{
if (startRowIndex == 0)
startRowIndex = 1; select.Paging(startRowIndex, maximumRows);
} if (!string.IsNullOrEmpty(sortExpression))
select.OrderBy(sortExpression); return select.QueryMany();
}
} public static int CountByManufacturer(int manufacturerId)
{
using (var context = Context())
{
return context.Sql(" SELECT COUNT(*) FROM Product WHERE ManufacturerId = @manufacturerid")
.Parameter("manufacturerid", manufacturerId)
.QuerySingle<int>();
}
} public static bool Insert(Product product)
{
using (var context = Context())
{
int id = context.Insert<Product>("Product", product)
.AutoMap(x => x.Id)
.ExecuteReturnLastId<int>(); product.Id = id;
return id > 0;
}
}
public static bool Update(Product product)
{
using (var context = Context())
{
return context.Update<Product>("Product", product)
.AutoMap(x => x.Id)
.Execute() > 0;
}
} public static bool Delete(Product product)
{
return Delete(product.Id);
} public static bool Delete(int id)
{
using (var context = Context())
{
return context.Sql(" DELETE FROM Product WHERE Id = @id ")
.Parameter("id", id)
.Execute() > 0;
}
}
}

Select single product by Id

        Product product = ProductGateway.Select(103);

Select all products

        List<Product> products = ProductGateway.SelectAll();

Count all products

        int count = ProductGateway.CountAll();

Select all products with paging

        // LOAD FIRST 20 PRODUCTS ORDER BY ID
List<Product> products = ProductGateway.SelectAll(1, 20, "Id ASC");

Select all products for manufacturer foreign key

        // LOAD FIRST 20 PRODUCTS ORDER BY NAME FOR MANUFACTURER ID 91
List<Product> products = ProductGateway.SelectByManufacturer(91,1, 20, "Name ASC");

Insert new product

            Product product = new Product() { Name = "New Product", Price = 111, Sku = "SKU-111", Description = "None" };
ProductGateway.Insert(product); // IF PRIMARYKEY IS IDENTITY THEN IT WILL BE SET BACK TO THE OBJECT
Console.Writeline(string.Format("Product Id = {0}", product.Id));

Update existing product

        Product product = ProductGateway.Select(103);
product.Price = 200;
ProductGateway.Update(product);

Delete existing product

        Product product = ProductGateway.Select(103);
ProductGateway.Delete(product);
 

Last edited Jun 25, 2013 at 6:55 AM by leadfoot, version 28

[转]FluentData的更多相关文章

  1. FluentData(微型ORM)

    using FluentData; using System; using System.Collections.Generic; using System.Linq; using System.Te ...

  2. 在不安装mysql-connector-net的情况下使用FluentData框架

    最近在开发项目中使用了FluentData框架,通过使用这个框架减少了很多开发的工作量,FluentData是一个轻量级的框架操作起来的自由度很大也少了很多负责的配置.但是在开发的时候发现一个问题就是 ...

  3. 微型orm fluentdata

    http://fluentdata.codeplex.com/documentation#Query

  4. FluentData Mysql分页的一个BUG

    开发环境 FluentData3.0.VS.NET2010.Mysql5.0 问题描述 使用FluentData对一个表(记录数28)进行分页时,突然发现一个诡异的问题,第一页返回10条数据正常,第二 ...

  5. FluentData,它是一个轻量级框架,关注性能和易用性。

    http://www.cnblogs.com/zengxiangzhan/p/3250105.html FluentData,它是一个轻量级框架,关注性能和易用性. 下载地址:FlunenData.M ...

  6. 快速上手如何使用FluentData

    http://blog.itpub.net/29511780/viewspace-1194048/ 目录:  一.什么是ORM? 二.使用ORM的优势 三.使用ORM的缺点 四.NET下的ORM框架有 ...

  7. FluentData官方文档翻译

    开始 要求 .NET 4.0. 支持的数据库 MS SQL Server using the native .NET driver. MS SQL Azure using the native .NE ...

  8. FluentData微型ORM

    最近在帮朋友做一个简单管理系统,因为笔者够懒,但是使用过的NHibernate用来做这中项目又太不实际了,索性百度了微型ORM,FluentData是第一个跳入我眼睛的词.简单的了解下FluentDa ...

  9. Oracle+FluentData+MVC4+EasyUI开发权限管理系统之开篇

    在园子里有很多EF+MVC+EasyUI的框架实在是太多了,经过在一段时间的学习高手写的思路,但是都是针对Sql数据的,但是今年我当上研发组组长的第一个任务就是编写一个通用平台框架,一刚开始想把学习过 ...

  10. orm fluentdata使用相关文章

    微型orm fluentdata使用:http://www.360doc.com/content/12/1228/23/9200790_256885743.shtml

随机推荐

  1. luogu p1101 单词方阵

    https://www.luogu.org/problem/show?pid=1101 很恶心的代码  就是八个方向都搜索 #include<bits/stdc++.h> using na ...

  2. (转载)CUDA、tensorflow与cuDNN的版本匹配问题

    转载:https://blog.csdn.net/MahoneSun/article/details/80809042 CUDA.tensorflow与cuDNN的版本匹配问题 一.问题现象 CUDA ...

  3. Qt570_CentOS64x64_01

    ZC: 其实 主要是要安装 OpenGL,具体看"3"... ... 1.运行 "/opt/Qt5.7.0/Tools/QtCreator/bin/qtcreator&q ...

  4. mysql explain extended 查看 执行计划

    本文以转移至本人的个人博客,请多多关注! 本文以转移至本人的个人博客,请多多关注! 本文以转移至本人的个人博客,请多多关注! 本文以转移至本人的个人博客,请多多关注! 1. explain 可以查看 ...

  5. 从invalidAuthenticationToken❌想到需要忽略:verify_authenticity_token。

    https://www.cnblogs.com/chentianwei/diary/2018/07/11/9296126.html 这篇日记记录了我遇到的invalidAuthenticaitonTo ...

  6. 流量监控iftop安装-CentOS7

    继之前撘的服务器后路由器一直崩溃,今天找到了原因.之前被下的木马并没有被删掉,而是一直在传输数据.占用了所有宽带. 官网(http://www.ex-parrot.com/pdw/iftop/down ...

  7. ZOJ-3962-数位dp

    http://acm.zju.edu.cn/onlinejudge/showProblem.do?problemId=5594             16进制下的数位dp,由于固定了位数,可以出现前 ...

  8. 解决ubuntu登陆失败,"Failed to start session"的问题

    我是在虚拟机中安装了Ubuntu 14.04 系统,在Ubuntu 中执行 apt-get update  和  apt-get upgrade 命令后,然后重启系统.    但是,在重启成功后,在登 ...

  9. Swagger使用总结(十九)

    1. Swagger是什么? Swagger 是一款RESTFUL接口的文档在线自动生成+功能测试功能软件. 官方说法:Swagger是一个规范和完整的框架,用于生成.描述.调用和可视化 RESTfu ...

  10. halcon之最小二乘拟合直线

    如果不了解最小二乘算法 请先阅读: Least squares的算法细节原理https://en.wikipedia.org/wiki/Least_squares 通常在halcon中拟合直线会用ho ...