(Software-)Schnittstelle / Interface

Allgemein irgendein Verfahren, über das Softwarekomponenten miteinander Informationen austauschen.

Vorsicht: In Java gibt es eine bestimmte Art von Klasse, die als Interface bezeichnet wird (siehe unten).

Framework

vgl. Softwarebibliothek ... aber nicht das gleiche

• Bibliothen (Library)

  • macht gewisse Vorgaben bei der Benutzung (z.B. kompatible Datentypen)
  • als einzelne Programmkomponente relativ austauschbar
  • übernimmt einzelne Aufgaben
  • ein Programm nutzt idR. mehrere Bibliotheken für verschiedene Aufgaben

• Framework

  • macht strenge Vorgaben für den Aufbau des Programms
  • idr. nutzt das Programm höchstens ein Framework
  • durch die Anpassung des Programms an das Framework ist das Framework schwer austauschbar

Aber! Der Übergang ist fließend. Es gibt mehr und weniger aufdringliche Frameworks.

Interfaces in Java

• Verhält sich ein Bisschen wie eine abstrakte Klasse (wird nicht Klasse genannt!)
• Kann nicht als eigenes Objekt angelegt werden
• Enthält Definitionen von Methoden, aber nicht die Methoden selbst

• Eine neue Klasse kann ein Interface implementieren (man sagt nicht erben/extenden!)

  • Die implementierende Klasse ist dann gezwungen die vordefinierten Methoden anzulegen
• Vorteil gegenüber der abstrakten Klasse: Eine neue Klasse kann mehrere Interfaces implementieren (Vorteil gegenüber Vererbung in Java)
• Nachteil gegenüber der Abstrakten Klasse: Methoden dürfen im Interface selbst nicht implementiert sein! (Die abstrakte Klasse erlaubt dagegen abstrakte und nicht-abstrakte Methoden)

• Einige Methoden aus der Java-Standard-Bibliothek (Java-API) benötigen Argumente, die ein bestimmtes Interface implementieren

  • → dadurch erhält die Methode, die Garantie, in dem übergebenen Objekt bestimmte Methoden aufrufen zu können (nämlich die Methoden, die das Interface vorschreibt)

https://docs.oracle.com/en/java/javase/17/docs/api/allclasses-index.html
IHK-Prüfungsrelevant eigentlich nur bei Klassendiagrammen: https://de.wikipedia.org/wiki/Klassendiagramm

Beispiel für die Praxis: ObejctWriter und das Serializable-Interface

Materialien:

• Handreichung HTML.pdf
• hallo.html
• hallo.js
• Apache Config-Datei: /etc/apache2/sites-available/000-default.conf
• zeit.sh

Einrichtung Tomcat-Webserver

• Der Tomcat Webserver kann Java-Servlets ausführen

• ~# apt-get install tomcat10 tomcat10-examples tomcat10-docs tomcat10-admin

  • In aktuellen distributionen stehen auch neuere Tomcat-Versionen zur Verfügung
• ggf. ~# service tomcat10 start

• Test: Im Browser aufrufen http://IPADRESSE:8080

  • → Zeigt die "It Works!"-Seite des Tomcat

• Die verlinkte "Manager webapp" Benötigt ein Passwort

  • Datei /etc/tomcat10/tomcat-users.xml anpassen

    • Dort ist der größte Teil auskommentiert
    • Beispielzeilen für gültige User stehen dort bereit

Dokumentation zu Servlets allgemein

https://tomcat.apache.org/tomcat-11.0-doc/appdev/index.html https://docs.oracle.com/javaee/7/api/javax/servlet/http/HttpServlet.html

Servlet erstellen in IntelliJ

• IntelliJ Ultimate

• Neues Projekt erstellen
• Wichtig: Template für Web Application

• In Tomcat10: jdk-Version nicht über 17, u. Jakarta EE Version nicht über 10

  • Alternativ: aktuellen Tomcat benutzen

• Quellcode-Dateien im Projekt sind:

  • webapp/index.jsp... kann auch durch index.html ersetzt werden
  • zusätzlich können hier weitere statische Dateien abgelegt (z.B. .css, .js)

  • src/main/java/.../*.java → Servlet Klassen mit dynamischem Code

    • Greeter.java

• Im Maven-Menü eine .war-Datei erstellen

  • .war-Archiv erscheint im target/-Verzeichnis des Projekts
  • ggf. auch explizit einen Rebuild des Projekts auslösen

• .war-Datei kann im Manager-UI von Tomcat deployed werden

  • vorherige Versionen vorher explizit undeployen

Lösung:

• hallo2.sh
• HelloServlet2.class ... Achtung! Die muss nach dem Download umbenannt werden, damit sie mit dem Klassennamen übereinstimmt!

Lösung für das Problem

• die eigentlichen Dienste werden gefirewalled (bzw. laufen nur auf localhost oder Unix-Socket).
• Der einzige Dienst, der Online sichtbar ist, ist ein Reverse Proxy.

Beispiel Apache

• ~# a2enmod rewrite proxy proxy_http
• Config File:

[...]

RewriteEngine on
# leitet alle URI, die mit /greeter beginnen *genau* auf die greeter-App in Tomcat weiter
RewriteRule   ^/greeter  http://localhost:8080/WebApp-1.0-SNAPSHOT/greeter   [P]

# Würde *genau* die URI /docs/ auf die /docs/ seite von Tomcat weiterleiten, aber *nicht* die Unterseiten
# RewriteRule ^/docs/$        http://localhost:8080/docs/                             [P]

# Richtig: URI /docs/ und alle unterseiten werden an Tomcat und Unterseiten weitergeleitet
RewriteRule   ^/docs/(.*)     http://localhost:8080/docs/$1                           [P]

[...]

https://httpd.apache.org/docs/2.4/mod/mod_rewrite.html