Простейшее web-приложение на Java на сервере Tomcat

В статье рассказывается о том, как поднять на своем компьютере локальный java сервер и прописать простейшее web-приложение.

Содержание

Введение
Установка JDK
Установка Apache Tomcat
Создание и сборка сервлета вручную
Собираем web-приложение

Введение

Tomcat нужен для работы Java сервера с применением сервлетов. Если грубо говоря, то сервелеты это аналог тех же php скриптов. На сервер Tomcat от клиентов приходят запросы. В зависимости от них сервер запустит те или иные сервелеты, которые сформируют ответы в виде текстовых файлов. Чаще всего это html страницы.

Установка JDK

Устанавливаем JDK. Если уже до этого устанавливали, то повторно не устанавливаем.

Для работы современных версий Android Studio или IntelliJ IDEA не нужно производить дополнительные действия, чтобы программы могли найти JDK и запускать java приложения. Но мы будем на данный момент компилировать сервлеты вручную, так что для удобства мы пропишем путь к папке JDK в системную переменную Path в Windows. Ниже приведена инструкция для Windows 10.

У меня JDK находится в папке C:\Program Files\Java\jdk1.8.0_121\bin.

Кликните правой кнопкой по иконке Этот компьютер и перейдите в Свойства.

Внимание! Не вздумайте удалять всё содержимое переменной Path. Иначе у операционной системы возникнут очень большие проблемы. Вы должны дописать в эту переменную нужный путь.

Установка Apache Tomcat

Переходим на сайт https://tomcat.apache.org/

Скачиваем установочный файл.

Устанавливаем Tomcat.

Эти компоненты должны быть выбраны.

Для учебных целей можно параметры оставить по умолчанию.

Далее нужно указать путь к JRE (устанавливается при установке JDK). Обычно программа сама находит папку.

Далее всё стандартно.

После этого в трее должен появится значок запущенного сервиса.

Перейдите по адресу http://localhost:8080/. Если вы видите это, то всё хорошо.

Кстати, потом включать (например, при перезапуске компа) сервер можно запуском программы Monitor Topcat из Пуска.

Создание и сборка сервлета вручную

Напишем первое web-приложение вручную без каких-либо IDE.

Перейдем в папку, где установлен Tomcat. У меня это папка C:\Program Files\Apache Software Foundation\Tomcat 9.0. Запомните этот путь, так как он вам еще много раз пригодится.

Выше говорилось, что сервлеты чем-то похожи на php скрипты (упоминание для тех, кто знает php). Но есть одна существенная разница. В php можно написать файл скрипта, закинуть в соответствующую папку и web-приложение готово. С java такой трюк не пройдет. Нам соответствующие сервлеты нужно будет скомпилировать в байт-код и уже с сгенерированными .class файлами работать.

Итак, где-нибудь создайте произвольную папку. Советовал бы не использовать русские буквы, пробелы. И в пути к папке тоже желательно обойтись без русских букв. Я на рабочем столе создал папку testapp.

В ней создайте текстовой файл TestServlet.java с таким содержимым.

package com.example;

import java.io.IOException;
import java.io.PrintWriter;
 
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
 
public class TestServlet extends HttpServlet {
 
    public void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        resp.setContentType("text/html;charset=utf-8");
 
        PrintWriter pw = resp.getWriter();
        pw.println("<H1>Hello, world!</H1>");
 
    }
}

package com.example;

import java.io.IOException;

import java.io.PrintWriter;

import javax.servlet.ServletException;

import javax.servlet.http.HttpServlet;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

public class TestServlet extends HttpServlet {

public void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

resp.setContentType("text/html;charset=utf-8");

PrintWriter pw = resp.getWriter();

pw.println("<H1>Hello, world!</H1>");

}

Это и есть код нашего сервлета. Мы создаем наследника класса HttpServlet. В нем реализуем один метод doGet(), в котором вначале сообщаем что сервлет будет выдавать html документ. Потом вытаскиваем из resp ссылку на экземпляр PrintWriter. И то, что мы будем писать в нем, будет отдано сервером на запрос от клиента.

Первое, на что нужно обратить внимание. Кодировка файла TestServlet.java должна быть UTF-8. У многих проблема с компиляцией данного файла возникает именно из-за проблем с кодировкой. Вот так кодировка выглядит в Notepad++.

Не используйте стандартный блокнот Windows!

Второе. Класс наследуется от HttpServlet. И для компиляции программы нам будет нужен jar файл с нужными классами внутри.

В папке Tomcat есть папка lib. В ней есть файл servlet-api.jar.

Копируем его в нашу папку с java файлом.

Третье. Мы разместили наш класс в пакете package com.example (у вас может быть другой). А это означает, что в папке, где лежит наш java файл нужно создать папку com, в ней папку example, и уже туда переместить файл TestServlet.java.

У меня для наших двух файлов получились такие пути:

C:\Users\Harrix\Desktop\testapp\com\example\TestServlet.java

C:\Users\Harrix\Desktop\testapp\servlet-api.jar

Теперь можем приступить к сборке. Открываем командную строку cmd.

Перейдем в папку, что мы создали для размещения наших файлов. Не забывайте после каждой команды в командной строке для её запуска нажимать Enter.

cd C:\Users\Harrix\Desktop\testapp

1	cd C:\Users\Harrix\Desktop\testapp

И запустим сборку. Если у вас в системной переменной Path не прописан путь к JDK (описано в начале статьи), то команда не сработает.

javac -encoding UTF-8 -cp .;servlet-api.jar com\example\*.java

1	javac -encoding UTF-8 -cp .;servlet-api.jar com\example\*.java

Если у вас не выведется список ошибок, а в папке с TestServlet.java файлом появится файл TestServlet.class, то всё получилось. Нам нужен будет этот файл и больше папка созданная для сборки больше не пригодится.

Собираем web-приложение

Перейдем опять в папку Tomcat. Там есть папка webapps с web-приложениями нашего сервера. В папке ROOT, как не сложно догадаться, располагается корневое приложение, которое вы видели при переходе на localhost:8080.

В папке webapps создадим папку с названием web-приложения. Допустим, testingapp.

В этой папке создайте папку WEB-INF, а в ней папку classes.

C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\testingapp\WEB-INF\classes

В папке classes у нас должны находиться файлы бай-кода наших классов. То есть тут должен появится файл TestServlet.class. Но мы помним, что класс был определен в пакете com.example.

Поэтому в папке classes создаем папку com, а ней папку example. И уже в эту папку кидаем файл TestServlet.class.

C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps\testingapp\WEB-INF\classes\com\example\TestServlet.class

Перейдем в папку WEB-INF. В ней создадим текстовой файл web.xml с таким содержанием.

<!DOCTYPE web-app PUBLIC '-//Sun Microsystems, Inc.//DTD
  Web Application 2.3//EN' 'http://java.sun.com/dtd/web-app_2_3.dtd'>
 
<web-app>
 
  <servlet>
    <servlet-name>test</servlet-name>
    <servlet-class>com.example.TestServlet</servlet-class>
  </servlet>
 
  <servlet-mapping>
    <servlet-name>test</servlet-name>
    <url-pattern>/test</url-pattern>
  </servlet-mapping>
 
</web-app>

<!DOCTYPE web-app PUBLIC '-//Sun Microsystems, Inc.//DTD

Web Application 2.3//EN' 'http://java.sun.com/dtd/web-app_2_3.dtd'>

<web-app>

<servlet-name>test</servlet-name>

<servlet-class>com.example.TestServlet</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>test</servlet-name>

<url-pattern>/test</url-pattern>

</servlet-mapping>

</web-app>

В тэге servlet-class мы указываем запускаемый класс сервлета, а в тэге url-pattern указываем url имя запускаемого сервлета.

Всё сборка прошла успешно. Теперь можем проверить работу web-приложения. Для этого переходим по адресу:

http://localhost:8080/testingapp/test.

Обратите внимание, что в адресе testingapp — это имя папки нашего приложения из папки webapps, а test — имя сервелета из тэга url-pattern из файла web.xml.

Если вы увидели в браузере это, то всё хорошо.

Если же увидели это, то что-то сделали не так. Проверьте свои шаги.