Coherence Go Client - v1.0.1

Introduction

This is release v1.0.1 of the Coherence Go Client, an API for accessing Coherence caches via native Go client.

Documentation

• Godoc on pkg.go.dev
• FAQ Page
• Comprehensive Examples
• README on GtiHub

Requirements

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

Getting Started

go get github.com/oracle/coherence-go-client@latest

After executing this command coherence-go-client is ready to use, and it's source will be in:

$GOPATH/pkg/mod/github.com/oracle/coherence-go-client@latest

New features since v1.0.0

• Added the IsReady() function to determine if the NamedCache or NamedMap is ready to accept requests. An example of when this method would return false would be where a partitioned cache service that owns this cache has no storage-enabled members. This call is only available when connecting to CE 23.03.1+, CE 22.06.05+ and commercial version 14.1.1-2206-5+
• Added the the following options to NewSession to allow for setting ot TLS options:
  • WithTLSConfig() allows you to set a specific tls.Config when you require fine grained control
  • WithTLSClientCert(), WithTLSClientKey() and WithTLSCertsPath() allows you to set TLS options directly when creating a session rather than relying on environment variables
• Additional CI tests against various Go versions

Fixed Issues since v1.0.0

• Fix a number of issues with timeouts when reconnecting to gRPC proxy servers.

All changes since v1.0.0

v1.0.0...v1.0.1

Coherence Go Client - v1.0.0

Introduction

This is the official v1.0.0 release of the Coherence Go Client, an API for accessing Coherence caches via native Go client.

Documentation

• Godoc on pkg.go.dev
• FAQ Page
• Comprehensive Examples
• README on GtiHub

Requirements

• Coherence CE 22.06.4+ or Coherence 14.1.1.2206.4+ Commercial edition with a configured gRPCProxy.
• Go 1.19.+

Getting Started

go get github.com/oracle/coherence-go-client@latest

After executing this command coherence-go-client is ready to use, and it's source will be in:

$GOPATH/pkg/mod/github.com/oracle/coherence-go-client@latest

New features since 1.0.0-rc3

• Changed the COHERENCE_SESSION_TIMEOUT env var to COHERENCE_CLIENT_REQUEST_TIMEOUT to match other gRPC clients see here for details.
• Added the ability to wait for a connection to be ready rather that fail fast, which is the default. See here for details
• Added the ability to control the maximum amount of time, in milliseconds, a Session may remain in a disconnected state
  without successfully reconnecting. See here for details.

Fixed Issues since 1.0.0-rc3

N/A

Coherence Go Client - v1.0.0-rc3

Introduction

This is the third release candidate (v1.0.0-rc3) of the Coherence Go Client, an API for accessing Coherence caches via native Go client.

Documentation

• Godoc on pkg.go.dev
• FAQ Page
• Comprehensive Examples
• README on GtiHub

Requirements

• Coherence CE 22.06.4+ or Coherence 14.1.1.2206.4+ Commercial edition with a configured gRPCProxy.
• Go 1.19.+

Getting Started

go get github.com/oracle/coherence-go-client@latest

After executing this command coherence-go-client is ready to use, and it's source will be in:

$GOPATH/pkg/mod/github.com/oracle/coherence-go-client@latest

New features since 1.0.0-rc2

• Added the ability to specify a session timeout using either coherence.WithSessionTimeout session option, providing a Context that has a deadline or specifying the COHERENCE_SESSION_TIMEOUT environment variable. See here for more details.
• Minor updates to examples

Fixed Issues since 1.0.0-rc2

• Fixed an issue where a session would never exit if the underlying gRPC server died

Coherence Go Client - v1.0.0-rc2

Introduction

This is the second release candidate (v1.0.0-rc2) of the Coherence Go Client, an API for accessing Coherence caches via native Go client.

Documentation

• Godoc on pkg.go.dev
• FAQ Page
• Comprehensive Examples
• README on GtiHub

Requirements

• Coherence CE 22.06.4+ or Coherence 14.1.1.2206.4+ Commercial edition with a configured gRPCProxy.
• Go 1.19.+

Getting Started

go get github.com/oracle/coherence-go-client@latest

After executing this command coherence-go-client is ready to use, and it's source will be in:

$GOPATH/pkg/mod/github.com/oracle/coherence-go-client@latest

Breaking changes from 1.0.0-rc1

• Renamed NewNameMap and NewNamedCache to GetNamedMap and GetNamedCache respectively to more accurately reflect their meaning and usage

Fixed Issues

• Fixed an issue where filters with extractors that return bool may return the wrong values

Coherence Go Client - v1.0.0-rc1

Introduction

This is the first release candidate (v1.0.0-rc1) of the Coherence Go Client, an API for accessing Coherence caches via native Go client.

Documentation

• Godoc on pkg.go.dev
• FAQ Page
• Comprehensive Examples
• README on GitHub

Requirements

• Coherence CE 22.06.4+ or Coherence 14.1.1.2206.4+ Commercial edition with a configured gRPCProxy.
• Go 1.19.+

Getting Started

go get github.com/oracle/[email protected]

After executing this command coherence-go-client is ready to use, and it's source will be in:

$GOPATH/pkg/mod/github.com/oracle/[email protected]

Known Issues

• Using filters with extractors that return bool may return the wrong values