About the Book
Over the years, I've spoken in front of a lot of Delphi developers. The one thing that I notice is that there are a lot more of you Delphi guys than the average Delphi guy thinks. There are Delphi folks everywhere. Also, I have noticed that a lot of Delphi developers are "behind". That is, they are either using an older version of Delphi, or they aren't using or aren't even aware of all the features in the newer versions of Delphi that they are using. Something I like to do when I'm in front of folks is ask a few questions about what people are doing. I'm always saddened that the response to questions like "Who is doing unit testing?" or "Who is taking advantage of Generics?" is pretty meager.
This is particularly true for the language features and the run-time library. It's quite easy to move forward with an older code base, utilizing the new features in the IDE and adding new things to your app using the new high level frameworks and components that come in the newer versions. For example, you might have been developing an application since Delphi 3, moving forward through various versions. Along the way, you may have added some DataSnap functionality, started using the Code Insight features in the IDE, and when you moved to XE2, you start poking around with FireMonkey.
But it's fairly easy to ignore the new language features that come along with those new versions. For instance, two powerful language features were added in Delphi 2009: generics and anonymous methods. Both are features that enable the development of really cool code and frameworks. But if you didn't understand or feel the need for them, then it was pretty easy to simply not use them. You can still do all kinds of great stuff in Delphi without them, but with them, well, you can write some really beautiful, testable, and amazing code.
For instance, a relatively new framework that exists only because of these new language features is the Spring Framework for Delphi, or Spring4D, as I'll refer to it in this book. Spring4D is a feature rich framework that provides a number of interesting services, including a wide variety of collections that leverage generics, an Inversion of Control container, encryption support, and much more. I view Spring4Dsolid as much a part of the Delphi RTL as SysUtils is. Using Spring4D in your code will make many, many things easier and cleaner. But many Delphi developers don't know this yet.
If the above is familiar, this book is for you: The Delphi developer that hasn't quite yet made the leap over into the cool and amazing things that you can do with the latest versions of the Delphi language. This book is all about introducing these new language features and some of the intriguing things you can do with them. It will take a look at these new language features, and then expand into some of the open source frameworks that have sprung up (no pun intended) as a result. It will then show you techniques that you can use to write [SOLID](http://butunclebob.com/ArticleS.UncleBob.PrinciplesOfOod), clean, testable code.
You won't find much of anything about the IDE or the higher level frameworks here. Screen shots will be few but code examples many. You won't find anything about how to build better user interfaces or fancy components. What you will find are ways to make your code much cleaner, much more powerful, and way easier to maintain.
This book is all about the cool, new code you can write with Delphi. It won't matter whether you are building a VCL or an FM application. I've titled it "Coding in Delphi" because I want to make it a book that shows you simple examples of how to use powerful features -- that, is about the *code*. These language features are indeed advanced features -- they are new relative to, say, the `case` statement -- and thus many of you are beginners to them. By the end of this book, you won't be.
The approach I'm taking for this book is to try to distill things down to the very basics. The examples will be very simple but the explanations deeper. I believe that if you can understand the basic idea in a simple example, it is but a small leap to using those ideas in more complex code. There is no point in giving complex examples when you can get the main thrust using fundamental implementations that illustrate advanced ideas. Between the code in this book and in the samples online ([https://bitbucket.org/NickHodges/codingindelphi](https://bitbucket.org/NickHodges/codingindelphi)) you can learn all the precepts and then begin applying them to your own code. In other words, nothing fancy here, just the basics -- it is then up to you to use these ideas in your own code.
This book is not done -- it's instead a living document. Since it is self-published on a platform that makes iteration very easy, I plan on having frequent releases to fix typos (which will, I'm sure, sneak through despite my best efforts), improve examples and descriptions, and keep up with technology changes. Owners of the PDF should get notifications of new versions automatically. If you are reading a paper version of this book, I'm sorry I can't deliver fixes to your hard-copy -- perhaps some day that will be possible.
The book will be done when you guys say it is done. Maybe, it will never be done because Delphi keeps growing and expanding. I guess we'll see.
As a result, I'm totally open to feedback -- please feel free to contact me at firstname.lastname@example.org with suggestions corrections, and improvements. Please join [the Google Plus group for the book.](https://plus.google.com/communities/110978417023349293804) I may even add whole new chapters.
Thanks for your purchase -- this book was a labor of love, so every sale is icing on the cake.
Table of Contents
Frameworks used in Coding in Delphi
- Delphi Spring Framework
- Delphi Mocks
1 Exceptions and Exception Handling
- 1.1 Introduction
- 1.2 Structured Exception Handling
- 1.3 How Not to Use Exceptions
- 1.4 How to Use Exceptions Properly
- 1.5 Conclusion
2 Using Interfaces
- 2.1 Introduction
- 2.2 Decoupling
- 2.3 What are Interfaces?
- 2.4 Interfaces Everywhere
- 2.5 A Simple Example
- 2.6 Implementing an Interface
- 2.7 Some Further Things to Note:
- 2.8 Interface Inheritance
- 2.9 Other Things to Think About
- 2.10 About TInterfacedObject
- 2.11 How to Actually Use Interfaces
- 2.12 Why Should You Be Using Interfaces?
3 Understanding Generics
- 3.1 Generics to the Rescue
- 3.2 Constraints
- 3.3 Generic Interfaces
- 3.4 Generic Methods
- 3.5 Generic Collections
- 3.6 Thinking Generically
- 3.7 A Contrived, Simple Example
- 3.8 A Practical Example
- 3.9 Conclusion
- 3.10 An Interview with Generics
4 Understanding Anonymous Methods
- 4.1 Introduction
- 4.2 Definition
- 4.3 Why?
- 4.4 Closures
- 4.5 Standard Declarations
- 4.6 A Practical Example
- 4.7 Another, Cooler Example
- 4.8 Anonymous methods in the RTL
- 4.9 Predicates
- 4.10 Conclusion
- 4.11 An Interview with Anonymous Methods
5 Delphi Collections
- 5.1 Introduction
- 5.2 General Notions about Collections
- 5.3 The Delphi-Provided Collections
- 5.5 Collections in the Delphi Spring Framework
- 5.6 Why you should be using the Spring4D Collections
- 5.7 Conclusion
6 Enumerators in Delphi
- 6.1 Introduction
- 6.3 Specialized Enumerators
- 6.5 Conclusion
7 IEnumerable<T />
- 7.2 Predicates
7.3 An Interview with
8 Run-time Type Information
- 8.1 Introduction
- 8.3 RTTI on Classes
- 8.4 Using RTTI to Affect Instances
- 8.5 General Notes
- 8.6 RTTI for Non-classes
- 8.7 Miscellaneous Methods
- 8.8 RTTI Compiler Directives
- 8.9 Conclusion
- 9.1 Introduction
- 9.2 What are Attributes
- 9.3 A Simple Example
- 9.4 Conclusion
- 9.5 An Interview with Attributes
10 Using TVirtualInterface
- 10.1 A Slightly Better TVirtualInterface
- 10.2 An Actually Useful Example
- 10.3 ISimpleStub
- 10.4 TSimpleMock
- 10.5 Conclusion
11 Introduction to Dependency Injection
- 11.1 Introduction
- 11.2 What is a Dependency?
- 11.3 The Law of Demeter (LoD)
- 11.4 A Design Example
- 11.5 Law of Demeter in Delphi
- 11.6 A Step-by-Step Code Example
- 11.7 The Dependency Injection Container
- 11.8 Conclusion
12 A Deeper Look at Dependency Injection
- 12.1 Optional Dependencies
- 12.2 Setter Injection
- 12.3 Method Injection
- 12.4 The Delphi Spring Container and Service Locator
- 12.5 Registering via attributes
- 12.7 Dependency Injection Summary
13 Unit Testing
- 13.1 So What is Unit Testing?
- 13.2 Why Do Unit Testing?
- 13.3 Unit Testing in Delphi
- 13.4 General Rules for Unit Tests
- 13.5 Test Driven Development
- 13.6 A Basic Example
14 Testing with an Isolation Framework
- 14.1 A Quick Review
- 14.2 Isolation Frameworks for Delphi
- 14.3 Getting Started
- 14.4 Conclusion
Appendix A: Resources
- Dependency Injection
- Unit Testing
- Source Control
- General Good Stuff
- Appendix B: My Delphi Story