// update all object members on a row in table based on primary key
// links:
// docLink: http://sql2x.org/documentationLink/ce75e72e-fb16-4f4e-a2e6-dbd079dfa206
public void Update(CrudeProductContract contract)
{
var data = new CrudeProductData();
ContractToData(contract, data);
data.Update();
}
// transfer model to data and update, on a transaction
// links:
// docLink: http://sql2x.org/documentationLink/aa07e05b-edc8-4e09-bf93-bf2a40c93c09
public void Update(CrudeProductModel model, SqlConnection connection, SqlTransaction transaction)
{
var data = new CrudeProductData();
ModelToData(model, data);
data.Update(connection, transaction);
}
// transfer model to data and update
// links:
// docLink: http://sql2x.org/documentationLink/658fda50-2ad3-414e-9299-2b399d17a057
public void Update(CrudeProductModel model)
{
var data = new CrudeProductData();
ModelToData(model, data);
data.Update();
}
// insert all object members as a new row in table
// links:
// docLink: http://sql2x.org/documentationLink/75aad010-e6aa-4f19-a6e5-597456aa20d8
public void Insert(CrudeProductContract contract)
{
var data = new CrudeProductData();
ContractToData(contract, data);
data.Insert();
}
// transfer model to data and insert
// links:
// docLink: http://sql2x.org/documentationLink/17cd8423-3c78-459f-a45b-773fcfbc3b7d
public void Insert(CrudeProductModel model)
{
var data = new CrudeProductData();
ModelToData(model, data);
data.Insert();
}
// update all object members on a row in table based on primary key, on a transaction
// the transaction and or connection state is not changed in any way other than what SqlClient does to it.
// it is the callers responsibility to commit or rollback the transaction
// links:
// docLink: http://sql2x.org/documentationLink/b798ad6b-f4b8-466a-9086-6588a814fcf3
public void Update(CrudeProductContract contract, SqlConnection connection, SqlTransaction transaction)
{
var data = new CrudeProductData();
ContractToData(contract, data);
data.Update(connection, transaction);
}
// copy all columns from a serialized data object to a SOAP Contract
// links:
// docLink: http://sql2x.org/documentationLink/7553d6dd-da65-4a72-84c8-81f2f99ef4f5
public static void DataToContract(CrudeProductData data, CrudeProductContract contract)
{
contract.ProductId = data.ProductId;
contract.ProductName = data.ProductName;
contract.StateRcd = data.StateRcd;
contract.UserId = data.UserId;
contract.DateTime = data.DateTime;
contract.ProductBecameId = data.ProductBecameId;
}
// copy all columns from a SOAP Contract to a serialized data object
// links:
// docLink: http://sql2x.org/documentationLink/10700d38-2227-4021-be12-2f4f206f5dd9
public static void ContractToData(CrudeProductContract contract, CrudeProductData data)
{
data.ProductId = contract.ProductId;
data.ProductName = contract.ProductName;
data.StateRcd = contract.StateRcd;
data.UserId = contract.UserId;
data.DateTime = contract.DateTime;
data.ProductBecameId = contract.ProductBecameId;
}
// transfer model object to data object
// links:
// docLink: http://sql2x.org/documentationLink/95875d99-b7f7-4a9e-baa4-3fbe9925d8a2
public static void ModelToData(CrudeProductModel model, CrudeProductData data)
{
data.ProductId = model.ProductId;
data.ProductName = model.ProductName;
data.StateRcd = model.StateRcd;
data.UserId = model.UserId;
data.DateTime = model.DateTime;
data.ProductBecameId = model.ProductBecameId;
}
// transfer data object to model object
// links:
// docLink: http://sql2x.org/documentationLink/43d57600-5ff5-4ef8-9330-123773d100d3
public static void DataToModel(CrudeProductData data, CrudeProductModel model)
{
model.ProductId = data.ProductId;
model.ProductName = data.ProductName;
model.StateRcd = data.StateRcd;
model.UserId = data.UserId;
model.DateTime = data.DateTime;
model.ProductBecameId = data.ProductBecameId;
}
// copy all rows from a List of SOAP Contracts to a List of serialized data objects
// links:
// docLink: http://sql2x.org/documentationLink/1c6c6b9c-e201-4590-8c69-d38a0ad2a9f7
public static void ContractListToDataList(List <CrudeProductContract> contractList, List <CrudeProductData> dataList)
{
foreach (CrudeProductContract contract in contractList)
{
var data = new CrudeProductData();
CrudeProductService.ContractToData(contract, data);
dataList.Add(data);
}
}
// transfer model list to data list
// links:
// crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
// docLink: http://sql2x.org/documentationLink/1d6a48d9-fe39-4397-b8fa-a332da164cbf
// parameters:
// CrudeProductData: key of table CrudeProductData
public static void ModelListToDataList(List <CrudeProductModel> modelList, List <CrudeProductData> dataList)
{
foreach (CrudeProductModel model in modelList)
{
var data = new CrudeProductData();
ModelToData(model, data);
dataList.Add(data);
}
}
// fetch all from table into new List of class instances, only populating specific columns,
// with a limit on number of returned rows and order by columns starting at a specific row
// links:
// docLink: http://sql2x.org/documentationLink/12d2812e-e963-4f26-8014-48c4e9cfb3ae
public static List <CrudeProductData> FetchAllWithLimitAndOffset(int limit, int offset)
{
var dataList = new List <CrudeProductData>();
// create query against product
// this will be ansi sql and parameterized
// parameterized queries are a good way of preventing sql injection
// and to make sure the query plan is pre-compiled
// links:
// docLink: http://sql2x.org/documentationLink/21eca289-4747-4a75-b0a2-1a58457be608
string sql = @" select product_id, product_name, state_rcd, user_id, date_time, product_became_id
from [product]
order by product_name";
// open standard connection
// the connection is found in web.config
// the connection is closed upon completion of the reader
// links:
// docLink: http://sql2x.org/documentationLink/c3e624a4-8479-4c17-bec7-ec09f3abbe64
using (var conn = new SqlConnection(Conn.ConnectionString)) {
conn.Open();
using (var command = new SqlCommand(sql, conn)) {
// execute query against product
// if the query fails in the preprocessor of sql server
// an exception will be raised
// links:
// docLink: http://sql2x.org/documentationLink/6507b543-adbc-4863-810b-8db439f40d5c
IDataReader reader = command.ExecuteReader(CommandBehavior.SingleResult);
int count = 0;
// read all rows returned from the query of product
// read all columns from the datareader and
// populate the List of C# objects with them
// links:
// docLink: http://sql2x.org/documentationLink/fcd15e2f-df3f-44d8-8a13-d2e93d97f685
while (reader.Read())
{
if ((count >= offset) && (count <= offset + limit))
{
var data = new CrudeProductData();
data.Populate(reader);
dataList.Add(data);
}
count++;
if (count > limit + offset)
{
break;
}
}
}
return(dataList);
}
}
// fetch by Primary key into current object
// links:
// crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
// docLink: http://sql2x.org/documentationLink/fdcc33b4-08f1-43c3-ae28-95fbf029c3bd
// parameters:
// CrudeProductData: primary key of table CrudeProductData
public CrudeProductModel FetchByProductId(System.Guid productId)
{
var dataAccessLayer = new CrudeProductData();
var model = new CrudeProductModel();
dataAccessLayer.FetchByProductId(productId);
DataToModel(dataAccessLayer, model);
return(model);
}
public CrudeProductContract FetchByProductName(string productName)
{
var dataAccessLayer = new CrudeProductData();
var contract = new CrudeProductContract();
dataAccessLayer.FetchByProductName(productName);
DataToContract(dataAccessLayer, contract);
return(contract);
}
// fetch by Primary key into current object
// links:
// crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
// docLink: http://sql2x.org/documentationLink/bbab4791-c9e7-49bf-90d5-fca19b1fedaa
// parameters:
// productId: primary key of table product
public CrudeProductContract FetchByProductId(System.Guid productId)
{
var dataAccessLayer = new CrudeProductData();
var contract = new CrudeProductContract();
dataAccessLayer.FetchByProductId(productId);
DataToContract(dataAccessLayer, contract);
return(contract);
}
// fetch by Search key into current object
// links:
// crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
// docLink: http://sql2x.org/documentationLink/ad2dd952-e3ec-471a-9e34-f5fc965b8b37
// parameters:
// ProductName: key of table CrudeProductData
public CrudeProductModel FetchByProductName(string productName)
{
var dataAccessLayer = new CrudeProductData();
var model = new CrudeProductModel();
dataAccessLayer.FetchByProductName(productName);
DataToModel(dataAccessLayer, model);
return(model);
}
// fetch by Foreign key into new List of class instances
// links:
// docLink: http://sql2x.org/documentationLink/13095cd7-f136-4532-8969-c50c62cc05ef
public static List <CrudeProductData> FetchByStateRcd(string stateRcd)
{
var dataList = new List <CrudeProductData>();
// create query against product
// this will be ansi sql and parameterized
// parameterized queries are a good way of preventing sql injection
// and to make sure the query plan is pre-compiled
// links:
// docLink: http://sql2x.org/documentationLink/86c78f05-a65f-4dfe-b048-d0cbece49f4e
string sql = @" select product_id, product_name, state_rcd, user_id, date_time, product_became_id
from [product]
where state_rcd = @state_rcd
order by product_name";
// open standard connection
// the connection is found in web.config
// the connection is closed upon completion of the reader
// links:
// docLink: http://sql2x.org/documentationLink/6fd25822-459f-4796-803a-071a3a270aa0
using (var conn = new SqlConnection(Conn.ConnectionString)) {
conn.Open();
using (var command = new SqlCommand(sql, conn)) {
// add foreign key column
// this foreign key column will be used together with the prepared ansi sql statement
// links:
// docLink: http://sql2x.org/documentationLink/8aec2e5c-4732-4662-badb-83b89d1c34a9
command.Parameters.Add("@state_rcd", SqlDbType.NVarChar).Value = stateRcd.Replace("'", "''");
// execute query against product
// if the query fails in the preprocessor of sql server
// an exception will be raised
// links:
// docLink: http://sql2x.org/documentationLink/bb9abe5c-d2c1-455a-b597-a2af0a35de5a
IDataReader reader = command.ExecuteReader(CommandBehavior.SingleResult);
// read all rows returned from the query of product
// read all columns from the datareader and
// populate the List of C# objects with them
// links:
// docLink: http://sql2x.org/documentationLink/5c413c03-5ddc-472a-a63d-53aecc7a2573
while (reader.Read())
{
var data = new CrudeProductData();
data.Populate(reader);
dataList.Add(data);
}
}
return(dataList);
}
}
// copy all rows from a List of serialized data objects in CrudeProductData to a List of SOAP Contracts
// links:
// docLink: http://sql2x.org/documentationLink/9204c68e-93b8-4c77-af3c-3181985ff75f
public List <CrudeProductContract> FetchAll()
{
var list = new List <CrudeProductContract>();
List <CrudeProductData> dataList = CrudeProductData.FetchAll();
foreach (CrudeProductData crudeProduct in dataList)
{
var contract = new CrudeProductContract();
DataToContract(crudeProduct, contract);
list.Add(contract);
}
return(list);
}
// copy all rows from a List of serialized data objects to a List of SOAP Contracts,
// with a limit on number of returned rows and order by columns, starting at a specific row
// links:
// docLink: http://sql2x.org/documentationLink/3fe9f1b3-97b6-4f58-a0f2-adfcbd973bfc
public List <CrudeProductContract> FetchAllWithLimitAndOffset(int limit, int offset)
{
var list = new List <CrudeProductContract>();
List <CrudeProductData> dataList = CrudeProductData.FetchAllWithLimitAndOffset(limit, offset);
foreach (CrudeProductData crudeProduct in dataList)
{
var contract = new CrudeProductContract();
DataToContract(crudeProduct, contract);
list.Add(contract);
}
return(list);
}
// fetch all from table into new List of class instances, filtered by any column
// links:
// docLink: http://sql2x.org/documentationLink/db27658d-4d23-46d7-9970-7bbaef8634b0
public List <CrudeProductModel> FetchWithFilter(System.Guid productId, string productName, string stateRcd, System.Guid userId, System.DateTime dateTime, System.Guid productBecameId)
{
var list = new List <CrudeProductModel>();
List <CrudeProductData> dataList = CrudeProductData.FetchWithFilter(productId, productName, stateRcd, userId, dateTime, productBecameId);
foreach (CrudeProductData data in dataList)
{
var crudeProductBusinessModel = new CrudeProductModel();
DataToModel(data, crudeProductBusinessModel);
list.Add(crudeProductBusinessModel);
}
return(list);
}
// fetch all rows from table with an offset, and limit of rows
// links:
// docLink: http://sql2x.org/documentationLink/a87e5c54-b47e-4031-bc3b-837b4cf9f692
public List <CrudeProductModel> FetchAllWithLimitAndOffset(string limit, string offset)
{
var list = new List <CrudeProductModel>();
List <CrudeProductData> dataList = CrudeProductData.FetchAllWithLimitAndOffset(int.Parse(limit), int.Parse(offset));
foreach (CrudeProductData crudeProductBusiness in dataList)
{
var model = new CrudeProductModel();
DataToModel(crudeProductBusiness, model);
list.Add(model);
}
return(list);
}
// copy all rows from a List of serialized data objects in CrudeProductData to a List of SOAP Contracts
// links:
// docLink: http://sql2x.org/documentationLink/3d3e60c3-69e4-43d6-8bd5-14a67a6ecf58
public List <CrudeProductModel> FetchAll()
{
var list = new List <CrudeProductModel>();
List <CrudeProductData> dataList = CrudeProductData.FetchAll();
foreach (CrudeProductData crudeProductBusiness in dataList)
{
var model = new CrudeProductModel();
DataToModel(crudeProductBusiness, model);
list.Add(model);
}
return(list);
}
// fetch by Primary key into new class instance
// links:
// crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
// docLink: http://sql2x.org/documentationLink/7a625d0a-3028-42ce-a543-72ea3673cef4
// parameters:
// productId: primary key of table product
public static CrudeProductData GetByProductId(System.Guid productId)
{
// create query against product
// this will be ansi sql and parameterized
// parameterized queries are a good way of preventing sql injection
// and to make sure the query plan is pre-compiled
// links:
// docLink: http://sql2x.org/documentationLink/72f5fc83-c460-40fe-bac9-73b7ee0c6b77
string sql = @" select top 1 product_id, product_name, state_rcd, user_id, date_time, product_became_id
from [product]
where product_id = @product_id
order by product_name";
var ret = new CrudeProductData();
// open standard connection
// the connection is found in web.config
// the connection is closed upon completion of the reader
// links:
// docLink: http://sql2x.org/documentationLink/1ecca728-0c07-4dd7-b095-d10777b25b70
using (var conn = new SqlConnection(Conn.ConnectionString)) {
conn.Open();
using (var command = new SqlCommand(sql, conn)) {
// add primary key
// this primary key will be used together with the prepared ansi sql statement
// links:
// docLink: http://sql2x.org/documentationLink/1ecca728-0c07-4dd7-b095-d10777b25b70
command.Parameters.Add("@product_id", SqlDbType.UniqueIdentifier).Value = productId;
// execute query against product
// if the query fails in the preprocessor of sql server
// an exception will be raised
// links:
// docLink: http://sql2x.org/documentationLink/fd5c5faa-b400-4f29-b12b-9675c53a757f
IDataReader reader = command.ExecuteReader(CommandBehavior.SingleRow);
// populate serialized class if a row was found
if (reader.Read())
{
ret.Populate(reader);
}
}
}
return(ret);
}
// fetch all rows from table product into new List of class instances
// links:
// docLink: http://sql2x.org/documentationLink/7ca0c014-527e-4a0a-bd1f-12f4d8ea4b43
public static List <CrudeProductData> FetchAll()
{
var dataList = new List <CrudeProductData>();
// create query against product
// this will be ansi sql and parameterized
// parameterized queries are a good way of preventing sql injection
// and to make sure the query plan is pre-compiled
// links:
// docLink: http://sql2x.org/documentationLink/72f9f1bc-447c-4327-9d26-4b0790a07ff8
string sql = @" select product_id, product_name, state_rcd, user_id, date_time, product_became_id
from [product]
order by product_name";
// open standard connection
// the connection is found in web.config
// the connection is closed upon completion of the reader
// links:
// docLink: http://sql2x.org/documentationLink/952b3f82-bc00-4e82-9430-6bc26ff8bc4d
using (var conn = new SqlConnection(Conn.ConnectionString)) {
conn.Open();
using (var command = new SqlCommand(sql, conn)) {
// execute query against product
// if the query fails in the preprocessor of sql server
// an exception will be raised
// links:
// docLink: http://sql2x.org/documentationLink/ed55cc5b-d6be-4f5e-9385-ee726dfc2bf1
IDataReader reader = command.ExecuteReader(CommandBehavior.SingleResult);
// read all rows returned from the query of product
// read all columns from the datareader and
// populate the List of C# objects with them
// links:
// docLink: http://sql2x.org/documentationLink/c1b8b800-b250-4822-a699-d93a35f4414d
while (reader.Read())
{
var data = new CrudeProductData();
data.Populate(reader);
dataList.Add(data);
}
}
return(dataList);
}
}
// fetch all from table into new List of class instances, with a limit on number of returned rows and order by columns
// links:
// docLink: http://sql2x.org/documentationLink/dfaa482b-059b-4f17-a9a9-4885138dbb46
public static List <CrudeProductData> FetchAllWithLimit(int limit)
{
var dataList = new List <CrudeProductData>();
// create query against product
// this will be ansi sql and parameterized
// parameterized queries are a good way of preventing sql injection
// and to make sure the query plan is pre-compiled
// links:
// docLink: http://sql2x.org/documentationLink/41f82773-6d37-4ebe-840c-c60e06337f45
string sql = @" select top " + limit.ToString() + @" product_id, product_name, state_rcd, user_id, date_time, product_became_id
from [product]
order by product_name";
// open standard connection
// the connection is found in web.config
// the connection is closed upon completion of the reader
// links:
// docLink: http://sql2x.org/documentationLink/da228d98-b30e-4d79-89ae-98e813437753
using (var conn = new SqlConnection(Conn.ConnectionString)) {
conn.Open();
using (var command = new SqlCommand(sql, conn)) {
// execute query against product
// if the query fails in the preprocessor of sql server
// an exception will be raised
// links:
// docLink: http://sql2x.org/documentationLink/c32ad724-8a03-4b4c-b6fb-a5abfb1d707e
IDataReader reader = command.ExecuteReader(CommandBehavior.SingleResult);
// read all rows returned from the query of product
// read all columns from the datareader and
// populate the List of C# objects with them
// links:
// docLink: http://sql2x.org/documentationLink/9ba4395d-d8a4-4427-b80f-7b828e34da7a
while (reader.Read())
{
var data = new CrudeProductData();
data.Populate(reader);
dataList.Add(data);
}
}
return(dataList);
}
}
// fetch all rows from table into new List of Contracts, filtered by any column
// links:
// docLink: http://sql2x.org/documentationLink/ce01ef4a-5cd0-4e51-b211-9c0a15b791a0
public List <CrudeProductContract> FetchWithFilter(System.Guid productId, string productName, string stateRcd, System.Guid userId, System.DateTime dateTime, System.Guid productBecameId)
{
var list = new List <CrudeProductContract>();
List <CrudeProductData> dataList = CrudeProductData.FetchWithFilter(
productId: productId,
productName: productName,
stateRcd: stateRcd,
userId: userId,
dateTime: dateTime,
productBecameId: productBecameId
);
foreach (CrudeProductData data in dataList)
{
var crudeProductContract = new CrudeProductContract();
DataToContract(data, crudeProductContract);
list.Add(crudeProductContract);
}
return(list);
}
// fetch by Search key into current object
// links:
// crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
// docLink: http://sql2x.org/documentationLink/87368fa6-b618-4f0c-acbb-1fc4e273bb2d
// parameters:
// UserId: key of table CrudeProductData
public List <CrudeProductModel> FetchByUserId(System.Guid userId)
{
return(DataListToModelList(CrudeProductData.FetchByUserId(userId)));
}
// fetch by Search key into current object
// links:
// crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
// docLink: http://sql2x.org/documentationLink/87368fa6-b618-4f0c-acbb-1fc4e273bb2d
// parameters:
// StateRcd: key of table CrudeProductData
public List <CrudeProductModel> FetchByStateRcd(string stateRcd)
{
return(DataListToModelList(CrudeProductData.FetchByStateRcd(stateRcd)));
}
// delete row
// links:
// docLink: http://sql2x.org/documentationLink/59823bf7-4ad8-4684-a48b-2abd49c607ee
public void Delete(System.Guid productId)
{
CrudeProductData.Delete(productId);
}