Glossary - https://docs.microsoft.com/en-us/dotnet/standard/glossary

.net standard

Vervangt PCL - Portable Class Libraries
Metafoor - .net standard als interface met implementaties
- https://github.com/dotnet/standard/blob/master/docs/metaphor.md
Lagenmodel - .net standard in relatie tot runtimes
- Voor .net standard
- Na .net standard
Versies - https://docs.microsoft.com/nl-nl/dotnet/standard/net-standard
Wanneer een .net standard lib maken?
- hergebruik op >1 platform (.net core, .net fw, xamarin, UWP)
- het is geen probleem als minder er API's beschikbaar zijn
Wanneer een .net core lib maken?
- als alleen gebruikt op .net core
- meer API's nodig
Wat kunnen we referencen vanuit netstandard lib?
- netstandard (of PCL)
- net framework via compat shim
  - zie ook https://github.com/dotnet/standard/tree/master/docs/netstandard-20#assembly-unification
  - type forwarding door msbuild toegevoegd waar nodig
- Type Forwarding
  - zorgt er voor dat types gemapt worden naar platform types
- Compatibility Shim
  - gebruikt type forwarding + een aparte dll om .NETFW dlls te gebruiken alsof ze net standard zijn
Eigen projecten / assemblies analyseren op compatibility?
- .NET Portability Analyzer

.net core

.net core is dus 1 van de 'implementaties' van .net standard

is een runtime met superset van netstandard API (zie versie tabel)
is cross-platform (linux, mac, win - Supported OS'es)
CLI tools + VS tools (Full VS, VSCode, VS for Mac)

Documentatie-urls

Entrypoint docs
- https://docs.microsoft.com/en-us/dotnet/core/
.net Core CLI
- https://docs.microsoft.com/en-us/dotnet/core/tutorials/using-with-xplat-cli
.net Core in Visual Studio
- https://docs.microsoft.com/en-us/dotnet/core/tutorials/with-visual-studio
.net Core in VsCode
- https://code.visualstudio.com/docs/other/dotnet
- https://docs.microsoft.com/nl-nl/dotnet/core/tutorials/with-visual-studio-code
.net Core in VS for Mac
- https://docs.microsoft.com/en-us/dotnet/core/tutorials/using-on-macos
- https://docs.microsoft.com/en-us/dotnet/core/tutorials/using-on-mac-vs-full-solution

Zie ook deze lijst van .net core libraries, tools etc... https://github.com/thangchung/awesome-dotnet-core

.net core of .Net Framework? https://docs.microsoft.com/en-us/dotnet/standard/choosing-core-framework-server

asp.net core

Vroeger gekend als ASP.NET 5 en de start van .NET core. Er is geen web api meer, alleen nog mvc.

Razor Pages

Razor pages vs MVC

Razor =~ MVVM
MVC kan makkelijk de combo maken tussen server-side pages en client-side javascript apps
Razor = enkel server-side
Razor is eenvoudiger, minder gebaseerd op naming conventions (e.g. 'Home' View + HomeController)
Razor doet denken aan klassieke 'Web Forms' maar er is geen postback

(opinie) Razor is een tegenreactie tegen de soms complexe structuur van MVC apps waarbij je vaak moet zoeken in de src code op basis van naming conventions. Mogelijke aanpak =

Razor voor alle views
MVC voor alle API's Zie ook https://stackify.com/asp-net-razor-pages-vs-mvc/

in VS2017

in VSCode

in VS for Mac

asp.net core of classic asp.net? Wat te kiezen?

voor containers met microservices is core de voor de hand liggende keuze
zie https://docs.microsoft.com/en-us/aspnet/core/choose-aspnet-framework

Configuratie & Startup

Het config model van asp.net core is verschillend van dat van web.config

Startup.cs https://docs.microsoft.com/en-us/aspnet/core/fundamentals/startup
Configuratie https://docs.microsoft.com/en-us/aspnet/core/fundamentals/configuration
ASPNETCORE_ENVIRONMENT environment variabele
- Zie ook https://docs.microsoft.com/en-us/aspnet/core/fundamentals/environments

Dependency Injection (DI)

Built-in DI in .net core - https://msdn.microsoft.com/en-us/magazine/mt707534.aspx
Built-in asp.net core - https://docs.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection
Vervangen door AutoFac?
- .net core - http://autofaccn.readthedocs.io/en/latest/integration/netcore.html
- asp.net core - http://autofaccn.readthedocs.io/en/latest/integration/aspnetcore.html

Middleware

Wat vroeger de asp.net pipeline was, is nu middleware

intro - https://docs.microsoft.com/en-us/aspnet/core/fundamentals/middleware/?tabs=aspnetcore2x
hoe globale exception handling doen?

Achtergrond taken

.net core ondersteunt 'hosted services' als background processing. Zowel in console app als in asp.net core.

Zie dit msdn artikel

Hou er rekening mee dat dit verschilt tussen .net core 2.0 en 2.1 (geunificeerde api voor console en webapp)

EF Core

Speelt .net standard hier een rol?
- EF Core >2 ' target' net standard 2.0 link
- Dus je kan van je 'entity' lib een net standard 2.0 lib maken en hergebruiken
Start hier
Full tutorial - https://docs.microsoft.com/en-us/aspnet/core/data/ef-mvc/intro
Mapping relationships
- met fluent API - https://docs.microsoft.com/en-us/aspnet/core/data/ef-mvc/complex-data-model#fluent-api-alternative-to-attributes
- met attributes - https://docs.microsoft.com/en-us/aspnet/core/data/ef-mvc/complex-data-model#customize-the-data-model-by-using-attributes
Injecting dbcontext - https://docs.microsoft.com/nl-nl/ef/core/get-started/aspnetcore/new-db#register-your-context-with-dependency-injection
connectionstring voor package manager tools
- via IDesignTimeDbContextFactory<TContext>
Package Manager Console commands
- https://docs.microsoft.com/en-us/ef/core/miscellaneous/cli/powershell

Setup ActiveMQ

http://activemq.apache.org/getting-started.html
zorg voor een compatibele JRE versie
- http://www.oracle.com/technetwork/java/javase/downloads/jre10-downloads-4417026.html
- set JAVA_HOME
download latest version http://activemq.apache.org/download.html
unzip en start - http://activemq.apache.org/getting-started.html#GettingStarted-StartingActiveMQStartingActiveMQ
check http://127.0.0.1:8161/admin/ met admin/admin
wanneer connectie maken van binnenin docker container, gebruik uw IP address, niet localhost

Setup RabbitMQ in docker

https://gist.github.com/yetanotherchris/c954d1e8b688845c2dcdb3b33c94b2d2

docker run -d --hostname my-rabbit --name some-rabbit -p 4369:4369 -p 5671:5671 -p 5672:5672 -p 15672:15672 rabbitmq
docker exec some-rabbit rabbitmq-plugins enable rabbitmq_management

(met dank aan lv :)

Amqp clients

Het voorbeeld is geschreven met AmqpNetLite, maar het is mogelijk dat de RabbitMQ client interessanter is.

run SQL server 2017 in docker

zie https://docs.microsoft.com/en-us/sql/linux/quickstart-install-connect-docker
run (elevated powershell)
- docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<min 8 char complex password>" -p 1401:1433 --name docker-sql-01 -d microsoft/mssql-server-linux:2017-latest
- dit geval is nu op poort 1401, dus voeg ,1401 aan je servernaam toe in connectionstring

PakjesDienst Project

Als voorbeeld gebruiken we een fictieve pakjesdienst. Een verzender kan een pakje registreren, te verzenden via een koerierdienst en te leveren aan een bestemmeling. De koerierdienst kan de status en voorziene levertijd van het pakje aanpassen. De bestemmeling kan berichten ontvangen wanneer de status of levertijd van het pakje aangepast wordt.

De applicatie bestaat uit een database, een queue of eventhub, een web api en een web applicatie. Alles kan in containers ge-deployed worden.

Een ander domein kan ook gerust gebruikt worden. Maak het niet te complex om mee te beginnen en voeg dan naar eigen smaak technische of functionele complexiteit toe.

Oefeningen

(niet in volgorde, niet exhaustief, pick & mix & voeg zelf toe wat je wil)

NSwag

Swagger-ui voor je API

Makkelijk te gebruiken als developer interface, configureerbaar
Injecteerbaar als middleware
Kan user authenticatie faciliteren in UI
Kan ook enkel docs genereren ipv ook de API aan te roepen (ReDoc)
Kan dienen als developer portal / SDK

Home: https://github.com/RSuter/NSwag Gebruiken in asp.net core: https://github.com/RSuter/NSwag/wiki/Middlewares

AutoMapper

Veelgebruikte lib voor Dto's die extern 'contract' mappen op interne types

http://aspnetcorepath.com/automapper-in-asp-net-core-2/

SignalR

Real-time communicatie naar clients

zoals op asp.net core 2.1 (preview!)
getting started - https://docs.microsoft.com/nl-nl/aspnet/core/signalr/get-started?tabs=visual-studio
sample app - https://github.com/aspnet/signalr-samples/blob/master/ChatSample/ChatSample/ChatHub.cs
stuur vanaf controller naar signalR - SO Question
stuur naar specifieke client via ConnectionId zie ook artikel

Lectuur achteraf

e-Shop on containers is een demo applicatie van Microsoft specifiek gericht op microservices.

Microservices book beschrijft een aantal technieken voor microservices op het .net core platform en maakt gebruik van eShopOnContainers als voorbeeld.

Deploy naar Openshift Platform

oc new-app registry.access.redhat.com/dotnet/dotnet-20-rhel7~https://github.com/pencil42be/workshop-netcore --context-dir=src --name=pakjes-dienst-api-YOURNAMEHERE --build-env=DOTNET_STARTUP_PROJECT=Pencil42.PakjesDienst.Api/Pencil42.PakjesDienst.Api.csproj

License

mserbruyns/workshop-netcore

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages