Library

Course: API in C#: The Best Practices of Design and Implementation

API in C#: The Best Practices of Design and Implementation

  • Life Time Access
  • Certificate on Completion
  • Access on Android and iOS App
About this Course

Learn how to design and implement types in C# so that the other developers won't hate you when using one of the types developed by you. It means you are going to learn how to write code of the high quality: readable, understandable and reliable.

Teaching Approach

No fluff, no ranting, no beating the air. I esteem your time. The course material is succinct, yet comprehensive. All important concepts are covered. Particularly important topics are covered in-depth. For absolute beginners I offer my help on Skype absolutely free, if requested. Don't forget that this course has English subtitles, so if you don't understand my accent, feel free to turn them on.

Take this course and you will be satisfied.

Improve your knowledge in object-oriented programming in the context of clean coding and building types of high quality.

  • Understand the characteristics of a well-designed type
  • Grasp the principles of the convenient API development
  • Write clean code, get rid of unpleasant smells
  • Learn about what exceptions are intended for and how to throw and catch them properly
  • Protect your types from the incorrect usage making them properly encapsulated.

Foundations of building object-oriented infrastructures

Despite the fact that C# is a very rich on features language, it's very common to see poorly designed and implemented types in a real world. In fact, C# is one of the richest on features language among object-oriented languages in the world nowadays. But with great power comes great responsibility. It's challenging  to use all those features in a right way.

You probably have already heard the following well-known statement: most code sucks. Well, this course is all about how to produce code which doesn't suck.

Owning skills of producing a well-designed and well-implemented types is the prerequisite for the other developers to treat you as a real professional.

Content and Overview

This course is aimed at all the C# developers, from beginners to seniors. Topics which are covered in the course are relevant for all kinds of C# developers since all developers design and implement APIs. The topics complexity is very different. There are plenty of very simple topics, and at the same time, there are topics which require from you a solid C# background. There are plenty of code examples throughout this course, so you will learn both theoretical and practical material.

Starting with characteristics and principles of a well-designed type you will go further, learning how to give names for different members, how many parameters a method should take, is it a good idea to take a Boolean as a parameter of a method and much more than that.

Then you will learn what encapsulation really means. How to encapsulate a type? There are some trade-offs we will deal with encapsulating our types. There are many experienced programmers who don't know what encapsulation is in essence. Investigating this topic together we will see how to build a consistent and reliable type.

After mastering the topic of types encapsulating you will face the great problem of exceptions handling. Yep, it's a hard nut to crack. We will start from discussing a question of why do we use exceptions as a mechanism of errors handling. And why C# team didn't invent any other mechanisms?

In the end, we will look at how to fight with null values. As you may know, Tony Hoar said that the invention of a null value was his billion-dollar mistake.

To sum up, the course covers the following topics:

  • API development principles
  • How to give better names for API members and what naming conventions exist in the .NET platform and suited for C#
  • Common problems encountered by C# developers in the process of designing and implementing APIs: classes vs structures, abstract classes vs interfaces, creational patterns vs constructors, how to implement dispose pattern (are you sure you understand this allegedly simple case?)
  • Common implementation smells such as poor naming, excessively long methods, output parameters and so on
  • Common Architectural Design Smells such as Primitive Obsession, Hidden Dependencies, Violation of Law of Demeter and other.
  • How to deal with errors. It is surprisingly hard to develop robust software where errors handling is based on exceptions. We will find out why this is so and how to struggle with problems of error handling
  • How to deal with Nulls. Null Vales have always been a pain the ass. NullReferenceException is a well-known and popular guest in our software. We will look at the possible ways of diminishing the disrupting power of null-values

How long is this course: The course is around 3.5 hours. All are video lectures. You will be able to download all the slides and code samples used in the course.

Keywords related to the course:

  • C# Clean Code
  • C# Best Practices
  • API in C#
  • Building API in C#
  • Clean Code in C# tutorial
  • Refactoring

Who is the target audience?

  • This course is primarily oriented on programmers who have at least basic knowledge of C# and looking for practical guidelines concentrated on the improving of code qualities
Basic knowledge
  • You should already be familiar with the basics of C#
  • You should already have some practice working with Visual Studio
What you will learn
  • Design and implement a type or an API taking care of it's users
  • Encapsulate types so the other programmers would not hate you
  • Code in a good style making the code clearer in its intent.
  • Refactor the code making it much better to read and understand
  • Throw and handle exceptions properly
  • Decide whether to comment a particular part of the code is a good idea or not. By the way, which comments are helpful and which are not?
  • Dealing with Null values
Curriculum
Lectures quantity: 62
Common duration: 03:23:27
Introduction to API
  • How to Ask Questions  
  • Outline  

    Outline of the course "API in C#: The Best Practices of Design and Implementation".

  • API's Characteristics  

    In this lecture you'll learn what characteristics of API are important.

  • Public API VS Private API  

    In this lecture you'll learn the difference between public API and private API.

  • API Development Principles  

    In this lecture you'll learn the main development principles of API.

  • Conclusion  

    The conclusion for the introduction into the course "API in C#: The Best Practices of Design and Implementation".

Names
  • Names - Outline  

    The outline of the module about naming of API members.

  • General Principles of Naming  

    You'll learn abour intention-revealing names, disinformative names, easily readable names, encodings, domain names, scope and length rule and other.

  • Naming Conventions in .NET  

    Learn about standard .NET naming conventions.

  • Names - Conclusion  

    Conclusion for the module about naming API members.

Designing and Implementing Types and their Members
  • Designing - Outline  

    The outline of the module where you'll learn how to design and implement types and their members in C#.

  • Class VS Structure  

    You'll learn the difference between class and structure in C#.

  • Abstract Class VS Interface  

    You'll learn the difference between an abstract class and an interface in C#.

  • Implementing Abstract Classes  

    You'll learn the caveats of abstract classes implementation in C#.

  • Property VS Method  

    You'll learn how to choose between property and method in C#.

  • Implementing Constructors  

    You'll learn the caveats of constructors implementation in C#.

  • Creational Patterns VS Constructors  

    You'll learn when to prefer a creational pattern over a constructor in C#.

  • Tester-Doer Pattern  

    You'll learn about the "Tester-Doer" pattern in C#.

  • Conversion VS Casting Operator  

    You'll learn how to choose between implementing either a conversion operator or casting operator in C#.

  • Implementing Parameters  

    You'll learn about the caveats of implementing method's parameters in C#.

  • Implementing "Dispose" Pattern  

    You'll learn about the caveats of implementing the "Dispose" pattern in C#.

  • Designing - Conclusion  

    The conclusion for the module where you learned how to design and implement types (API) and their members in C#.

Implementation Smells
  • Implementation - Outline  

    The outline of the module where you'll learn the typical implementation smells of API in C#.

  • Poor Naming  

    You'll learn about mysterious, meaningless, shortened, ambiguous names and other naming smells.

  • Violating Naming Conventions  

    You'll learn about the violation of naming conventions. How to impose the rules of naming by harnessing the power of modern tools.

  • Variable Declarations on the Top  

    You'll learn about the smell of declaring variable on top of methods.

  • Magic Numbers  

    You'll learn about the smell of magic numbers. You'll see how to refactor them.

  • Too Long Method  

    You'll learn abou the technique "Extract Till You Drop" which was introduced by Robert Martin (aka Uncle Bob). You'll learn the pros and cons of that technique.

  • Poor Conditional Clauses  

    You'll learn about the right using of ternary operators and how to avoid abusing them.

  • Output Parameters  

    You'll learn about the smell of out-parameters and how refactor them out.

  • Comments  

    You'll learn about the smell of silly comments.

  • Prefer Positive if-statements  

    You'll learn about the smell of double negative if-statements.

  • Implementation - Conclusion  

    The conclusion for the module where you learned the common smells of API implementation in C#.

Common Architectural Smells
  • Common Architectural - Outline  

    The outline of the module where you'll learn about common architectural smells in C#.

  • Primitives Obsession  

    You'll learn about the primitives obsession, when developers inappropriately use primitive types for representing higher-level concepts.

  • Hidden Dependencies  

    You'll learn about hidden dependencies by the example of inappropriate use of the Service Locator pattern.

  • Violation of Law of Demeter  

    You'll learn the Law of Demeter and you'll see the example of the violation of that law in C#.

  • Temporal Coupling  

    You'll learn about the smell of temporal coupling and how to avoid it.

  • Temporal Coupling and Immutability  

    In this lecture, you'll learn the functional style of building functions, without side effects.

  • Switch Statements  

    You'll learn about the pros and cons of using switch-statements. You'll see how to refactor them into an object-oriented form.

  • Common Architectural - Conclusion  

    The conclusion for the module where you learned common architectural smells in C#.

Dealing with Errors
  • Dealing with Errors - Outline  

    The outline of the module where you'll learn about the approaches to errors handling. How to handle exceptions in C# and how to avoid them.

  • What Does an "Error" Mean?  

    Learn the meaning of the "error" term. What categories of errors exist in C#.

  • Problems with Exceptions  

    Learn deeply what the problems accompany exceptions in C#.

  • Common Misconceptions  

    Look at the common misconceptions concerning exceptions handling in C#.

  • Exception Handling Strategies  

    Learn what strategies of exceptions handling exist in C#.

  • CQS Principle  

    Learn about the Command-Query Separation principle.

  • Errors and Functional Programming  

    Learns about the interconnection between errors and functional programming.

  • Pipelining by Method Chaining  

    Learn what is pipelining and how to implement it via methods chaining in C#.

  • Conclusion on Exceptions Handling  

    A sub-conclusion about exceptions handling in C#.

  • BCL Exceptions Types  

    Learn about the built-in exception types in C#. Use them properly!

  • Custom Exception Types  

    Learn the rules of implementing custom exceptions types in C#.

  • Dealing with Errors - Conclusion  

    The conclusion for the module where you learned all nitty-gritty abour errors and exceptions handling C#.

Dealing with Nulls
  • Dealing with Nulls - Outline  

    The outline of the module where you'll learn the approaches to dealing with nulls in C#.

  • Problems with Nulls  

    You'll learn what the problems accompany null values.

  • Null Object Pattern  

    Learn the Null Object pattern in C#.

  • Maybe monad in C#  

    Learn what is the Maybe monad and how to implement it in C#.

  • Automating Null Checks  

    Learn how to automate null checks using the NullGuard.Fody.

  • Static Analysis  

    Learn how the static analysis can help to struggle with nulls.

  • Returning IEnumerables  

    Learn about the special case (regarding null values) of returning null values.

  • Dealing with Nulls - Conclusion  

    The conclusion for the module where you learned the approaches to dealing with null values in C#.

  • BONUS LECTURE  
reviews (0)
Average rating
0
0 voices
Detailed rating
5 stars
0%
4 stars
0%
3 stars
0%
2 stars
0%
1 stars
0%