Udostępnij za pośrednictwem


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 korzystającej z Spring Data do przechowywania i pobierania informacji przy użyciu usługi Azure Cosmos DB for MongoDB.

Warunki wstępne

Tworzenie konta usługi Azure Cosmos DB

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

Notatka

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 Bazy danych, a następnie Azure Cosmos DB.

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

    W portalu Azure utwórz zasób, wybierz opcję API, wybrano Azure Cosmos DB dla 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 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 na potrzeby 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 wszystko wygląda poprawnie na stronie przeglądu, kliknij przycisk Utwórz.

    Przejrzyj ustawienia konta usługi Azure Cosmos DB.

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 Wszystkie zasoby, a następnie kliknij konto usługi Azure Cosmos DB, które właśnie utworzyłeś.

  3. Kliknij parametry połączeniai skopiuj wartość pola podstawowe parametry połączenia; Użyjesz tej wartości do późniejszego skonfigurowania aplikacji.

    Pobierz parametry połączenia usługi Azure Cosmos DB.

Konfigurowanie przykładowej aplikacji

  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 zasobów w katalogu głównym projektu /complete/src/main przykładowego projektu i utwórz plik application.properties w katalogu zasobów .

  3. Otwórz plik application.properties w edytorze tekstów i dodaj następujące wiersze w pliku, a następnie 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 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, użyj Azure Portal, aby 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.