Menggunakan Spring Data dengan Azure Cosmos DB untuk MongoDB API

Artikel ini memperlihatkan cara membuat aplikasi sampel yang menggunakan Spring Data untuk menyimpan dan mengambil informasi dengan menggunakan Azure Cosmos DB untuk MongoDB.

Prasyarat

Membuat akun Azure Cosmos DB

Membuat akun Azure Cosmos DB dengan menggunakan portal Azure

Nota

Untuk informasi selengkapnya tentang membuat akun, lihat dokumentasi Azure Cosmos DB.

  1. Telusuri ke portal Microsoft Azure di https://portal.azure.com/ dan masuk.

  2. Pilih Buat sumber daya, pilih Database, lalu pilih Azure Cosmos DB.

  3. Pada layar Pilihan API , pilih Azure Cosmos DB untuk MongoDB.

    Cuplikan layar opsi Pilih API portal Azure dengan Azure Cosmos DB untuk MongoDB dipilih.

  4. Tentukan informasi berikut:

    • Langganan: Tentukan langganan Azure Anda yang akan digunakan.
    • Grup sumber daya: Tentukan apakah akan membuat grup sumber daya baru atau memilih grup sumber daya yang sudah ada.
    • Nama akun: Pilih nama unik untuk akun Azure Cosmos DB Anda. Nama ini digunakan untuk membuat nama domain yang sepenuhnya memenuhi syarat seperti wingtiptoysmongodb.documents.azure.com.
    • API: Tentukan Azure Cosmos DB for MongoDB API untuk tutorial ini.
    • Lokasi: Tentukan wilayah geografis terdekat untuk database Anda.
  5. Saat Anda memasukkan semua informasi sebelumnya, pilih Tinjau + buat.

  6. Jika semuanya terlihat benar di halaman tinjauan, pilih Buat.

    Cuplikan layar halaman tinjauan memperlihatkan pengaturan akun Azure Cosmos DB sebelum pembuatan.

Mengambil string koneksi untuk akun Azure Cosmos DB Anda

  1. Telusuri ke portal Microsoft Azure di https://portal.azure.com/ dan masuk.

  2. Klik Semua Sumber Daya, lalu pilih akun Azure Cosmos DB yang Anda buat.

  3. Klik String koneksi, dan salin nilai untuk bidang String Koneksi Utama . Gunakan nilai ini untuk mengonfigurasi aplikasi Anda nanti.

    Cuplikan layar halaman String koneksi yang menampilkan string koneksi utama untuk akun Azure Cosmos DB.

Mengonfigurasi aplikasi sampel

  1. Buka shell perintah dan kloning proyek sampel dengan menggunakan perintah git. Contohnya:

    git clone https://github.com/spring-guides/gs-accessing-data-mongodb.git
    
  2. Buat direktori resources di direktori <root proyek>/complete/src/main pada proyek contoh. Kemudian, buat file application.properties di direktori sumber daya .

  3. Buka file application.properties di editor teks. Tambahkan baris berikut ke file, dan ganti nilai sampel dengan nilai yang sesuai dari sebelumnya:

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

    Di mana

    Pengaturan Deskripsi
    spring.data.mongodb.database Menentukan nama akun Azure Cosmos DB Anda yang disebutkan sebelumnya di dalam artikel ini.
    spring.data.mongodb.uri Menentukan String Koneksi Utama dari sebelumnya dalam artikel ini.
  4. Simpan dan tutup file application.properties .

Mengemas dan menguji aplikasi sampel

Untuk membuat aplikasi, buka direktori /gs-accessing-data-mongodb/complete, yang berisi file pom.xml .

  1. Bangun aplikasi sampel dengan Maven, dan konfigurasikan Maven untuk melewati pengujian; misalnya:

    mvn clean package -DskipTests
    
  2. Mulai aplikasi sampel; misalnya:

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

    Aplikasi Anda harus mengembalikan nilai seperti berikut:

    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']
    

Ringkasan

Dalam tutorial ini, Anda membuat sampel aplikasi Java yang menggunakan Spring Data untuk menyimpan dan mengambil informasi dengan menggunakan Azure Cosmos DB untuk MongoDB.

Membersihkan sumber daya

Saat Anda tidak lagi memerlukan sumber daya, gunakan portal Azure untuk menghapusnya. Menghapus sumber daya membantu Anda menghindari biaya tak terduga.

Langkah berikutnya

Untuk mempelajari selengkapnya tentang Spring dan Azure, lanjutkan ke pusat dokumentasi Spring on Azure.

Lihat juga

Untuk informasi selengkapnya tentang menggunakan Azure dengan Java, lihat Azure for Java Developers dan Bekerja dengan Azure DevOps dan Java.