[ Inhaltsverzeichnis ] | WMLScript |
URL-Bibliothek |
Grundlagen der URL-Bibliothek
Die URL-Bibliothek enthält Funktionen, um mit absoluten und relativen URLs arbeiten zu können. Der allgemeine
Aufbau einer Url ist folgender: |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
escapeString(...)Die Funktion escapeString(...) liefert eine neue Zeichenkette zurück, in der alle Sonderzeichen der übergebenen Zeichenkette String in Escape-Sequenzen umgewandelt worden sind.
Beispiel : |
|||||||||||||||||||
var x = URL.escapeString("http://www.wml-tutorial.de/ws09.html#A"); // --> x = "http%3a%2f%2fwww.wml-tutorial.de%2fws09.html%23A" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
getBase(...)Die Funktion getBase(...) liefert die absolute Url der aktuellen WMLScript-Datei zurück. Eventuell vorhandene Fragmente ( #fragment ) werden nicht berücksichtigt.
Erklärung :Angenommen, daß der folgende Funktionsaufruf von getBase(...) in einer WMLScript-Datei stattfindet, deren Url http://wml-tutorial.de/test.wmls lautet, so wird auch der Variablen x der Wert http://wml-tutorial.de/test.wmls zugewiesen. Beispiel : |
|||||||||||||||||||
var x = URL.getBase(); |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
getFragment(...)
Die Funktion getFragment(...) liefert das in der absoluten oder relativen Url vorkommende Fragment zurück. Ist kein Fragment in
der Url vorhanden, so wird eine leere Zeichenkette zurückgegeben. Ist die übergebene Url ungültig so ist der Rückgabewert invalid.
Beispiel : |
|||||||||||||||||||
var x = URL.getFragment("http://wml-tutorial.de/ws09#F"); // --> x = "F" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
getHost(...)
Die Funktion getHost(...) liefert den Hostnamen zurück, der in der absoluten oder relativen Url
enthalten ist. Sollte in der Url kein Hostname vorkommen, so liefert die Funktion eine leere Zeichenkette zurück.
Ist die übergebene Url ungültig so ist der Rückgabewert invalid.
Beispiel : |
|||||||||||||||||||
var x = URL.getHost("http://wml-tutorial.de/ws09#F"); // --> x ="wml-tutorial.de" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
getPath(...)
Die Funktion getPath(...) liefert den Pfad in der absoluten oder relativen Url zurück. Ist die
übergebene Url ungültig so ist der Rückgabewert invalid.
Beispiel : |
|||||||||||||||||||
var x = URL.getPath("http://www.wml-tutorial.de/wml/datei#A"); // --> x = "/wml/datei" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
getParameters(...)
Die Funktion getParameters(...) gibt die Parameter zurück, die im letzten Pfad-Segment der absoluten oder relativen Url
enthalten sind. Ist kein Parameter in der Url enthalten, so wird eine leere Zeichenkette zurückgegeben. Ist die
übergebene Url ungültig so ist der Rückgabewert invalid.
Beispiel : |
|||||||||||||||||||
var x = URL.getParameters("http://wml-tutorial.de/wml;1;8"); // --> x ="1;8" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
getPort(...)
Die Funktion getPort(...) liefert die in der absoluten oder relativen Url vorkommende Portnummer zurück. Ist kein Port in
der Url vorhanden, so wird eine leere Zeichenkette zurückgegeben. Ist die übergebene Url ungültig so ist der Rückgabewert invalid.
Beispiel : |
|||||||||||||||||||
var x = URL.getPort("http://wml-tutorial.de:80/ws09#F"); // --> x = "80" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
getQuery(...)
Die Funktion getQuery(...) liefert als Rückgabewert den Query, der in der absoluten oder relativen
Url enthalten ist. Ist kein Query in der Url vorhanden, so gibt die Funktion die leere Zeichenkette
zurück. Ist die übergebene Url ungültig so ist der Rückgabewert invalid.
Beispiel : |
|||||||||||||||||||
var x = URL.getQuery("http://www.wml-tutorial.de/datei.wml?rpk=10&ae=18"); // --> x = "rpk=10&ae=18" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
getReferer(...)Die Funktion getReferer(...) liefert die kleinste relative URL von der Resource zurück, die das WMLScript aufgerufen hat in der diese Funktion aufgerufen wird.
Erklärung :Angenommen, daß der folgende Funktionsaufruf von getReferer(...) in einer WMLScript-Datei stattfindet, die von der card mit der id eins, die sich der WML-Seite http://www.wml-tutorial.de/beispiel.wml befindet, aufgerufen worde, dann wird der Variablen x der Wert beispiel.wml#eins. Beispiel : |
|||||||||||||||||||
var x = URL.getReferer(); // --> x = "beispiel.wml#eins" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
getScheme(...)
Die Funktion getScheme(...) liefert das verwendete Schema der ihr übergebenen absoluten
oder relativen Url zurück. Ist die
übergebene Url ungültig so ist der Rückgabewert invalid.
Beispiel : |
|||||||||||||||||||
var x = URL.getScheme("http://www.wml-tutorial.de"); // --> x ="http" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
isvalid(...)Die Funktion isvalid(...) überprüft, ob die ihr übergebene Url eine gültige relative oder absolute URL ist. Ist die Url gültig, so liefert die Funktion true ,anderfalls wird false zurückgegeben.
Beispiel : |
|||||||||||||||||||
var x = URL.isvalid("http://www.wml-tutorial.de"); // --> x = true var y = URL.isValid("/wml/w08.html"); // --> y = true var z = URL.isvalid("http://www.wml-tutorial.de>"); // --> z = false |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
loadString(...)Die Funktion loadString(...) liefert den Inhalt der Url, welche vom angegebenen ContentType sein muss. Als ContentType kann jeder gültige Inhaltstyp dienen, der mit dem Präfix text beginnt, z.B. text/html oder text/x-vcard und viele andere. Der Rückgabewert dieser Funktion ist ein integer Wert, falls die Url nicht geladen, angefordert kann. Dieser integer Wert ist abhängig vom verwendeten Schema. Ist das Schema http oder wsp, dann ist der integer Wert ein http-error-code ( z.B. 404 für not found ). Sollte der ContentType fehlerhaft sein, dann gibt die Funktion invalid zurück.
Erklärung :Im folgendem Beispiel wird der Variablen x durch die Funktion loadString(...) der Inhalt der HTML-Datei zugewiesen, die unter http://127.0.0.1/default.htm erreichbar ist. Beispiel : |
|||||||||||||||||||
var u = "http://127.0.0.1/default.htm"; var x = URL.loadString(u,"text/html"); |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
resolve(...)Die Funktion resolve(...) gibt eine absolute URL zurück, die aus der Url1 und Url2 zusammengesetzt ist. Ist in der Url1 kein Pfad vorhanden, so wird der Slash als Pfad angenommen. Ist die Url2 schon eine absolute URL, so wird diese Url2 zurückgegeben. Ist die resultierende URL ungültig so ist der Rückgabewert invalid.
Beispiel : |
|||||||||||||||||||
var x = URL.resolve("http://www.wml-tutorial.de","inhalt.html"); // --> x ="http://www.wml-tutorial.de/inhalt.html" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
|||||||||||||||||||
unescapeString(...)Die Funktion unescapeString(...) liefert eine neue Zeichenkette zurück, in der alle Escape-Sequenzen in der übergebenen Zeichenkette String in die entsprechenden Sonderzeichen umgewandelt worden sind.
Beispiel : |
|||||||||||||||||||
var x = URL.unescapeString("http%3a%2f%2fwww.wml-tutorial.de%2fws09.html%23A"); // --> x = "http://www.wml-tutorial.de/ws09.html#A" |
|||||||||||||||||||
Seitenanfang Inhaltsverzeichnis |
© 2001 Ralf Peter Korte |