Die komplette MoSKito-Integrationsanleitung – Schritt 0
Der Auftakt einer Schritt-für-Schritt-Anleitung zur MoSKito-Integration: Wir stellen The Burger Shop vor, eine kleine Spring-MVC-Demo-App, und zeigen, wie Sie unser Versuchskaninchen bauen und starten.
Trotz der Mühe, die wir in die MoSKito-Dokumentation stecken, bekommen wir immer wieder Fragen wie ‚Wie mache ich dies‘ und ‚Wie bekomme ich das‘.
Jetzt möchten wir Ihnen eine Anleitung für den gesamten Setup-Zyklus an die Hand geben, die mit diesem Beitrag beginnt.
Die Anleitung deckt einen kompletten Anwendungslebenszyklus mit MoSKito ab, von der Integration des ersten MoSKito-Essential-Producers bis zur Installation von MoSKito-Control und dem Setup von MoSKito-Central.
Doch bevor wir anfangen, brauchen wir ein Versuchskaninchen. Darum kümmern wir uns heute – wir richten eine einfache Anwendung für Experimentierzwecke ein.
Unser niedliches kleines Versuchskaninchen wird The Burger Shop sein.
The Burger Shop entstand in einer Brainstorming-Session im Oliva bei Kalbsmedaillons mit Rosmarin und Thymian (etwas, das Sie unbedingt probieren sollten, wenn Sie in Kiew sind). Die App wurde von Olena Mukha, einer unserer sehr talentierten Kiewer Designerinnen, gestaltet und in HTML umgesetzt.
Da The Burger Shop (überraschenderweise) keine echten Burger verkauft, habe ich daraus eine kleine, geradlinige Spring-MVC-Anwendung gemacht. Die App besteht aus 10 Klassen (3 Controller, ein Service) und drei JSPs. Der Code ist kein Musterbeispiel für eine Spring-Anwendung oder Ähnliches, nehmen Sie ihn also, wie er ist: ein leicht verständliches kleines Versuchskaninchen für die MoSKito-Integration.
Der Code wird auf GitHub unter https://github.com/anotheria/moskito-demo verwaltet. Dieses Repository enthält verschiedene Versionen von The Burger Shop und weitere MoSKito-Demonstrationsmaterialien.
Klonen Sie das Demo-Repository.
git clone https://github.com/anotheria/moskito-demo.git
Wenn Sie dieser Anleitung folgen möchten, verwenden Sie „burgershop-spring-stripped“ und führen alle Integrationsschritte selbst durch. Wenn Sie nur ein Gefühl dafür bekommen möchten, wie MoSKito funktioniert, können Sie sich „burgershop-spring-example“ ansehen.
I. Den Shop starten.
Um den Shop zu starten, benötigen Sie:
- Java SE, vorzugsweise 1.7.irgendwas. Ich verwende 1.7.0_06.
- Maven, ich verwende 3.1.1.
- Einen Servlet-Container wie Tomcat, Jetty oder Resin. Ich verwende Tomcat 7.0.39.
- Einen Git-Client. Meiner kam mit meinem Mac, die aktuelle Version ist 1.8.3.4 (Apple Git-47).
Um den Shop zu starten, bauen Sie das Projekt mit Maven clean install:
mvn clean install
Nach der Ausführung von Maven, die typischerweise ein paar Sekunden dauert (es gibt wirklich nicht viel zu tun), sehen Sie die Erfolgsmeldung:
[INFO] -----------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] -----------------------------------------------------------
[INFO] Total time: 4.226s
[INFO] Finished at: Wed Dec 04 15:49:27 CET 2013
[INFO] Final Memory: 12M/30M
[INFO] -----------------------------------------------------------
Das bedeutet, dass Maven ein Webarchiv (*.war) unter target/burgershop.war. abgelegt hat. Kopieren Sie nun burgershop.war in Ihren Servlet-Container und rufen Sie http://localhost:8080/burgershop/ auf.
Natürlich kann der Port in Ihrer Installation abweichen, aber bei mir erscheint folgender Bildschirm:
Startseite des Burgershops
II. Wir haben also einen Shop, und jetzt?
Wie Sie sehen, haben wir gerade unseren brillanten Shop für Burger aller Art bekommen, bestens empfohlen von Vegsource, Michelin, Weight Watchers und sogar der Regierung Albaniens. Jetzt müssen Sie nur noch auf den freundlichen roten Button „make your own burger now!“ klicken:
Wählen Sie ein paar leckere Zutaten (Insidertipp: Probieren Sie die Kakerlake)
Bestellen Sie den Burger
Und in spätestens 30 Minuten wartet Ihr Burger irgendwo in Timbuktu auf Sie:
Übrigens empfehlen wir zum Burger eine Flasche Chianti Classico Riserva 2009. Er passt perfekt zum Geschmack einer Kakerlake.
III. Nächste Schritte.
Jetzt haben wir also eine Anwendung, die wir MoSKitoRisieren (TM), überwachen, kaputt machen, skalieren und mit der wir spielen können. Im nächsten Schritt fügen wir dem Shop eine grundlegende MoSKito-Integration hinzu.
Bis morgen 😉
Leon