{"id":13806744,"url":"https://github.com/dream11/vertx-aerospike-client","last_synced_at":"2025-07-20T08:06:16.839Z","repository":{"id":42373510,"uuid":"366925238","full_name":"dream11/vertx-aerospike-client","owner":"dream11","description":"Non-Blocking Rxified Vertx aerospike client","archived":false,"fork":false,"pushed_at":"2025-06-20T12:13:34.000Z","size":68,"stargazers_count":31,"open_issues_count":3,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-22T05:06:20.021Z","etag":null,"topics":["aerospike","reactive","rxjava2","vertx"],"latest_commit_sha":null,"homepage":"https://dream11.github.io/vertx-aerospike-client/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dream11.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-05-13T03:40:09.000Z","updated_at":"2025-05-14T10:33:07.000Z","dependencies_parsed_at":"2024-01-03T02:24:59.340Z","dependency_job_id":"adb55367-365c-424b-8781-863f06144a7f","html_url":"https://github.com/dream11/vertx-aerospike-client","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/dream11/vertx-aerospike-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dream11%2Fvertx-aerospike-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dream11%2Fvertx-aerospike-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dream11%2Fvertx-aerospike-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dream11%2Fvertx-aerospike-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dream11","download_url":"https://codeload.github.com/dream11/vertx-aerospike-client/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dream11%2Fvertx-aerospike-client/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266087790,"owners_count":23874519,"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":["aerospike","reactive","rxjava2","vertx"],"created_at":"2024-08-04T01:01:15.534Z","updated_at":"2025-07-20T08:06:16.815Z","avatar_url":"https://github.com/dream11.png","language":"Java","funding_links":[],"categories":["Database Clients"],"sub_categories":[],"readme":"# The Reactive Aerospike Client\n\n[![Continuous Integration](https://github.com/dream11/vertx-aerospike-client/actions/workflows/ci.yml/badge.svg)](https://github.com/dream11/vertx-aerospike-client/actions/workflows/ci.yml)\n[![Code Coverage](https://codecov.io/gh/dream11/vertx-aerospike-client/branch/master/graph/badge.svg)](https://codecov.io/gh/dream11/vertx-aerospike-client)\n![License](https://img.shields.io/badge/license-MIT-green.svg)\n\n## Overview\n\nThe Vert.x Aerospike client provides an asynchronous API to interact with aerospike server.\n(Internally uses [AerospikeClient's](https://www.aerospike.com/docs/client/java/) async commands and handles the result on vertx-context)\n\n## Usage\n\nAdd the following dependency to the *dependencies* section of your build descriptor:\n  \n- Maven (in your `pom.xml`):\n```xml\n  \u003cdependency\u003e\n    \u003cgroupId\u003eio.d11\u003c/groupId\u003e\n    \u003cartifactId\u003evertx-aerospike-client\u003c/artifactId\u003e\n    \u003cversion\u003eLATEST\u003c/version\u003e\n  \u003c/dependency\u003e\n```\n\n- Gradle (in your `build.gradle` file):\n```\n  dependencies {\n   compile 'io.d11:vertx-aerospike-client:x.y.z'\n  }\n```\n\n## Connecting to Aerospike\n\n```java\n  AerospikeConnectOptions connectOptions = new AerospikeConnectOptions()\n    .setHosts(\"my-host\")\n    .setEventLoopSize(16);\n\n  // create a shared aerospike client across vertx instance\n  AerospikeClient client = AerospikeClient.create(vertx, connectOptions);\n  \n  // create non shared aerospike client\n  AerospikeClient client = AerospikeClient.createNonShared(vertx, connectOptions);\n```\n\n## Configuration\n\nConfiguration options for `AerospikeConnectOptions`\n\n| Key | Default  | Type  | Required | Description |\n| --- | --- | --- | --- | --- |\n| host | localhost | String | false | Aerospike server host |\n| port | 3000 | Integer | false | Aerospike server port |\n| eventLoopSize | 2*\u003c#cores\u003e | Integer | false | Number of EventLoop threads |\n| maxCommandsInProcess | 100 | Integer | false | Maximum number of commands in process on each EventLoop thread |\n| maxCommandsInQueue | 0 | Integer | false | Maximum number of commands in each EventLoop's queue |\n| maxConnsPerNode | 2*\u003c#cores\u003e*100 | Integer | false | Maximum number of connections to one server node |\n| maxConnectRetries | 2 | Integer | false | Maximum number of retries to connect |\n| clientPolicy | \u003cClientPolicy with replica policy MASTER_PROLES\u003e | ClientPolicy | false | Aerospike client policy |\n\n### Note on Configuration options:\n* Do not set the clientPolicy.eventLoops. Use AerospikeConnectOptions to configure them.\n\n## Running queries\n\n```java\n  AerospikeClient client = AerospikeClient.create(vertx, connectOptions);\n  client\n    .rxGet(policy, key)\n    .map(record -\u003e {\n      // Handle record\n        })...\n```\n\nDetailed documentation can be found [here](https://javadoc.io/doc/io.d11/vertx-aerospike-client/latest/index.html).\n\n## Running the tests\n\nTo run the test suite:\n```shell\n  mvn clean verify\n```\nThe test suite runs a Docker container from image `aerospike/aerospike-server` using [TestContainers](https://www.testcontainers.org/)\nby default. \n\nTo run the test suite on a container built from a different docker image:\n```shell\n  mvn clean verify -Daerospike.image=\u003cimage\u003e\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdream11%2Fvertx-aerospike-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdream11%2Fvertx-aerospike-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdream11%2Fvertx-aerospike-client/lists"}