chore: Deprecate invoke methods

[javier-aliaga]

Description

The guidance since 2023 has been to not use SDK invoke* methods for Service Invocation. However this has never been formalised by marking the methods as deprecated.

Instead it is recommended to use language native http clients and grpc clients for Service Invoke.

Factory methods in the SDK which return a native http/grpc client is fine too, and are not deprecated.

Issue reference

We strive to have all PR being opened based on an issue, where the problem or feature have been discussed prior to implementation.

Please reference the issue this PR will close: #1642

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

• Code compiles correctly
• Created/updated tests
• Extended the documentation

[siri-varma]

@javier-aliaga quick question, do we need to update the javadoc on the pr suggesting the new approach ? May be it would good to update the examples as well ?

[javier-aliaga]

@olitomlinson this will not be part of 1.17, as Siri pointed we have tests and examples to update and it will take some time to replace them. I will plan this for 1.18

[salaboy]

/LGTM

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 79.48%. Comparing base (5cca2f0) to head (1feb5cf).

Additional details and impacted files

@@             Coverage Diff              @@
##             master    #1666      +/-   ##
============================================
+ Coverage     79.46%   79.48%   +0.01%     
+ Complexity     2192     2191       -1     
============================================
  Files           237      237              
  Lines          6575     6575              
  Branches        729      729              
============================================
+ Hits           5225     5226       +1     
+ Misses          996      994       -2     
- Partials        354      355       +1     

☔ 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.