Java REST Anfragen und Anworten (PUT und GET)

Heute habe ich mich mit dem Datenaustausch von REST mit Java auseinander gesetzt. Hierbei werden Daten von Maschine zu Maschine gesendet, zu meist in dem XML oder JSON Format. Ich wollte eine XML Datei an einen Server senden, damit dieser die Anfrage beantwortet und mir eine Anwort schickt. Das Programm soll zum Testen eine API verwendet werden, weshalb Test XML Dateien geschickt werden. Später sollen die XML von dem einem Programm erzeugt werden und von dem anderem Programm gelesen und beantwortet werden. Mit Hilfe von Bibliotheken kann man sehr schnell so eine Funktionalität programmieren, jedoch ist das Testen schwieriger je größer ein Programm wird. Aus diesem Grund programmiere ich ein kleines Testprogramm.

Hier folgen nun die Quellcodebeispiele zum senden eine XML Datei und erhalten einer Serverantwort. Mit wenigen Handgriffen kann dieser Quellcode für JSON und andere Formate verwendet werden.

    /**
     * 
     * @param server {@link String} mit Host und Port
     * @param file {@link File} XML welche an den Server gesendet werden soll,
     * @return {@link String} mit der Serverantwort
     */
    public String putDataXML(String server, File file) throws Exception
    {
	String input = FileHelper.readFile(file.getAbsolutePath());
	Client client = Client.create();
	client.setConnectTimeout(30000);
	WebResource webResource = client.resource(server);
	ClientResponse response = webResource.type("application/xml").post(ClientResponse.class, input);
	return response.getEntity(String.class);
    }

/**

* @param server {@link String} mit Host und Port

* @param file {@link File} XML welche an den Server gesendet werden soll,

* @return {@link String} mit der Serverantwort

public String putDataXML(String server, File file) throws Exception

{

String input = FileHelper.readFile(file.getAbsolutePath());

Client client = Client.create();

client.setConnectTimeout(30000);

WebResource webResource = client.resource(server);

ClientResponse response = webResource.type("application/xml").post(ClientResponse.class, input);

return response.getEntity(String.class);

}

FileHelper hilft Dateien zu einem String auszulesen.

    /**
     * Eine Datei wird zu einem String ausgelesen.
     * 
     * @param pathname
     *            {@link String} mit dem Dateinamen
     * @return {@link String} Dateiinhalt
     * @throws IOException
     *             wenn die Datei nicht geöffnet werden konnte.
     */
    public static String readFile(String pathname) throws IOException
    {

	File file = new File(pathname);
	StringBuilder fileContents = new StringBuilder((int) file.length());
	Scanner scanner = new Scanner(file);
	String lineSeparator = System.getProperty("line.separator");

	try
	{
	    while (scanner.hasNextLine())
	    {
		fileContents.append(scanner.nextLine() + lineSeparator);
	    }
	    return fileContents.toString();
	}
	finally
	{
	    scanner.close();
	}
    }

/**

* Eine Datei wird zu einem String ausgelesen.

* @param pathname

* {@link String} mit dem Dateinamen

* @return {@link String} Dateiinhalt

* @throws IOException

* wenn die Datei nicht geöffnet werden konnte.

public static String readFile(String pathname) throws IOException

{

File file = new File(pathname);

StringBuilder fileContents = new StringBuilder((int) file.length());

Scanner scanner = new Scanner(file);

String lineSeparator = System.getProperty("line.separator");

try

{

while (scanner.hasNextLine())

{

fileContents.append(scanner.nextLine() + lineSeparator);

}

return fileContents.toString();

}

finally

{

scanner.close();

}

Für die REST Funktionen habe ich eine JAVA Bibliothek verwendet, welche in das Programm eingefügt wird und in den Build-Path gehangen wird. Die Entwicklungsumgebungen machen dies automatisch. Folgende Bibliotheken benötigt ihr:

jersey-bundle.jar (http://download.java.net/maven/2/com/sun/jersey/jersey-bundle/1.8/jersey-bundle-1.8.jar)
jsr311-api.jar (http://download.java.net/maven/2/javax/ws/rs/jsr311-api/1.1/jsr311-api-1.1.jar)
asm.jar (http://repo1.maven.org/maven2/asm/asm/3.1/asm-3.1.jar)

Mehr dazu könnt ihr im Openbook Java 7 vom Rheinwerk Computing Verlag nachlesen.

Diese Artikel sind auch interessant: