probleemstelling
Bij het opstarten van een project, krijg je in Eclipse of MyEclipse alvast een aantal standaardprojecten mee. Dit volstaat indien je pakweg een aantal oefeningen wil maken zoals je die in de meeste handboeken over Java terugvindt. Wil je echter verder gaan, zoals pakweg een webapplicatie maken, dan moet je meer zaken toevoegen. De Javabouwstenen vind je terug in de diverse Javabibliotheken. Deze bibliotheken zijn ook bekend als Java Archives of Java-archieven. Deze JAR bestanden herken je aan de .jar extensie. Een JAR file kan je dubbelklikken om te openen. In feite werkt zo'n JAR file op dezelfde manier als een zipfile. De inhoud is gecomprimeerd om schijfruimte te winnen, maar de inhoud is nog wel raadpleegbaar.
Aanmaken Javaproject onder Eclipse
In Eclipse maak je een Javaproject aan door via het hoofdmenu File - new - java project te selecteren.
Je geeft daarna een naam in (bijvoorbeeld "testproject") en bevestigt dit samen met de keuze van de JEE of Java Enterprise Edition waarmee je wil werken. In het onderstaande scherm kiezen we voor JEE 5. Deze keuze bepaalt tevens de mogelijkheden van de Javaversie waarmee je aan de slag wil.
In de package explorer krijg je een overzicht van alle Javaprojecten. Hieronder zie je het javaproject "testproject" met zijn Java archives. Het gaat hier om de standaard Java-archieven die je voor ieder Javaproject nodig hebt.
definiëren Java webproject in MyEclipse
Eclipse is gratis, MyEclipse biedt voor een jaarlijkse licentie van iets meer dan 30 $ (prijs van 2008) een aantal opties waar je mee aan de slag kan als je webapplicaties wilt maken. Hieronder overlopen we die mogelijkheden. We selecteren de naam van ons nieuwe project ("testproject") en klikken met de rechtermuisknop. Er verschijnt nu een snelmenu. In dit snelmenu kiezen we voor MyEclipse - Add Web project capabilities.
We configureren nu het JEE project als een Java webproject. Automatisch is de optie "Add J2EE libraries to build path" aangevinkt.
Het resultaat zie je hieronder. Er zijn een aantal Java-archieven of Java Archives bijgekomen. Deze Java archives bevatten een aantal klassen waar je nu gebruik van kan maken of een Java webapplicatie te bouwen. Je kan hierbij denken aan de klasse Servlet die je nodig zal hebben om de webapplicatie te kunnen besturen.
Overstappen naar Java Server Faces
Je kan een Java webapplicatie volledig zelf maken, maar daar is behoorlijk wat tijd en energie mee gemoeid. Om je toe te laten je te focussen op de inhoud van de webapplicatie en minder op het loodgieterswerk dat nodig is voor het paginabeheer, zijn er diverse raamwerken opgestart. Om er maar een paar te noemen : Struts, Tapestry, Java Server Faces. Die laatste is door Sun opgestart en behoort nu tot de Java Enterprise Edition standaard. MyEclipse biedt je de mogelijkheid om met JSF aan de slag te gaan. Hiervoor selecteer je weer de naam van het project en je drukt op de rechtermuisknop. Omdat je tevoren al dit project als webproject hebt gedefinieerd, biedt het snelmenu een aantal extra opties die zoëven niet zichtbaar waren. We selecteren de optie "Add JSF capabilities".
Op het volgende scherm kunnen we de standaard waardes bevestigen door op de "finish" knop te klikken.
Het resultaat is hieronder te zien. Java Server Faces beheert de paginaovergang via een XMLbestand met de naam faces-config.xml. De JSF JAR bestanden hadden we in een vorig scherm al gezien en waren toegevoegd zodra we het project als webproject wilden definiëren.
Icefaces
Icefaces is een raamwerk dat verder bouwt op Java Server Faces. JSF behoort tot de JEE standaard; alle andere raamwerken zoals Icefaces, MyFaces, RichFaces behoren hier niet toe. Waarom zou je dan zo'n raamwerk willen gebruiken ? In mijn geval wil ik gebruik maken van de paginering die standaard in Icefaces zit. En de keuze van Icefaces is me in feite een beetje opgedrongen : MyEclipse biedt de mogelijkheid om icefaces te installeren; de andere raamwerken zitten hier niet bij.
Het omvormen van JSF webproject naar Icefaces webproject zorgt ervoor dat de web.xml en faces-config.xml ook gewijzigd worden. Er worden wel kopieën genomen van de orginele bestanden. En natuurlijk is er een hele Icefaces bibliotheek bijgekomen.
Log4J
In de vorige schermafdrukken hebben we gezien hoe we JAR files toevoegden door een Javaproject om te vormen tot een Java webproject. Maar je kan ook zelf bepalen welke Java Archive er moet toegevoegd worden. Een goed voorbeeld vinden we hieronder met de introductie van Log4J.
Wat is Log4J
Log4J staat voor Logging for Java. Log4J omvat een aantal klassen waarmee je een logboek kan inbouwen in een applicatie. In het begin ben je wel eens geneigd om vooral te werken met System.out.println("..") om overal berichten te zetten en zo aan debugging te doen. Maar dit kost veel performantie en is niet netjes. Bovendien zit ik ook met een webapplicatie die ik publiceer op een server ergens in Roswell, Georgia. Daar ben ik met System.out.println instructies niets. Java voorziet ook in de mogelijkheid om met java.util.logging te werken, maar ook dat geniet geen genade in de ogen van de systeembeheerders van Roswell. En dus moet ik wel Log4J inbouwen als ik in geval van nood wil weten wat er nu net misloopt in mijn webapplicatie.
startsituatie begin januari 2009
In januari 2009 werk ik aan een tweede versie en daarom begin ik in stuk en brok code te kopiëren van de gco map naar de gcoV2 map. En met het kopiëren krijg ik al direct een foutmelding zoals je hieronder kan zien.
Als ik dubbelklik op Log4JBoek krijg ik de code van deze klasse te zien. En hier is duidelijk dat Eclipse zich geen raad weet met de definitie van org.apache.log4j. Da's ook logisch want die klassen zitten niet in de standaard definitie van Java. Je kan Log4J van het net plukken bij Apache. Op de webpagina http://logging.apache.org/log4j/1.2/index.html kan je terecht voor een overzicht van wat versie 1.2 inhoudt. We kiezen voor de laatste versie, zijnde 1.2.15.
Eenmaal van het net afgeladen, kan je de Java Archive toevoegen aan de Eclipse werkomgeving. Hiervoor selecteer je de naam van het project waaraan je de JAR file wil toevoegen. Klik met de rechtermuisknop en je ziet een snelmenu. Selecteer nu Build Path - Add External Libraries.
Je krijgt nu de kans om te bladeren op de harde schijf. Hieronder zie je waar ik de jar file heb geplaatst.
Na het toevoegen vertoont Log4JBoek geen pictogram meer dat erop wijst dat er foutmeldingen zijn. En ook de Java Archive van Log4J is nu zichtbaar in dit project. Met als gevolg dat de Eclipse compiler nu wél weet wat org.apache.log4j betekent.
