FINERACT-1694: External event storage integration

fineract-provider/src/test/java/org/apache/fineract/infrastructure/event/external/service/DelayedExternalEventServiceTest.java

@@ -0,0 +1,116 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.fineract.infrastructure.event.external.service;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+
+import java.util.List;
+import org.apache.fineract.portfolio.businessevent.domain.BulkBusinessEvent;
+import org.apache.fineract.portfolio.businessevent.domain.BusinessEvent;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.ArgumentCaptor;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+
+@ExtendWith(MockitoExtension.class)
+@SuppressWarnings({ "rawtypes", "unchecked" })
+class DelayedExternalEventServiceTest {
+
+    @Mock
+    private ExternalEventService delegate;
+
+    @InjectMocks
+    private DelayedExternalEventService underTest;
+
+    @BeforeEach
+    public void setUp() {
+        underTest.clearEnqueuedEvents();
+    }
+
+    @Test
+    public void testEnqueueEventFailsWhenNullEventIsGiven() {
+        // given
+        // when & then
+        assertThatThrownBy(() -> underTest.enqueueEvent(null)).isExactlyInstanceOf(IllegalArgumentException.class);
+    }
+
+    @Test
+    public void testEnqueueEventWorks() {
+        // given
+        BusinessEvent event = mock(BusinessEvent.class);
+        // when
+        underTest.enqueueEvent(event);
+        // then
+        List<BusinessEvent<?>> enqueuedEvents = underTest.getEnqueuedEvents();
+        assertThat(enqueuedEvents).hasSize(1);
+        assertThat(enqueuedEvents.get(0)).isEqualTo(event);
+    }
+
+    @Test
+    public void testHasEnqueuedEventsReturnsTrueWhenEventIsEnqueued() {
+        // given
+        BusinessEvent event = mock(BusinessEvent.class);
+        underTest.enqueueEvent(event);
+        // when
+        boolean result = underTest.hasEnqueuedEvents();
+        // then
+        assertThat(result).isTrue();
+    }
+
+    @Test
+    public void testHasEnqueuedEventsReturnsFalseWhenNoEventIsEnqueued() {
+        // given
+        // when
+        boolean result = underTest.hasEnqueuedEvents();
+        // then
+        assertThat(result).isFalse();
+    }
+
+    @Test
+    public void testPostEnqueuedEventsFailsWhenNoEventIsEnqueued() {
+        // given
+        // when & then
+        assertThatThrownBy(() -> underTest.postEnqueuedEvents()).isExactlyInstanceOf(IllegalStateException.class);
+    }
+
+    @Test
+    public void testPostEnqueuedEventsWorks() {
+        // given
+        ArgumentCaptor<BusinessEvent> delegateEventCaptor = ArgumentCaptor.forClass(BusinessEvent.class);
+
+        BusinessEvent event = mock(BusinessEvent.class);
+        underTest.enqueueEvent(event);
+        // when
+        underTest.postEnqueuedEvents();
+        // then
+        verify(delegate).postEvent(delegateEventCaptor.capture());
+        BusinessEvent delegateEvent = delegateEventCaptor.getValue();
+        assertThat(delegateEvent).isExactlyInstanceOf(BulkBusinessEvent.class);
+        BulkBusinessEvent bulkDelegateEvent = (BulkBusinessEvent) delegateEvent;
+        List<BusinessEvent<?>> enqueuedEvents = bulkDelegateEvent.get();
+        assertThat(enqueuedEvents).hasSize(1);
+        assertThat(enqueuedEvents.get(0)).isEqualTo(event);
+    }
+}

fineract-provider/src/test/java/org/apache/fineract/infrastructure/event/external/service/ExternalEventServiceTest.java

@@ -0,0 +1,115 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.fineract.infrastructure.event.external.service;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+import static org.mockito.BDDMockito.given;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+
+import java.io.IOException;
+import java.time.LocalDate;
+import java.time.ZoneId;
+import java.util.HashMap;
+import java.util.Map;
+import org.apache.fineract.infrastructure.businessdate.domain.BusinessDateType;
+import org.apache.fineract.infrastructure.core.domain.FineractPlatformTenant;
+import org.apache.fineract.infrastructure.core.service.ThreadLocalContextUtil;
+import org.apache.fineract.infrastructure.event.external.repository.ExternalEventRepository;
+import org.apache.fineract.infrastructure.event.external.repository.domain.ExternalEvent;
+import org.apache.fineract.infrastructure.event.external.service.idempotency.ExternalEventIdempotencyKeyGenerator;
+import org.apache.fineract.infrastructure.event.external.service.serialization.BusinessEventSerializerFactory;
+import org.apache.fineract.infrastructure.event.external.service.serialization.serializer.BusinessEventSerializer;
+import org.apache.fineract.portfolio.businessevent.domain.BusinessEvent;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.ArgumentCaptor;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+
+@ExtendWith(MockitoExtension.class)
+@SuppressWarnings({ "rawtypes", "unchecked" })
+class ExternalEventServiceTest {
+
+    @Mock
+    private ExternalEventRepository repository;
+    @Mock
+    private ExternalEventIdempotencyKeyGenerator idempotencyKeyGenerator;
+    @Mock
+    private BusinessEventSerializerFactory serializerFactory;
+
+    @InjectMocks
+    private ExternalEventService underTest;
+
+    @BeforeEach
+    public void setUp() {
+        FineractPlatformTenant tenant = new FineractPlatformTenant(1L, "default", "Default Tenant", "Europe/Budapest", null);
+        ThreadLocalContextUtil.setTenant(tenant);
+        ThreadLocalContextUtil
+                .setBusinessDates(new HashMap<>(Map.of(BusinessDateType.BUSINESS_DATE, LocalDate.now(ZoneId.systemDefault()))));
+    }
+
+    @Test
+    public void testPostEventShouldFailWhenNullEventIsGiven() {
+        // given
+        // when & then
+        assertThatThrownBy(() -> underTest.postEvent(null)).isExactlyInstanceOf(IllegalArgumentException.class);
+    }
+
+    @Test
+    public void testPostEventShouldFailWhenEventSerializationFails() throws IOException {
+        // given
+        BusinessEvent event = mock(BusinessEvent.class);
+        BusinessEventSerializer eventSerializer = mock(BusinessEventSerializer.class);
+
+        given(idempotencyKeyGenerator.generate(event)).willReturn("");
+        given(serializerFactory.create(event)).willReturn(eventSerializer);
+        given(eventSerializer.serialize(event)).willThrow(IOException.class);
+        // when & then
+        assertThatThrownBy(() -> underTest.postEvent(event)).isExactlyInstanceOf(RuntimeException.class);
+    }
+
+    @Test
+    public void testPostEventShouldWork() throws IOException {
+        // given
+        ArgumentCaptor<ExternalEvent> externalEventArgumentCaptor = ArgumentCaptor.forClass(ExternalEvent.class);
+
+        String eventType = "TestType";
+        String idempotencyKey = "key";
+        BusinessEvent event = mock(BusinessEvent.class);
+        BusinessEventSerializer eventSerializer = mock(BusinessEventSerializer.class);
+        byte[] data = new byte[0];
+
+        given(event.getType()).willReturn(eventType);
+        given(idempotencyKeyGenerator.generate(event)).willReturn(idempotencyKey);
+        given(serializerFactory.create(event)).willReturn(eventSerializer);
+        given(eventSerializer.serialize(event)).willReturn(data);
+        // when
+        underTest.postEvent(event);
+        // then
+        verify(repository).save(externalEventArgumentCaptor.capture());
+        ExternalEvent externalEvent = externalEventArgumentCaptor.getValue();
+        assertThat(externalEvent.getIdempotencyKey()).isEqualTo(idempotencyKey);
+        assertThat(externalEvent.getData()).isEqualTo(data);
+        assertThat(externalEvent.getType()).isEqualTo(eventType);
+    }
+}

fineract-provider/src/test/resources/application-test.properties

@@ -45,6 +45,7 @@ fineract.partitioned-job.partitioned-job-properties[0].thread-count=1
 fineract.remote-job-message-handler.spring-events.enabled=${FINERACT_REMOTE_JOB_MESSAGE_HANDLER_SPRING_EVENTS_ENABLED:true}
 fineract.remote-job-message-handler.jms.enabled=${FINERACT_REMOTE_JOB_MESSAGE_HANDLER_JMS_ENABLED:false}
 fineract.remote-job-message-handler.jms.request-queue-name=${FINERACT_REMOTE_JOB_MESSAGE_HANDLER_JMS_QUEUE_NAME:JMS-request-queue}
+fineract.events.external.enabled=${FINERACT_EXTERNAL_EVENTS_ENABLED:false}
 
 management.health.jms.enabled=false