11.4 Mit GET und POST Daten übergeben *
Beim Aufruf einer Webseite können wir Parameter übergeben – bei einer Suchmaschine etwa den Suchbegriff. Es gibt nun zwei Möglichkeiten, wie diese Parameter zum Skript kommen und somit vom Webserver verarbeitet werden:
- Die Parameter (auch Query-Strings genannt) werden an die URL angehängt (GET-Methode).
- Die Daten werden zur Standardeingabe des Webservers gesendet (POST-Methode). Das Skript muss dann aus dieser Eingabe lesen.
GET und POST unterscheiden sich auch in der Länge der übertragenen Daten. Bei vielen Systemen ist die Länge einer GET-Anfrage auf 1.024 Byte beschränkt. POST-Anfragen sind in ihrer Länge unbegrenzt.
Daten nach der GET-Methode verschicken
Im Fall der GET-Anfrage steht der Anfrage-String (Query-String) hinter dem Fragezeichen, das wiederum hinter der Pfadangabe steht. Mehrere Query-Strings trennt das &-Zeichen. Unter Java setzen wir einfach einen Befehl ab, indem wir ein neues URL-Objekt erzeugen und anschließend den Inhalt auslesen.
Daten nach der POST-Methode versenden
Die Klasse URLConnection bietet die schon bekannte Methode getOutputStream() an, die eine Verbindung zur Eingabe des serverseitigen Programms möglich macht (POST-Methode).
11.4.1 Kodieren der Parameter für Serverprogramme
Da nicht alle Zeichen in einer URL-Zeile erlaubt sind, müssen sie umkodiert werden. So sind zum Beispiel keine Leerzeichen gültig; sie werden durch ein Pluszeichen umkodiert. Es gibt noch weitere zu übersetzende Zeichen, so das Plus-, Gleichheits- und Und-Zeichen. Von diesen Symbolen wird die Hex-Repräsentation als ASCII übersandt, aus »Ulli + Tina« wird dann »Ulli+%2B+Tina«. Aus dem Leerzeichen wird ein Plus, und aus dem Plus wird »%2B«.
Wollten wir einen String dieser Art zu einer URL zusammenbauen, um etwa eine Anfrage an ein Suchprogramm zu formulieren, müssen wir den String nicht kodieren. Dies übernimmt die Java-Klasse URLEncoder; den Weg zurück übernimmt URLDecoder.
Abbildung 11.6: UML-Diagramm für URLEncoder und URLDecoder
Listing 11.6: com/tutego/insel/net/URLEncoderDemo.java
package com.tutego.insel.net;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
public class URLEncoderDemo
{
static void enc( String s )
{
try {
System.out.println( URLEncoder.encode( s, "UTF-8" ) );
}
catch ( UnsupportedEncodingException e ) {
e.printStackTrace();
}
}
public static void main( String[] args )
{
enc( "String mit Leerzeichen" ); // String+mit+Leerzeichen
enc( "String%mit%Prozenten" ); // String%25mit%25Prozenten
enc( "String*mit*Sternen" ); // String*mit*Sternen
enc( "String+hat+ein+Plus" ); // String%2Bhat%2Bein%2BPlus
enc( "String/mit/Slashes" ); // String%2Fmit%2FSlashes
enc( "String\"mit\"Gänsen" ); // String%22mit%22G%C3 %A4nsen
enc( "String:Doppelpunkten" ); // String%3ADoppelpunkten
enc( "String=ist=alles=gleich" ); // String%3Dist%3Dalles%3Dgleich
enc( "String&String&String" ); // String%26String%26String
enc( "String.mit.Punkten"); // String.mit.Punkten
}
}
class java.net.URLEncoder |
- static String encode(String s, String enc) throws UnsupportedEncodingException
Kodiert einen String s mit einem bestimmten Encoding.
- static String decode(String s, String enc) throws UnsupportedEncodingException
Dekodiert einen String s mit einem bestimmten Encoding.
11.4.2 Eine Suchmaschine mit GET-Request ansprechen
Wir wollen nun direkt eine Suchmaschine ansprechen und so das Verhalten eines Anfrageprogramms nachbilden. Unser Programm sammelt dazu alle Suchbegriffe als Parameter auf der Kommandozeile, und falls keine Parameter vorhanden sind, wird nach »Teletubbies on Tour« gesucht. Die Klasse URLEncoder kodiert den Suchstring, und der Inhalt wird hinter die URL des serverseitigen Programms gehängt, noch getrennt durch ein Fragezeichen. Dies wird als Anfrage für die Suchmaschine Yahoo verpackt und weggeschickt. Die Ausgabe wird die komplette HTML-Seite mit dem Ergebnis sein.
Listing 11.7: com/tutego/insel/net/YahooSeeker.java
package com.tutego.insel.net;
import java.net.URL;
import java.net.URLEncoder;
import java.util.Scanner;
public class YahooSeeker
{
public static void main( String... args ) throws Exception
{
String search = "Teletubbies On Tour";
if ( args.length > 0 )
{
search = args[ 0 ];
for ( int i = 1; i < args.length; i++ )
search += " " + args[ i ];
}
search = "p=" + URLEncoder.encode( search.trim(), "UTF-8" );
URL u = new URL( "http://de.search.yahoo.com/search?" + search );
String r = new Scanner( u.openStream() ).useDelimiter( "\\Z" ).next();
System.out.println( r );
}
}
11.4.3 POST-Request absenden
Ein POST-Request überträgt die Parameter nicht in der URL, sondern setzt sie in einen Block, der zum Server übertragen wird. Gegenüber einem GET ändert sich einiges, was das folgende Beispiel (zu einem fiktiven Server) zusammenfasst:
Listing 11.8: com/tutego/insel/net/PostRequest.java, main()
String body = "param1=" + URLEncoder.encode( "value1", "UTF-8" ) + "&" +
"param2=" + URLEncoder.encode( "value2", "UTF-8" );
URL url = new URL( "http://li.la.lu.lo/post/" );
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod( "POST" );
connection.setDoInput( true );
connection.setDoOutput( true );
connection.setUseCaches( false );
connection.setRequestProperty( "Content-Type",
"application/x-www-form-urlencoded" );
connection.setRequestProperty( "Content-Length", String.valueOf(body.length()) );
OutputStreamWriter writer = new OutputStreamWriter( connection.getOutputStream() );
writer.write( body );
writer.flush();
BufferedReader reader = new BufferedReader(
new InputStreamReader(connection.getInputStream()) );
for ( String line; (line = reader.readLine()) != null; )
System.out.println( line );
writer.close();
reader.close();
Der MIME-Typ »application/x-www-form-urlencoded« steht für ein Web-Formular, muss aber je nach Typ angepasst werden.
Tipp |
Für POST-Anfragen gibt es Open-Source-Bibliotheken, die die Serveranfrage vereinfachen. Mehr Informationen geben Abschnitt 11.8, »Apache HttpComponents und Commons Net«, und Abschnitt 13.2.10, »PUT/POST/DELETE-Sendungen mit der Jersey-Client-API absetzen«. |
Ihr Kommentar
Wie hat Ihnen das <openbook> gefallen? Wir freuen uns immer über Ihre freundlichen und kritischen Rückmeldungen.