WML-Tutorial
[ Inhaltsverzeichnis ]WMLScript
 URL-Bibliothek
Grundlagen der URL-Bibliothek
escapeString(...)
getBase(...)
getFragment(...)
getHost(...)
getPath(...)
getParameters(...)
getPort(...)
getQuery(...)
getReferer(...)
getScheme(...)
isvalid(...)
loadString(...)
resolve(...)
unescapeString(...)


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:

schema://host:port/pfad;parameter?query#fragment


escapeString(...)

Die Funktion escapeString(...) liefert eine neue Zeichenkette zurück, in der alle Sonderzeichen der übergebenen Zeichenkette String in Escape-Sequenzen umgewandelt worden sind.

Funktionskopf 

 : 

 escapeString(String)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = URL.escapeString("http://www.wml-tutorial.de/ws09.html#A");
// --> x = "http%3a%2f%2fwww.wml-tutorial.de%2fws09.html%23A"

getBase(...)

Die Funktion getBase(...) liefert die absolute Url der aktuellen WMLScript-Datei zurück. Eventuell vorhandene Fragmente ( #fragment ) werden nicht berücksichtigt.

Funktionskopf 

 : 

 getBase()

 

 

 

Parameter 

 : 

 

 

 

 

 

Rückgabewert 

 : 

 Zeichenkette

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();

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.

schema://host:port/pfad;parameter?query#fragment

Funktionskopf 

 : 

 getFragment(Url)

 

 

 

Parameter 

 : 

 Url

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = URL.getFragment("http://wml-tutorial.de/ws09#F"); // --> x = "F"

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.

schema://host:port/pfad;parameter?query#fragment

Funktionskopf 

 : 

 getHost(Url)

 

 

 

Parameter 

 : 

 Url

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = URL.getHost("http://wml-tutorial.de/ws09#F"); // --> x ="wml-tutorial.de"

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.

schema://host:port/pfad;parameter?query#fragment

Funktionskopf 

 : 

 getPath(Url)

 

 

 

Parameter 

 : 

 Url

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = URL.getPath("http://www.wml-tutorial.de/wml/datei#A"); // --> x = "/wml/datei"

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.

schema://host:port/pfad;parameter?query#fragment

Funktionskopf 

 : 

 getParameters(Url)

 

 

 

Parameter 

 : 

 Url

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = URL.getParameters("http://wml-tutorial.de/wml;1;8"); // --> x ="1;8"

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.

schema://host:port/pfad;parameter?query#fragment

Funktionskopf 

 : 

 getPort(Url)

 

 

 

Parameter 

 : 

 Url

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = URL.getPort("http://wml-tutorial.de:80/ws09#F"); // --> x = "80"

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.

schema://host:port/pfad;parameter?query#fragment

Funktionskopf 

 : 

 getQuery(Url)

 

 

 

Parameter 

 : 

 Url

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = URL.getQuery("http://www.wml-tutorial.de/datei.wml?rpk=10&ae=18"); // --> x = "rpk=10&ae=18"

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.

Funktionskopf 

 : 

 getReferer()

 

 

 

Parameter 

 : 

 

 

 

 

 

Rückgabewert 

 : 

 Zeichenkette

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"

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.

schema://host:port/pfad;parameter?query#fragment

Funktionskopf 

 : 

 getScheme(Url)

 

 

 

Parameter 

 : 

 Url

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = URL.getScheme("http://www.wml-tutorial.de"); // --> x ="http"

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.

Funktionskopf 

 : 

 isvalid(Url)

 

 

 

Parameter 

 : 

 Url

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 true,false oder invalid

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

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.

Funktionskopf 

 : 

 loadString(Url,Contenttype)

 

 

 

Parameter 

 : 

 Url

 Zeichenkette

 ContentType

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette, Integer-Wert oder invalid

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");

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.

Funktionskopf 

 : 

 resolve(Url1,Url2)

 

 

 

Parameter 

 : 

 Url1

 Zeichenkette

 Url2

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = URL.resolve("http://www.wml-tutorial.de","inhalt.html"); 
// --> x ="http://www.wml-tutorial.de/inhalt.html"

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.

Funktionskopf 

 : 

 unescapeString(String)

 

 

 

Parameter 

 : 

 String

 Zeichenkette

 

 

 

Rückgabewert 

 : 

 Zeichenkette oder invalid

Beispiel :


var x = URL.unescapeString("http%3a%2f%2fwww.wml-tutorial.de%2fws09.html%23A");
// --> x = "http://www.wml-tutorial.de/ws09.html#A"