Wprowadzenie do zestawu Azure SDK i narzędzia Gradle
W tym artykule pokazano, jak używać narzędzia Gradle do tworzenia aplikacji za pomocą zestawu Azure SDK dla języka Java. W tym artykule skonfigurujesz nowy projekt za pomocą narzędzia Gradle, kompilujesz projekty za pomocą narzędzia do tworzenia obrazów natywnych dla maszyny Wirtualnej GraalVM w celu tworzenia natywnych plików binarnych specyficznych dla platformy.
Wymagania wstępne
- Java Developer Kit, wersja 8 lub nowsza. Zalecamy wersję 17, aby uzyskać najlepsze środowisko.
- Narzędzie Gradle
Tworzenie nowego projektu narzędzia Gradle
W przeciwieństwie do narzędzia Maven, narzędzie Gradle nie ma systemu archetypu dla projektów bootstrapping w sposób szablonu. Uruchamianie projektu Gradle jest możliwe, ale nie konfiguruje zestawu Azure SDK dla środowisk Java, takich jak odpowiednik narzędzia Maven. Aby wykonać kroki, najpierw użyj następującego polecenia, aby utworzyć nowy, pusty katalog z wiersza polecenia:
gradle init --type java-application
Zostanie wyświetlony monit o udzielenie odpowiedzi na krótką serię pytań, po którym masz katalog zawierający kolekcję plików i podkatalogów. Aby upewnić się, że wygenerowany plik jest kompilowany, uruchom następujące polecenia wymagane do zweryfikowania kompilacji:
gradle clean assemble test
Teraz możesz przejść do edytowania pliku build.gradle znajdującego się w katalogu aplikacji. Na początek, aby ułatwić zarządzanie wersjami zależności, zespół zestawu Azure SDK dla języka Java publikuje zestaw Azure SDK dla modelu BOM klienta java każdego miesiąca. Ten plik BOM zawiera wszystkie ogólnie dostępne pakiety klienta platformy Azure dla języka Java z zgodną wersją zależności.
Aby użyć wersji zależności dla biblioteki klienta zestawu Azure SDK dla języka Java, która znajduje się w modelu BOM, dołącz następujący fragment kodu w pliku build.gradle projektu. {bom_version_to_target} Zastąp symbol zastępczy najnowszą wersją zestawu Azure SDK dla modelu BOM języka Java.
dependencies {
implementation platform('com.azure:azure-sdk-bom:{bom_version_to_target}')
}
Wszystkie wersje zestawu Azure SDK dla klienta Java BOM można znaleźć na stronie azure-sdk-bom. Zalecamy użycie najnowszej wersji, aby skorzystać z najnowszych funkcji zestawu Azure SDK dla bibliotek klienckich języka Java.
Po rozpoczęciu pracy w zależności od zestawu Azure SDK dla modelu BOM języka Java można uwzględnić zależności od bibliotek bez określania ich wersji. Te wartości wersji są automatycznie sprawdzane w zestawie Azure SDK dla modelu BOM języka Java. Aby na przykład uwzględnić azure-storage-blob zależność, dodaj następujące wiersze do pliku build.gradle :
dependencies {
implementation 'com.azure:azure-storage-blob'
}
Używanie narzędzia Gradle do definiowania zależności projektu może ułatwić zarządzanie projektami. Dzięki modelowi BOM zestawu Azure SDK możesz przyspieszyć projekt, jednocześnie zapewniając większą pewność co do przechowywania wersji zależności w dłuższej perspektywie. Zalecamy używanie modelu BOM, aby zachować wyrównanie zależności i ich aktualność.
Uwzględnij pakiet, który nie znajduje się w modelu BOM
Model BOM klienta zestawu Azure SDK dla języka Java zawiera tylko biblioteki ogólnie dostępne . Jeśli chcesz zależeć od pakietu, który jest nadal w wersji beta lub w wersji biblioteki innej niż ta zawarta w modelu BOM, możesz określić wersję zależności programu Maven wraz z groupId sekcją i artifactId w sekcji zależności. Możesz wybrać zależności korzystające z wersji I zależności BOM z zastąpionymi wersjami w tym samym pliku POM projektu, jak pokazano w poniższym przykładzie:
dependencies {
// Use the dependency version that is in the BOM
implementation 'com.azure:azure-messaging-eventhubs'
// Override the Service Bus dependency version specified in the BOM
implementation 'com.azure:azure-messaging-servicebus:7.4.0'
}
Jeśli używasz tej metody i określasz wersje bezpośrednio w projekcie, mogą wystąpić konflikty wersji zależności. Te konflikty występują, ponieważ różne pakiety mogą zależeć od różnych wersji wspólnych zależności, a te wersje mogą nie być ze sobą zgodne. W przypadku wystąpienia konfliktów możesz wystąpić niepożądane zachowanie w czasie kompilacji lub w czasie wykonywania. Zalecamy korzystanie z wersji, które znajdują się w zestawie Azure SDK BOM, chyba że jest to konieczne. Aby uzyskać więcej informacji na temat radzenia sobie z zależnościami w przypadku korzystania z zestawu Azure SDK dla języka Java, zobacz Rozwiązywanie problemów z konfliktami wersji zależności.
Tworzenie obrazu natywnego za pomocą maszyny GraalVM
Maszynę wirtualną GraalVM można użyć do utworzenia obrazu natywnego aplikacji Java. GraalVM kompiluje kod Java przed upływem czasu do natywnego kodu maszynowego, co może przynieść drastyczne wzrosty wydajności w niektórych sytuacjach. Zestaw Azure SDK dla języka Java udostępnia niezbędne metadane w każdej z jego bibliotek klienckich do obsługi kompilacji obrazu natywnego graalVM.
Aby rozpocząć, musisz zainstalować maszynę GraalVM i przygotować system programowania do kompilowania obrazów natywnych. Proces instalacji maszyny GraalVM jest prosty, a dokumentacja graalVM zawiera instrukcje krok po kroku dotyczące instalowania maszyny GraalVM i używania maszyny GraalVM do zainstalowania obrazu natywnego. Dokładnie postępuj zgodnie z sekcją wymagań wstępnych, aby zainstalować niezbędne natywne kompilatory dla systemu operacyjnego.
W istniejącym projekcie opartym na programie Gradle możesz postępować zgodnie z instrukcjami graalVM dotyczącymi narzędzia Gradle , aby dodawać obsługę maszyny GraalVM do projektu. W ten sposób masz więcej opcji kompilacji, co pozwala skompilować aplikację do standardowego kodu bajtowego Java lub w obraz natywny skompilowany przez maszynę wirtualną GraalVM.
Następnie możesz uruchomić kompilację obrazu natywnego. Aby użyć obrazu natywnego GraalVM, można użyć standardowych narzędzi narzędzia Gradle. W przypadku narzędzia Gradle użyj następującego polecenia:
gradle nativeCompile
Po uruchomieniu tego polecenia graalVM generuje natywny plik wykonywalny dla platformy, na której działa. Plik wykonywalny zostanie wyświetlony w katalogu Gradle /app/build/native/nativeCompile projektu. Teraz możesz uruchomić aplikację przy użyciu tego pliku wykonywalnego i powinna działać podobnie jak w przypadku standardowej aplikacji Java.