UriMatcherResponse – Umfang

Stellt Methoden bereit, um Informationen darüber zurückzugeben, ob ein URI den angegebenen Kriterien für Schema, Host, Pfad, Fragmente und Vorhandensein von Abfrageparametern entspricht.

Verwenden Sie diese API mit UriMatcher API. Diese API hat keinen Konstruktor. Verwenden Sie stattdessen UriMatcher – Match() Methode zum Instanziieren von UriMatcherResponse Objekt.

Die UriMatcherResponse API erfordert das Plugin „REST API Provider“ (com.Glide.Rest), das standardmäßig aktiviert ist.

Diese API wird in bereitgestellt sn_WS Namespace.

UriMatcherResponse – getErrorMessages()

Gibt Nachrichten zu Fehlern zurück, die beim Testen des URI anhand der angegebenen Kriterien aufgetreten sind.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Beschreibung des aufgetretenen Fehlers. Wenn kein Fehler aufgetreten ist, wird eine leere Zeichenfolge zurückgegeben.

Dieses Beispiel gibt einen Fehler zurück, da in den Übereinstimmungskriterien kein Host angegeben wurde.

var uri = "https://example.com";
var scheme = "https";    
var matcher = new sn_ws.UriMatcher();  
var resp = matcher.match(uri, scheme);  

gs.info("Error occurred: " + resp.isError());  
gs.info("Error message: " + resp.getErrorMessages());

Ausgabe:

Error occurred: true
Error message: Hosts rule is null or empty.

UriMatcherResponse – isError()

Überprüft, ob beim Testen des URI anhand der angegebenen Kriterien ein Fehler aufgetreten ist.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob ein Fehler aufgetreten ist. Gültige Werte: Wahr: Ein Fehler ist aufgetreten. Falsch: Es sind keine Fehler aufgetreten.

Dieses Beispiel gibt einen Fehler zurück, da der URI Abfrageparameter enthält. Der Fehler tritt auf, da das Argument an übergeben wurde Übereinstimmung () Für disallowQueryParametersIst Wahr .

var uri = "https://example.com/path1/more?q=query";
var scheme = "https";  
var allowedHosts = ["example.com", "sample.com"];  
var allowedPaths = ["/path1/more", "/path2/less"];  
var allowedFragments = ["section1", "section2"];  
var noQueryParams = true;
var matcher = new sn_ws.UriMatcher();  
var resp = matcher.match(uri, scheme, allowedHosts, allowedPaths, allowedFragments, noQueryParams);  

gs.info("Error occurred: " + resp.isError());  
gs.info("Error message: " + resp.getErrorMessages());

Ausgabe:

Error occurred: true
Error message: Query parameters are not allowed for matching.

UriMatcherResponse – isFragmentMatches()

Überprüft, ob der URI den Kriterien für Fragmente entspricht.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der URI den Kriterien für Fragmente entspricht. Gültige Werte: Wahr: Der URI entspricht den Kriterien für Fragmente. Falsch: Der URI stimmt nicht mit den Kriterien für Fragmente überein.

Dieses Beispiel zeigt, dass der URI nicht den Kriterien entspricht, da er ein Fragment enthält, das nicht in der Liste der zulässigen Fragmente enthalten ist.

var uri = "https://example.com/path1/more#section3";
var scheme = "https";  
var allowedHosts = ["example.com", "sample.com"];  
var allowedPaths = ["/path1/more", "/path2/less"];  
var allowedFragments = ["section1", "section2"];  
var matcher = new sn_ws.UriMatcher();  
var resp = matcher.match(uri, scheme, allowedHosts, allowedPaths, allowedFragments);  

gs.info("Is URI a match: " + resp.isMatch());  
gs.info("Is scheme a match: " + resp.isSchemeMatches());  
gs.info("Is host a match: " + resp.isHostMatches());  
gs.info("Is path a match: " + resp.isPathMatches());  
gs.info("Is fragment a match: " + resp.isFragmentMatches());
gs.info("Error occurred: " + resp.isError());

Ausgabe:

Is URI a match: false
Is scheme a match: true
Is host a match: true
Is path a match: true
Is fragment a match: false
Error occurred: false

UriMatcherResponse – isHostMatches()

Überprüft, ob der URI den Kriterien für den Host entspricht.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der URI den Kriterien für den Host entspricht. Gültige Werte: Wahr: Der URI entspricht den Kriterien für den Host. Falsch: Der URI stimmt nicht mit den Kriterien für den Host überein.

In diesem Beispiel wird überprüft, ob der URI mit dem angegebenen Schema und Host übereinstimmt.

var uri = "https://example.com/path?q=query";
var scheme = "https";  
var allowedHosts = ["example.com"];  
var matcher = new sn_ws.UriMatcher();  
var resp = matcher.match(uri, scheme, allowedHosts);  

gs.info("Is URI a match: " + resp.isMatch());
gs.info("Is host a match: " + resp.isHostMatches());

Ausgabe:

Is URI a match: true
Is host a match: true

UriMatcherResponse – isMatch()

Überprüft, ob der URI allen angegebenen Kriterien entspricht.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 10. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der URI allen angegebenen Kriterien entspricht. Gültige Werte: Wahr: Der URI entspricht allen Kriterien. Falsch: Der URI stimmt nicht mit allen Kriterien überein.

In diesem Beispiel wird überprüft, ob der URI mit dem angegebenen Schema und Host übereinstimmt.

var uri = "https://example.com/path?q=query";
var scheme = "https";  
var allowedHosts = ["example.com"];  
var matcher = new sn_ws.UriMatcher();  
var resp = matcher.match(uri, scheme, allowedHosts);  

gs.info("Is URI a match: " + resp.isMatch());

Ausgabe:

Is URI a match: true

UriMatcherResponse – isPathMatches()

Überprüft, ob der URI den Kriterien für den Pfad entspricht.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 12. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der URI den Kriterien für den Pfad entspricht. Gültige Werte: Wahr: Der URI entspricht den Kriterien für den Pfad. Falsch: Der URI stimmt nicht mit den Kriterien für den Pfad überein.

In diesem Beispiel wird überprüft, ob der URI mit dem angegebenen Schema, Host und Pfad übereinstimmt.

var uri = "https://example.com/path1/more";
var scheme = "https";  
var allowedHosts = ["example.com", "sample.com"];  
var allowedPaths = ["/path1/more", "/path2/less"];  
var matcher = new sn_ws.UriMatcher();  
var resp = matcher.match(uri, scheme, allowedHosts, allowedPaths);  

gs.info("Is URI a match: " + resp.isMatch());  
gs.info("Is scheme a match: " + resp.isSchemeMatches());  
gs.info("Is host a match: " + resp.isHostMatches());  
gs.info("Is path a match: " + resp.isPathMatches());  
gs.info("Is fragment a match: " + resp.isFragmentMatches());
gs.info("Error occurred: " + resp.isError());

Ausgabe:

Is URI a match: true
Is scheme a match: true
Is host a match: true
Is path a match: true
Is fragment a match: true
Error occurred: false

UriMatcherResponse – isSchemeMatches()

Überprüft, ob der URI den Kriterien für das Schema entspricht.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 14. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der URI den Kriterien für das Schema entspricht. Gültige Werte: Wahr: Der URI entspricht den Kriterien für das Schema. Falsch: Der URI stimmt nicht mit den Kriterien für das Schema überein.

In diesem Beispiel wird überprüft, ob der URI mit dem angegebenen Schema und Host übereinstimmt.

var uri = "https://example.com/path?q=query";
var scheme = "https";  
var allowedHosts = ["example.com"];  
var matcher = new sn_ws.UriMatcher();  
var resp = matcher.match(uri, scheme, allowedHosts);  

gs.info("Is URI a match: " + resp.isMatch());
gs.info("Is scheme a match: " + resp.isSchemeMatches());

Ausgabe:

Is URI a match: true
Is scheme a match: true