documentation
This commit is contained in:
Ilya Chudin
Родитель
592f0d90ad
Коммит
51f1eb88cf
|
|
@ -32,7 +32,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -36,7 +36,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
7. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
7. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -37,7 +37,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
7. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
7. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -33,7 +33,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -33,7 +33,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
6. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
6. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
7. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
7. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -32,7 +32,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
|
||||
If you need to use the Microsoft.SqlServer.Types namespace, install the Microsoft.SqlServer.Types nuget,
|
||||
and replace the following include at the top of this file:
|
||||
|
|
|
|||
|
|
@ -32,7 +32,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
|
||||
If you need to use the Microsoft.SqlServer.Types namespace, install the Microsoft.SqlServer.Types nuget,
|
||||
and replace the following include at the top of this file:
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
7. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
7. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModels";
|
||||
|
|
|
|||
|
|
@ -32,7 +32,7 @@
|
|||
Console.WriteLine(c.ContactName);
|
||||
}
|
||||
|
||||
5. See more at https://github.com/linq2db/t4models/blob/master/Templates/ReadMe.LinqToDB.md.
|
||||
5. See more at https://github.com/linq2db/t4models
|
||||
*/
|
||||
|
||||
NamespaceName = "DataModel";
|
||||
|
|
|
|||
|
|
@ -36,11 +36,11 @@
|
|||
<file src="..\packages\linq2db.1.8.0\lib\net40\linq2db.dll" target="tools" />
|
||||
<file src="init.ps1" target="tools\init.ps1" />
|
||||
|
||||
<file src="..\Templates\ReadMe.LinqToDB.md" target="content\LinqToDB.Templates" />
|
||||
<file src="..\ReadMe.md" target="content\LinqToDB.Templates" />
|
||||
<file src="..\Templates\*.ttinclude" target="content\LinqToDB.Templates" />
|
||||
<file src="LinqToDB.Tools.ttinclude" target="content\LinqToDB.Templates" />
|
||||
|
||||
<file src="..\Templates\ReadMe.LinqToDB.md" target="contentFiles\LinqToDB.Templates" />
|
||||
<file src="..\ReadMe.md" target="contentFiles\LinqToDB.Templates" />
|
||||
<file src="..\Templates\*.ttinclude" target="contentFiles\LinqToDB.Templates" />
|
||||
<file src="LinqToDB.Tools.ttinclude" target="contentFiles\LinqToDB.Templates" />
|
||||
</files>
|
||||
|
|
|
|||
51
README.md
51
README.md
|
|
@ -1,7 +1,46 @@
|
|||
# t4models
|
||||
To create a data model template take a look at one of the CopyMe.XXX.tt.txt file in your LinqToDB.Templates project folder.
|
||||
# T4 Models
|
||||
|
||||
* Use the following initialization before you call the LoadMetadata() method.
|
||||
T4 models are used to generate POCO's C# code using your database structure.
|
||||
|
||||
## Installation
|
||||
|
||||
Firstly you should install one of tools packages into your project:
|
||||
|
||||
`Install-Package linq2db.XXX`
|
||||
|
||||
Where XXX is one of supported databases, for example:
|
||||
|
||||
`Install-Package linq2db.SqlServer`
|
||||
|
||||
This also will install needed linq2db packages:
|
||||
* linq2db.t4models
|
||||
* linq2db
|
||||
|
||||
But **not** data provider packages (install them only if needed to compile your project, T4 models ships it's own data provider assemblies).
|
||||
|
||||
### .Net Core specific
|
||||
|
||||
Firstly bu some reason NuGet does not install `linq2db.Core` package automatically, so you'll need to install it manually.
|
||||
|
||||
Secondly, because of .Net Core projects do not support NuGet content files all stuff is not copied into project's folder, so to run T4 templates you'll need:
|
||||
* open `$(SolutionDir).tools\linq2db.t4models` in Explorer
|
||||
* copy `CopyMe.XXX.Core.tt.txt` to your project's folder or subfolder, then you should use it instead of `CopyMe.XXX.tt.txt`
|
||||
|
||||
# Running
|
||||
|
||||
After package installing you will see new `LinqToDB.Templates` folder in your project, this folder contains all needed T4 stuff to generate your model. Also would be created new folder in tour solution: `$(SolutionDir).tools\linq2db.t4models`, it is used to store and link assemblies, needed for generation (linq2db.dll and data provider assemblies).
|
||||
|
||||
To create a data model template take a look at one of the CopyMe.XXX.tt.txt file in your LinqToDB.Templates project folder. Copy this file to needed project location and rename it, like `MyModel.tt`
|
||||
|
||||
There are few main steps in this file:
|
||||
1. Configuring generation process (read below)
|
||||
1. Loading metadata - this is a call to `LoadMatadata()` function - it connects to your database and fetches all needed metadata (table structure, views, and so on)
|
||||
1. Customizing generation process (read below)
|
||||
1. Calling `GenerateModel()` - this will run model generation
|
||||
|
||||
## Configuring generation process
|
||||
|
||||
Use the following initialization **before** you call the `LoadMetadata()` method.
|
||||
|
||||
```c#
|
||||
NamespaceName = "DataModels"; // Namespace of the generated classes.
|
||||
|
|
@ -47,7 +86,9 @@ GetSchemaOptions.ExcludedCatalogs = new[] { "TestUser", "SYSSTAT" }; // Defines
|
|||
GetSchemaOptions.IncludedCatalogs = new[] { "TestUser", "SYS" }; // Defines only included catalogs.
|
||||
```
|
||||
|
||||
* Use the following code to modify your model befor you call the GenerateModel() method.
|
||||
## Customizing generation process
|
||||
|
||||
Use the following code to modify your model **before** you call the `GenerateModel()` method.
|
||||
|
||||
```c#
|
||||
GetTable("Person").TypeName = "MyName"; // Replaces table name.
|
||||
|
|
@ -72,7 +113,7 @@ foreach (var t in Tables.Values)
|
|||
c.MemberName = "ID";
|
||||
```
|
||||
|
||||
* Useful members and data structues.
|
||||
## Useful members and data structures
|
||||
|
||||
```c#
|
||||
Dictionary<string,Table> Tables = new Dictionary<string,Table> ();
|
||||
|
|
|
|||
|
|
@ -25,7 +25,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Templates", "Templates", "{
|
|||
Templates\NotifyPropertyChanged.ttinclude = Templates\NotifyPropertyChanged.ttinclude
|
||||
Templates\ObsoleteAttributes.ttinclude = Templates\ObsoleteAttributes.ttinclude
|
||||
Templates\PluralizationService.ttinclude = Templates\PluralizationService.ttinclude
|
||||
Templates\ReadMe.LinqToDB.md = Templates\ReadMe.LinqToDB.md
|
||||
Templates\T4Model.ttinclude = Templates\T4Model.ttinclude
|
||||
Templates\Validation.ttinclude = Templates\Validation.ttinclude
|
||||
EndProjectSection
|
||||
|
|
|
|||
|
|
@ -1,160 +0,0 @@
|
|||
To create a data model template take a look at one of the CopyMe.XXX.tt.txt file in your LinqToDB.Templates project folder.
|
||||
|
||||
* Use the following initialization before you call the LoadMetadata() method.
|
||||
|
||||
```c#
|
||||
NamespaceName = "DataModels"; // Namespace of the generated classes.
|
||||
|
||||
DataContextName = null; // DataContext class name. If null - database name + "DB".
|
||||
BaseDataContextClass = null; // Base DataContext class name. If null - LinqToDB.Data.DataConnection.
|
||||
GenerateConstructors = true; // Enforce generating DataContext constructors.
|
||||
DefaultConfiguration = null; // Defines default configuration for default DataContext constructor.
|
||||
|
||||
BaseEntityClass = null; // Base Entity class name. If null - none.
|
||||
DatabaseName = null; // Table database name - [Table(Database="DatabaseName")].
|
||||
GenerateDatabaseName = false; // Always generate table database name, even though DatabaseName is null.
|
||||
IncludeDefaultSchema = true; // Default schema name is generated - [Table(Database="Northwind", Schema="dbo", Name="Customers")]
|
||||
OneToManyAssociationType = "IEnumerable<{0}>"; // One To Many association type. Change it to "List<{0}>" if needed.
|
||||
GenerateAssociations = true; // Enforce generating associations.
|
||||
GenerateBackReferences = true; // Enforce generating backreference associations.
|
||||
|
||||
ReplaceSimilarTables = true; // Replaces stored procedure result class names with similar to existing table class names.
|
||||
GenerateFindExtensions = true; // Generates find extension methods based on PKs information.
|
||||
IsCompactColumns = true; // If true, column compact view.
|
||||
|
||||
PluralizeClassNames = false; // If true, pluralizes table class names.
|
||||
SingularizeClassNames = true; // If true, singularizes table class names.
|
||||
PluralizeDataContextPropertyNames = true; // If true, pluralizes DataContext property names.
|
||||
SingularizeDataContextPropertyNames = false; // If true, singularizes DataContex pProperty names.
|
||||
|
||||
GenerateDataTypes = false; // If true, generates the DataType/Length/Precision/Scale properties of the Column attribute (unless overriden by the properties below).
|
||||
GenerateDataTypeProperty = null; // If true, generates the DataType property of the Column attribute. If false, excludes generation on the DataType property even if GenerateDataTypes == true.
|
||||
GenerateLengthProperty = null; // If true, generates the Length property of the Column attribute. If false, excludes generation on the Length property even if GenerateDataTypes == true.
|
||||
GeneratePrecisionProperty = null; // If true, generates the Precision property of the Column attribute. If false, excludes generation on the Precision property even if GenerateDataTypes == true.
|
||||
GenerateScaleProperty = null; // If true, generates the Scale property of the Column attribute. If false, excludes generation on the Scale property even if GenerateDataTypes == true.
|
||||
GenerateDbTypes = false; // If true, generates the DbType property of the Column attribute.
|
||||
|
||||
GenerateObsoleteAttributeForAliases = false; // If true, generates [Obsolete] attribute for aliases.
|
||||
IsCompactColumnAliases = true; // If true, column alias compact view.
|
||||
|
||||
GetSchemaOptions.ExcludedSchemas = new[] { "TestUser", "SYSSTAT" }; // Defines excluded schemas.
|
||||
GetSchemaOptions.IncludedSchemas = new[] { "TestUser", "SYS" }; // Defines only included schemas.
|
||||
```
|
||||
|
||||
* Use the following code to modify your model befor you call the GenerateModel() method.
|
||||
|
||||
```c#
|
||||
GetTable("Person").TypeName = "MyName"; // Replaces table name.
|
||||
GetColumn("Person", "PersonID").MemberName = "ID"; // Replaces column PersonID of Person table with ID.
|
||||
GetFK("Orders", "FK_Orders_Customers").MemberName = "Customers"; // Replaces association name.
|
||||
GetFK("Orders", "FK_Orders_Customers").AssociationType = AssociationType.OneToMany; // Changes association type.
|
||||
|
||||
SetTable(string tableName,
|
||||
string TypeName = null,
|
||||
string DataContextPropertyName = null)
|
||||
|
||||
.Column(string columnName, string MemberName = null, string Type = null, bool? IsNullable = null)
|
||||
.FK (string fkName, string MemberName = null, AssociationType? AssociationType = null)
|
||||
;
|
||||
|
||||
Model.Usings.Add("MyNamespace"); // Adds using of namespace.
|
||||
|
||||
// Replaces all the columns where name is 'TableName' + 'ID' with 'ID'.
|
||||
foreach (var t in Tables.Values)
|
||||
foreach (var c in t.Columns.Values)
|
||||
if (c.IsPrimaryKey && c.MemberName == t.TypeName + "ID")
|
||||
c.MemberName = "ID";
|
||||
```
|
||||
|
||||
* Useful members and data structues.
|
||||
|
||||
```c#
|
||||
Dictionary<string,Table> Tables = new Dictionary<string,Table> ();
|
||||
Dictionary<string,Procedure> Procedures = new Dictionary<string,Procedure>();
|
||||
|
||||
Table GetTable (string name);
|
||||
Procedure GetProcedure (string name);
|
||||
Column GetColumn (string tableName, string columnName);
|
||||
ForeignKey GetFK (string tableName, string fkName);
|
||||
ForeignKey GetForeignKey(string tableName, string fkName);
|
||||
|
||||
public class Table
|
||||
{
|
||||
public string Schema;
|
||||
public string TableName;
|
||||
public string DataContextPropertyName;
|
||||
public bool IsView;
|
||||
public string Description;
|
||||
public string AliasPropertyName;
|
||||
public string AliasTypeName;
|
||||
public string TypeName;
|
||||
|
||||
public Dictionary<string,Column> Columns;
|
||||
public Dictionary<string,ForeignKey> ForeignKeys;
|
||||
}
|
||||
|
||||
public partial class Column : Property
|
||||
{
|
||||
public string ColumnName; // Column name in database
|
||||
public bool IsNullable;
|
||||
public bool IsIdentity;
|
||||
public string ColumnType; // Type of the column in database
|
||||
public DbType DbType;
|
||||
public string Description;
|
||||
public bool IsPrimaryKey;
|
||||
public int PrimaryKeyOrder;
|
||||
public bool SkipOnUpdate;
|
||||
public bool SkipOnInsert;
|
||||
public bool IsDuplicateOrEmpty;
|
||||
public string AliasName;
|
||||
public string MemberName;
|
||||
}
|
||||
|
||||
public enum AssociationType
|
||||
{
|
||||
Auto,
|
||||
OneToOne,
|
||||
OneToMany,
|
||||
ManyToOne,
|
||||
}
|
||||
|
||||
public partial class ForeignKey : Property
|
||||
{
|
||||
public string KeyName;
|
||||
public Table OtherTable;
|
||||
public List<Column> ThisColumns;
|
||||
public List<Column> OtherColumns;
|
||||
public bool CanBeNull;
|
||||
public ForeignKey BackReference;
|
||||
public string MemberName;
|
||||
public AssociationType AssociationType;
|
||||
}
|
||||
|
||||
public partial class Procedure : Method
|
||||
{
|
||||
public string Schema;
|
||||
public string ProcedureName;
|
||||
public bool IsFunction;
|
||||
public bool IsTableFunction;
|
||||
public bool IsDefaultSchema;
|
||||
|
||||
public Table ResultTable;
|
||||
public Exception ResultException;
|
||||
public List<Table> SimilarTables;
|
||||
public List<Parameter> ProcParameters;
|
||||
}
|
||||
|
||||
public class Parameter
|
||||
{
|
||||
public string SchemaName;
|
||||
public string SchemaType;
|
||||
public bool IsIn;
|
||||
public bool IsOut;
|
||||
public bool IsResult;
|
||||
public int? Size;
|
||||
public string ParameterName;
|
||||
public string ParameterType;
|
||||
public Type SystemType;
|
||||
public string DataType;
|
||||
}
|
||||
```
|
||||
|
|
@ -51,3 +51,6 @@ deploy:
|
|||
secure: oTYw2IwTnz4qMD8c/MR/6mo+Nx3wa5Pp8MYfsKBCKCVuU6QCHlj+6QMXpnQses8G
|
||||
on:
|
||||
branch: release
|
||||
|
||||
skip_commits:
|
||||
message: /doc./ # Regex for matching commit message
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче