├── .gitignore
├── LICENSE
├── README.md
├── application
├── pom.xml
└── src
│ ├── main
│ ├── java
│ │ └── com
│ │ │ └── octoperf
│ │ │ ├── Application.java
│ │ │ └── ClusterController.java
│ └── resources
│ │ ├── application-hazelcast.yml
│ │ └── application.yml
│ └── test
│ └── java
│ └── com
│ └── octoperf
│ ├── ApplicationSpringTest.java
│ └── ApplicationTest.java
├── cluster-api
├── pom.xml
└── src
│ ├── main
│ └── java
│ │ └── com
│ │ └── octoperf
│ │ └── cluster
│ │ └── api
│ │ ├── AbstractClusteredQueue.java
│ │ ├── ClusteredAtomicLong.java
│ │ ├── ClusteredLock.java
│ │ ├── ClusteredMap.java
│ │ ├── ClusteredQueue.java
│ │ ├── ClusteredTopic.java
│ │ ├── ClusteringService.java
│ │ ├── DestroyableObject.java
│ │ ├── TopicMessage.java
│ │ ├── TopicMessageListener.java
│ │ └── package-info.java
│ └── test
│ └── java
│ └── com
│ └── octoperf
│ └── cluster
│ └── api
│ ├── AbstractClusteredAtomicLongTest.java
│ ├── AbstractClusteredLockTest.java
│ ├── AbstractClusteredMapTest.java
│ ├── AbstractClusteredQueueTest.java
│ ├── AbstractClusteredTopicTest.java
│ ├── AbstractClusteringServiceTest.java
│ ├── AbstractTopicMessageListenerTest.java
│ ├── ForwardingClusteredQueueTest.java
│ ├── TestForwardingClusteredQueue.java
│ └── TopicMessageTest.java
├── cluster-hazelcast
├── pom.xml
└── src
│ ├── main
│ └── java
│ │ └── com
│ │ └── octoperf
│ │ └── cluster
│ │ └── hazelcast
│ │ ├── HZQuorumListener.java
│ │ ├── HazelcastAtomicLong.java
│ │ ├── HazelcastClusteringService.java
│ │ ├── HazelcastConfig.java
│ │ ├── HazelcastHealthIndicator.java
│ │ ├── HazelcastLock.java
│ │ ├── HazelcastMap.java
│ │ ├── HazelcastQueue.java
│ │ ├── HazelcastQuorumListener.java
│ │ ├── HazelcastTopic.java
│ │ └── package-info.java
│ └── test
│ ├── java
│ └── com
│ │ └── octoperf
│ │ └── cluster
│ │ └── hazelcast
│ │ ├── Application.java
│ │ ├── HazelcastAtomicLongTest.java
│ │ ├── HazelcastClusteringServiceTest.java
│ │ ├── HazelcastConfigSpringTest.java
│ │ ├── HazelcastConfigTest.java
│ │ ├── HazelcastHealthIndicatorTest.java
│ │ ├── HazelcastLockTest.java
│ │ ├── HazelcastMapTest.java
│ │ ├── HazelcastQueueTest.java
│ │ ├── HazelcastQuorumListenerTest.java
│ │ └── HazelcastTopicTest.java
│ └── resources
│ └── application.yml
├── cluster-jvm
├── pom.xml
└── src
│ ├── main
│ └── java
│ │ └── com
│ │ └── octoperf
│ │ └── cluster
│ │ └── jvm
│ │ ├── JVMAtomicLong.java
│ │ ├── JVMClusteringService.java
│ │ ├── JVMLock.java
│ │ ├── JVMMap.java
│ │ ├── JVMQueue.java
│ │ └── JVMTopic.java
│ └── test
│ └── java
│ └── com
│ └── octoperf
│ └── cluster
│ └── jvm
│ ├── JVMAtomicLongTest.java
│ ├── JVMClusteringServiceTest.java
│ ├── JVMLockTest.java
│ ├── JVMMapTest.java
│ ├── JVMQueueTest.java
│ └── JVMTopicTest.java
└── pom.xml
/.gitignore:
--------------------------------------------------------------------------------
1 | target/
2 | pom.xml.tag
3 | pom.xml.releaseBackup
4 | pom.xml.versionsBackup
5 | pom.xml.next
6 | release.properties
7 | dependency-reduced-pom.xml
8 | buildNumber.properties
9 | .mvn/timing.properties
10 |
11 | # Avoid ignoring Maven wrapper jar file (.jar files are usually ignored)
12 | !/.mvn/wrapper/maven-wrapper.jar
13 |
14 | *.iml
15 |
16 | .idea
17 | .idea/
18 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Apache License
2 | Version 2.0, January 2004
3 | http://www.apache.org/licenses/
4 |
5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6 |
7 | 1. Definitions.
8 |
9 | "License" shall mean the terms and conditions for use, reproduction,
10 | and distribution as defined by Sections 1 through 9 of this document.
11 |
12 | "Licensor" shall mean the copyright owner or entity authorized by
13 | the copyright owner that is granting the License.
14 |
15 | "Legal Entity" shall mean the union of the acting entity and all
16 | other entities that control, are controlled by, or are under common
17 | control with that entity. For the purposes of this definition,
18 | "control" means (i) the power, direct or indirect, to cause the
19 | direction or management of such entity, whether by contract or
20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
21 | outstanding shares, or (iii) beneficial ownership of such entity.
22 |
23 | "You" (or "Your") shall mean an individual or Legal Entity
24 | exercising permissions granted by this License.
25 |
26 | "Source" form shall mean the preferred form for making modifications,
27 | including but not limited to software source code, documentation
28 | source, and configuration files.
29 |
30 | "Object" form shall mean any form resulting from mechanical
31 | transformation or translation of a Source form, including but
32 | not limited to compiled object code, generated documentation,
33 | and conversions to other media types.
34 |
35 | "Work" shall mean the work of authorship, whether in Source or
36 | Object form, made available under the License, as indicated by a
37 | copyright notice that is included in or attached to the work
38 | (an example is provided in the Appendix below).
39 |
40 | "Derivative Works" shall mean any work, whether in Source or Object
41 | form, that is based on (or derived from) the Work and for which the
42 | editorial revisions, annotations, elaborations, or other modifications
43 | represent, as a whole, an original work of authorship. For the purposes
44 | of this License, Derivative Works shall not include works that remain
45 | separable from, or merely link (or bind by name) to the interfaces of,
46 | the Work and Derivative Works thereof.
47 |
48 | "Contribution" shall mean any work of authorship, including
49 | the original version of the Work and any modifications or additions
50 | to that Work or Derivative Works thereof, that is intentionally
51 | submitted to Licensor for inclusion in the Work by the copyright owner
52 | or by an individual or Legal Entity authorized to submit on behalf of
53 | the copyright owner. For the purposes of this definition, "submitted"
54 | means any form of electronic, verbal, or written communication sent
55 | to the Licensor or its representatives, including but not limited to
56 | communication on electronic mailing lists, source code control systems,
57 | and issue tracking systems that are managed by, or on behalf of, the
58 | Licensor for the purpose of discussing and improving the Work, but
59 | excluding communication that is conspicuously marked or otherwise
60 | designated in writing by the copyright owner as "Not a Contribution."
61 |
62 | "Contributor" shall mean Licensor and any individual or Legal Entity
63 | on behalf of whom a Contribution has been received by Licensor and
64 | subsequently incorporated within the Work.
65 |
66 | 2. Grant of Copyright License. Subject to the terms and conditions of
67 | this License, each Contributor hereby grants to You a perpetual,
68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69 | copyright license to reproduce, prepare Derivative Works of,
70 | publicly display, publicly perform, sublicense, and distribute the
71 | Work and such Derivative Works in Source or Object form.
72 |
73 | 3. Grant of Patent License. Subject to the terms and conditions of
74 | this License, each Contributor hereby grants to You a perpetual,
75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76 | (except as stated in this section) patent license to make, have made,
77 | use, offer to sell, sell, import, and otherwise transfer the Work,
78 | where such license applies only to those patent claims licensable
79 | by such Contributor that are necessarily infringed by their
80 | Contribution(s) alone or by combination of their Contribution(s)
81 | with the Work to which such Contribution(s) was submitted. If You
82 | institute patent litigation against any entity (including a
83 | cross-claim or counterclaim in a lawsuit) alleging that the Work
84 | or a Contribution incorporated within the Work constitutes direct
85 | or contributory patent infringement, then any patent licenses
86 | granted to You under this License for that Work shall terminate
87 | as of the date such litigation is filed.
88 |
89 | 4. Redistribution. You may reproduce and distribute copies of the
90 | Work or Derivative Works thereof in any medium, with or without
91 | modifications, and in Source or Object form, provided that You
92 | meet the following conditions:
93 |
94 | (a) You must give any other recipients of the Work or
95 | Derivative Works a copy of this License; and
96 |
97 | (b) You must cause any modified files to carry prominent notices
98 | stating that You changed the files; and
99 |
100 | (c) You must retain, in the Source form of any Derivative Works
101 | that You distribute, all copyright, patent, trademark, and
102 | attribution notices from the Source form of the Work,
103 | excluding those notices that do not pertain to any part of
104 | the Derivative Works; and
105 |
106 | (d) If the Work includes a "NOTICE" text file as part of its
107 | distribution, then any Derivative Works that You distribute must
108 | include a readable copy of the attribution notices contained
109 | within such NOTICE file, excluding those notices that do not
110 | pertain to any part of the Derivative Works, in at least one
111 | of the following places: within a NOTICE text file distributed
112 | as part of the Derivative Works; within the Source form or
113 | documentation, if provided along with the Derivative Works; or,
114 | within a display generated by the Derivative Works, if and
115 | wherever such third-party notices normally appear. The contents
116 | of the NOTICE file are for informational purposes only and
117 | do not modify the License. You may add Your own attribution
118 | notices within Derivative Works that You distribute, alongside
119 | or as an addendum to the NOTICE text from the Work, provided
120 | that such additional attribution notices cannot be construed
121 | as modifying the License.
122 |
123 | You may add Your own copyright statement to Your modifications and
124 | may provide additional or different license terms and conditions
125 | for use, reproduction, or distribution of Your modifications, or
126 | for any such Derivative Works as a whole, provided Your use,
127 | reproduction, and distribution of the Work otherwise complies with
128 | the conditions stated in this License.
129 |
130 | 5. Submission of Contributions. Unless You explicitly state otherwise,
131 | any Contribution intentionally submitted for inclusion in the Work
132 | by You to the Licensor shall be under the terms and conditions of
133 | this License, without any additional terms or conditions.
134 | Notwithstanding the above, nothing herein shall supersede or modify
135 | the terms of any separate license agreement you may have executed
136 | with Licensor regarding such Contributions.
137 |
138 | 6. Trademarks. This License does not grant permission to use the trade
139 | names, trademarks, service marks, or product names of the Licensor,
140 | except as required for reasonable and customary use in describing the
141 | origin of the Work and reproducing the content of the NOTICE file.
142 |
143 | 7. Disclaimer of Warranty. Unless required by applicable law or
144 | agreed to in writing, Licensor provides the Work (and each
145 | Contributor provides its Contributions) on an "AS IS" BASIS,
146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 | implied, including, without limitation, any warranties or conditions
148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 | PARTICULAR PURPOSE. You are solely responsible for determining the
150 | appropriateness of using or redistributing the Work and assume any
151 | risks associated with Your exercise of permissions under this License.
152 |
153 | 8. Limitation of Liability. In no event and under no legal theory,
154 | whether in tort (including negligence), contract, or otherwise,
155 | unless required by applicable law (such as deliberate and grossly
156 | negligent acts) or agreed to in writing, shall any Contributor be
157 | liable to You for damages, including any direct, indirect, special,
158 | incidental, or consequential damages of any character arising as a
159 | result of this License or out of the use or inability to use the
160 | Work (including but not limited to damages for loss of goodwill,
161 | work stoppage, computer failure or malfunction, or any and all
162 | other commercial damages or losses), even if such Contributor
163 | has been advised of the possibility of such damages.
164 |
165 | 9. Accepting Warranty or Additional Liability. While redistributing
166 | the Work or Derivative Works thereof, You may choose to offer,
167 | and charge a fee for, acceptance of support, warranty, indemnity,
168 | or other liability obligations and/or rights consistent with this
169 | License. However, in accepting such obligations, You may act only
170 | on Your own behalf and on Your sole responsibility, not on behalf
171 | of any other Contributor, and only if You agree to indemnify,
172 | defend, and hold each Contributor harmless for any liability
173 | incurred by, or claims asserted against, such Contributor by reason
174 | of your accepting any such warranty or additional liability.
175 |
176 | END OF TERMS AND CONDITIONS
177 |
178 | APPENDIX: How to apply the Apache License to your work.
179 |
180 | To apply the Apache License to your work, attach the following
181 | boilerplate notice, with the fields enclosed by brackets "[]"
182 | replaced with your own identifying information. (Don't include
183 | the brackets!) The text should be enclosed in the appropriate
184 | comment syntax for the file format. We also recommend that a
185 | file or class name and description of purpose be included on the
186 | same "printed page" as the copyright notice for easier
187 | identification within third-party archives.
188 |
189 | Copyright [yyyy] [name of copyright owner]
190 |
191 | Licensed under the Apache License, Version 2.0 (the "License");
192 | you may not use this file except in compliance with the License.
193 | You may obtain a copy of the License at
194 |
195 | http://www.apache.org/licenses/LICENSE-2.0
196 |
197 | Unless required by applicable law or agreed to in writing, software
198 | distributed under the License is distributed on an "AS IS" BASIS,
199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 | See the License for the specific language governing permissions and
201 | limitations under the License.
202 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | Spring Boot + Hazelcast Integration
2 |
3 | ## Introduction
4 |
5 | Spring Boot Web application with configurable clustering:
6 |
7 | - `cluster-api`: Interfaces hiding the clustering implementation used,
8 | - `cluster-jvm`: no clustering backed by JVM data structures (like HashMap),
9 | - `cluster-hazelcast`: clusterting backend by [Hazelcast](https://hazelcast.org).
10 |
11 | This allows you to create a web application which supports single-jvm or clustered data structures depending on configuration in `application.yml`:
12 |
13 | ```yml
14 | clustering:
15 | driver: hazelcast # Enable Hazelcast Clustering
16 | ```
17 | ## Pre-Requisites
18 |
19 | This project uses [Lombok](https://projectlombok.org/) which requires **Annotations Processors** to be enabled in Eclipse / Intellij when importing from sources. Requires **Java 8** or later.
20 |
21 | ## Demo Application
22 |
23 | Run with intellij:
24 |
25 | - **Main class**: `com.octoperf.Application`
26 | - **Use classpath of module**: `application`,
27 | - **Working Directory**: `$MODULE_DIR$`,
28 | - **VM Options**: `-Dspring.profiles.active=hazelcast` to run with hazelcast clustering. Nothing otherwise.
29 |
--------------------------------------------------------------------------------
/application/pom.xml:
--------------------------------------------------------------------------------
1 |
2 |
5 |
6 | spring-boot-hazelcast
7 | com.octoperf
8 | 1.0-SNAPSHOT
9 |
10 | 4.0.0
11 |
12 | application
13 |
14 |
15 |
16 | com.octoperf
17 | cluster-jvm
18 | ${project.version}
19 |
20 |
21 | com.octoperf
22 | cluster-hazelcast
23 | ${project.version}
24 |
25 |
26 |
27 | org.springframework.boot
28 | spring-boot-starter-web
29 |
30 |
31 |
32 | org.springframework.boot
33 | spring-boot-starter-test
34 | test
35 |
36 |
37 | org.slf4j
38 | slf4j-simple
39 | test
40 |
41 |
42 |
--------------------------------------------------------------------------------
/application/src/main/java/com/octoperf/Application.java:
--------------------------------------------------------------------------------
1 | package com.octoperf;
2 |
3 | import org.springframework.boot.SpringApplication;
4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
5 |
6 | @SpringBootApplication
7 | public class Application {
8 |
9 | public static void main(final String[] args) {
10 | SpringApplication.run(Application.class, args); // NOSONAR
11 | }
12 | }
13 |
--------------------------------------------------------------------------------
/application/src/main/java/com/octoperf/ClusterController.java:
--------------------------------------------------------------------------------
1 | package com.octoperf;
2 |
3 | import com.octoperf.cluster.api.ClusteredMap;
4 | import com.octoperf.cluster.api.ClusteringService;
5 | import lombok.AllArgsConstructor;
6 | import lombok.NonNull;
7 | import lombok.experimental.FieldDefaults;
8 | import org.springframework.web.bind.annotation.DeleteMapping;
9 | import org.springframework.web.bind.annotation.GetMapping;
10 | import org.springframework.web.bind.annotation.PathVariable;
11 | import org.springframework.web.bind.annotation.PutMapping;
12 | import org.springframework.web.bind.annotation.RequestMapping;
13 | import org.springframework.web.bind.annotation.RestController;
14 |
15 | import java.util.Optional;
16 |
17 | import static lombok.AccessLevel.PACKAGE;
18 | import static lombok.AccessLevel.PRIVATE;
19 |
20 | @RestController
21 | @RequestMapping("/cluster")
22 | @AllArgsConstructor(access = PACKAGE)
23 | @FieldDefaults(level = PRIVATE, makeFinal = true)
24 | class ClusterController {
25 | private static final String MAP_ID = "map";
26 |
27 | @NonNull
28 | ClusteringService clustering;
29 |
30 | @GetMapping("/is-leader") boolean isLeader() {
31 | return clustering.isLeader();
32 | }
33 |
34 | @GetMapping("/{key}")
35 | Optional get(@PathVariable("key") final String key) {
36 | final ClusteredMap map = clustering.getMap(MAP_ID);
37 | return map.get(key);
38 | }
39 |
40 | @PutMapping("/{key}/{value}")
41 | void get(@PathVariable("key") final String key, @PathVariable("value") final String value) {
42 | final ClusteredMap map = clustering.getMap("map");
43 | map.put(key, value);
44 | }
45 |
46 | @DeleteMapping("/{key}")
47 | void delete(@PathVariable("key") final String key) {
48 | final ClusteredMap map = clustering.getMap("map");
49 | map.remove(key);
50 | }
51 |
52 | }
53 |
--------------------------------------------------------------------------------
/application/src/main/resources/application-hazelcast.yml:
--------------------------------------------------------------------------------
1 | clustering:
2 | driver: hazelcast
3 | hazelcast:
4 | quorum: 2
5 |
--------------------------------------------------------------------------------
/application/src/main/resources/application.yml:
--------------------------------------------------------------------------------
1 | server:
2 | port: 0
--------------------------------------------------------------------------------
/application/src/test/java/com/octoperf/ApplicationSpringTest.java:
--------------------------------------------------------------------------------
1 | package com.octoperf;
2 |
3 | import org.junit.Test;
4 | import org.junit.runner.RunWith;
5 | import org.springframework.beans.factory.annotation.Autowired;
6 | import org.springframework.boot.test.context.SpringBootTest;
7 | import org.springframework.core.env.Environment;
8 | import org.springframework.test.context.junit4.SpringRunner;
9 |
10 | import static org.junit.Assert.assertNotNull;
11 |
12 | @RunWith(SpringRunner.class)
13 | @SpringBootTest(classes = Application.class)
14 | public class ApplicationSpringTest {
15 |
16 | @Autowired
17 | Environment env;
18 |
19 | @Test
20 | public void shouldAutowire() {
21 | assertNotNull(env);
22 | }
23 | }
24 |
--------------------------------------------------------------------------------
/application/src/test/java/com/octoperf/ApplicationTest.java:
--------------------------------------------------------------------------------
1 | package com.octoperf;
2 |
3 | import org.junit.Test;
4 |
5 | public class ApplicationTest {
6 |
7 | @Test
8 | public void shouldRunMain() {
9 | Application.main(new String[0]);
10 | }
11 | }
12 |
--------------------------------------------------------------------------------
/cluster-api/pom.xml:
--------------------------------------------------------------------------------
1 |
2 |
5 |
6 | spring-boot-hazelcast
7 | com.octoperf
8 | 1.0-SNAPSHOT
9 |
10 | 4.0.0
11 |
12 | cluster-api
13 |
14 |
15 |
16 | org.springframework
17 | spring-context
18 |
19 |
20 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/AbstractClusteredQueue.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | import java.util.List;
4 | import java.util.concurrent.BlockingQueue;
5 | import java.util.concurrent.TimeUnit;
6 |
7 | public abstract class AbstractClusteredQueue implements ClusteredQueue {
8 |
9 | @Override
10 | public final void put(final T elt) throws InterruptedException {
11 | queue().put(elt);
12 | }
13 |
14 | @Override
15 | public final int drainTo(final List list) {
16 | return queue().drainTo(list);
17 | }
18 |
19 | @Override
20 | public final int size() {
21 | return queue().size();
22 | }
23 |
24 | @Override
25 | public final T poll(final long timeout, final TimeUnit unit) throws InterruptedException {
26 | return queue().poll(timeout, unit);
27 | }
28 |
29 | protected abstract BlockingQueue queue();
30 | }
31 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/ClusteredAtomicLong.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | public interface ClusteredAtomicLong extends DestroyableObject {
4 |
5 | long incrementAndGet();
6 |
7 | long get();
8 | }
9 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/ClusteredLock.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | public interface ClusteredLock extends DestroyableObject {
4 |
5 | void lock();
6 |
7 | void unlock();
8 | }
9 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/ClusteredMap.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | import java.util.Map;
4 | import java.util.Optional;
5 |
6 | public interface ClusteredMap extends DestroyableObject {
7 |
8 | Optional get(final K key);
9 |
10 | void put(final K key, final V value);
11 |
12 | void remove(final K key);
13 |
14 | Map copyOf();
15 | }
16 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/ClusteredQueue.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | import java.util.List;
4 | import java.util.concurrent.TimeUnit;
5 |
6 | public interface ClusteredQueue extends DestroyableObject {
7 |
8 | void put(T elt) throws InterruptedException;
9 |
10 | int drainTo(List list);
11 |
12 | int size();
13 |
14 | T poll(long timeout, TimeUnit unit) throws InterruptedException;
15 | }
16 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/ClusteredTopic.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | public interface ClusteredTopic extends DestroyableObject {
4 |
5 | void register(TopicMessageListener listener);
6 |
7 | void unregister(TopicMessageListener listener);
8 |
9 | void publish(T s);
10 | }
11 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/ClusteringService.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | public interface ClusteringService {
4 |
5 | boolean isLeader();
6 |
7 | ClusteredMap getMap(String id);
8 |
9 | ClusteredQueue getQueue(String id);
10 |
11 | ClusteredTopic getReliableTopic(String id);
12 |
13 | ClusteredAtomicLong getAtomicLong(String id);
14 |
15 | ClusteredLock getLock(String id);
16 | }
17 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/DestroyableObject.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | @FunctionalInterface
4 | public interface DestroyableObject {
5 |
6 | void destroy();
7 | }
8 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/TopicMessage.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | import lombok.Value;
4 |
5 | import static java.util.Objects.requireNonNull;
6 |
7 | @Value
8 | public class TopicMessage {
9 | T value;
10 |
11 | public TopicMessage(final T value) {
12 | super();
13 | this.value = requireNonNull(value);
14 | }
15 | }
16 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/TopicMessageListener.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | @FunctionalInterface
4 | public interface TopicMessageListener {
5 |
6 | void onMessage(TopicMessage message);
7 | }
8 |
--------------------------------------------------------------------------------
/cluster-api/src/main/java/com/octoperf/cluster/api/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Clustering APIs.
3 | *
4 | * @author jerome
5 | *
6 | */
7 | package com.octoperf.cluster.api;
8 |
--------------------------------------------------------------------------------
/cluster-api/src/test/java/com/octoperf/cluster/api/AbstractClusteredAtomicLongTest.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | import com.google.common.testing.NullPointerTester;
4 | import org.junit.After;
5 | import org.junit.Before;
6 | import org.junit.Test;
7 |
8 | import static com.google.common.testing.NullPointerTester.Visibility.PACKAGE;
9 | import static org.junit.Assert.assertEquals;
10 |
11 | public abstract class AbstractClusteredAtomicLongTest {
12 |
13 | private ClusteredAtomicLong service;
14 |
15 | @Before
16 | public void before() {
17 | service = newService();
18 | }
19 |
20 | @Test
21 | public void shouldIncrementAndGet() {
22 | assertEquals(1, service.incrementAndGet());
23 | assertEquals(2, service.incrementAndGet());
24 | }
25 |
26 | @Test
27 | public void shouldGet() {
28 | assertEquals(1, service.incrementAndGet());
29 | assertEquals(1, service.get());
30 | }
31 |
32 | @Test
33 | public void shouldPassNPETester() {
34 | new NullPointerTester().testConstructors(service.getClass(), PACKAGE);
35 | }
36 |
37 | @After
38 | public void after() {
39 | service.destroy();
40 | }
41 |
42 | protected abstract ClusteredAtomicLong newService();
43 | }
44 |
--------------------------------------------------------------------------------
/cluster-api/src/test/java/com/octoperf/cluster/api/AbstractClusteredLockTest.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | import com.google.common.testing.NullPointerTester;
4 | import org.junit.After;
5 | import org.junit.Before;
6 | import org.junit.Test;
7 |
8 | import static com.google.common.testing.NullPointerTester.Visibility.PACKAGE;
9 |
10 | public abstract class AbstractClusteredLockTest {
11 | private ClusteredLock service;
12 |
13 | @Before
14 | public void before() {
15 | service = newService();
16 | }
17 |
18 | @Test
19 | public void shouldLock() throws InterruptedException {
20 | service.lock();
21 | }
22 |
23 | @Test
24 | public void shouldUnLock() throws InterruptedException {
25 | service.lock();
26 | service.unlock();
27 | }
28 |
29 | @Test
30 | public void shouldPassNPETester() {
31 | new NullPointerTester().testConstructors(service.getClass(), PACKAGE);
32 | }
33 |
34 | @After
35 | public void after() {
36 | service.destroy();
37 | }
38 |
39 | protected abstract ClusteredLock newService();
40 | }
41 |
--------------------------------------------------------------------------------
/cluster-api/src/test/java/com/octoperf/cluster/api/AbstractClusteredMapTest.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | import com.google.common.collect.ImmutableMap;
4 | import com.google.common.testing.NullPointerTester;
5 | import org.junit.After;
6 | import org.junit.Before;
7 | import org.junit.Test;
8 |
9 | import java.util.Map;
10 | import java.util.Optional;
11 |
12 | import static com.google.common.testing.NullPointerTester.Visibility.PACKAGE;
13 | import static org.junit.Assert.assertEquals;
14 |
15 | public abstract class AbstractClusteredMapTest {
16 |
17 | private ClusteredMap service;
18 |
19 | private V value;
20 |
21 | @Before
22 | public void before() {
23 | service = newService();
24 | value = newValue();
25 | }
26 |
27 | @Test
28 | public void shouldPutGet() {
29 | service.put("key", value);
30 | assertEquals(value, service.get("key").orElse(null));
31 | }
32 |
33 | @Test
34 | public void shouldPutRemove() {
35 | service.put("key", value);
36 | service.remove("key");
37 | assertEquals(Optional.empty(), service.get("key"));
38 | }
39 |
40 | @Test
41 | public void shouldCopyOf() {
42 | service.put("key", value);
43 | final Map copyOf = service.copyOf();
44 | assertEquals(ImmutableMap.of("key", value), copyOf);
45 | }
46 |
47 | @Test
48 | public void shouldDestroy() {
49 | service.destroy();
50 | }
51 |
52 | @Test
53 | public void shouldPassNPETester() {
54 | new NullPointerTester().testConstructors(service.getClass(), PACKAGE);
55 | }
56 |
57 | @After
58 | public void after() {
59 | service.destroy();
60 | }
61 |
62 | protected abstract ClusteredMap newService();
63 |
64 | protected abstract V newValue();
65 | }
66 |
--------------------------------------------------------------------------------
/cluster-api/src/test/java/com/octoperf/cluster/api/AbstractClusteredQueueTest.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | import com.google.common.collect.ImmutableList;
4 | import com.google.common.testing.NullPointerTester;
5 | import org.junit.After;
6 | import org.junit.Before;
7 | import org.junit.Test;
8 |
9 | import java.util.ArrayList;
10 | import java.util.List;
11 |
12 | import static com.google.common.testing.NullPointerTester.Visibility.PACKAGE;
13 | import static java.util.concurrent.TimeUnit.SECONDS;
14 | import static org.junit.Assert.assertEquals;
15 |
16 | public abstract class AbstractClusteredQueueTest {
17 |
18 | private static final String HELLO_WORLD = "Hello World!";
19 |
20 | private ClusteredQueue service;
21 |
22 | @Before
23 | public void before() {
24 | service = newService();
25 | }
26 |
27 | @Test
28 | public void shouldAdd() throws InterruptedException {
29 | service.put(HELLO_WORLD);
30 | assertEquals(1, service.size());
31 | }
32 |
33 | @Test
34 | public void shouldHaveZeroSize() {
35 | assertEquals(0, service.size());
36 | }
37 |
38 | @Test
39 | public void shouldDrainTo() throws InterruptedException {
40 | service.put(HELLO_WORLD);
41 | assertEquals(1, service.size());
42 |
43 | final List list = new ArrayList<>();
44 | service.drainTo(list);
45 | assertEquals(ImmutableList.of(HELLO_WORLD), list);
46 | assertEquals(0, service.size());
47 | }
48 |
49 | @Test
50 | public void shouldPoll() throws InterruptedException {
51 | service.put(HELLO_WORLD);
52 | assertEquals(1, service.size());
53 |
54 | final String polled = service.poll(0, SECONDS);
55 | assertEquals(HELLO_WORLD, polled);
56 | }
57 |
58 | @Test
59 | public void shouldPassNPETester() {
60 | new NullPointerTester().testConstructors(service.getClass(), PACKAGE);
61 | }
62 |
63 | @After
64 | public void after() {
65 | service.destroy();
66 | }
67 |
68 | protected abstract ClusteredQueue newService();
69 | }
70 |
--------------------------------------------------------------------------------
/cluster-api/src/test/java/com/octoperf/cluster/api/AbstractClusteredTopicTest.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | import com.google.common.testing.NullPointerTester;
4 | import org.junit.After;
5 | import org.junit.Before;
6 | import org.junit.Test;
7 |
8 | import static com.google.common.testing.NullPointerTester.Visibility.PACKAGE;
9 | import static org.mockito.Mockito.mock;
10 |
11 | public abstract class AbstractClusteredTopicTest {
12 | protected static final String HELLO_WORLD = "Hello World!";
13 |
14 | private ClusteredTopic service;
15 |
16 | @Before
17 | public void before() {
18 | service = newService();
19 | }
20 |
21 | @Test
22 | @SuppressWarnings("unchecked")
23 | public void shouldRegisterAndPublish() {
24 | final TopicMessageListener listener = mock(TopicMessageListener.class);
25 | service.register(listener);
26 | service.publish(HELLO_WORLD);
27 | }
28 |
29 | @Test
30 | @SuppressWarnings("unchecked")
31 | public void shouldUnregisterAndPublish() {
32 | final TopicMessageListener listener = mock(TopicMessageListener.class);
33 | service.register(listener);
34 | service.publish(HELLO_WORLD);
35 | service.unregister(listener);
36 | service.publish(HELLO_WORLD);
37 | }
38 |
39 | @Test
40 | public void shouldPassNPETester() {
41 | new NullPointerTester().testConstructors(service.getClass(), PACKAGE);
42 | }
43 |
44 | @After
45 | public void after() {
46 | service.destroy();
47 | }
48 |
49 | protected abstract ClusteredTopic newService();
50 | }
51 |
--------------------------------------------------------------------------------
/cluster-api/src/test/java/com/octoperf/cluster/api/AbstractClusteringServiceTest.java:
--------------------------------------------------------------------------------
1 | package com.octoperf.cluster.api;
2 |
3 | import com.google.common.testing.NullPointerTester;
4 | import org.junit.Test;
5 |
6 | import static com.google.common.testing.NullPointerTester.Visibility.PACKAGE;
7 | import static org.junit.Assert.assertNotNull;
8 | import static org.junit.Assert.assertNotSame;
9 | import static org.junit.Assert.assertTrue;
10 |
11 | public abstract class AbstractClusteringServiceTest {
12 |
13 | public static final String TEST = "Test";
14 |
15 | @Test
16 | public void shouldReturnIsLeader() {
17 | final ClusteringService service = newService();
18 | final boolean isLeader = service.isLeader();
19 | assertTrue(isLeader);
20 | }
21 |
22 | @Test
23 | public void shouldReturnLock() {
24 | final ClusteringService service = newService();
25 | final ClusteredLock lock = service.getLock(TEST);
26 | assertNotNull(lock);
27 | lock.destroy();
28 | assertNotSame(lock, service.getLock(TEST));
29 | }
30 |
31 | @Test
32 | public void shouldReturnQueue() {
33 | final ClusteringService service = newService();
34 | final ClusteredQueue queue = service.getQueue(TEST);
35 | assertNotNull(queue);
36 | queue.destroy();
37 | assertNotSame(queue, service.getQueue(TEST));
38 | }
39 |
40 | @Test
41 | public void shouldReturnAtomicLong() {
42 | final ClusteringService service = newService();
43 | final ClusteredAtomicLong atomicLong = service.getAtomicLong(TEST);
44 | assertNotNull(atomicLong);
45 | atomicLong.destroy();
46 | assertNotSame(atomicLong, service.getAtomicLong(TEST));
47 | }
48 |
49 | @Test
50 | public void shouldReturnTopic() {
51 | final ClusteringService service = newService();
52 | final ClusteredTopic topic = service.getReliableTopic(TEST);
53 | assertNotNull(topic);
54 | topic.destroy();
55 | assertNotSame(topic, service.getReliableTopic(TEST));
56 | }
57 |
58 | @Test
59 | public void shouldReturnMap() {
60 | final ClusteringService service = newService();
61 | final ClusteredMap