Gyakorlat – Beépített köztes szoftver használata

  • 5 perc

ASP.NET Core beépített köztes szoftverösszetevőket tartalmaz, amelyek olyan gyakori feladatokat kezelnek, mint az útválasztás, a hitelesítés és a HTTP-naplózás. Ezekkel az összetevőkkel egyéni köztes szoftver írása nélkül adhat hozzá funkciókat az alkalmazáshoz.

A csapatvezető arra bízta, hogy hozzon létre egy csupasz webhelyet a vállalat számára. A webhelynek egy üdvözlő üzenetet kell megjelenítenie a főoldalon, és külön /about lapon kell megjelenítenie a vállalat rövid előzményeit. Az alkalmazás egy korábbi verziójában a céges előzmények szerepelnek az /history URL-címen, ezért át kell irányítania a kéréseket /history a /about meglévő hivatkozásokkal való kompatibilitás fenntartása érdekében.

Ezeket a feladatokat a beépített MapGet metódus és UrlRewriter köztes szoftver használatával hajthatja végre.

ASP.NET Core-alkalmazás létrehozása

Egy ASP.NET Core-alkalmazásra van szüksége a csapat alkalmazásának szerepéhez. Hozzunk létre egy új ASP.NET Core-alkalmazást a Visual Studio Code C# Dev Kit bővítményével.

  1. Indítsa el a Visual Studio Code-ot.

  2. A parancskatalógus megnyitásához nyomja le a Ctrl+Shift+P billentyűkombinációt.

  3. Keresse meg és válassza a .NET: Új projekt... lehetőséget.

  4. Keresse meg és válassza ki ASP.NET Üres magot.

    Képernyőkép a parancskatalógusról, amelyen ASP.NET Core Empty van kiválasztva.

  5. Jelöljön ki vagy hozzon létre egy mappát az új projekthez.

  6. Nevezze el az új alkalmazást a MyWebAppnak.

  7. A projekt létrehozásához válassza a Projekt létrehozása lehetőséget.

  8. Amikor megnyílik az új projekt, bontsa ki a Solution Explorer panelt a projektfájlok megtekintéséhez.

Az alkalmazás futtatása

Tesztelje az alkalmazást annak ellenőrzéséhez, hogy fut-e.

  1. A Visual Studio Code-ban nyomja le az F5 billentyűt az alkalmazás létrehozásához és futtatásához.

    1. Amikor a rendszer kéri, válassza a C# lehetőséget hibakeresőként.
    2. Amikor a rendszer kéri, válassza a C#: MyWebApp [Alapértelmezett konfiguráció] lehetőséget a használni kívánt indítási konfigurációként.

    Ez a parancs elindítja az alkalmazást, és egy helyi webkiszolgálón üzemelteti. Megnyílik egy böngészőablak, és megjelenik a "Hello, World!"

  2. Zárja be a böngészőablakot, és állítsa le az alkalmazást a Shift+F5 billentyűkombináció lenyomásával a Visual Studio Code-ban.

Végpontok leképezése és URL-cím újraíró hozzáadása

Most, hogy már rendelkezik egy működő alkalmazással, adjunk hozzá egy üdvözlő üzenetet a főoldalhoz.

  1. Nyissa meg a Program.cs fájlt.

  2. app.MapGet("/", () => "Hello World!"); A sorban módosítsa a "„Helló világ!” alkalmazás!" üzenetet "Üdvözli a Contoso!"

    app.MapGet("/", () => "Welcome to Contoso!");

    app.MapGet() HTTP GET-kérést képez le egy megadott elérési útra. A ASP.NET Core ezen funkcióját végpont-útválasztásnak nevezzük. Ez a kód egy ágat ad hozzá a folyamathoz. Ha a kérelem elérési útja, /a végpont útválasztási köztes szoftvere átirányítja a kérést erre a végpontra, amely ezután az "Üdvözöljük a Contoso-nak!" szöveget írja a válaszra.

  3. A következő sorban adja hozzá a következő kódot:

    app.MapGet("/about", () => "Contoso was founded in 2000.");

    Ez a kód egy másik végpontot ad hozzá. Ha a kérelem elérési útja, /abouta végpont a következőt írja a válaszra: "Cégünk 2000-ben alakult."

  4. adja hozzá a következő kódot:

    app.UseRewriter(new RewriteOptions().AddRedirect("history", "about"));

    Ez a kód hozzáad egy URL-újraíró köztes szoftverösszetevőt, amely átirányítja a kéréseket a fájlba /history/about. A AddRedirect() metódus két paramétert használ: egy reguláris kifejezésmintát, amely megfelel a kérelem elérési útjának, és a csere elérési utat, a amelybe átirányítani szeretné.

  5. Adja hozzá a következő irányelvet a fájl elejéhez:

    using Microsoft.AspNetCore.Rewrite;

    Ez az irányelv feloldja az osztályra RewriteOptions való hivatkozást.

A módosítások tesztelése

  1. Mentse az összes módosítást, és futtassa az alkalmazást a korábbiakhoz hasonlóan.
  2. Amikor megnyílik a böngészőablak, vegye figyelembe, hogy a gyökér URL-címe "Üdvözli a Contoso!" Adja hozzá /about az URL-címet, és nyomja le az Enter billentyűt. A böngészőben a "Contoso-t 2000-ben alapították".
  3. Cserélje le /about az URL-címre, és nyomja /history. A böngészőnek a következőre kell átirányítani: /about.
  4. Hagyja futni az alkalmazást a következő gyakorlatban.