{"id":15013820,"url":"https://github.com/hazelcast/quarkus-hazelcast-client","last_synced_at":"2025-04-03T02:10:19.747Z","repository":{"id":37830874,"uuid":"245388716","full_name":"hazelcast/quarkus-hazelcast-client","owner":"hazelcast","description":"Quarkus Hazelcast Client Extension","archived":false,"fork":false,"pushed_at":"2024-08-28T02:54:35.000Z","size":424,"stargazers_count":44,"open_issues_count":12,"forks_count":12,"subscribers_count":31,"default_branch":"master","last_synced_at":"2025-03-26T19:10:47.446Z","etag":null,"topics":["hacktoberfest","hazelcast-client","quarkus"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hazelcast.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.MD","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-06T10:15:36.000Z","updated_at":"2025-03-26T01:32:52.000Z","dependencies_parsed_at":"2023-02-17T13:16:03.307Z","dependency_job_id":"ced14c83-02ae-4fad-9c8e-ee4a29131822","html_url":"https://github.com/hazelcast/quarkus-hazelcast-client","commit_stats":{"total_commits":291,"total_committers":12,"mean_commits":24.25,"dds":0.4914089347079038,"last_synced_commit":"83335ee00b4f6100f3403bd605eb44ee36e586e0"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hazelcast%2Fquarkus-hazelcast-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hazelcast%2Fquarkus-hazelcast-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hazelcast%2Fquarkus-hazelcast-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hazelcast%2Fquarkus-hazelcast-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hazelcast","download_url":"https://codeload.github.com/hazelcast/quarkus-hazelcast-client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246922247,"owners_count":20855345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","hazelcast-client","quarkus"],"created_at":"2024-09-24T19:44:49.219Z","updated_at":"2025-04-03T02:10:19.730Z","avatar_url":"https://github.com/hazelcast.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hazelcast Client for Quarkus\n\n\u003ca href=\"https://github.com/actions/toolkit\"\u003e\u003cimg alt=\"GitHub Actions status\" src=\"https://github.com/hazelcast/quarkus-hazelcast-client/workflows/CI/badge.svg\"\u003e\u003c/a\u003e\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.hazelcast/quarkus-hazelcast-client/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.hazelcast/quarkus-hazelcast-client) \n\n[Hazelcast IMDG](https://hazelcast.com/products/imdg/) is a distributed in-memory object store and compute engine that supports a wide variety of data structures such as Map, Set, List, MultiMap, RingBuffer, HyperLogLog. \n\nUse Hazelcast IMDG to store your data in RAM, spread and replicate it across a cluster of machines, and perform data-local computation on it. \n\nHazelcast is:\n- cloud and Kubernetes friendly\n- often used as a Distributed Cache amongst other use cases\n\nSee the official guide [here](https://guides.hazelcast.org/hazelcast-client-quarkus/).\n\n## Features\n- The HazelcastInstance bean is initialized lazily by Quarkus, if you want eager initialization, make sure to double-check [Quarkus Documentation](https://quarkus.io/guides/cdi-reference#eager-instantiation-of-beans). \n\n## Configuration\n\nAfter configuring `quarkus-universe BOM`:\n\n    \u003cdependencyManagement\u003e\n        \u003cdependencies\u003e\n            \u003cdependency\u003e\n                \u003cgroupId\u003eio.quarkus\u003c/groupId\u003e\n                \u003cartifactId\u003equarkus-universe-bom\u003c/artifactId\u003e\n                \u003cversion\u003e${insert.newest.quarkus.version.here}\u003c/version\u003e\n                \u003ctype\u003epom\u003c/type\u003e\n                \u003cscope\u003eimport\u003c/scope\u003e\n            \u003c/dependency\u003e\n        \u003c/dependencies\u003e\n    \u003c/dependencyManagement\u003e\n\nYou can just configure the `hazelcast-client` extension by adding the following dependency:\n\n    \u003cdependency\u003e\n        \u003cgroupId\u003ecom.hazelcast\u003c/groupId\u003e\n        \u003cartifactId\u003equarkus-hazelcast-client\u003c/artifactId\u003e\n    \u003c/dependency\u003e\n    \n***NOTE:*** You can bootstrap a new application quickly by using [code.quarkus.io](https://code.quarkus.io) and choosing `quarkus-hazelcast-client`\n    \n### Quarkus hazelcast-client configuration\n\nThe extension exposes a single native-mode-compatible Hazelcast Client bean (`HazelcastInstance`) which can be directly injected into your beans:\n\n    private final HazelcastInstance hazelcastInstance;\n    \n    public UsersService(HazelcastInstance hazelcastInstance) {\n        this.hazelcastInstance = hazelcastInstance;\n    }\n\nBy default, client will try to connect to a Hazelcast instance running on the host using port 5701.\n\nDefaults can be customized using `application.properties` entries such as:\n\n    quarkus.hazelcast-client.cluster-members\n    quarkus.hazelcast-client.outbound-port-definitions\n    quarkus.hazelcast-client.outbound-ports\n    quarkus.hazelcast-client.cluster-name\n    quarkus.hazelcast-client.labels\n    quarkus.hazelcast-client.connection-timeout\n\nFor example:\n\n    quarkus.hazelcast-client.cluster-members=localhost:5701\n    \nIf you don't provide a port number, Hazelcast Client will try to autodetect it:\n\n    quarkus.hazelcast-client.cluster-members=localhost\n    \nYou can also pass a comma-separate list of values as a single entry:\n    \n    quarkus.hazelcast-client.cluster-members=localhost:5701,localhost:5702\n    \nIf you need more, use a standard `hazelcast-client.yml/hazelcast-client.xml`-based configuration (described below) or wire-up your own `HazelcastInstance` bean. \n\nKeep in mind that you will still be able to benefit from GraalVM compatibility!\n\n### Configuration Files\n\n#### Configuration using `hazelcast-client.yml` or `hazelcast-client.xml`\n\nIn order to configure the client using the `hazelcast-client.yml`/`hazelcast-client.xml` file, place the configuration file in the `src/main/resources` directory.\n\nKeep in mind that configuration entries from `hazelcast-client.yml/xml` are overridden by `quarkus.hazelcast-client.*` entries \nso it's a good idea to stick to one of these exclusively.\n\n## Testing\n\nTo make testing simple, the extension provides the `HazelcastServerTestResource` which automatically launches an embedded Hazelcast instance with defaults settings and manages its lifecycle:\n\n     @QuarkusTest\n     @QuarkusTestResource(HazelcastServerTestResource.class)\n     public class HazelcastAwareTest {\n\n         @Test\n         public void test() {\n             // you can safely call embedded Hazelcast instance from here\n         }\n     }\n     \n#### Maven dependency:\n\n    \u003cdependency\u003e\n        \u003cgroupId\u003eio.quarkus\u003c/groupId\u003e\n        \u003cartifactId\u003equarkus-test-hazelcast\u003c/artifactId\u003e\n        \u003cscope\u003etest\u003c/scope\u003e\n    \u003c/dependency\u003e\n    \n## Compatibility Matrix\n\n- `1.0.x` is compatible with Quarkus 1.6.x-1.7.x (no longer maintained)\n- `1.1.1` is compatible with Quarkus 1.8.x+ and Hazelcast 4.0.x and 4.1.x and JDK 8+\n- `1.2.0` is compatible with Quarkus 1.13.x+ and Hazelcast 4.x and JDK 8+\n- `3.0.0` is compatible with Quarkus 2.x+ and Hazelcast 4.x and JDK 8+\n- `4.0.0` is compatible with Quarkus 3.x+ and Hazelcast 4.x and JDK 11+\n\n## Limitations (native mode)\nThere's no support for:\n- Default Java serialization\n- User code deployment\n- Hazelcast SPI support on OSGi\n- JCache integration\n- JMX\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhazelcast%2Fquarkus-hazelcast-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhazelcast%2Fquarkus-hazelcast-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhazelcast%2Fquarkus-hazelcast-client/lists"}