Content Understanding GA SDK for Java #47952

changjian-wang · 2026-02-10T02:41:15Z

This pull request introduces the initial release of the Azure Content Understanding Java SDK by adding the new azure-ai-contentunderstanding package and integrating it into the build system. The changes include all necessary configuration, metadata, and source files to support client creation, versioning, and customization for the new service.

Key changes in this pull request:

New SDK Package Addition:

Introduced the azure-ai-contentunderstanding Java SDK, including client builder, service version enum, and internal helper classes for the Content Understanding service. [1] [2] [3]

Build System and Versioning Integration:

Registered the new module in the root pom.xml and versioning files to ensure the SDK is included in builds and version tracking. [1] [2]

Project Metadata and Configuration:

Added Maven project files (pom.xml), changelog, spell-check configuration, and asset tracking for the new SDK package. [1] [2] [3] [4] [5]

Development Environment Setup:

Included a .gitignore tailored for local development and security best practices in the new SDK directory.

…', API Version: 2025-11-01, SDK Release Type: beta, and CommitSHA: 'd0cd556bd91d2dda700e983c0d253fa025b324c0' in SpecRepo: 'https://github.com/Azure/azure-rest-api-specs' Pipeline run: https://dev.azure.com/azure-sdk/internal/_build/results?buildId=5634426 Refer to https://eng.ms/docs/products/azure-developer-experience/develop/sdk-release/sdk-release-prerequisites to prepare for SDK release.

…entunderstanding-5634426

…ca4b0e1d5ed1c

…nts in Content Understanding SDK

… from .NET SDK - Sample00_ConfigureDefaults: Demonstrates configuration management (get/update defaults) - Sample01_AnalyzeBinary: Binary PDF analysis from local file - Sample02_AnalyzeUrl: Analyze documents from URL - Sample03_AnalyzeInvoice: Extract structured invoice fields with nested objects and arrays - Sample04_CreateAnalyzer: Create and use custom analyzer with field schema (Extract/Generate/Classify methods) Key features: - All samples use DefaultAzureCredentialBuilder for authentication - Environment variable based configuration (ENDPOINT) - Comprehensive JUnit 5 tests with assertions - GitHub public URLs for test data - Proper field access patterns with type casting (ContentField, StringField, NumberField, ObjectField, ArrayField) - All tests passing (6/6 = 100% success rate) Technical implementation: - Fixed API differences from C# SDK (ContentSpan, ContentField, 5-parameter beginAnalyze) - Proper null checking and type casting for all field access - Detailed validation assertions for all document properties - Clean resource management with @AfterEach cleanup Module-info.java formatting cleanup included.

- Sample05_CreateClassifier: Create classifier analyzer with multiple classification fields (document_type, industry, urgency) - Sample06_GetAnalyzer: Get analyzer information including configuration and field schema Key features: - Sample05: Demonstrates classification-only analyzer with 3 classifiers - Sample06: Shows how to retrieve and inspect analyzer properties including prebuilt analyzers - Fixed API usage: getAnalyzerId(), getCreatedAt(), getLastModified At() instead of getId(), getCreatedDateTime(), getUpdatedDateTime() - Comprehensive field schema inspection with all 31 prebuilt-invoice fields - All tests passing with real Azure service

- Sample07_ListAnalyzers: List and filter all available analyzers (prebuilt and custom) * testListAnalyzersAsync: Lists all 134 analyzers (87 prebuilt, 47 custom) * testListReadyAnalyzersAsync: Filters for ready analyzers only - Sample08_UpdateAnalyzer: Update existing analyzer properties * Demonstrates updating description, configuration, and field schema * Uses @beforeeach to create test analyzer and @AfterEach for cleanup * Shows how to add new fields while preserving existing ones All tests passing with real Azure service

Fixed Sample08_UpdateAnalyzer to avoid 409 conflict error: - Delete existing analyzer before recreating with updated configuration - Added note about using updateAnalyzerWithResponse for atomic updates in production - All 12 tests now passing (Sample00-08 with multiple test methods) Test results: 12/12 passed (100% success rate)

…eAnalyzerWithLabels

…iables and Improve Test Patterns - Updated environment variable names from "ENDPOINT" and "CONTENTUNDERSTANDING_API_KEY" to "CONTENTUNDERSTANDING_ENDPOINT" and "AZURE_CONTENT_UNDERSTANDING_KEY" across multiple sample test files. - Modified sample tests to load local files instead of using publicly accessible URLs for document analysis. - Enhanced assertions and logging for better clarity and debugging. - Improved API usage patterns in tests for creating, copying, and deleting analyzers, including async patterns. - Added model mappings for analyzers in relevant samples to demonstrate configuration capabilities.

…r Authentication

…ted responses

…e validation of source and copied analyzers

… Azure Credential Authentication - Updated Sample03_AnalyzeInvoice, Sample04_CreateAnalyzer, Sample05_CreateClassifier, Sample06_GetAnalyzer, Sample07_ListAnalyzers, Sample08_UpdateAnalyzer, Sample09_DeleteAnalyzer, Sample10_AnalyzeConfigs, Sample11_AnalyzeReturnRawJson, Sample12_GetResultFile, Sample13_DeleteResult, Sample14_CopyAnalyzer, Sample15_GrantCopyAuth, and Sample16_CreateAnalyzerWithLabels to include logic for initializing the Content Understanding client with either an API key or the Default Azure Credential. - Added assertions to verify client initialization in each sample. - Improved code readability and maintainability by consolidating client creation logic.

…Builder Initialization

- Sample12_GetResultFile: Demonstrates how to retrieve keyframe images from video analysis operations. - Sample13_DeleteResult: Shows how to delete analysis results after they are no longer needed. - Sample14_CopyAnalyzer: Illustrates how to copy an analyzer within the same resource. - Sample15_GrantCopyAuth: Demonstrates granting copy authorization for cross-resource analyzer copying. - Sample16_CreateAnalyzerWithLabels: Shows how to create an analyzer with labeled training data from Azure Blob Storage.

…erstanding SDK

…opment

@disabled

- Delete 13 @disabled test files (replaced by Sample tests) - Modify Sample00-Sample16 to extend ContentUnderstandingClientTestBase - Add testResourceNamer for reproducible random IDs in PLAYBACK mode - Remove problematic sanitizers (AZSDK2003, AZSDK2030, AZSDK3423, AZSDK3430, AZSDK3493) - Configure maven-surefire-plugin to include Sample*.java - Use AZURE_CONTENT_UNDERSTANDING_ENDPOINT env var (matches .NET naming)

Exclude src/samples/.../samples/Sample*.java standalone examples from test execution.

- Fixed URI mismatch issue where recorded URLs had double slashes (//contentunderstanding) - Updated assets.json to point to new recordings tag (3de1635cfc) - All 23 tests pass in PLAYBACK mode

…tag _41c669f1bc

@OverRide

…ple reliability (#47959) * Initial plan * Address review comments: fix error message formatting, unused imports, missing @OverRide, and use deterministic waiting in async sample Co-authored-by: changjian-wang <15209050+changjian-wang@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: changjian-wang <15209050+changjian-wang@users.noreply.github.com>

@OverRide

- Add fixGeneratedPollingStrategyCode to customization: replaces String.valueOf(PollingUtils.OPERATION_LOCATION_HEADER) with PollingUtils.OPERATION_LOCATION_HEADER.getCaseSensitiveName() - Fix error message comma in OperationLocationPollingStrategy - Remove @OverRide from getResult in SyncOperationLocationPollingStrategy - Fix ObjectField NoSuchElementException formatting

Copilot

Pull request overview

Copilot reviewed 110 out of 180 changed files in this pull request and generated 5 comments.

...src/samples/java/com/azure/ai/contentunderstanding/samples/Sample00_UpdateDefaultsAsync.java

...ng/src/samples/java/com/azure/ai/contentunderstanding/samples/Sample06_GetAnalyzerAsync.java

...entunderstanding/src/main/java/com/azure/ai/contentunderstanding/models/KnowledgeSource.java

...tunderstanding/src/main/java/com/azure/ai/contentunderstanding/models/DocumentParagraph.java

sdk/contentunderstanding/azure-ai-contentunderstanding/pom.xml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…n/java/com/azure/ai/contentunderstanding/models/KnowledgeSource.java Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…n/java/com/azure/ai/contentunderstanding/models/DocumentParagraph.java Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

changjian-wang · 2026-02-10T11:04:53Z

@copilot open a new pull request to apply changes based on the comments in this thread

Copilot · 2026-02-10T11:05:04Z

@changjian-wang I've opened a new pull request, #47964, to work on those changes. Once the pull request is ready, I'll request review from you.

…n completion

Copilot

Pull request overview

Copilot reviewed 110 out of 180 changed files in this pull request and generated 6 comments.

...derstanding/src/main/java/com/azure/ai/contentunderstanding/implementation/PollingUtils.java

...contentunderstanding/src/main/java/com/azure/ai/contentunderstanding/models/ObjectField.java

...ontentunderstanding/src/main/java/com/azure/ai/contentunderstanding/models/BooleanField.java

...src/samples/java/com/azure/ai/contentunderstanding/samples/Sample00_UpdateDefaultsAsync.java

...ng/src/samples/java/com/azure/ai/contentunderstanding/samples/Sample06_GetAnalyzerAsync.java

Copilot · 2026-02-10T14:43:56Z

@yungshinlintw I've opened a new pull request, #47966, to work on those changes. Once the pull request is ready, I'll request review from you.

…ples/java/com/azure/ai/contentunderstanding/samples/Sample06_GetAnalyzerAsync.java Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…ples/java/com/azure/ai/contentunderstanding/samples/Sample00_UpdateDefaultsAsync.java Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…Understanding SDK

* Initial plan * Remove System.exit(1) from async samples Co-authored-by: yungshinlintw <14239352+yungshinlintw@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: yungshinlintw <14239352+yungshinlintw@users.noreply.github.com>

.github/CODEOWNERS

…service

The method matched 4-param beginAnalyze and 5-param beginAnalyzeBinary which no longer exist in generated code. It was a no-op. The actual utf16 hardcoding is handled by addBeginAnalyzeConvenienceOverloads and addBeginAnalyzeBinaryConvenienceOverloads.

…ssage formatting

azure-sdk and others added 30 commits December 3, 2025 22:19

Merge remote-tracking branch 'origin/main' into sdkauto/azure-ai-cont…

876170a

…entunderstanding-5634426

SDK-GEN: Re-generate SDK based on commmit e11e268a65224bd90f3aa450d44…

c8df6ad

…ca4b0e1d5ed1c

Add sample tests for configuring defaults and analyzing binary docume…

72993cc

…nts in Content Understanding SDK

[ContentUnderstanding] Add Sample09_DeleteAnalyzer

3495c1f

[ContentUnderstanding] Fix Sample09 and remove incompatible Sample10-16

5be60e5

Add Sample10_AnalyzeConfigs and Sample11_AnalyzeReturnRawJson

fc4a36b

Add Sample12_GetResultFile and Sample13_DeleteResult

a101b28

Add Sample14_CopyAnalyzer, Sample15_GrantCopyAuth, and Sample16_Creat…

cbdc2ad

…eAnalyzerWithLabels

Update Content Understanding Samples to Use DefaultAzureCredential fo…

984b4df

…r Authentication

Update analyzer copy endpoint to use simplified path and expand expec…

24a9ff7

…ted responses

Enhance verification steps in Sample14_CopyAnalyzer to ensure accurat…

5fefcc3

…e validation of source and copied analyzers

Refactor Content Understanding Samples to Use Single Line for Client …

aad4f2e

…Builder Initialization

Update assets.json to include specific tag for content understanding SDK

fedf711

Update sample file paths and add new sample documents for content und…

dd8ebf3

…erstanding SDK

Disable JaCoCo coverage and Checkstyle for beta.1 - tests under devel…

8467d24

…opment

Fix JaCoCo coverage values: use 0 instead of 0.00

420cb89

Add UPCA and UPCE barcode terms to spelling dictionary

e2af7aa

Fix surefire include pattern to only match generated/Sample*.java

bea9203

Exclude src/samples/.../samples/Sample*.java standalone examples from test execution.

Fix double-slash issue in test recordings for Content Understanding

61fc2a3

- Fixed URI mismatch issue where recorded URLs had double slashes (//contentunderstanding) - Updated assets.json to point to new recordings tag (3de1635cfc) - All 23 tests pass in PLAYBACK mode

Fix double-slash issue in test recordings: update assets.json to new …

7b55d95

…tag _41c669f1bc

Strip trailing slash from endpoint to prevent double-slash in URLs

760866c

changjian-wang marked this pull request as ready for review February 10, 2026 09:03

changjian-wang marked this pull request as draft February 10, 2026 09:04

changjian-wang requested a review from Copilot February 10, 2026 10:59

Copilot AI reviewed Feb 10, 2026

View reviewed changes

changjian-wang and others added 3 commits February 10, 2026 19:03

Update sdk/contentunderstanding/azure-ai-contentunderstanding/pom.xml

a33390e

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update sdk/contentunderstanding/azure-ai-contentunderstanding/src/mai…

656d581

…n/java/com/azure/ai/contentunderstanding/models/KnowledgeSource.java Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update sdk/contentunderstanding/azure-ai-contentunderstanding/src/mai…

f14a45a

…n/java/com/azure/ai/contentunderstanding/models/DocumentParagraph.java Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI mentioned this pull request Feb 10, 2026

Fix async sample synchronization patterns with timeouts #47964

Draft

wangchangjian1130 added 2 commits February 10, 2026 19:39

Fix typos in DocumentParagraph and initialize kind in KnowledgeSource

6e6ba02

Refactor sample applications to use CountDownLatch for async operatio…

a627f43

…n completion

yungshinlintw requested a review from Copilot February 10, 2026 14:15

Copilot AI reviewed Feb 10, 2026

View reviewed changes

yungshinlintw marked this pull request as ready for review February 10, 2026 14:19

Copilot AI mentioned this pull request Feb 10, 2026

Remove System.exit(1) from async samples #47966

Merged

yungshinlintw and others added 2 commits February 10, 2026 09:43

Update sdk/contentunderstanding/azure-ai-contentunderstanding/src/sam…

656b892

…ples/java/com/azure/ai/contentunderstanding/samples/Sample06_GetAnalyzerAsync.java Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update sdk/contentunderstanding/azure-ai-contentunderstanding/src/sam…

73cf1eb

…ples/java/com/azure/ai/contentunderstanding/samples/Sample00_UpdateDefaultsAsync.java Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

yungshinlintw changed the title ~~[Draft] Content Understanding GA SDK for Java~~ Content Understanding GA SDK for Java Feb 10, 2026

Update version to 1.0.0 and finalize release notes for Azure Content …

fbab37e

…Understanding SDK

changjian-wang requested a review from a team as a code owner February 11, 2026 02:23

yungshinlintw reviewed Feb 11, 2026

View reviewed changes

.github/CODEOWNERS Outdated Show resolved Hide resolved

Changjian Wang and others added 4 commits February 11, 2026 15:04

Update CODEOWNERS to add additional owners for Content Understanding …

e10f302

…service

Remove fixGeneratedPollingStrategyCode method and related calls

c381b36

Fix generated polling strategy code for case sensitivity and error me…

52f3fb1

…ssage formatting

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Content Understanding GA SDK for Java #47952

Content Understanding GA SDK for Java #47952

Uh oh!

changjian-wang commented Feb 10, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

changjian-wang commented Feb 10, 2026

Uh oh!

Copilot AI commented Feb 10, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Feb 10, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Content Understanding GA SDK for Java #47952

Are you sure you want to change the base?

Content Understanding GA SDK for Java #47952

Uh oh!

Conversation

changjian-wang commented Feb 10, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

changjian-wang commented Feb 10, 2026

Uh oh!

Copilot AI commented Feb 10, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Feb 10, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants