Spring Boot

Täydellinen käyttöönotto-opas: Spring Boot NStrim-alustalla

Yleiskatsaus

Spring Boot on Java-kehys, joka helpottaa itsenäisten, tuotantovalmiiden sovellusten luomista. Se tarjoaa automaattisen konfiguroinnin, sulautetut palvelimet ja mielipiteellisen lähestymistavan REST-rajapintojen ja web-sovellusten rakentamiseen.

Ennen kuin aloitat
Varmista, että kojelautasi on auki - tarvitset siellä näkyvät Git-tunnukset. Tämä malli sisältää Spring Web, Spring Data JPA, MySQL-ajurin ja Thymeleaf-mallinemoottoren.

Pikaopas

1

Luo arkisto mallista

Siirry kojelaudallasi Tools & Deployment -välilehteen. Napsauta "New Repository" -painiketta, valitse Spring Boot -malli pudotusvalikosta, anna arkiston nimi ja alidomain ja napsauta "Create Repository".

2

Kloonaa arkistosi

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>
3

Konfiguroi tietokanta

Päivitä src/main/resources/application.properties kojelaudan tunnuksillasi:

spring.datasource.url=jdbc:mysql://db.<session-domain>:3306/<username>
spring.datasource.username=<username>
spring.datasource.password=<password>
4

Rakenna ja suorita

./mvnw spring-boot:run

Palvelin käynnistyy oletuksena osoitteessa http://localhost:8080.

5

Lähetä muutoksesi

git add .
git commit -m "Initial setup"
git push origin main
Jokainen push Gitiin julkaisee sovelluksesi automaattisesti. Tarkista moduulin työ-URL kojelaudaltasi nähdäksesi live-sivustosi.

Paikallinen kehitys Dockerilla

Jos sinulla ei ole Javaa asennettuna paikallisesti, voit käyttää Dockeria Spring Boot -sovelluksen rakentamiseen ja suorittamiseen.

Mikä on Docker?
Docker luo eristettyjä kontteja, joissa on kaikki tarvitsemasi ohjelmistot (Java, Maven) asentamatta niitä tietokoneellesi.

Komentojen suorittaminen Dockerilla

# Rakenna projekti
docker run --rm -v $(pwd):/app -w /app maven:3-eclipse-temurin-21 ./mvnw clean package -DskipTests

# Suorita sovellus
docker run --rm -v $(pwd):/app -w /app -p 8080:8080 eclipse-temurin:21 java -jar target/*.jar

Tietokantakonfiguraatio

NStrim-alusta tarjoaa sinulle MySQL/MariaDB-tietokannan. Konfiguroi application.properties-tiedosto oikeilla tunnuksilla.

Täydellinen konfiguraatio

spring.datasource.url=jdbc:mysql://db.<session-domain>:3306/<username>
spring.datasource.username=<username>
spring.datasource.password=<password>
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
Tärkeää
Tietokannan nimi ja käyttäjänimi ovat yleensä samat kuin kojelaudan käyttäjänimesi (esim. student01). Tarkista tarkat arvot kojelaudan tunnusosiosta.

Projektin rakenne

├── src/
│   └── main/
│       ├── java/com/example/
│       │   ├── Application.java          # Spring Boot -aloituspiste
│       │   ├── controllers/              # REST-ohjaimet
│       │   ├── models/                   # JPA-entiteetit
│       │   ├── repositories/             # Spring Data -repositoriot
│       │   └── services/                 # Liiketoimintalogiikka
│       └── resources/
│           ├── application.properties    # Konfiguraatio
│           ├── templates/                # Thymeleaf-mallit
│           └── static/                   # CSS, JS, kuvat
├── pom.xml                               # Maven-riippuvuudet
└── Dockerfile                            # Docker-konfiguraatio
        

Yleiset tehtävät

REST-ohjaimen luominen

@RestController
@RequestMapping("/api/users")
public class UserController {

    @GetMapping
    public List<User> getAll() {
        return userRepository.findAll();
    }

    @PostMapping
    public User create(@RequestBody User user) {
        return userRepository.save(user);
    }
}

JPA-entiteetin luominen

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
    private String email;

    // getters and setters
}

Repositorion luominen

public interface UserRepository extends JpaRepository<User, Long> {
    Optional<User> findByEmail(String email);
}

Hyödylliset komennot

./mvnw spring-boot:run Käynnistä kehityspalvelin
./mvnw clean package Rakenna projekti
./mvnw test Suorita testit
./mvnw dependency:tree Näytä riippuvuuspuu

Vianmääritys

Communications link failure / Connection refused

Syy: Tietokantapalvelin on virheellinen tai ei saavutettavissa.

Ratkaisu: Tarkista, että spring.datasource.url vastaa kojelaudan tietokantapalvelinta.

Access denied for user

Syy: Väärä käyttäjänimi tai salasana.

Ratkaisu: Tarkista, että spring.datasource.username ja spring.datasource.password vastaavat täsmälleen kojelaudan tunnuksia.

Port 8080 already in use

Ratkaisu: Lisää server.port=8081 tiedostoon application.properties tai pysäytä toinen prosessi.

Whitelabel Error Page (404)

Syy: Pyydettyyn URL-osoitteeseen ei ole yhdistetty ohjainta.

Ratkaisu: Varmista, että ohjaimessasi on oikea @RequestMapping-annotaatio ja sovellus skannaa oikeat paketit.

Käyttöönotto

Koodimuutos git push mvn package Live!
Lisätietoja virallisesta Spring Boot -dokumentaatiosta.