Forutsetninger

.NET Core SDK.

Hvis du vil bruke Visual Studio må du ha VS2015 Update 2 + .NET Core SDK. Workshopen er laget for Windows, men hvis du vil gjøre den på Linux, OS X eller i Docker skal det gå helt fint.

Del 1 - donet klienten

Til disse oppgavene anbefales det å bruke en lettvekts-editor som feks Atom, Visual Studio Code, e.l.

1a - Core App

Bruk kommandolinjeverktøyet dotnet til å lage en ny console-applikasjon og kjør denne. Publiser den og kjør den publiserte DLL'en.

• Gå inn i mappen 1a og lag en ny .NET-applikasjon med dotnet new
• Last ned dependencies fra nuget med dotnet restore
• Kjør programmet med dotnet run
• Publisér løsnigen med dotnet publish -o .corepublish. Dette publiserer appen til mappa .publish. Ta en titt på de forskjellige filene som havner der.
• Kjør den publiserte dll'en med `dotnet run .publish/1a.dll'

1b .NET Framework App

Bruk dotnet til å lage en ny console-applikasjon. Gjør om denne til en .NET Framework-basert applikasjon. Publiser den, finn den resulterende .exe-fila og kjør den.

• Gå inn i mappen 1b og lag en ny .NET-applikasjon med dotnet new
• Legg til Console.Read(); i Program.cs
• Gjør om prosjektet slik at det kompilerer til en .NET Framework-modell i stedet. Dette kan gjøres ved å bytte ut "netcoreapp1.0": { "imports": "dnxcore50" } med "net461": { "imports": "dnxcore50" } i project.json. I tillegg må vi fjerne avhengigheten "Microsoft.NETCore.App" ettersom denne ikke er nødvendig/kompatibel med en .NET Framework-modell.
• Publiser applikasjonen i en mappe du velger selv
• Gå inn mappa og finn 1b.exe - kjør denne

1c Testprosjekt

Lag et tesprosjekt. Bruk et testrammeverk, feks xUnit, til å lage en test. Kjør testen med dotnet

• Gå inn i mappen 1c og opprett et nytt prosjekt med dotnet new
• Slett Program.cs og fjern "emitEntryPoint" fra project.json
• Legg til xUnit og xUnit Testrunner som dependencies/testrunner, i tillegg til "portable-net45+win8" under imports (xUnit krever dette) - slik
• Lag en ny klasse som heter HelloWorld.cs og inneholder en metode Get() som returnerer "Hello World!"
• Lag en testklasse som heter HelloWorldTests og importer xUnit using Xunit;
• Lag en testmetode som tester HelloWorld.cs og annoter denne med [Fact]
• Restore nuget-pakker
• Kjør testen med dotnet test

Web app

Til disse oppgavene er det lettest å bruke Visual Studio

2a

Bruk Kestrel til å lage en web app som svarer med "Hello World!"

• Åpne Visual Studio og velg new -> project. Velg Console Application og legg det i mappa 2.
• Legg til Kestrel som en dependency i project.json
• Lag en ny klasse Startup.cs med en metode void Configure(IApplicationBuilder app)
• Bruk app.Run til å skrive "Hello World!" til HttpResponse
• Konfigurer Program.cs til å kjøre en Kestrel-server med 'Startup.cs` som oppstartsfil
• Kjør appen fra kommandolinja og test at det funker

2b

Flytt funksjonaliteten som skriver "Hello World!" til en egen klasse med et eget interface. Bruk den innebygde funksjonaliteten for dependency injection for å resolve klassen og skrive ut HelloWorld

• Lag en ny klasse og et nytt interface med en metode Task Write(HttpContext context) som skriver til responsen
• Lag en ny metode public void ConfigureServices(IServiceCollection services) i Startup.cs hvor du registrerer den nye klassen til interfacet
• Skriv om void Configure(IApplicationBuilder app)-metoden i Startup.cs til å resolve ut klassen og printe med den. ( feks var helloWorld = context.RequestServices.GetService<IHelloWorld>(); )
• Kjør appen fra kommandolinja og test at det funker

2c

Lag en Mock-versjon av klassen du lagde i forrige oppgave som arver av samme interface, men skriver ut "Hello Mock!". Bruk IHostingEnvironment til å sjekke hvilket miljø du er i, og registrer Mock-utgaven dersom det er Development og den ekte utgaven ellers.

• Lag en ny property private IHostingEnvironment _env; på Startup.cs
• Lag en ny metode public Startup(IHostingEnvironment env) på Startup.cs hvor du binder env til _env
• Sjekk hvilket miljø som er aktivt i ConfigureServices og registrer Mock eller vanlig deretter.
• Kjør applikasjonen fra kommandolinja
• I kommandolinja, skriv set ASPNETCORE_ENVIRONMENT=Production
• Kjør på nytt, og se at riktig konfigurasjon benyttes

2d

Fjern registreringen fra forrige oppgave, slik at du ikke lenger bruker Mock-klassen. Lagre "Hello World!" i appsettings.production.json og "Hello Mock!" i appsettings.development.json. Lag en POCO som holder på streng-verdien og registrer denne som en Configuration-verdi. Verifiser at verdien er forskjellig når du endrer miljø-variabelen

• Legg til ny dependencies i project.json: "Microsoft.Extensions.Configuration.Json": "1.0.0-rc2-final", "Microsoft.Extensions.Options.ConfigurationExtensions": "1.0.0-rc2-final"

• Opprett konfigfiler; appsettings.json, appsettings.production.json og appsettings.development.json

• I Program.cs, legg til .UseContentRoot(Directory.GetCurrentDirectory()) på webhostBuilder slik at appen kan lese filer fra prosjektmappa.

• Opprett en ny property på Startup.cs - public IConfigurationRoot Configuration

• Sett opp appen til å lese appsettings i Startup-metoden i Startup.cs - `var builder = new ConfigurationBuilder() .SetBasePath(env.ContentRootPath) .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true) .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true);

        Configuration = builder.Build();`
  

• Lag en ny POCO-klasse som heter feks HelloOptions.cs med en string-property som heter det samme som en verdi du legger i appsettings.

• I ConfigureServices-metoden, registrer denne klassen slik services.Configure<HelloOptions>(Configuration);

• I klassen som printer "Hello World", ta inn IOptions<HelloOptions> options i konstruktøren, og print denne meldingen til HttpResponse

• Kjør appen fra kommandolinja og verifiser at det funker

• Bytt environment og sjekk at riktig config brukes

2e

Legg til HelloMessage-variablen som en environment variable. Konfigurer appen til å lese env-variabler etter den har lest appsettings. Bruk dette til å legge inn en annen melding

• Legg til avhengigheten "Microsoft.Extensions.Configuration.EnvironmentVariables": "1.0.0-rc2-final"
• I Startup.Startup(), legg til .AddEnvironmentVariables(); etter AddJsonFile()
• Set environment variablen for HelloMessage - set HelloMessage=Hello world from env-variables
• Kjør på nytt og se at det virker

MVC

3a

Legg til MVC og lag en Controller og en Action som sender ut noen verdier

• "Microsoft.AspNetCore.Mvc": "1.0.0-rc2-final"
• services.AddMvc();
• app.UseMvc();
• Lag en mappe Controllers og lag en Controller med en Action
• Husk å dekorere med [Route("hello")]
• Test at det funker

3b

Fri lek