Add retry support

[niveathika]

Purpose

Fixes ballerina-platform/ballerina-library#8585

Examples

Checklist

• Linked to an issue
• Updated the changelog
• Added tests
• Updated the spec
• Checked native-image compatibility

[codecov]

Codecov Report

❌ Patch coverage is 72.17391% with 32 lines in your changes missing coverage. Please review.
✅ Project coverage is 80.38%. Comparing base (9898a6a) to head (ebe3428).
⚠️ Report is 12 commits behind head on master.

Files with missing lines	Patch %	Lines
...java/io/ballerina/stdlib/ftp/client/FtpClient.java	72.05%	12 Missing and 7 partials ⚠️
...io/ballerina/stdlib/ftp/client/FtpRetryHelper.java	80.00%	7 Missing and 1 partial ⚠️
.../exception/FtpAllRetryAttemptsFailedException.java	0.00%	5 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##             master    #1531      +/-   ##
============================================
- Coverage     80.74%   80.38%   -0.36%     
- Complexity      816      831      +15     
============================================
  Files            61       63       +2     
  Lines          3620     3712      +92     
  Branches        609      621      +12     
============================================
+ Hits           2923     2984      +61     
- Misses          437      461      +24     
- Partials        260      267       +7     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

This PR adds automatic retry support with exponential backoff for FTP client read operations. When configured, the client will automatically retry failed read operations (getBytes, getText, getJson, getXml, getCsv) with configurable retry count, interval, backoff factor, and maximum wait interval.

Changes:

• Added RetryConfig record type with configurable retry parameters (count, interval, backOffFactor, maxWaitInterval)
• Implemented retry logic with exponential backoff in FtpRetryHelper class
• Added new AllRetryAttemptsFailedError error type for when all retry attempts are exhausted
• Wrapped all typed read operations (getBytes, getText, getJson, getXml, getCsv) with retry logic
• Added comprehensive tests covering successful operations with retry config, retry exhaustion scenarios, and configuration validation

Reviewed changes

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

Show a summary per file

File	Description
ballerina/commons.bal	Added RetryConfig record type definition with default values
ballerina/client_endpoint.bal	Added optional retryConfig field to ClientConfiguration
ballerina/error.bal	Added AllRetryAttemptsFailedError distinct error type
ballerina/tests/retry_test.bal	Added comprehensive retry behavior tests including success and failure scenarios
ballerina/tests/client_endpoint_test.bal	Updated test expectations to include new retry directory
native/src/main/java/io/ballerina/stdlib/ftp/client/FtpClient.java	Wrapped typed read operations with retry logic and stored retry config in native data
native/src/main/java/io/ballerina/stdlib/ftp/client/FtpRetryHelper.java	Implemented core retry logic with exponential backoff
native/src/main/java/io/ballerina/stdlib/ftp/exception/FtpAllRetryAttemptsFailedException.java	Added exception class for retry exhaustion
native/src/main/java/io/ballerina/stdlib/ftp/util/FtpConstants.java	Added retry-related constants
native/src/main/java/io/ballerina/stdlib/ftp/util/FtpUtil.java	Added AllRetryAttemptsFailedError enum value
test-utils/src/main/java/io/ballerina/stdlib/ftp/testutils/mockServerUtils/MockFtpServer.java	Added retry test directory and file to mock server
docs/spec/spec.md	Documented retry configuration and usage examples
changelog.md	Added changelog entry for retry feature

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 1 comment.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud