Skip to content

Coherence Go Client - v2.0.0-rc1

Pre-release
Pre-release
Compare
Choose a tag to compare
@tmiddlet2666 tmiddlet2666 released this 05 Dec 06:44
· 12 commits to main since this release
v2.0.0-rc1
a2705c6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.

Introduction

This is release v2.0.0-rc1 of the Coherence Go Client, an API for accessing Coherence via a native Go client.

Note: this is a release candidate only and functionality may be changes before the official v2.0.0 release.

Requirements

  • Coherence CE 22.06.4+, 24.03+, or Coherence 14.1.1.2206.4+ Commercial edition with a configured gRPCProxy. (Always ensure you are using the latest Coherence available patch.)
  • Go 1.19.+

Updates / New Features

  • Added support for new internal gRPC v1 API in CE 24.09 and commercial 14.1.2 and above. No changes are required in code, the Go client will automatically detect the new version and is backwardly compatible with existing supported versions . This version hardens event processing and adds support for proper implementation queues and other future protocols.
  • Added the ability to specify a pruneFactor (defaults to 0.8 or 80%) for a near cache. This indicates the percentage of the total number of units that will remain after the cache manager prunes the near cache(i.e. this is the "low watermark" value)
  • Updated Queue API - This update provides a more stable API and adds support for the following queue types
    • Queue - a simple queue which stores data in a single partition and is limited to approx 2GB of storage.
    • PagedQueue - a queue which distributes data over the cluster and is only limited by the cluster capacity.
    • Dequeue - a simple double-ended queue that stores data in a single partition

Note: The queue API has changed and you will need to update your code. See breaking changes below.

Breaking Changes

Queues

  • In this release, the queues API has been rewritten based upon the above internal gRPC v1 API. This was done to improve reliability, and prepare for support for other protocols in the future and Queues were affected.
This means that Queues in v2.0.0+ of the coherence-go-client it will only work against CE 24.09+ or Commercial 14.1.2.0+ Coherence versions
  • If you wish to use the old queue API <v2.0.0 , it will only work against Coherence CE 24.03

Other Breaking Changes

To ensure compatibility with other Coherence API's, the following functions now return channels of StreamedEntry[K, R] rather than StreamedValue[R]. You will need to change any code that uses the following API's:

  • InvokeAllFilter[K comparable, V any, R any] - now returns <-chan *StreamedEntry[K, R]
  • InvokeAllKeys[K comparable, V any, R any] - now returns <-chan *StreamedEntry[K, R]

Bug Fixes

  • Fixed an issue where the resolve would not resolve addresses correctly on failover

Documentation

Getting Started

go get github.com/oracle/coherence-go-client/[email protected]

What's Changed

Full Change log: v1.2.2...v2.0.0-rc1

Contributors

tmiddlet2666
Assets 2
Loading