[fix][client] Add description method to ClientBuilder

[nodece]

Modifications

#20009 introduced the description(String) method, but it was not added to the ClientBuilder. As a result, it is currently impossible to set the description using PulsarClient.builder().description().

Modifications

• Add the description(String) method to ClientBuilder to support setting a client description through the builder API.

Documentation

• doc
• doc-required
• doc-not-needed
• doc-complete

[Copilot]

Pull Request Overview

This PR adds a missing description(String) method to the ClientBuilder interface and its implementation to enable setting client descriptions through the builder API. This fixes an issue where the description method was available in the client configuration but not exposed through the builder pattern.

• Adds the description(String) method to the ClientBuilder interface with proper documentation
• Implements the method in ClientBuilderImpl with validation logic
• Updates test code to use the builder API instead of casting to implementation class

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
pulsar-client-api/src/main/java/org/apache/pulsar/client/api/ClientBuilder.java	Adds the description(String) method signature and documentation to the interface
pulsar-client/src/main/java/org/apache/pulsar/client/impl/ClientBuilderImpl.java	Implements the description(String) method with validation and configuration setting
pulsar-broker/src/test/java/org/apache/pulsar/client/api/SimpleProducerConsumerTest.java	Updates test to use the public builder API instead of casting to implementation

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[lhotari]

LGTM

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 74.20%. Comparing base (415c6fa) to head (2618003).
⚠️ Report is 3 commits behind head on master.

Additional details and impacted files

@@             Coverage Diff              @@
##             master   #24728      +/-   ##
============================================
- Coverage     74.27%   74.20%   -0.08%     
+ Complexity    33569    33125     -444     
============================================
  Files          1896     1896              
  Lines        148111   148111              
  Branches      17164    17164              
============================================
- Hits         110009   109903     -106     
- Misses        29370    29418      +48     
- Partials       8732     8790      +58     

Flag	Coverage Δ
inttests	26.33% <ø> (-0.17%)	⬇️
systests	22.69% <ø> (+0.02%)	⬆️
unittests	73.71% <ø> (-0.09%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
...g/apache/pulsar/client/impl/ClientBuilderImpl.java	85.79% <ø> (ø)

... and 86 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.