We’re thrilled to announce the general availability of Spring Cloud Azure 4.9.0 and 5.3.0. These major releases bring increased compatibility with Spring Boot 2 for 4.9.0 and Spring Boot 3 for 5.3.0.<\/p>\n
This release includes noteworthy features and enhancements such as:<\/p>\n
azure-sdk-bom<\/code> (version 1.2.14) and azure-resourcemanager<\/code> (version 2.28.0).<\/li>\n<\/ul>\nSpring Cloud Azure 4.9.0<\/h3>\n
This version comes with the following additions:<\/p>\n
\n- A new Spring Boot starter for Azure Event Grid.<\/li>\n
- Upgrades to
azure-sdk-bom<\/code> (version 1.2.14) and azure-resourcemanager<\/code> (version 2.28.0).<\/li>\n<\/ul>\nMoreover, we’ve launched the 4.9.0-beta.1<\/code> version of spring-cloud-azure-starter-openai<\/code>, extending support to the Azure OpenAI service.<\/p>\nLet’s delve deeper into the new offerings!<\/p>\n
What’s new?<\/h2>\nSpring Data Cosmos<\/h3>\n
Spring Data Cosmos 5.3.0 is the first GA version compatible with Spring Boot 3. For more information, see the Spring Data Cosmos changelog<\/a>.<\/p>\nThere’s no change in how you use Spring Data Cosmos. Just add the starter to your project:<\/p>\n
<dependency>\r\n <groupId>com.azure.spring<\/groupId>\r\n <artifactId>spring-cloud-azure-starter-cosmos<\/artifactId>\r\n<\/dependency><\/code><\/pre>\nNext, configure the Cosmos properties in your application.properties<\/code> file:<\/p>\nspring.cloud.azure.cosmos.endpoint=<your-azure-cosmos-endpoint>\r\nspring.cloud.azure.cosmos.database=<your-azure-cosmos-database><\/code><\/pre>\nThis configuration uses the available credential on your local environment, such as Azure CLI, to connect to the Azure Cosmos DB database. To configure other types of authentication principals, see Authenticate with Entra ID<\/a>.<\/p>\nYou can define a repository in your project to save and query data as follows:<\/p>\n
@Repository\r\npublic interface UserRepository extends CosmosRepository<User, String> {}\r\n\r\n@Service\r\npublic class CosmosService {\r\n\r\n @Autowired\r\n private UserRepository userRepository;\r\n\r\n public void someMethod() {\r\n User testUser = new User(USER_ID, \"testFirstName\", \"testLastName\", \"test address line one\");\r\n userRepository.save(testUser);\r\n Optional<User> user = userRepository.findById(USER_ID);\r\n userRepository.delete(testUser);\r\n }\r\n}<\/code><\/pre>\nAutoconfiguration of Azure Event Grid<\/h3>\n
Azure Event Grid enables easy construction of event-based architecture applications. With the new Spring Cloud Azure starter for Event Grid, Event Grid client autoconfiguration is a breeze. For more information about Azure Event Grid, see What is Event Grid?<\/a>.<\/p>\nTo utilize this feature, add the starter to your project:<\/p>\n
<dependency>\r\n <groupId>com.azure.spring<\/groupId>\r\n <artifactId>spring-cloud-azure-starter-eventgrid<\/artifactId>\r\n<\/dependency><\/code><\/pre>\nThen, configure the Event Grid properties in your application.properties<\/code> file:<\/p>\nspring.cloud.azure.eventgrid.endpoint=https:\/\/xxx.eventgrid.azure.net\/api\/events\r\nspring.cloud.azure.eventgrid.key=<your-event-grid-key><\/code><\/pre>\nYou can also use Entra ID principals to connect to the Event Grid service. Authenticate with Entra ID<\/a> offers guidance on configuring other types of authentication principals.<\/p>\nHere’s how you can autowire the Event Grid client:<\/p>\n
@Autowired\r\nEventGridPublisherClient<EventGridEvent> client;\r\n\r\npublic void someMethod(String user) {\r\n \/\/ ...\r\n \/\/ topic must be set when sending to an Event Grid Domain.\r\n EventGridEvent event = new EventGridEvent(\"A user is created\",\r\n \"User.Created.Object\",\r\n BinaryData.fromObject(user),\r\n \"0.1\");\r\n client.sendEvent(event);\r\n \/\/ ...\r\n}<\/code><\/pre>\nPasswordless connection to Azure Service Bus JMS<\/h3>\n
Prior to the support of passwordless connections, a connection to Azure Service Bus required a connection string. However, with the new feature, you can connect to Azure Service Bus JMS using Managed Identity or any Entra ID principal. To learn more about passwordless connections, see aka.ms\/passwordless-connections<\/a>.<\/p>\nTo connect to Azure Service Bus JMS with a passwordless connection, add the starter to your project:<\/p>\n
<dependency>\r\n <groupId>com.azure.spring<\/groupId>\r\n <artifactId>spring-cloud-azure-starter-servicebus-jms<\/artifactId>\r\n<\/dependency><\/code><\/pre>\nThen, configure the necessary properties in application.properties<\/code>:<\/p>\nspring.jms.servicebus.passwordless-enabled=true\r\nspring.jms.servicebus.namespace=<your-servicebus-namespace>\r\nspring.jms.servicebus.pricing-tier=<your-servicebus-pricing-tier> # e.g. standard\r\nspring.cloud.azure.credential.managed-identity-enabled=true\r\nspring.cloud.azure.credential.client-id=<your-user-assigned-managed-identity-id><\/code><\/pre>\nThis configuration uses the user-assigned managed identity to connect to the Service Bus. To configure other types of authentication principals, see Authenticate with Entra ID<\/a>.<\/p>\nAfterward, you can use the Spring JmsTemplate<\/code> or @JmsListener<\/code> in your application:<\/p>\n@SpringBootApplication\r\n@EnableJms\r\npublic class ServiceBusJMSApplication implements CommandLineRunner {\r\n\r\n private static final Logger LOGGER = LoggerFactory.getLogger(ServiceBusJMSApplication.class);\r\n private static final String QUEUE_NAME = \"<QueueName>\";\r\n\r\n @Autowired\r\n private JmsTemplate jmsTemplate;\r\n\r\n public static void main(String[] args) {\r\n SpringApplication.run(ServiceBusJMSApplication.class, args);\r\n }\r\n\r\n @Override\r\n public void run(String... args) {\r\n LOGGER.info(\"Sending message\");\r\n jmsTemplate.convertAndSend(QUEUE_NAME, \"Hello Word\");\r\n }\r\n\r\n @JmsListener(destination = QUEUE_NAME, containerFactory = \"jmsListenerContainerFactory\")\r\n public void receiveMessage(String message) {\r\n LOGGER.info(\"Message received: {}\", message);\r\n }\r\n\r\n}<\/code><\/pre>\nAzure OpenAI support<\/h3>\n
Azure OpenAI<\/a> is a managed service enabling developers to deploy, tune, and generate content from OpenAI models on Azure resources.<\/p>\nThe Spring Cloud Azure starter for Azure OpenAI allows autoconfiguration of the OpenAI client<\/a> provided by the Azure SDK for Java. To use this feature, add the starter to your project:<\/p>\n<dependency>\r\n <groupId>com.azure.spring<\/groupId>\r\n <artifactId>spring-cloud-azure-starter-openai<\/artifactId>\r\n <version>4.9.0-beta.1<\/version>\r\n<\/dependency><\/code><\/pre>\nNext, configure the OpenAI properties in your application.properties<\/code> file:<\/p>\nspring.cloud.azure.openai.endpoint=https:\/\/xxx.openai.azure.com\/\r\nspring.cloud.azure.openai.key=<your-azure-openai-key>\r\n# or you can use the key of the public non-Azure OpenAI\r\n# spring.cloud.azure.openai.non-azure-openai-key=<your-public-openai-key><\/code><\/pre>\nThen, you’re ready to autowire the OpenAI client:<\/p>\n
@Autowired\r\nprivate OpenAIClient client;\r\n\r\npublic void someMethod() {\r\n List<String> prompt = List.of(\"How many breeds of dogs are there in the world?\");\r\n\r\n Completions completions = client.getCompletions(\"gpt-35-turbo\", new CompletionsOptions(prompt));\r\n\r\n for (Choice choice : completions.getChoices()) {\r\n System.out.printf(\"Index: %d, Text: %s.%n\", choice.getIndex(), choice.getText());\r\n }\r\n}<\/code><\/pre>\nOne dependency BOM for all Spring Cloud Azure components<\/h3>\n
The spring-cloud-azure-dependencies<\/code> BOM manages all Spring Cloud Azure components, including Cosmos and App Configuration. You can add the BOM to your project as follows:<\/p>\n<dependencyManagement> \r\n <dependencies> \r\n <dependency> \r\n <groupId>com.azure.spring<\/groupId> \r\n <artifactId>spring-cloud-azure-dependencies<\/artifactId> \r\n <version>5.3.0<\/version> <!-- 4.9.0 or 4.9.0-beta.1 -->\r\n <type>pom<\/type> \r\n <scope>import<\/scope> \r\n <\/dependency> \r\n <\/dependencies> \r\n<\/dependencyManagement> <\/code><\/pre>\nThis configuration allows all Spring Cloud Azure component versions to be managed. For example:<\/p>\n
<dependency>\r\n <groupId>com.azure.spring<\/groupId>\r\n <artifactId>spring-cloud-azure-starter-servicebus-jms<\/artifactId>\r\n <!-- The version can be omitted -->\r\n<\/dependency><\/code><\/pre>\nCompatibility with Spring Boot 3.1<\/h3>\n
Spring Cloud Azure 5.3.0 is now compatible with Spring Boot 3.1<\/a>. This version is compatible with both Spring Boot 3.0.x and 3.1.x. Check https:\/\/aka.ms\/spring\/versions for more information on versioning details.<\/p>\nFeedback<\/h2>\n
Your feedback and contributions are always welcome on StackOverflow<\/a>\u202for\u202fGitHub<\/a>.<\/p>\nResources<\/h2>\n
To learn more about Spring Cloud Azure, we invite you to visit the following links:<\/p>\n
\n- Reference Documentation<\/a><\/li>\n
- Conceptual Documentation<\/a><\/li>\n
- Code Samples<\/a><\/li>\n
- Spring Version Mapping<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
This post announces the release of Spring Cloud Azure 4.9.0 and 5.3.0.<\/p>\n","protected":false},"author":103258,"featured_media":2783,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[160,871,872,854],"class_list":["post-2775","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-azure-sdk","tag-java","tag-spring","tag-spring-cloud-azure","tag-stable-releases"],"acf":[],"blog_post_summary":"
This post announces the release of Spring Cloud Azure 4.9.0 and 5.3.0.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/posts\/2775","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/users\/103258"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/comments?post=2775"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/posts\/2775\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/media\/2783"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/media?parent=2775"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/categories?post=2775"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azure-sdk\/wp-json\/wp\/v2\/tags?post=2775"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}