Backend Ortam Kurulumu

Bu bölümde, Spring Boot tabanlı backend uygulaması geliştirmek için gerekli ortamın kurulumunu adım adım anlatacağız. Backend geliştirme ortamı için Java Development Kit (JDK), Spring Boot ve MySQL veritabanının kurulumu gerekmektedir.

Java Development Kit (JDK) Kurulumu

Spring Boot uygulamaları Java programlama dili ile geliştirildiği için, öncelikle JDK’nın kurulması gerekmektedir. Bu proje için Java 11 veya daha yeni bir sürüm önerilmektedir.

Windows için JDK Kurulumu

  1. Oracle JDK indirme sayfası veya OpenJDK indirme sayfası adresine gidin.
  2. Java 11 (veya daha yeni) sürümünü seçin ve Windows için olan kurulum dosyasını indirin.
  3. İndirilen kurulum dosyasını çalıştırın ve ekrandaki talimatları izleyin.
  4. Kurulum tamamlandıktan sonra, Java’nın doğru şekilde kurulduğunu kontrol etmek için komut istemini (Command Prompt) açın ve aşağıdaki komutu çalıştırın:
java -version
  1. Sistem değişkenlerini ayarlamak için:
    • Bilgisayarım (veya Bu Bilgisayar) simgesine sağ tıklayın ve “Özellikler”i seçin.
    • “Gelişmiş sistem ayarları”na tıklayın.
    • “Ortam Değişkenleri” düğmesine tıklayın.
    • “Sistem değişkenleri” bölümünde, “Yeni” düğmesine tıklayın.
    • Değişken adı olarak “JAVA_HOME” girin.
    • Değişken değeri olarak JDK’nın kurulu olduğu dizini girin (örneğin, C:\Program Files\Java\jdk-11.0.12).
    • “Tamam” düğmesine tıklayın.
    • “Path” değişkenini seçin ve “Düzenle” düğmesine tıklayın.
    • “Yeni” düğmesine tıklayın ve %JAVA_HOME%\bin ekleyin.
    • “Tamam” düğmesine tıklayarak tüm pencereleri kapatın.

macOS için JDK Kurulumu

  1. Oracle JDK indirme sayfası veya OpenJDK indirme sayfası adresine gidin.
  2. Java 11 (veya daha yeni) sürümünü seçin ve macOS için olan kurulum dosyasını indirin.
  3. İndirilen .dmg dosyasını açın ve kurulum paketini çalıştırın.
  4. Ekrandaki talimatları izleyerek kurulumu tamamlayın.
  5. Kurulum tamamlandıktan sonra, Terminal uygulamasını açın ve aşağıdaki komutu çalıştırarak Java’nın doğru şekilde kurulduğunu kontrol edin:
java -version

Linux (Ubuntu) için JDK Kurulumu

Ubuntu’da OpenJDK’yı apt paket yöneticisi ile kurabilirsiniz:

  1. Terminal uygulamasını açın.
  2. Paket listesini güncelleyin:
sudo apt update
  1. OpenJDK 11’i kurun:
sudo apt install openjdk-11-jdk
  1. Kurulum tamamlandıktan sonra, aşağıdaki komutu çalıştırarak Java’nın doğru şekilde kurulduğunu kontrol edin:
java -version
  1. JAVA_HOME ortam değişkenini ayarlamak için:
echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64' >> ~/.bashrc
echo 'export PATH=$PATH:$JAVA_HOME/bin' >> ~/.bashrc
source ~/.bashrc

Spring Boot Projesi Oluşturma

Spring Boot projesi oluşturmak için Spring Initializr web aracını kullanacağız. Bu araç, Spring Boot projesinin temel yapısını ve gerekli bağımlılıkları otomatik olarak oluşturur.

  1. Spring Initializr web sitesine gidin.
  2. Aşağıdaki ayarları yapın:
    • Project (Proje): Maven Project
    • Language (Dil): Java
    • Spring Boot: 2.7.x (veya en son kararlı sürüm)
    • Project Metadata (Proje Metadataları):
      • Group (Grup): com.example
      • Artifact (Yapıt): ecommerce
      • Name (İsim): ecommerce
      • Description (Açıklama): E-Commerce Web Application
      • Package name (Paket adı): com.example.ecommerce
      • Packaging (Paketleme): Jar
      • Java: 11 (veya kurduğunuz JDK sürümü)
  3. Dependencies (Bağımlılıklar) bölümünde, aşağıdaki bağımlılıkları ekleyin:
    • Spring Web
    • Spring Data JPA
    • MySQL Driver
    • Spring Security
    • Validation
    • Lombok (opsiyonel, ancak kod yazımını kolaylaştırır)
    • Spring Boot DevTools (geliştirme sürecini hızlandırır)
  4. “Generate” (Oluştur) düğmesine tıklayın. Proje bir ZIP dosyası olarak indirilecektir.
  5. İndirilen ZIP dosyasını çalışma dizininize çıkarın.

MySQL Kurulumu

E-ticaret uygulaması için veritabanı olarak MySQL kullanacağız. Aşağıda, farklı işletim sistemleri için MySQL kurulum adımları verilmiştir.

Windows için MySQL Kurulumu

  1. MySQL İndirme Sayfası adresine gidin ve MySQL Installer for Windows’u indirin.
  2. İndirilen kurulum dosyasını çalıştırın.
  3. “Developer Default” (Geliştirici Varsayılanı) kurulum tipini seçin ve “Next” (İleri) düğmesine tıklayın.
  4. Gerekli bağımlılıkların kontrolü yapıldıktan sonra “Execute” (Çalıştır) düğmesine tıklayın.
  5. Kurulum tamamlandıktan sonra “Next” (İleri) düğmesine tıklayın.
  6. Yapılandırma adımında, “Standalone MySQL Server” (Bağımsız MySQL Sunucusu) seçeneğini seçin ve “Next” (İleri) düğmesine tıklayın.
  7. “Development Computer” (Geliştirme Bilgisayarı) seçeneğini seçin ve “Next” (İleri) düğmesine tıklayın.
  8. Kimlik doğrulama yöntemi olarak “Use Strong Password Encryption” (Güçlü Şifre Şifrelemesi Kullan) seçeneğini seçin ve “Next” (İleri) düğmesine tıklayın.
  9. MySQL root kullanıcısı için bir şifre belirleyin ve “Next” (İleri) düğmesine tıklayın.
  10. Windows servisi ayarlarını varsayılan olarak bırakın ve “Next” (İleri) düğmesine tıklayın.
  11. Yapılandırmayı uygulamak için “Execute” (Çalıştır) düğmesine tıklayın.
  12. Kurulum tamamlandıktan sonra “Finish” (Bitir) düğmesine tıklayın.
  13. MySQL Workbench kurulumu için “Next” (İleri) düğmesine tıklayın ve kurulumu tamamlayın.

macOS için MySQL Kurulumu

  1. MySQL İndirme Sayfası adresine gidin ve macOS için olan DMG dosyasını indirin.
  2. İndirilen .dmg dosyasını açın ve kurulum paketini çalıştırın.
  3. Ekrandaki talimatları izleyerek kurulumu tamamlayın.
  4. Kurulum sırasında, MySQL root kullanıcısı için bir şifre belirlemeniz istenecektir. Bu şifreyi not alın, çünkü veritabanına bağlanmak için gerekli olacaktır.
  5. Kurulum tamamlandıktan sonra, Sistem Tercihleri’nde MySQL öğesi görünecektir. Buradan MySQL sunucusunu başlatabilir veya durdurabilirsiniz.

Linux (Ubuntu) için MySQL Kurulumu

  1. Terminal uygulamasını açın.
  2. Paket listesini güncelleyin:
sudo apt update
  1. MySQL sunucusunu kurun:
sudo apt install mysql-server
  1. MySQL güvenlik ayarlarını yapılandırın:
sudo mysql_secure_installation
  1. Bu komut, aşağıdaki güvenlik ayarlarını yapmanızı isteyecektir:

    • Validate Password Plugin (Şifre Doğrulama Eklentisi) kurulumu
    • Root şifresi belirleme
    • Anonim kullanıcıları kaldırma
    • Root kullanıcısının uzaktan erişimini devre dışı bırakma
    • Test veritabanını ve erişimini kaldırma
    • Ayrıcalık tablolarını yeniden yükleme
  2. MySQL sunucusunun durumunu kontrol edin:

sudo systemctl status mysql
  1. MySQL’e root kullanıcısı olarak bağlanın:
sudo mysql -u root -p
  1. E-ticaret uygulaması için bir veritabanı oluşturun:
CREATE DATABASE ecommerce;
  1. Uygulama için bir kullanıcı oluşturun ve gerekli izinleri verin:
CREATE USER 'ecommerceuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON ecommerce.* TO 'ecommerceuser'@'localhost';
FLUSH PRIVILEGES;
  1. MySQL’den çıkın:
EXIT;

Spring Boot Uygulamasını Yapılandırma

Spring Boot projesini oluşturduktan ve MySQL’i kurduktan sonra, uygulamayı veritabanına bağlamak için yapılandırmanız gerekmektedir.

  1. Spring Boot projesinin src/main/resources dizinindeki application.properties dosyasını açın.
  2. Aşağıdaki yapılandırma ayarlarını ekleyin:
# Veritabanı Bağlantı Ayarları
spring.datasource.url=jdbc:mysql://localhost:3306/ecommerce?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
spring.datasource.username=ecommerceuser
spring.datasource.password=password

# Hibernate Ayarları
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
spring.jpa.properties.hibernate.format_sql=true

# Server Port
server.port=8080

# Logging
logging.level.org.hibernate.SQL=DEBUG
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE

# Spring Security (Geliştirme aşamasında)
spring.security.user.name=admin
spring.security.user.password=admin

Bu yapılandırma, Spring Boot uygulamasının MySQL veritabanına bağlanmasını sağlar. spring.jpa.hibernate.ddl-auto=update ayarı, uygulama başlatıldığında Hibernate’in veritabanı şemasını otomatik olarak güncellemesini sağlar.

Spring Boot Uygulamasını Çalıştırma

Spring Boot uygulamasını çalıştırmak için aşağıdaki adımları izleyin:

  1. Komut satırını (Command Prompt, Terminal) açın.
  2. Spring Boot projesinin kök dizinine gidin.
  3. Aşağıdaki komutu çalıştırın:
# Windows için
mvnw.cmd spring-boot:run

# macOS/Linux için
./mvnw spring-boot:run
  1. Uygulama başarıyla başlatıldığında, aşağıdaki URL’yi tarayıcınızda açarak uygulamanın çalıştığını kontrol edebilirsiniz:
http://localhost:8080

Tebrikler! Backend geliştirme ortamını başarıyla kurdunuz. Bir sonraki bölümde, frontend geliştirme ortamının kurulumunu anlatacağız.