Files
tasks/tools/cassandra/handler.go
Kent GruberandGitHub eadf754dc8 Use better string splitting techniques where possible (#8226)
## What changed?

This PR aims to avoid usage of
[`strings.Split`](https://pkg.go.dev/strings#Split) where possible in
favor of better string splitting techniques, speficially:
[`strings.SplitN`](https://pkg.go.dev/strings#SplitN) and
[`strings.SplitSeq`](https://pkg.go.dev/strings#SplitSeq) where
appropriate.

There was also a [`strings.Fields`](https://pkg.go.dev/strings#Fields)
change I made to use
[`strings.FieldsSeq`](https://pkg.go.dev/strings#FieldsSeq) instead, and
another for S3 to use the [`path`](https://pkg.go.dev/path) package
instead of [`strings.Split`](https://pkg.go.dev/strings#Split).

## Why?

[`strings.SplitN`](https://pkg.go.dev/strings#SplitN) and
[`strings.SplitSeq`](https://pkg.go.dev/strings#SplitSeq) are often
better options in many cases, and can be _partially_ detected using
[`modernize`](https://pkg.go.dev/golang.org/x/tools/gopls/internal/analysis/modernize):
> `stringsseq`: replace Split in "for range strings.Split(...)" by
go1.24's more efficient `SplitSeq`, or `Fields` with `FieldSeq`.

## How did you test it?
- [X] built
- [X] run locally and tested manually
- [x] covered by existing tests
- [x] added new unit test(s)
- [ ] added new functional test(s)

## Potential risks

There are lots of potentially subtle behaviors from the `strings.Split`
(and `strings.Fields`) usage that should be accounted for. If our
existing tests don't cover those subtleties, there's risk for
introducing an unintended bug. More intricate handling/parsing
previously using the `strings` package should get extra attention from
reviewers. I've attempted to break up my changes into logical commit
chunks to aid in review / help spot potentially concerning changes.
2025-08-26 13:23:40 -04:00

234 lines
6.8 KiB
Go

package cassandra
import (
"fmt"
"strings"
"github.com/urfave/cli"
"go.temporal.io/server/common/auth"
c "go.temporal.io/server/common/config"
"go.temporal.io/server/common/log"
"go.temporal.io/server/common/log/tag"
"go.temporal.io/server/temporal/environment"
"go.temporal.io/server/tools/common/schema"
)
const defaultNumReplicas = 1
// SetupSchemaConfig contains the configuration params needed to setup schema tables
type SetupSchemaConfig struct {
CQLClientConfig
schema.SetupConfig
}
// setupSchema executes the setupSchemaTask
// using the given command line arguments
// as input
func setupSchema(cli *cli.Context, logger log.Logger) error {
config, err := newCQLClientConfig(cli)
if err != nil {
logger.Error("Unable to read config.", tag.Error(schema.NewConfigError(err.Error())))
return err
}
client, err := newCQLClient(config, logger)
if err != nil {
logger.Error("Unable to establish CQL session.", tag.Error(err))
return err
}
defer client.Close()
if err := schema.Setup(cli, client, logger); err != nil {
logger.Error("Unable to setup CQL schema.", tag.Error(err))
return err
}
return nil
}
// updateSchema executes the updateSchemaTask
// using the given command line args as input
func updateSchema(cli *cli.Context, logger log.Logger) error {
config, err := newCQLClientConfig(cli)
if err != nil {
logger.Error("Unable to read config.", tag.Error(schema.NewConfigError(err.Error())))
return err
}
client, err := newCQLClient(config, logger)
if err != nil {
logger.Error("Unable to establish CQL session.", tag.Error(err))
return err
}
defer client.Close()
if err := schema.Update(cli, client, logger); err != nil {
logger.Error("Unable to update CQL schema.", tag.Error(err))
return err
}
return nil
}
func createKeyspace(cli *cli.Context, logger log.Logger) error {
config, err := newCQLClientConfig(cli)
if err != nil {
logger.Error("Unable to read config.", tag.Error(schema.NewConfigError(err.Error())))
return err
}
keyspace := cli.String(schema.CLIOptKeyspace)
if keyspace == "" {
err := fmt.Errorf("missing %s argument", flag(schema.CLIOptKeyspace))
logger.Error("Unable to read config.", tag.Error(schema.NewConfigError(err.Error())))
return err
}
err = doCreateKeyspace(config, keyspace, logger)
if err != nil {
logger.Error("Unable to create keyspace.", tag.Error(err))
return err
}
return nil
}
func dropKeyspace(cli *cli.Context, logger log.Logger) error {
config, err := newCQLClientConfig(cli)
if err != nil {
logger.Error("Unable to read config.", tag.Error(schema.NewConfigError(err.Error())))
return err
}
keyspace := cli.String(schema.CLIOptKeyspace)
if keyspace == "" {
err := fmt.Errorf("missing %s argument", flag(schema.CLIOptKeyspace))
logger.Error("Unable to read config.", tag.Error(schema.NewConfigError(err.Error())))
return err
}
err = doDropKeyspace(config, keyspace, logger)
if err != nil {
logger.Error("Unable to drop keyspace.", tag.Error(err))
return err
}
return nil
}
func validateHealth(cli *cli.Context, logger log.Logger) error {
config, err := newCQLClientConfig(cli)
if err != nil {
logger.Error("Unable to read config.", tag.Error(schema.NewConfigError(err.Error())))
return err
}
config.Keyspace = systemKeyspace
client, err := newCQLClient(config, logger)
if err != nil {
logger.Error("Unable to establish CQL session.", tag.Error(err))
return err
}
defer client.Close()
return nil
}
func doCreateKeyspace(cfg *CQLClientConfig, name string, logger log.Logger) error {
cfg.Keyspace = systemKeyspace
client, err := newCQLClient(cfg, logger)
if err != nil {
return err
}
defer client.Close()
return client.createKeyspace(name)
}
func doDropKeyspace(cfg *CQLClientConfig, name string, logger log.Logger) error {
cfg.Keyspace = systemKeyspace
client, err := newCQLClient(cfg, logger)
if err != nil {
return err
}
defer client.Close()
return client.dropKeyspace(name)
}
func newCQLClientConfig(cli *cli.Context) (*CQLClientConfig, error) {
config := &CQLClientConfig{
Hosts: cli.GlobalString(schema.CLIOptEndpoint),
Port: cli.GlobalInt(schema.CLIOptPort),
User: cli.GlobalString(schema.CLIOptUser),
Password: cli.GlobalString(schema.CLIOptPassword),
AllowedAuthenticators: cli.GlobalStringSlice(schema.CLIOptAllowedAuthenticators),
Timeout: cli.GlobalInt(schema.CLIOptTimeout),
Keyspace: cli.GlobalString(schema.CLIOptKeyspace),
numReplicas: cli.Int(schema.CLIOptReplicationFactor),
Datacenter: cli.String(schema.CLIOptDatacenter),
Consistency: cli.String(schema.CLIOptConsistency),
DisableInitialHostLookup: cli.GlobalBool(schema.CLIFlagDisableInitialHostLookup),
}
if cli.GlobalBool(schema.CLIFlagEnableTLS) {
config.TLS = &auth.TLS{
Enabled: true,
CertFile: cli.GlobalString(schema.CLIFlagTLSCertFile),
KeyFile: cli.GlobalString(schema.CLIFlagTLSKeyFile),
CaFile: cli.GlobalString(schema.CLIFlagTLSCaFile),
ServerName: cli.GlobalString(schema.CLIFlagTLSHostName),
EnableHostVerification: !cli.GlobalBool(schema.CLIFlagTLSDisableHostVerification),
}
}
config.AddressTranslator = &c.CassandraAddressTranslator{
Translator: cli.GlobalString(schema.CLIOptAddressTranslator),
Options: parseOptionsMap(cli.GlobalString(schema.CLIOptAddressTranslatorOptions)),
}
if err := validateCQLClientConfig(config); err != nil {
return nil, err
}
return config, nil
}
func parseOptionsMap(value string) map[string]string {
if len(value) == 0 {
return make(map[string]string)
}
parsedMap := make(map[string]string)
for pair := range strings.SplitSeq(value, ",") {
trimmedPair := strings.ReplaceAll(pair, " ", "")
if len(trimmedPair) == 0 {
continue
}
splitPair := strings.Split(trimmedPair, "=")
if len(splitPair) != 2 {
continue
}
if len(splitPair[0]) == 0 || len(splitPair[1]) == 0 {
continue
}
parsedMap[splitPair[0]] = splitPair[1]
}
return parsedMap
}
func validateCQLClientConfig(config *CQLClientConfig) error {
if len(config.Hosts) == 0 {
return schema.NewConfigError("missing cassandra endpoint argument " + flag(schema.CLIOptEndpoint))
}
if config.Keyspace == "" {
return schema.NewConfigError("missing " + flag(schema.CLIOptKeyspace) + " argument ")
}
if config.Port == 0 {
config.Port = environment.GetCassandraPort()
}
if config.numReplicas == 0 {
config.numReplicas = defaultNumReplicas
}
if config.AddressTranslator != nil && len(config.AddressTranslator.Options) != 0 {
if len(config.AddressTranslator.Translator) == 0 {
return schema.NewConfigError("missing address translator argument " + flag(schema.CLIOptAddressTranslator))
}
}
return nil
}
func flag(opt string) string {
return "(-" + opt + ")"
}