Doelservers voor J2EE-projecten opgeven

Tijdens het ontwikkelen van een J2EE-toepassing kunt u de serverruntime-omgeving van het J2EE-project opgeven. Tijdens het maken of het importeren wordt de doelserver opgegeven. De instelling kan via de projecteigenschappen worden gewijzigd. De doelserver geldt als standaardmethode voor het instellen van het klassenpad van J2EE-projecten.

Ter ondersteuning van verschillende toepassingenservers met uiteenlopende JDK-niveaus voor de Java Runtime Environment (JRE) moet in de workbench een doelserverinstelling worden opgegeven voor projecten. Als u bijvoorbeeld de functionaliteit van JDK 1.4.2 wilt benutten, zijn voor de toepassingen andere klassenpaditems nodig dan voor eerdere workbenchversies. Door u te vragen een doelserver op te geven, zorgt de workbench ervoor dat de juiste vermeldingen worden toegevoegd voor uitvoer op de server die u selecteert.

U kunt meer dan één doelserver voor het project opgeven. In dat geval voorkomt de workbench dat u facetten toevoegt die niet door alle doelservers worden ondersteund. Wanneer u meer dan één doelserver toevoegt, moet één van deze servers de primaire server zijn. Deze server wordt vermeld in het klassepad van het project.

Bij het maken van het project wordt het klassenpad bijgewerkt met twee klassenpadcontainers. De ene container is van JDK, de andere van de server. De JDK-container verwijst naar de directory met de JAR-bestanden die ter ondersteuning van de JDK-versie dienen. De servercontainer verwijst naar de directory met de openbare JAR-bestanden die op de geselecteerde server staan. Het project wordt vervolgens gecompileerd aan de hand van de vereiste JAR-bestanden in deze mappen en u hoeft tijdens de ontwikkeling geen aanvullende JAR-bestanden van de server toe te voegen. Bij het compileren van het project worden de JAR-bestanden in het klassenpad opgenomen. U kunt uw eigen JAR-bestanden nog steeds eraan toevoegen.

De runtime-omgeving wordt opgegeven in het bestand org.eclipse.wst.common.project.facet.core.xml in de map .settings van het project. Pas dit bestand niet handmatig aan, maar gebruik het venster Eigenschappen, zoals beschreven in dit onderwerp.

Alle J2EE-wizards voor het aanmaken en importeren van projecten vragen u om een doelserver op te geven. De lijst van beschikbare doelservers wordt gefilterd op basis van de geïnstalleerde runtimes, het J2EE-niveau van de toepassing en het J2EE-moduletype. Voor EJB-projecten worden bijvoorbeeld alleen toepassingenservers afgebeeld die ondersteuning voor Enterprise JavaBeans bieden. Aan alle projecten van één EAR-bestand moet dezelfde doelserver worden toegekend. Als u een nieuw project maakt en aan een bestaand EAR-project toevoegt, wordt de doelserverinstelling van het EAR-project overgenomen.

Opmerking: Voor Java-functieprojecten die aan een toepassing worden toegevoegd, wordt dezelfde doelserver gehanteerd als de toepassing. Voor webbibliotheekprojecten wordt dezelfde doelserver gehanteerd als het webproject.

U kunt de doelruntime en de standaardserver van een bestaand project als volgt wijzigen:

  1. Klik in de Projectverkenner van het perspectief J2EE met de rechtermuisknop op de bedrijfstoepassing of het moduleproject en kies Eigenschappen uit het voorgrondmenu. Het dialoogvenster Eigenschappen wordt geopend voor het project.
  2. Selecteer de pagina Doelruntimes in het venster Eigenschappen.
  3. Selecteer in de lijst van Runtimes het vakje naast elke runtime waarvoor u het project wilt ontwikkelen.

    Er worden alleen runtimes afgebeeld die compatibel zijn met de facetten van het project. Selecteer het vakje Alle runtimes afbeelden om ook runtimes af te beelden die niet compatibel zijn met de facetconfiguratie van het project. Deze runtimes worden grijs afgebeeld.

    Wanneer de runtime die u wilt gebruiken niet in de lijst staat, moet u deze toevoegen aan de runtimes in de workbench. Zie De geïnstalleerde serverruntime-omgevingen definiëren.

  4. Om de primaire runtime te selecteren, klikt u op de runtime en klikt u op de knop Primair maken.

    Wanneer u runtimes voor het project kiest, moet u ervoor zorgen dat één van deze runtimes de primaire runtime voor het project is. Wanneer u slechts één runtime selecteert, wordt dit automatisch de primaire runtime. De primaire runtime wordt vet afgebeeld.

  5. Klik op Voltooien.
  6. Klik op OK.

Verwante onderwerpen
J2EE-architectuur
Verwante informatie
De geïnstalleerde serverruntime-omgevingen definiëren