Spring Boot
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.
Pikaopas
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".
Kloonaa arkistosi
git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>
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>
Rakenna ja suorita
./mvnw spring-boot:run
Palvelin käynnistyy oletuksena osoitteessa http://localhost:8080.
Lähetä muutoksesi
git add .
git commit -m "Initial setup"
git push origin main
Paikallinen kehitys Dockerilla
Jos sinulla ei ole Javaa asennettuna paikallisesti, voit käyttää Dockeria Spring Boot -sovelluksen rakentamiseen ja suorittamiseen.
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
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.