Jak używać Spring Data z Azure Cosmos DB dla Apache Cassandra

W tym artykule pokazano, jak używać rozwiązania Spring Data z Azure Cosmos DB dla systemu Apache Cassandra w celu utworzenia przykładowej aplikacji Java, która przechowuje i pobiera dane.

Warunki wstępne

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

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

• Apache Maven.

• Azure CLI.

• Klient Git.

• cURL lub podobne narzędzie HTTP do testowania funkcji.

Tworzenie konta usługi Azure Cosmos DB

Poniższa procedura tworzy i konfiguruje konto usługi Azure Cosmos DB w witrynie Azure Portal.

Tworzenie konta Azure Cosmos DB przy użyciu portalu Azure

Notatka

Aby uzyskać więcej informacji na temat tworzenia kont, zobacz dokumentację 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, wybierz pozycję Rozpocznij, a następnie wybierz pozycję Azure Cosmos DB.

3. Na ekranie Select API option wybierz opcję Cassandra.

   

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

   • Subskrypcja: Określ subskrypcję platformy Azure do wykorzystania.
   • 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 wingtiptoyscassandra.documents.azure.com.
   • interfejsu API: określ Cassandra 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.

Wdrożenie bazy danych trwa kilka minut.

Dodawanie przestrzeni kluczy do konta usługi Azure Cosmos DB

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

2. Wybierz pozycję Wszystkie zasoby, a następnie wybierz utworzone konto Azure Cosmos DB.

3. Wybierz Data Explorer, wybierz strzałkę w dół i wybierz pozycję Nowa przestrzeń kluczy. Wprowadź unikatowy identyfikator identyfikatora przestrzeni kluczy, a następnie wybierz przycisk OK.

   

   

Pobieranie ustawień 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. Wybierz pozycję Wszystkie zasoby, a następnie wybierz utworzone konto Azure Cosmos DB.

3. Wybierz pozycję Parametry połączenia i skopiuj wartości pól Punkt kontaktu, Port, Nazwa użytkownika i Hasło podstawowe . Te wartości służą do późniejszego konfigurowania aplikacji.

   

Konfigurowanie przykładowej aplikacji

Poniższa procedura umożliwia skonfigurowanie aplikacji testowej.

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

   git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
   

2. Znajdź plik application.properties w katalogu zasobów przykładowego projektu lub utwórz plik, jeśli jeszcze nie istnieje.

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

   spring.data.cassandra.contact-points=wingtiptoyscassandra.cassandra.cosmos.azure.com
   spring.data.cassandra.port=10350
   spring.data.cassandra.username=wingtiptoyscassandra
   spring.data.cassandra.password=********
   

   Gdzie:

   Parametr	Opis
   spring.data.cassandra.contact-points	Określa punkt kontaktowy z wcześniejszej części tego artykułu.
   spring.data.cassandra.port	Określa port we wcześniejszej części tego artykułu.
   spring.data.cassandra.username	Określa nazwę użytkownika z wcześniejszej sekcji tego artykułu.
   spring.data.cassandra.password	Wskazuje podstawowe hasło z wcześniejszej części tego artykułu.

4. Zapisz i zamknij plik application.properties.

Pakowanie i testowanie przykładowej aplikacji

Przejdź do katalogu zawierającego plik pom.xml, aby skompilować i przetestować aplikację.

1. Skompiluj przykładową aplikację za pomocą narzędzia Maven; na przykład:

   mvn clean package
   

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

   java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar
   

3. Utwórz nowe rekordy przy użyciu wiersza curl polecenia. W poniższych przykładach pokazano, jak utworzyć rekordy:

   curl -s -d "{\"name\":\"dog\",\"species\":\"canine\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets
   
   curl -s -d "{\"name\":\"cat\",\"species\":\"feline\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets
   

   Aplikacja powinna zwracać wartości podobne do następującego przykładu:

   Added Pet{id=60fa8cb0-0423-11e9-9a70-39311962166b, name='dog', species='canine'}.
   
   Added Pet{id=72c1c9e0-0423-11e9-9a70-39311962166b, name='cat', species='feline'}.
   

4. Pobierz wszystkie istniejące rekordy przy użyciu wiersza curl polecenia. W poniższych przykładach pokazano, jak pobrać rekordy:

   curl -s http://localhost:8080/pets
   

   Aplikacja powinna zwracać wartości podobne do następujących przykładów:

   [{"id":"60fa8cb0-0423-11e9-9a70-39311962166b","name":"dog","species":"canine"},{"id":"72c1c9e0-0423-11e9-9a70-39311962166b","name":"cat","species":"feline"}]
   

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 Azure Cosmos DB dla usługi Apache Cassandra.

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.

Spring na platformie 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.