Skip to content

Latest commit

 

History

History
38 lines (31 loc) · 1.66 KB

ignite.md

File metadata and controls

38 lines (31 loc) · 1.66 KB
Raw

Apache Ignite integration

Before use bucket4j-ignite module please read bucket4j-jcache documentation, because bucket4j-ignite is just a follow-up of bucket4j-jcache.

Question: Bucket4j already supports JCache since version 1.2. Why it was needed to introduce direct support for Apache Ignite?
Answer: Because JCache API (JSR 107) does not specify asynchronous API, developing the dedicated module bucket4j-ignite was the only way to provide asynchrony for users who use Bucket4j and Apache Ignite together.

Question: Should I migrate from bucket4j-jcache to bucketj-ignite If I do not need in asynchronous API?
Answer: No, you should not migrate to bucketj-ignite in this case.

Dependencies

To use bucket4j-ignite extension you need to add following dependency:

<dependency>
    <groupId>com.github.vladimir-bukhtoyarov</groupId>
    <artifactId>bucket4j-ignite</artifactId>
    <version>${bucket4j.version}</version>
</dependency>

Example of Bucket instantiation

org.apache.ignite.IgniteCache<K, GridBucketState> cache = ...;
...

Bucket bucket = Bucket4j.extension(io.github.bucket4j.grid.ignite.Ignite.class).builder()
                   .addLimit(Bandwidth.simple(1_000, Duration.ofMinutes(1)))
                   .build(cache, key, RecoveryStrategy.RECONSTRUCT);

Example of ProxyManager instantiation

org.apache.ignite.IgniteCache<K, GridBucketState> cache = ...;
...

ProxyManager proxyManager = Bucket4j.extension(io.github.bucket4j.grid.ignite.Ignite.class).proxyManagerForCache(cache);