Een Java EE-toepassing (Jakarta EE) implementeren in JBoss EAP op Azure-app Service

Voltooid

De stappen in deze les laten zien hoe u uw Java EE-toepassing implementeert in JBoss EAP op Azure-app Service en hoe u verbinding maakt met de database. U voert deze stappen daadwerkelijk uit in de volgende les.

Een Java EE-toepassing (Jakarta EE) maken

In deze module gebruikt u een Java EE-voorbeeldtoepassing die vooraf is voorbereid en gebruikmaakt van de volgende technologieën:

  • Java EE 8 (Jakarta EE 8)
  • JAX-RS 2.1
  • JSON-B 1.0
  • CDI 2.0
  • JPA 2.2

Tip

De implementatieprocedure die hier is geïntroduceerd, is vergelijkbaar voor de meeste Java EE-webtoepassingen (Jakarta EE).

Het toepassingsproject configureren voor implementatie in Azure met behulp van Maven

Microsoft biedt de Maven-invoegtoepassing voor Azure-app Service om uw Java-webtoepassingen te implementeren in Azure-app Service. Met deze Maven-invoegtoepassing kunt u eenvoudig de volgende instellingen configureren voor uw App Service-exemplaar:

Artikelen Beschrijving
subscriptionID Azure-abonnement voor implementatie
resourceGroup Naam van de resourcegroep waarin de webcontainer is geïmplementeerd
appName Naam van toepassingsexemplaren voor de webcontainer
pricingTier Selectie van virtuele machines om uit te voeren
region Te implementeren regio (dezelfde locatie als de MySQL-installatielocatie)
runtime OS Het besturingssysteem dat moet worden uitgevoerd (Linux)
runtime javaVersion Versie van virtuele Java-machines voor de webcontainer (Java 8)
runtime webContainer Webcontainer (JBoss EAP 7)

In deze module implementeert u een toepassing in de JBoss EAP-omgeving. Selecteer Java 8 voor de Java-versie en Jbosseap 7.4 voor de runtime-webcontainer.

Het WAR-pakket bouwen

U kunt de ./mvnw package opdracht gebruiken om een WAR-pakket (Web Application Archive) te bouwen.

Notitie

U kunt het pakket desgewenst testen door te implementeren in een lokale JBoss EAP-omgeving.

De Java EE-app implementeren in JBoss EAP

Nadat u uw Maven-artefact hebt gemaakt, kunt u de deploy opdracht uitvoeren in de Maven-invoegtoepassing voor Azure-app Service om de toepassing te implementeren in JBoss EAP.

Met de deploy opdracht maakt u een Azure-resourcegroep en een exemplaar van JBoss EAP op basis van de voorgaande invoegtoepassingsinstellingen. Deze ene opdracht doet alles van het maken van exemplaren tot het implementeren van de Java-webtoepassing.

Zie de referentiedocumentatie van de invoegtoepassing voor de volledige lijst met configuraties. Alle Azure Maven-invoegtoepassingen delen een algemene set configuraties. Zie Algemene configuraties voor deze configuraties. Zie Azure Web App: Configuratiedetails voor configuraties die specifiek zijn voor App Service.

Een databaseverbinding configureren met behulp van een gegevensbron en JNDI

Uw toepassing vereist een binding met een gegevensbron. We configureren de toepassing voor het gebruik van de MySQL-database die we in de vorige eenheden hebben gemaakt.

Als u vanuit JBoss EAP verbinding wilt maken met de database, moet u een DataSource object configureren. Wanneer u een DataSource object configureert, kan een toepassing verbinding maken met de database.

U configureert DataSource om verbinding te maken met het Azure Database for MySQL-exemplaar dat u eerder hebt gemaakt met de volgende informatie:

Configuratie van de gegevensbron waarde
DataSource Name JPAWorldDataSourceDS
JNDI Name java:jboss/datasources/JPAWorldDataSource
Connection URL ${MYSQL_CONNECTION_URL}
JDBC Driver Name $PACKAGE_NAME.war_com.mysql.cj.jdbc.Driver_8_0
User Name ${MYSQL_USER}
Password ${MYSQL_PASSWORD}
Minimum Pool Size 5
Maximum Pool Size 20
JDBC Class Name com.mysql.cj.jdbc.Driver

We hebben een JNDI-naam (Java Naming and Directory Interface) gebruikt voor java:jboss/datasources/JPAWorldDataSource de gegevensbron. JNDI is handig in meerdere omgevingen om te wijzigen in een andere database zonder codewijzigingen.

Toegang tot de toepassing

Nadat u de MySQL-gegevensbronverbinding in JBoss EAP hebt geconfigureerd, hebt u toegang tot de Java EE-toepassing met behulp van een webbrowser of de curl opdracht.

In de volgende les implementeert u de voorbeeld-app met behulp van de procedure die hier wordt beschreven.