Створення RESTful API серверу

Лабораторная работа №1 Створення RESTful API серверу

Базовая конфигурация:

Шаги:

1. Проверить установлена ли java на компьютере. Для этого зайти в Командную строку (Windows) или Терминал (Linux) и написать:

 > java -version

В результате должны получить нечто подобное:

java version "1.8.0_201"

Java(TM) SE Runtime Environment (build 1.8.0_201-b09)

Java HotSpot(TM) 64-Bit Server VM (build 25.201-b09, mixed mode)

1. Если Java не установлена необходимо сделать это (Рекомендуется установить последний билд версии 8 с сайта Oracle).

1. Если же Java установлена, но не удалось получить информацию о ней в консоли, необходимо установить переменную JAVA_HOME в environment variables вашей операционной системы.
2. Установить любую IDE для работы с Enterprise Java (Eclipse, IntelliJ IDEA (Ultimate), Netbeans, Spring Tool Suite). Далее примеры будут приводиться для IntelliJ IDEA.

Создание проекта:

        Способ 1:

1. Зайти на сайт Spring Initializr (https://start.spring.io/).[pic 1]
2. Перейти на полную версию сайта, нажав Switch to the full version.
3. В поле Group ввести свои имя и фамилию через точку (например ivan.ivanov)
4. В поля Artifact, Name ввести название проекта (например network-java)
5. Demo заполнить на свое усмотрение
6. Package Name заполнить в формате Group.Name (только без дефисов, нижних подчеркиваний и т.д., придерживаясь правил именования java)
7. В поле Search for dependencies ввести название модулей для работы DevTools и Web (или выбрать их с помощью чек-боксов ниже на странице)
8. Нажать сгенерировать проект, скачать файл и распаковать в директорию на диске.

Импорт и настройка проекта:

1. Зайти в IDE
2. Нажать Import Project[pic 2]
3. Выбрать распакованную папку
4. а. Выбрать создать проект с существующих исходников

б. Выбрать Import from external model (Maven) потом выбрать Import maven projects automatically)

 [pic 3]

1. Нажимать Далее до создания проекта
2. В итоге должны получить проект со следующей структурой:

[pic 4]

Главным классом является класс NetworkJavaApplication с аннотацей @SpringBootApplication, который содержит в себе метод Main и всю необходимую конфигурацию для старта сервера.

[pic 5]

1. Теперь можно запустить приложение с помощью этой панели[pic 6]

Или  с помощью кликом правой кнопкой мыши по классу и пункта Run.

1. После старта получаем в консоли подробное логирование всего, что происходит при старте, а также при дальнейшей работе сервера. Последняя строчка сигнализирует про успешный старт и время, которое понадобилось для этого старта.[pic 7]

Создание проекта Способ 2 (для тех, кто знаком с Maven):

1. Создать пустой Maven проект.
2. Привести pom.xml к подобному виду:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <parent>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-parent</artifactId>
     <version>2.1.3.RELEASE</version>
     <relativePath/> <!-- lookup parent from repository -->
  </parent>
  <groupId>stanislav.danylenko</groupId>
  <artifactId>network-java</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <name>network-java</name>
  <description>Demo project for Spring Boot</description>

  <properties>
     <java.version>1.8</java.version>
  </properties>

  <dependencies>
     <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
     </dependency>

     <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <scope>runtime</scope>
     </dependency>
     <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
     </dependency>
  </dependencies>

  <build>
     <plugins>
        <plugin>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
     </plugins>
  </build>

</project>