Używanie rozwiązania Spring Data z usługą Azure Cosmos DB dla interfejsu API bazy danych MongoDB

W tym artykule przedstawiono tworzenie przykładowej aplikacji, która używa rozwiązania Spring Data do przechowywania i pobierania informacji przy użyciu usługi Azure Cosmos DB dla bazy danych MongoDB.

Wymagania wstępne

• Subskrypcja platformy Azure — utwórz bezpłatnie.

• Zestaw Java Development Kit (JDK) w wersji 8 lub nowszej.

• Apache Maven.

• Interfejs wiersza polecenia platformy Azure.

• Klient usługi Git.

Tworzenie konta usługi Azure Cosmos DB

Tworzenie konta usługi Azure Cosmos DB przy użyciu witryny Azure Portal

Uwaga

Więcej szczegółowych informacji na temat tworzenia kont można znaleźć w dokumentacji usługi Azure Cosmos DB.

1. Przejdź do witryny Azure Portal pod adresem https://portal.azure.com/ i zaloguj się.

2. Wybierz pozycję Utwórz zasób, a następnie pozycję Bazy danych, a następnie pozycję Azure Cosmos DB.

3. Na ekranie Wybierz interfejs API wybierz pozycję Azure Cosmos DB dla bazy danych MongoDB.

   

4. Pozwala określić następujące informacje:

   • Subskrypcja: określ subskrypcję platformy Azure do użycia.
   • Grupa zasobów: określ, czy chcesz utworzyć nową grupę zasobów, czy wybrać istniejącą grupę zasobów.
   • Nazwa konta: wybierz unikatową nazwę konta usługi Azure Cosmos DB. Zostanie użyta do utworzenia w pełni kwalifikowanej nazwy domeny, takiej jak wingtiptoysmongodb.documents.azure.com.
   • Interfejs API: określ Azure Cosmos DB for MongoDB API dla tego samouczka.
   • Lokalizacja: określ najbliższy region geograficzny dla bazy danych.

5. Po wprowadzeniu wszystkich powyższych informacji kliknij pozycję Przejrzyj i utwórz.

6. Jeśli na stronie przeglądu wszystko wygląda poprawnie, kliknij przycisk Utwórz.

   

Pobieranie parametrów połączenia dla konta usługi Azure Cosmos DB

1. Przejdź do witryny Azure Portal pod adresem https://portal.azure.com/ i zaloguj się.

2. Kliknij pozycję Wszystkie zasoby, a następnie kliknij utworzone teraz konto usługi Azure Cosmos DB.

3. Kliknij pozycję ciągi Połączenie ion i skopiuj wartość pola Ciąg podstawowy Połączenie ion. Użyjesz tej wartości do późniejszego skonfigurowania aplikacji.

   

Konfigurowanie aplikacji przykładowej

1. Otwórz powłokę poleceń i sklonuj przykładowy projekt przy użyciu polecenia git, jak w poniższym przykładzie:

   git clone https://github.com/spring-guides/gs-accessing-data-mongodb.git
   

2. Utwórz katalog resources (zasoby) w katalogu <katalog główny projektu>/complete/src/main projektu przykładowego, a następnie utwórz plik application.properties w katalogu resources.

3. Otwórz plik application.properties w edytorze tekstów, a następnie dodaj następujące wiersze w pliku i zastąp przykładowe wartości odpowiednimi wartościami skopiowanymi wcześniej:

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

   Gdzie:

   Parametr	Opis
   spring.data.mongodb.database	Określa nazwę konta usługi Azure Cosmos DB z wcześniejszej części tego artykułu.
   spring.data.mongodb.uri	Określa podstawowe parametry połączenia z wcześniejszej części tego artykułu.

4. Zapisz i zamknij plik application.properties.

Pakowanie i testowanie aplikacji przykładowej

Aby skompilować aplikację, przejdź do katalogu /gs-accessing-data-mongodb/complete, który zawiera plik pom.xml .

1. Skompiluj przykładową aplikację przy użyciu narzędzia Maven i skonfiguruj narzędzie Maven w celu pomijania testów, na przykład:

   mvn clean package -DskipTests
   

2. Uruchom aplikację przykładową, na przykład:

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

   Aplikacja powinna zwracać wartości podobne do następujących:

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

Podsumowanie

W tym samouczku utworzono przykładową aplikację Java, która używa rozwiązania Spring Data do przechowywania i pobierania informacji przy użyciu usługi Azure Cosmos DB dla bazy danych MongoDB.

Czyszczenie zasobów

Gdy zasoby utworzone w tym artykule nie będą już potrzebne, usuń je w witrynie Azure Portal, aby uniknąć naliczania opłat.

Następne kroki

Aby dowiedzieć się więcej na temat oprogramowania Spring i platformy Azure, przejdź do centrum dokumentacji dotyczącej oprogramowania Spring na platformie Azure.

Oprogramowanie Spring na platformie Azure

Zobacz też

Aby uzyskać więcej informacji na temat korzystania z platformy Azure przy użyciu języka Java, zapoznaj się z tematami Platforma Azure dla deweloperów języka Java oraz Praca z narzędziami Azure DevOps i językiem Java.