MongoDB için Azure Cosmos DB API'siyle Spring Data kullanma

Bu makalede, MongoDB için Azure Cosmos DB kullanarak bilgileri depolamak ve almak için Spring Data kullanan örnek bir uygulamanın nasıl oluşturulacağı gösterilmektedir.

Önkoşullar

  • Git istemcisi.

Azure Cosmos DB hesabı oluşturma

Azure portalını kullanarak Azure Cosmos DB hesabı oluşturma

Not

Hesap oluşturma hakkında daha fazla bilgi için Azure Cosmos DB belgelerine bakın.

  1. https://portal.azure.com/'da Azure portalına göz atın ve oturum açın.

  2. Kaynak oluştur'u, Veritabanları'yı ve ardından Azure Cosmos DB'ı seçin.

  3. Select API seçeneği ekranında, MongoDB için Azure Cosmos DBseçin.

    MongoDB için Azure Cosmos DB seçili Azure portalı API seç seçeneği ekranının ekran görüntüsü.

  4. Aşağıdaki bilgileri belirtin:

    • abonelik: Kullanılacak Azure aboneliğinizi belirtin.
    • Kaynak grubu: Yeni bir kaynak grubu mu oluşturulacağını yoksa var olan bir kaynak grubunu mu seçileceğini belirtin.
    • Hesap adı: Azure Cosmos DB hesabınız için benzersiz bir ad seçin. Bu ad, wingtiptoysmongodb.documents.azure.com gibi tam nitelikli bir alan adı oluşturmak için kullanılır.
    • API: Bu öğretici için Azure Cosmos DB for MongoDB API belirtin.
    • Konum: Veritabanınız için en yakın coğrafi bölgeyi belirtin.
  5. Önceki tüm bilgileri girdiğinizde Gözden Geçir ve oluştur'u seçin.

  6. Gözden geçirme sayfasında her şey doğru görünüyorsa Oluştur'u seçin.

    Oluşturmadan önce Azure Cosmos DB hesap ayarlarını gösteren gözden geçirme sayfasının ekran görüntüsü.

Azure Cosmos DB hesabınızın bağlantı dizesini alma

  1. https://portal.azure.com/'da Azure portalına göz atın ve oturum açın.

  2. Tüm Kaynaklar'a tıklayın ve oluşturduğunuz Azure Cosmos DB hesabını seçin.

  3. Bağlantı dizeleri'ne tıklayın ve Birincil Bağlantı Dizesi alanının değerini kopyalayın. Uygulamanızı daha sonra yapılandırmak için bu değeri kullanın.

    Azure Cosmos DB hesabının Birincil Bağlantı Dizesini gösteren Bağlantı dizeleri sayfasının ekran görüntüsü.

Örnek uygulamayı yapılandırma

  1. Bir komut kabuğu açın ve git komutunu kullanarak örnek projeyi kopyalayın. Örneğin:

    git clone https://github.com/spring-guides/gs-accessing-data-mongodb.git
    
  2. Örnek projenin proje kökü>/complete/src/main dizininde bir kaynak< dizini oluşturun. Ardından resources dizininde bir application.properties dosyası oluşturun.

  3. application.properties dosyasını bir metin düzenleyicisinde açın. Dosyaya aşağıdaki satırları ekleyin ve örnek değerleri daha önceki uygun değerlerle değiştirin:

    spring.data.mongodb.database=wingtiptoysmongodb
    spring.data.mongodb.uri=mongodb://wingtiptoysmongodb:AbCdEfGhIjKlMnOpQrStUvWxYz==@wingtiptoysmongodb.documents.azure.com:10255/?ssl=true&replicaSet=globaldb
    

    Nerede:

    Parametre Açıklama
    spring.data.mongodb.database Bu makalenin önceki bölümlerinde yer alan Azure Cosmos DB hesabınızın adını belirtir.
    spring.data.mongodb.uri Bu makalenin önceki bölümlerinden Birincil Bağlantı Dizesi'ni belirtir.
  4. application.properties dosyasını kaydedin ve kapatın.

Örnek uygulamayı paketleme ve test edin

Uygulamayı oluşturmak için pom.xmldosyasını içeren /gs-accessing-data-mongodb/complete dizinine gidin.

  1. Maven ile örnek uygulamayı oluşturun ve Maven'i testleri atlayarak yapılandırın; mesela:

    mvn clean package -DskipTests
    
  2. Örnek uygulamayı başlatın; mesela:

    
    java -jar target/accessing-data-mongodb-complete-0.0.1-SNAPSHOT.jar
    

    Uygulamanız aşağıdaki gibi değerler döndürmelidir:

    Customers found with findAll():
    -------------------------------
    Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
    Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']
    
    Customer found with findByFirstName('Alice'):
    --------------------------------
    Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
    Customers found with findByLastName('Smith'):
    --------------------------------
    Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
    Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']
    

Özet

Bu öğreticide, MongoDB için Azure Cosmos DB kullanarak bilgileri depolamak ve almak için Spring Data kullanan örnek bir Java uygulaması oluşturdunuz.

Kaynakları temizleme

Kaynaklara artık ihtiyacınız kalmadığında, bunları silmek için Azure portalını kullanın. Kaynakları silmek beklenmeyen ücretlerden kaçınmanıza yardımcı olur.

Sonraki adımlar

Spring ve Azure hakkında daha fazla bilgi edinmek için Azure'da Spring belge merkezine geçin.

Azure'de Bahar

Ayrıca bkz.

Azure'ı Java ile kullanma hakkında daha fazla bilgi için Java Geliştiricileri için Azure ve Azure DevOps ve Java ile Çalışmabölümlerine bakın.