Framework Design Guidelines

Communication Artifacts ,[object Object],[object Object],[object Object],[object Object],[object Object]

Hungarian Notation ,[object Object],public class CMyClass { int CompareTo (object objValue) {..} string lpstrName {get;} int iValue {get;} }

On Abbreviations, acronym, initialism and the like… ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Constructors are ,[object Object],[object Object],[object Object],public class XmlFile { string filename; Stream data; public XmlFile(string filename) { this.data = DownloadData(filename); } } lazy

Properties ,[object Object],[object Object],[object Object],[object Object],public class ArrayList { public int Count {get;} }

Properties versus Methods ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

EmployeeList l = FillList(); for (int i = 0; i < l.Length; i++){ if (l.All[i] == x){...} } public Employee[] All {get{}} Moral: Use method if the operation is expensive Calling Code Properties and returning arrays

 CONSIDER using extension methods to "add" methods to interfaces

 CONSIDER using extension methods to manage dependencies Uri uri = “ftp://some.ftp.uri”.ToUri(); // higher level assembly (not mscorlib) namespace System.Net { public static class StringExtensions{ public static Uri ToUri(this string s){ … } } }

 AVOID frivolously defining extension methods, especially on types you don’t own ,[object Object],[object Object],[object Object],[object Object]

 AVOID defining extension methods on System.Object

What we ship: Too much and not enough…

Abstract and Base classes ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Virtual Methods ,[object Object],[object Object],[object Object],[object Object],[object Object]

Overriding Methods ,[object Object],[object Object],[object Object],[object Object]

To Virtual Or Not Virtual … ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],Barbara Liskov

Interfaces ,[object Object],[object Object],[object Object],[object Object],[object Object],public interface IComparable { int CompareTo(object obj); }

Libraries , Primitives, Abstractions

 CONSIDER placing library types higher on the dependency stack ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

 DO keep primitives policy free (i.e. simple) ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Test Driven Development ,[object Object],[object Object]

Heavy Dependencies & Testability

Inversion of Control // your better API public abstract class TraceListener { public abstract void Trace(string message); } public class Tracer { TraceListener listener; public Tracer( TraceListener listener ){ this.listener = listener; } public void Trace(string message){ listener.Trace(message); } }

Dependency Injection Check Containers like: Spring.NET, Castle Windsor , Structuremap, , Unity … MEF session tomorrow will talk about it (isA)

The Power of Sameness ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

The perilous summit of complexity by example

How do I read all the lines from a file?

VS7 Era “ IO” seems like a reasonable place to start

Why did they make it inaccessible Backup, and try again…

Open.. Looks like a good first step…

Hmm… OK, what do I do with a FileStream?

Ok good, synchronous and asynchronous operations.. What the heck is that?

I think I am in the wrong place..

Back up, let’s try a different type

Ahh, ReadLine(), this looks more promising..

Thanks goodness there was a sample

The pit of success way ,[object Object]

Ah, a string[] I know just what to do with that…

Make the simple things simple and the hard things possible

References ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

Framework Design Guidelines

Recommandé

Recommandé

Contenu connexe

Tendances

Tendances (20)

En vedette

En vedette (6)

Similaire à Framework Design Guidelines

Similaire à Framework Design Guidelines (20)

Plus de Mohamed Meligy

Plus de Mohamed Meligy (7)

Dernier

Dernier (20)

Framework Design Guidelines