Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Conversation

@jeremyprime
Copy link
Collaborator

@jeremyprime jeremyprime commented Oct 23, 2025

Summary

Updated top-level README.md (changed from adoc to md, and updated to reflect Valkey instead of Redis), removed Redis-specific CONTRIBUTING.adoc and SECURITY.adoc, and added MIGRATION.md.

This PR closes #7.

Testing

Tested following the migration guide steps for some custom examples, as well as a set of Spring Data Redis examples.

Current limitations:

  • Some methods have not been implemented in the Valkey GLIDE driver, so refactoring of the driver usage is required rather than simple migration (or some functionality is simply not possible at this time)
  • Cluster, PubSub, Reactive, and some other features are not yet supported, so they could not be tested as part of migration
  • Spring Boot is not supported, which means dependency management and Configuration must be done manually (and this causes conflicts with projects that already use Spring Boot)

Next Steps

Next up is to rebrand/rewrite the full documentation (see src/main/antora). This will require aligning with how other Valkey documentation is generated and published.

Signed-off-by: Jeremy Parr-Pearson <[email protected]>
Signed-off-by: Jeremy Parr-Pearson <[email protected]>
Signed-off-by: Jeremy Parr-Pearson <[email protected]>
Signed-off-by: Jeremy Parr-Pearson <[email protected]>
Signed-off-by: Jeremy Parr-Pearson <[email protected]>
Signed-off-by: Jeremy Parr-Pearson <[email protected]>
@jeremyprime jeremyprime marked this pull request as ready for review October 30, 2025 18:40
Comment on lines +9 to +22
* Connection package as low-level abstraction across multiple drivers ([Valkey GLIDE](https://github.com/valkey-io/valkey-glide), [Lettuce](https://github.com/lettuce-io/lettuce-core), and [Jedis](https://github.com/redis/jedis)).
* Exception translation to Spring's portable Data Access exception hierarchy for driver exceptions.
* `ValkeyTemplate` that provides a high level abstraction for performing various Valkey operations, exception translation and serialization support.
* Pubsub support (such as a MessageListenerContainer for message-driven POJOs).
* Valkey Sentinel and Valkey Cluster support.
* Reactive API using Lettuce.
* JDK, String, JSON and Spring Object/XML mapping serializers.
* JDK Collection implementations on top of Valkey.
* Atomic counter support classes.
* Sorting and Pipelining functionality.
* Dedicated support for SORT, SORT/GET pattern and returned bulk values.
* Valkey implementation for Spring cache abstraction.
* Automatic implementation of `Repository` interfaces including support for custom finder methods using `@EnableValkeyRepositories`.
* CDI support for repositories.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is just a rebranding of the existing Redis feature list. Wasn't sure which items to remove or alter.

While updating dependencies and adding new configurations must be done manually, the renaming of packages and classes can be automated with a script. Here's an example using `sed`:

```bash
find path/to/project -type f \( -name "*.java" -o -name "*.properties" -o -name "*.yml" \) -exec sed -i \
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's hard to come up with a comprehensive script since there are so many classes, and some things like dependency management and Spring configuration are not simple replacements. But I was able to use this command to get most of the way there by updating package names and most class names when I was testing migration of a few example projects.

@jeremyprime jeremyprime requested a review from ikolomi October 30, 2025 18:45
@jeremyprime jeremyprime merged commit 964ae2e into valkey-io:main Nov 3, 2025
40 of 42 checks passed
@jeremyprime jeremyprime deleted the min_docs branch November 3, 2025 16:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Minimal docs for Alpha

2 participants