Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/algolia/algoliasearch-client-java

⚡️ A fully-featured and blazing-fast Java API client to interact with Algolia.
https://github.com/algolia/algoliasearch-client-java

algolia algolia-api algolia-search api-client java java-8 search-engine

Last synced: about 11 hours ago
JSON representation

⚡️ A fully-featured and blazing-fast Java API client to interact with Algolia.

Awesome Lists containing this project

README

        



Algolia for Java

The perfect starting point to integrate Algolia within your Java project


CircleCI
Licence


Documentation
Community Forum
Stack Overflow
Report a bug
FAQ
Support

## ✨ Features

* Support Java 8 and above
* Asynchronous and synchronous methods to interact with Algolia's API
* Thread-safe clients
* Typed requests and responses

## 💡 Getting Started

To get started, add the algoliasearch-client-java dependency to your project, either with [Maven](Maven):

```java

com.algolia
algoliasearch
[4,)

```

or [Gradle](https://gradle.org/):

```java
dependencies {
implementation 'com.algolia:algoliasearch:4.+'
}
```

You can now import the Algolia API client in your project and play with it.

```java
import com.algolia.api.SearchClient;
import com.algolia.model.search.*;

SearchClient client = new SearchClient("YOUR_APP_ID", "YOUR_API_KEY");

// Add a new record to your Algolia index
client.saveObject("", Map.of("objectID", "id", "test", "val"));

// Poll the task status to know when it has been indexed
client.waitForTask("", response.getTaskID());

// Fetch search results, with typo tolerance
client.search(
new SearchMethodParams()
.setRequests(List.of(new SearchForHits().setIndexName("").setQuery("").setHitsPerPage(50))),
Hit.class
);
```

For full documentation, visit the **[Algolia Java API Client](https://www.algolia.com/doc/libraries/java/)**.

## ❓ Troubleshooting

Encountering an issue? Before reaching out to support, we recommend heading to our [FAQ](https://www.algolia.com/doc/api-client/troubleshooting/faq/java/) where you will find answers for the most common issues and gotchas with the client. You can also open [a GitHub issue](https://github.com/algolia/api-clients-automation/issues/new?assignees=&labels=&projects=&template=Bug_report.md)

## Contributing

This repository hosts the code of the generated Algolia API client for Java, if you'd like to contribute, head over to the [main repository](https://github.com/algolia/api-clients-automation). You can also find contributing guides on [our documentation website](https://api-clients-automation.netlify.app/docs/introduction).

## 📄 License

The Algolia Java API Client is an open-sourced software licensed under the [MIT license](LICENSE).