Text Template Transformation Toolkit (T4)

1. .NET
User
Group
Bern
René Leupold
www.databinding.net
connect@databinding.net
Follow dnugbe on twitter
http://www.dnug-bern.ch/rss.aspx

2. DNUG Bern Sponsoren

3. Über René Leupold
• Siehe Xing ;-)
• Speaker VSone 16.-17. Feb. 2011,
München (www.vsone.de)
– Inheritance mit EF (DB First, Model First,
Code First)
Hinweis: Verwendung für eigene Präsentationen nur mit Einverständnis des Autors

4. Was ist T4
• Code-Generator mit ASP ähnlicher
Syntax
• Templatesprache in VB.NET und C#
• Generierung von
technologieunabhängigem Code
• Erstmalig built-in mit VS 2008
• Verbesserte Integration mit VS 2010
Ein Tool das macht was ich
will (fast immer)

5. Motivation

6. Abgrenzung
• Eine das kann VS Ultimate Show
• Eine Einführung in die Erstellung
eigener DSL’s
• Eine T4 Missionierung
Was ist dieser Vortrag nicht

7. Agenda
• Werkzeuge für Intellisense
• Syntax
• Prozessablauf und Architektur
• Aufbau Text Template
• Anwendungsszenarien
• Aufbau Preprocessed Template
• Beispielprojekt
• Vorteile
• Herausforderungen
• Ressourcen

8. Werkzeuge für Intellisense
Tangible T4 – Editor
• Visual Studio 2005
• Visual Studio 2008
• Visual Studio 2010
• Wir verlosen heute eine
Lizenz, das nächste Mal
auch und das
übernächste Mal immer
noch, bis Ende Jahr ;-)
Visual T4 – Editor (Clarius)
• Visual Studio 2005
• Visual Studio 2008
• Visual Studio 2010
– mittlerweile Beta

9. Syntax
Processing
Directive
Text Block
Statement Block
Expression Block
Class Feature
Block

10. Built-in Directives
output
template
include
assembly
import
parameter

11. Include file=
• Relative Pfadangaben dirtemplate.ttinclude
• Umgebungsvariablen %pfad%template.ttinclude
• VS Makro $(SolutionDir)t4incT4.ttinclude
Neu in VS 2010
• Include Folder in Registry setzen
Datei ohne Pfad
• Drag and Drop - Support mit tangible T4-Editor
• Verhält sich wie SSI (Vorsicht)
Besonderheit
[HKEY_LOCAL_MACHINESoftwareWow6432NodeMicrosoftVisualStudio10.0TextTemplatingIncludeFolders.tt]

12. assembly name=
• Umgebungsvariablen %pfad%template.tt
• VS Makro $(ProjectDir)binT4.dll
Neu in VS 2010
• GAC
• Public Assembly Folder VS
Datei ohne Pfad
• Sperrung der Assembly bis Solution geschlossen wird
Besonderheit
Alternative: VolatileAssembly

13. assembly name=
• Assembly wird nicht mehr gesperrt
Neu ab VS 2010 SP1
• Temporäre Kopie der Assembly
• So wie VolatileAssembly
Angelehnt an Verhalten von ASP.NET
• ShadowCopy = false
Besonderheit (kann deaktiviert werden)
HKEY_LOCAL_MACHINESOFTWARE[Wow6432Node]MicrosoftVisualStudio10.0TextTemplating

14. • Primärer Einsatz für DSL
• Ermöglicht Zugriff auf das Modell
• Eigene DSL mit VS Visualization &
Modeling SDK
Class Diagram (als Beispiel)
Generated Directive

15. • Klasse muss von DirectiveProcessor
ableiten
• CodeDom Provider verwenden, wenn
Support für C# und VB.NET
• Klasse in Registry registrieren
• Bsp.: VolatileAssembly
• Alternative: Verwenden einer eigenen
Assembly
DirectiveProcessor
Custom Directive

16. Prozessablauf
Output
Template
Generate
Compiled Template
Run

17. Architektur

18. Sicherheit

19. AUFBAU TEXT TEMPLATE
Demo

20. ANWENDUNGSSZENARIEN
o Debugging
o Generierung von Datenbank(Bottom up)
o Mehrere Files mit einem Text Template erstellen
o Parametrisierte Text Templates
o Code in andere Solution erstellen (T4 Toolbox und TemplFileM.)
o Visual Studio 2010 Automation
o Refactoring handcodierter Klassen mit T4, VS FCM und StoryQ
o Beispiele Technologieunabhängigkeit mit Excel
o EF Codegenerierungsvorlage erstellen
o Model First mit EF CTP 5 und «UML/DSL»

21. Preprocessed Template
• Keine Abhängigkeit zu VS
• Erweiterbar
• Verwendbar in eigenen
Anwendungen
Neu mit VS 2010

22. AUFBAU PREPROCESSED
TEMPLATE
Demo

23. ANWENDUNGSSZENARIEN
o Erweiterbares Preprocessed Template
o StoryQ Preprocessed Template

24. BEISPIELPROJEKT
o Angepasster EDM-Designer
o Angepasste EF Codegenerierungsvorlage
o Generierung des langweiligen Codes
o Codezentrierte Entwicklung der funktionalen Anforderungen
o Generierung des StoryQ-Testgerüsts aus TFS Workitem
o Generierung der WCF-Services basierend auf den
geschriebenen Code
o T4 Templates ausführen mit F6 ;-)

25. Vorteile

26. Vorteile
Innerhalb der Solution (Freiräume)
Code-Qualität
Steigerung der Produktivität
Technologieunabhängiger Code
Keine Methodenbindung
Mehr Zeit für die Anforderungen

27. Herausforderungen

28. Herausforderungen
Menschlicher Faktor
Arbeiten ohne den gewohnten Komfort von VS
Kein Framework mit Basisskripts
Strukturierte Anforderungsdokumente
Technologische Weiterentwicklung der Templates
Designüberlegungen

29. T4 Erweitert
• EntityFrameworkTemplateFileManager
(EF.Utility.CS.ttinclude)
• Damien Guards Output manager
• TemplateFileManager by myself
• T4Toolbox (unterstützt Ausgabe in unterschiedliche
Projektmappen)
Mehrere Dateien mit T4
• MsBuild-Integration (VS Visualization & Modeling SDK)
• Chirpy (VS AddIn)
T4 mit Build ausführen

30. Ressourcen
• Gareth Jones (http://blogs.msdn.com/b/garethj/)
• MSDN (http://www.microsoft.com/germany/msdn/webcasts/library.aspx?id=1032456634)
• MvcContrib (http://mvccontrib.codeplex.com/)
• Oleg Sych (http://www.olegsych.com/)
• T4 Mind Map (http://www.mindmeister.com/de/52082132/t4-textvorlagen)
• T4 Toolbox (http://t4toolbox.codeplex.com/)
• tangible, clarius …

31. Ressourcen
• Kay’s ASP.NET MVC 2 HOL T4 Section
http://blogs.msdn.com/b/swiss_dpe_team/archive/2010/12/01/asp-net-mvc-hands-on-lab.aspx
• Meine Erfahrungen mit T4
http://www.databinding.net/blog/category/t4.html
• T4 Beispiele http://www.databinding.net/blog/post/2010/10/28/t4-beispiele-der-
advanced-developer-conference-adc-2010-im-mindmap.html

32. Ressourcen Tangible Code Gallery
• FileTemplateManagerr

33. Ressourcen Tangible Code Gallery
• VsAutomationHelperr

34. Fragen und Diskussion beim
Apéro?

35. bzw. .NET User Group Bern
Community Feed
http://www.dnug-bern.ch/rss.aspx