Tämä Git-repositorio sisältää valmiin Eclipse-projektin, jota voit käyttää Java-kielisen web-sovelluksen pohjana. Projekti on tarkoitettu pohjaksi verkkosovellusten koodaamiseen Haaga-Helian Ohjelmointi 2 -opintojaksolla.
Projektissa hyödynnetään Javan Servlet- sekä JSP-teknologioita yhdessä Apachen Tomcat -sovelluspalvelimen kanssa. Projekti sisältää valmiit asetustiedostot sen tuomiseksi Eclipse-sovelluskehittimeen, mutta voit käyttää sitä soveltaen myös muilla kehitystyökaluilla, kuten VS Code tai IntelliJ IDEA.
Kloonaa tämä Git-repositorio itsellesi Eclipseen valitsemalla File-valikosta:
File → Import → Git → Projects From Git → Clone URI
Sytä Eclipsen Source Git Repository -dialogin URI-kenttään tämän Git-projektin osoite: https://github.com/ohjelmointi2/embedded-tomcat-template.git. Tarvittaessa löydät tarkempia ohjeita projektin kloonaamiseksi Googlella.
Varmista projektipohjan toimivuus omalla koneellasi suorittamalla siihen kuuluvat testit. Voit suorittaa testit Eclipsessä klikkaamalla projektia Package-näkymässä hiiren kakkospainikkeella ja valitsemalla "Run As"-kohdasta vaihtoehdon "JUnit Test".
Mikäli sinulla on GitHub-tunnukset, voit kopioida projektin myös omalle käyttäjätunnuksellesi "Use this template"-painikkeella. Tekemällä oman kopion ja kloonaamalla sen Eclipseen voit lisätä tekemäsi muutokset myös takaisin GitHubiin.
Esimerkkiprojekti noudattaa seuraavaa hakemistorakennetta:
embedded-tomcat
│ pom.xml
│ README.md
│
├───src
│ ├───main
│ │ ├───java
│ │ │ ├───launch
│ │ │ │ Main.java
│ │ │ │
│ │ │ └───servlet
│ │ │ IndexServlet.java
│ │ │
│ │ ├───resources
│ │ └───webapp
│ │ ├───styles
│ │ │ demo.css
│ │ │
│ │ └───WEB-INF
│ │ index.jsp
│ │
│ └───test
│ ├───java
│ │ ├───servlet
│ │ │ IndexServletTest.java
│ │ │
│ │ └───testserver
│ │ TestServer.java
│ │
│ └───resources
| Sijainti | Tarkoitus |
|---|---|
| README.md | Tämä tiedosto |
| pom.xml | "Project Object Model"-tiedosto mm. riippuvuuksien määrittelemiseksi |
| src/main/java | Java-pakettien juurihakemisto |
| src/main/resources | Hakemisto esimerkiksi .properties-tiedostoille |
| src/main/java/launch/Main.java | Luokka Tomcat-palvelimen käynnistämiseksi |
| src/main/java/servlet/IndexServlet.java | Esimerkki HTTP-liikennettä tukevasta Java-luokasta |
| src/main/webapp | Hakemisto staattisille tiedostoille (css, kuvat, JS) |
| src/main/webapp/WEB-INF | Erityinen hakemisto, jonne on estetty suora pääsy selaimilta ¹ |
| src/main/webapp/WEB-INF/index.jsp | IndexServlet-luokan käyttämä sivupohja |
| src/test/java | JUnit-testiluokkien pakettien juurihakemisto |
| src/test/java/servlet/IndexServletTest.java | IndexServlet-luokan JUnit-testit |
| src/test/java/testserver/TestServer.java | Apuluokka palvelimen testaamiseksi |
| src/test/resources | Hakemisto esimerkiksi testien .properties-tiedostoille |
¹ "No file contained in the WEB-INF directory may be served directly to a client by the container. However, the contents of the WEB-INF directory are visible to servlet code..." Java Servlet Specification Version 2.4
Tämä video esittelee perusteet HTTP-palvelimen toiminnassa dynaamisten sivujen (servlet) käsittelyssä. Servlettien rakenne sekä yhteys servlettien ja Tomcatin välillä esitetään tällä videolla varsin selkeällä tavalla.
Servlet-pohjaiset sovellukset tarvitsevat aina jonkin suoritusympäristön, joka tällä esimerkkiprojektilla on nimeltään Tomcat. Tomcat ja muut sovelluksen riippuvuudet on suoraviivaista määrittää projektin pom.xml-tiedostoon, jolloin Eclipsen Maven-plugin asentaa riippuvuudet automaattisesti.
Kun riippuvuudet on asennettu, on Tomcat-palvelinohjelmisto käytettävissä projektissasi ja voit ryhtyä kehittämään verkkosovelluksia Javalla.
Tämän projektin pom.xml on rakennettu noudattaen Heroku-pilvialustan esimerkkiä "Create a Java Web Application Using Embedded Tomcat".
Tomcat-palvelin voidaan käynnistää lukuisilla eri tavoilla, esimerkiksi erillisenä ohjelmana tai Eclipsen hallinnoimana palvelimena. Voimme käyttää sitä myös ohjelmallisesti, eli kirjoittamalla tavallista Java-koodia.
Tämä yksinkertaistettu esimerkki näyttää, miten uusi Tomcat-olio luodaan, miten sen käyttämä portti määritellään ja miten palvelin käynnistetään odottamaan HTTP-pyyntöjä:
import org.apache.catalina.startup.Tomcat;
public class Main {
public static void main(String[] args) throws Exception {
// Luodaan uusi palvelinolio:
Tomcat tomcat = new Tomcat();
// Asetetaan kuunneltava portti (http://localhost:8080)
tomcat.setPort(8080);
// ...muiden asetusten määrittely...
// Palvelimen käynnistäminen:
tomcat.start();
tomcat.getServer().await();
}
}Tässä projektissa Tomcatin käynnistämiseksi ja sen asetusten asettamiseksi tarvittavat komennot on kirjoitettu valmiiksi tiedostoon src/main/java/launch/Main.java. Voit käynnistää Tomcat-palvelimen suorittamalla tämän tiedoston aivan kuten olet tähänkin asti suorittanut Java-ohjelmiasi Eclipsessä.
Ohjelman suoritus tulostaa lokitietoja Eclipsen konsoliin, ja onnistunut käynnistys näyttää pääpiirteittäin tältä:
configuring app with basedir: C:\workspace\embedded-tomcat\.\src\main\webapp
tammik. 28, 2020 10:13:05 AP. org.apache.coyote.AbstractProtocol init
INFO: Initializing ProtocolHandler ["http-nio-8080"]
tammik. 28, 2020 10:13:05 AP. org.apache.tomcat.util.net.NioSelectorPool getSharedSelector
INFO: Using a shared selector for servlet write/read
tammik. 28, 2020 10:13:05 AP. org.apache.catalina.core.StandardService startInternal
INFO: Starting service [Tomcat]
tammik. 28, 2020 10:13:05 AP. org.apache.catalina.core.StandardEngine startInternal
INFO: Starting Servlet Engine: Apache Tomcat/8.5.50
tammik. 28, 2020 10:13:06 AP. org.apache.catalina.startup.ContextConfig getDefaultWebXmlFragment
INFO: No global web.xml found
tammik. 28, 2020 10:13:06 AP. org.apache.jasper.servlet.TldScanner scanJars
INFO: At least one JAR was scanned for TLDs yet contained no TLDs. Enable debug logging for this logger for a complete list of JARs that were scanned but no TLDs were found in them. Skipping unneeded JARs during scanning can improve startup time and JSP compilation time.
tammik. 28, 2020 10:13:06 AP. org.apache.catalina.util.SessionIdGeneratorBase createSecureRandom
WARNING: Creation of SecureRandom instance for session ID generation using [SHA1PRNG] took [308] milliseconds.
tammik. 28, 2020 10:13:06 AP. org.apache.coyote.AbstractProtocol start
INFO: Starting ProtocolHandler ["http-nio-8080"]
Voit nyt navigoida selaimellasi osoitteeseen http://localhost:8080! Mikäli kaikki toimii, näet sivun joka näyttää tältä:
Esimerkkisivu selostaa muutamia vaiheita, jotka palvelinohjelmisto kävi läpi toteuttakseen vastauksen selaimesi pyyntöön. Käymme nämä vaiheet läpi seuraavissa luvuissa.
Mikäli palvelin ei käynnisty oikein ja tuloste sisältää seuraavanlaisia virheilmoituksia, portti 8080 on jo varattuna koneellasi:
INFO: Initializing ProtocolHandler ["http-nio-8080"]
tammik. 28, 2021 10:17:42 AP. org.apache.catalina.core.StandardService initInternal
SEVERE: Failed to initialize connector [Connector[HTTP/1.1-8080]]
org.apache.catalina.LifecycleException: Protocol handler initialization failed
at org.apache.catalina.connector.Connector.initInternal(Connector.java:995)
at org.apache.catalina.util.LifecycleBase.init(LifecycleBase.java:136)
...
at launch.Main.main(Main.java:44)
Caused by: java.net.BindException: Address already in use: bind
at java.base/sun.nio.ch.Net.bind0(Native Method)
at java.base/sun.nio.ch.Net.bind(Net.java:461)
Tämä johtuu usein siitä, että olet käynnistänyt palvelimesi useaan kertaan, ja jokin aikaisemmista suorituksista on edelleen käynnissä taustalla.
Eclipsen "console"-välilehdeltä löytyy painikkeet "terminate" sekä "remove...", joiden avulla saat suljettua vanhat prosessit. Klikkaa vuorotellen "terminate" ja "remove" -painikkeita, kunnes konsoli on kokonaan tyhjä. Voit joutua sulkemaan isonkin kasan prosesseja, jos niitä on jäänyt roikkumaan.
Käynnistä lopuksi Main.java-tiedosto uudelleen.
Java EE -spesifikaatiossa on määriteltynä tapa, jolla Java-luokat voivat kommunikoida verkkoyhteyksistä huolehtivien sovelluspalvelimien kanssa. Tämän määrittelyn toteuttavista luokista käytetään termiä "servlet".
Teknisesti servletit toteutetaan aivan tavallisina Java-luokkina, jotka:
- perivät
javax.servlet.http.HttpServlet-luokan:extends HttpServlet - annotoidaan
javax.servlet.annotation.WebServlet-annotaatiolla:@WebServlet("/hello")
Kun perimme (extend) HttpServlet-luokan, Tomcat tunnistaa luokan servletiksi. @WebServlet-annotaatio puolestaan kertoo Tomcatille, mikä servletin polku on palvelimella.
HttpServlet-luokka sisältää ylikirjoitettavat metodit mm. GET- ja POST-tyyppisille HTTP-pyynnöille:
doGetdoPostdoHeaddoPutdoDelete- ...
Alla oleva esimerkkiluokka on annotoitu @WebServlet("/hello")-annotaatiolla, eli tätä servlettiä käytetään /hello-polkuun tuleviin pyyntöihiin vastaamisessa. Koska luokka ylikirjoittaa (@Override) HttpServlet-luokan doGet-metodin, käytetään tätä servlettiä ainoastaan HTTP GET -tyyppisten pyyntöjen käsittelyyn. Koska metodi ei sisällä lainkaan vastaamiseen tarvittavaa logiikkaa, selaimelle palautetaan vain tyhjä sivu.
import java.io.IOException;
import java.time.LocalTime;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// TODO: implement request handling here
}
}HttpServlet-luokan HTTP-pyyntöjä käsittelevät metodit saavat aina parametreinaan kaksi oliota:
javax.servlet.http.HttpServletRequest sisältää tiedot saadusta http-pyynnöstä:
- Evästeet
- Otsikot (HTTP headers)
- HTTP-parametrit
- ...
javax.servlet.http.HttpServletResponse on olio, jonka kautta voidaan lähettää vastaus saatuun pyyntöön. Vastaus voidaan esim. kirjoittaa println()-metodilla pyytämällä HttpServletResponse-oliolta writer-olio. Writer saadaan getWriter()-metodilla, jonka println-metodia voidaan kutsua seuraavasti:
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
// tulostaa tekstin HTTP-vastaukseen (ei konsoliin)
resp.getWriter().println("Hello world");
}HTML-muotoisten vastausten muodostaminen edellyttäisi, että sekoitamme Java-koodia ja HTML:ää, mistä tulisi nopeasti vaikeaselkoista ja huonosti ylläpidettävää:
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
String timeString = LocalTime.now().toString();
// FIXME: vaikeasti ylläpidettävää koodia!
resp.getWriter().println("<html>\n"
+ " <head>\n"
+ " <title>Hello</title>\n"
+ " </head>\n"
+ " <body>\n"
+ " <h1>Hello world!</h1>\n"
+ " <p class=\"time\">Time is now " + timeString + "!</p>\n"
+ " </body>\n"
+ "</html>");
}Vaikka siis periaatteessa voisimme generoida HTML-muotoiluja tulostamalla, ei se olisi tehokasta eikä kovin helposti ylläpidettävää. HTML-rakenteet kannattaakin muodostaa Java-luokkien ulkopuolisten sivupohjien avulla, joihin tutustumme seuraavaksi.
Servlet-teknologialla toteutettujen palveluiden käyttöliittymät toteutetaan usein JSP-sivuina. Logiikka, kuten pyyntöön liittyvän datan lukeminen ja tietokantahaut, puolestaan toteutetaan servleteissä. Kun kaikki pyynnön käsittelyyn liittyvä logiikka on saatu suoritettua, voidaan pyyntö välittää servletiltä JSP-sivulle.
Alla olevassa esimerkkiluokassa servletissä ensin muodostetaan nykyistä kellonaikaa vastaava merkkijono, joka asetetaan pyyntöön uudeksi attribuutiksi request-olion setAttribute-metodilla. Tämä metodi toimii hyvin samalla periaatteella kuin Map-tietorakenne, eli attribuutti annetaan avain-arvo-parina, jossa on avain "timeNow" ja sitä vastaava arvo. Arvo on tässä tapauksessa merkkijono, mutta se voisi olla periaatteessa mitä tahansa muutakin. Usein JSP-sivuille välitetään esimerkiksi listoja tietokannasta haetuista oliosta.
Viimeisellä rivillä pyyntö välitetään eteenpäin /WEB-INF/index.jsp-sivulle. Pyynnön välittämiseksi tarvitaan RequestDispatcher-olio ja kyseinen rivi voi vaikuttaa vaikeaselkoiselta. Käytännössä voit välittää pyynnöt aina tällä tavalla, vaihda vain käytetyn JSP-sivun sijainti servlet-kohtaisesti:
package servlet;
import java.io.IOException;
import java.time.LocalTime;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("")
public class IndexServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
String timeString = LocalTime.now().toString();
// pass the time string to the JSP page as an attribute
req.setAttribute("timeNow", timeString);
// forward the request to the index.jsp page
req.getRequestDispatcher("/WEB-INF/index.jsp").forward(req, resp);
}
}Huomaa, että JSP-sivun polku annetaan suhteessa webapp-hakemistoon, jossa säilytetään myös palvelun staattisia tiedostoja, kuten kuvia, tyylitiedostoja ja JavaScript-tiedostoja. WEB-INF-alihakemistossa sijaitsevat JSP-sivut ovat turvassa suorilta selainten pyynnöiltä, eli niihin pääsee käsiksi ainoastaan servlettien kautta.
Edellisen kappaleen esimerkissä pyyntö välitetään /WEB-INF/index.jsp-tiedostolle. Tiedoston sisältö on typistettynä seuraava:
<%@ page language="java" contentType="text/html; utf-8" pageEncoding="utf-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Web application test page</title>
<link rel="stylesheet" href="/styles/demo.css">
</head>
<body>
<h1>🎉 Congratulations! 🎉</h1>
<!-- ✄ content removed for brevity ✄ -->
<p>
The added information was set in an attribute
<code>timeNow</code> and its value is:
</p>
<p class="time-now">${ timeNow }</p>
<!-- ✄ content removed for brevity ✄ -->
</body>
</html>Sivu on suurilta osin tavallinen HTML-tiedosto. Suurimmat erot ovat ensimmäisellä rivillä oleva JSP-syntaksin mukainen page-direktiivi sekä sivun alaosassa esiintyvä <p>-kappale:
<p class="time-now">${ timeNow }</p>Direktiivien avulla voidaan vaikuttaa siihen, miten Tomcat-palvelin muodostaa vastauksen tätä tiedostoa hyödyntäen. ${ timeNow }-kohta puolestaan on JSP-sivuilla käytettävän Expression Language -kielen lauseke. Lausekkeiden avulla sivulla voidaan käyttää Javan tietorakenteita ja tässä tapauksessa, kun lauseke on osana sivun HTML-sisältöä, tulee lausekkeen arvo sivulle tekstinä. Tässä lausekkeessa arvona on ainostaan timeNow, joka on sama merkkijono, kuin jonka annoimme edellä servletissä attribuutin nimenä. Tämän nimen kautta löytyy se merkkijono, joka annettiin setAttribute-metodin toisena parametrina, eli nykyinen kellonaika merkkijonona.
JSP-sivua renderöitäessä lausekkeen tilalle ilmestyy siis kellonaika, esim:
<p class="time-now">10:55:10.299545500</p>Edellä esitellyssä sivupohjassa hyödynnetään ulkoista CSS-tiedostoa:
<link rel="stylesheet" href="/styles/demo.css">Tämä tiedosto sijaitsee projektin hakemistossa src/main/webapp, jonka alla olevat tiedostot tarjotaan selaimelle staattisina tiedostoina (poikkeuksena WEB-INF).
Selaimen pyytäessä osoitetta http://localhost:8080/styles/demo.css Tomcat tarjoaa vastauksesi CSS-tiedostomme. Vastaavalla tavalla voisimme asettaa saataville myös kuvat ja JavaScript-tiedostot sijoittamalla ne src/main/webapp hakemiston alle.
Seuraavaksi sinun kannattaa luoda projektiin uusia servlettejä ja JSP-sivuja ja tutustua niiden toimintaan.
Tutustu myös JSP-sivujen sisällä käytettävään JSTL-kirjastoon tutoriaalien avulla. JSTL (JSP Standard Tag Library) mahdollistaa mm. tekstin turvallisen tulostamisen c:out-tagin avulla ja kokoelmien läpikäynnin c:forEach-tagin avulla.
Lomakkeiden käsittelemiseksi sinun kannattaa tutustua doPost-metodiin ja pyynnön mukana tulleiden arvojen käyttämiseksi tarkoitettuun getParameter-metodiin.
Java varoittaa servlet-luokkien yhteydessä tyypillisesti seuraavaa:
"The serializable class XYZ does not declare a static final serialVersionUID field of type long"
Voit jättää tämän varoituksen huomioimatta. serialVersionUID nimistä muuttujaa käytetään luokasta luotujen olioiden versiointiin, lue tarvittaessa lisää täältä.
Tämän oppimateriaalin on kehittänyt Teemu Havulinna ja se on lisensoitu Creative Commons BY-NC-SA -lisenssillä.