Java Spring Boot Projesi Nasıl Kurulur ve Çalıştırılır? Adım Adım Kılavuz

Java Spring Boot Nedir?

Java Spring Boot, Java ile geliştirme yapanların hayatını kolaylaştıran harika bir çerçevedir. Geliştiriciler, karmaşık yapılandırmalardan kurtulup hızla uygulamalarını kurabilirler. Bu framework, Spring’in sağladığı sağlam yapıyı alır ve geliştirme sürecini basitleştirir. Bugün, sizlere Spring Boot ile nasıl bir proje kuracağınızı ve çalıştıracağınızı anlatacağım. Hadi başlayalım!

1. Gerekli Araçları İndirme ve Kurma

İlk adım, doğru araçları kurmaktır. Spring Boot projesini çalıştırabilmek için öncelikle aşağıdaki araçlara ihtiyacınız olacak:

Java Development Kit (JDK):
Spring Boot’un çalışabilmesi için JDK 8 veya üstü gereklidir. JDK’yı Oracle’ın web sitesinden indirebilirsiniz.

IDE (Integrated Development Environment):
Java geliştiricilerinin genellikle IntelliJ IDEA, Eclipse ya da VS Code gibi IDE’leri kullanması yaygındır. Ben IntelliJ IDEA kullanmanızı öneririm çünkü Spring Boot ile uyumlu ve kullanıcı dostudur.

Maven veya Gradle:
Spring Boot projeleri genellikle Maven ya da Gradle ile yönetilir. Proje bağımlılıklarını yönetmek için Maven kullanacağız.

2. Spring Initializr Kullanarak Proje Oluşturma

Spring Boot projenizi başlatmanın en kolay yolu Spring Initializr’ı kullanmaktır. Bu araç, gerekli yapılandırmaları otomatik olarak oluşturur ve size sadece projeyi indirip başlatmak kalır.

Adımlar şu şekilde:

1. Spring Initializr’a Git: [https://start.spring.io/](https://start.spring.io/) adresine gidin.
2. Proje Yapılandırmasını Seçin: Proje türünü “Maven Project” olarak seçin. “Java” dilini ve “Spring Boot” versiyonunu seçin (en son sürümü tercih edin).
3. Group ve Artifact: Burada, projenizin “Group” kısmına genellikle şirketinizin veya projenizin adı (örn: com.example) ve “Artifact” kısmına da proje ismi (örn: my-spring-boot-app) yazılır.
4. Bağımlılıkları Seçin: Spring Web, Spring Boot DevTools, ve Spring Data JPA gibi temel bağımlılıkları seçebilirsiniz.
5. Generate: “Generate” butonuna tıklayın. Bu, seçtiğiniz yapılandırmaya uygun bir zip dosyası oluşturur.

Zip dosyasını indirdikten sonra, dosyayı çıkarın ve projeyi IntelliJ IDEA veya başka bir IDE ile açın.

3. Proje Yapısını İnceleyelim

Spring Boot projesi, genellikle aşağıdaki yapıyı takip eder:

my-spring-boot-app
|-- src
|   |-- main
|   |   |-- java
|   |   |   |-- com
|   |   |   |   |-- example
|   |   |   |   |   |-- MySpringBootApp.java
|   |   |-- resources
|   |   |   |-- application.properties
|-- pom.xml

- src/main/java: Java kodlarının yer aldığı klasördür. Burada, ana uygulama sınıfınız olan `MySpringBootApp.java` yer alır.
- src/main/resources: Uygulama yapılandırmalarının yer aldığı alandır. Burada, veritabanı bağlantı ayarları gibi yapılandırmalar bulunabilir.
- pom.xml: Maven yapılandırma dosyasıdır. Bağımlılıklarınızı burada belirtirsiniz.

4. İlk Controller’ınızı Yazın

Şimdi, basit bir REST API ekleyelim. Proje yapısında bulunan `com.example.MySpringBootApp` sınıfını aşağıdaki gibi güncelleyelim:

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class MySpringBootApp {
    public static void main(String[] args) {
        SpringApplication.run(MySpringBootApp.class, args);
    }
}

@RestController
class HelloController {
    @GetMapping("/hello")
    public String hello() {
        return "Merhaba, Spring Boot!";
    }
}

Burada dikkat etmeniz gereken birkaç şey var:
- @SpringBootApplication: Bu, Spring Boot uygulamanızın başlangıç sınıfıdır.
- @RestController: Bu, sınıfın bir REST API denetleyicisi olduğunu belirtir.
- @GetMapping("/hello"): Bu, HTTP GET isteği geldiğinde tetiklenecek bir metodun işaretleyicisidir.

5. Uygulamayı Çalıştırma

Projeyi başlatmak için, IntelliJ IDEA üzerinde `MySpringBootApp.java` sınıfını sağ tıklayıp “Run” diyebilirsiniz. Alternatif olarak, terminal üzerinden şu komutu kullanarak da başlatabilirsiniz:

mvn spring-boot:run

Eğer her şey doğru yapılmışsa, terminalde Spring Boot’un başlatıldığını göreceksiniz.

6. Uygulamayı Test Etme

Uygulamanız çalışmaya başladı! Şimdi bir tarayıcı açın ve şu adresi ziyaret edin:

http://localhost:8080/hello

Eğer her şey yolunda giderse, "Merhaba, Spring Boot!" mesajını görmelisiniz.

7. Sonraki Adımlar

Tebrikler! Spring Boot uygulamanızı başarıyla çalıştırdınız. Şimdi, uygulamanıza yeni özellikler ekleyebilir, veritabanı entegrasyonu gerçekleştirebilir ve çok daha fazlasını yapabilirsiniz. Spring Boot, esneklik ve ölçeklenebilirlik sağladığı için projelerinizin gelecekteki büyümesini kolaylaştıracaktır.

İleriye dönük olarak, Spring Security, Spring Data gibi modülleri keşfetmek faydalı olabilir.