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

W tym artykule pokazano, jak utworzyć przykładową aplikację, która używa rozwiązania Spring Data do przechowywania i pobierania informacji przy użyciu Azure Cosmos DB dla bazy danych MongoDB.

Warunki wstępne

• Subskrypcja platformy Azure — utwórz bezpłatną subskrypcję.

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

• Apache Maven.

• Azure CLI.

• Klient Git.

Tworzenie konta usługi Azure Cosmos DB

Tworzenie konta Azure Cosmos DB przy użyciu portalu Azure

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

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

3. Na ekranie Wybierz interfejs API wybierz pozycję Azure Cosmos DB for MongoDB.

   

4. Określ następujące informacje:

   • Subskrypcja: Określ subskrypcję platformy Azure, której chcesz użyć.
   • 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 Azure Cosmos DB. Ta nazwa służy do tworzenia w pełni kwalifikowanej nazwy domeny, takiej jak wingtiptoysmongodb.documents.azure.com.
   • interfejs API: określ Azure Cosmos DB for MongoDB API na potrzeby tego samouczka.
   • Lokalizacja: określ najbliższy region geograficzny dla bazy danych.

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

6. Jeśli wszystko wygląda poprawnie na stronie przeglądu, wybierz pozycję 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 wybierz utworzone konto Azure Cosmos DB.

3. Kliknij pozycję Parametry połączenia i skopiuj wartość pola Podstawowe parametry połączenia . Użyj tej wartości, aby później skonfigurować aplikację.

   

Konfigurowanie przykładowej aplikacji

1. Otwórz powłokę poleceń i sklonuj przykładowy projekt za pomocą polecenia git. Przykład:

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

2. Utwórz katalog zasobów w <katalogu głównym>/kompletnym/src/main projektu przykładowego. Następnie utwórz plik application.properties w katalogu resources .

3. Otwórz plik application.properties w edytorze tekstów. Dodaj następujące wiersze do pliku i zastąp przykładowe wartości odpowiednimi wartościami z wcześniejszych:

   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 sekcji tego artykułu.

4. Zapisz i zamknij plik application.properties.

Pakowanie i testowanie przykładowej aplikacji

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

1. Skompiluj przykładową aplikację za pomocą narzędzia Maven i skonfiguruj narzędzie Maven, aby pominąć testy; na przykład:

   mvn clean package -DskipTests
   

2. Uruchom przykładową aplikację; 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']
   

Streszczenie

W tym samouczku utworzysz przykładową aplikację w języku Java, która używa Spring Data do przechowywania i pobierania danych przy użyciu Azure Cosmos DB for MongoDB.

Czyszczenie zasobów

Jeśli zasoby nie są już potrzebne, użyj portalu Azure, aby je usunąć. Usunięcie zasobów pomaga uniknąć nieoczekiwanych opłat.

Następne kroki

Aby dowiedzieć się więcej na temat platformy Spring i platformy Azure, przejdź do Centrum dokumentacji platformy Azure.

Zobacz też

Aby uzyskać więcej informacji na temat korzystania z platformy Azure z językiem Java, zobacz Azure for Java Developers oraz Praca z usługami Azure DevOps i Java.