Delen via

Plug-in herschrijven

Herschrijft aanvragen.

Schermopname van een opdrachtprompt met Dev Proxy die een binnenkomende API-aanvraag herschrijft.

Definitie van invoegtoepassingexemplaren

{
  "name": "RewritePlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
  "configSection": "rewritePlugin"
}

Configuratievoorbeeld

{
  "rewritePlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/rewriteplugin.schema.json",
    "rewritesFile": "rewrites.json"
  }
}

Configuratie-eigenschappen

Eigenschappen Beschrijving Standaard
rewritesFile Pad naar het bestand met herschrijfdefinities rewrites.json

Opdrachtregelopties

Geen

Voorbeelden van herschrijven van bestanden

Hieronder volgen voorbeelden van herschrijfregels.

Alle aanvragen van HTTP naar HTTPS herschrijven

Herschrijf alle aanvragen van HTTP naar HTTPS. In deze context betekent alles alle aanvragen die zijn geconfigureerd met Dev Proxy of rewritePlugin.

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/rewriteplugin.rewritesfile.schema.json",
  "rewrites": [
    {
      "in": {
        "url": "^http://(.*)"
      },
      "out": {
        "url": "https://$1"
      }
    }
  ]
}

Eigenschappen van mocks-bestanden

Eigenschappen Beschrijving Vereist
rewrites Matrix van herschrijfobjecten die de lijst met herschrijfregels definieert die de RewritePlugin toepast op de aanvragen die worden onderschept ja

Object herschrijven

Elke herschrijfregel heeft de volgende eigenschappen:

Eigenschappen Beschrijving Vereist
in Herschrijfpatroon zodat deze overeenkomt met de binnenkomende aanvraag. ja
out Patroon herschrijven om de aanvraag opnieuw te schrijven ja

Opmerkingen

Als de aanvraag die de RewritePlugin onderschept, niet overeenkomt met alle eigenschappen die in het patroon zijn gedefinieerd, past de invoegtoepassing de herschrijfregel niet toe op de aanvraag.

Patroon herschrijven

Elk herschrijfpatroon heeft de volgende eigenschappen:

Eigenschappen Beschrijving Vereist Standaardwaarde Voorbeeldwaarde
url Reguliere expressie die de invoegtoepassing van toepassing is op de URL. ja ^http://(.*)

Opmerkingen

Als u capture-groepen gebruikt in de reguliere expressie in de patronen , kunt u ernaar verwijzen in het out-patroon . Als u bijvoorbeeld wilt herschrijven http://example.com/foohttps://example.com/foo, kunt u de volgende herschrijfregel gebruiken:

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/rewriteplugin.rewritesfile.schema.json",
  "rewrites": [
    {
      "in": {
        "url": "^http://(.*)"
      },
      "out": {
        "url": "https://$1"
      }
    }
  ]
}