CallableCacheLoaderAdapterTest.java

/*
 * Copyright 2016 the original author or authors.
 *
 * Licensed 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.springframework.data.gemfire.cache;

import static org.hamcrest.Matchers.*;
import static org.junit.Assert.*;
import static org.mockito.ArgumentMatchers.*;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.isA;
import static org.mockito.Mockito.*;

import org.apache.geode.cache.CacheLoader;
import org.apache.geode.cache.LoaderHelper;
import org.apache.geode.cache.Region;
import org.junit.Rule;
import org.junit.Test;
import org.junit.rules.ExpectedException;
import org.junit.runner.RunWith;
import org.mockito.Mock;
import org.mockito.invocation.InvocationOnMock;
import org.mockito.junit.MockitoJUnitRunner;
import org.mockito.stubbing.Answer;

/**
 * Unit tests to test the adaption of the {@link java.util.concurrent.Callable}
 * into GemFire's {@link org.apache.geode.cache.CacheLoader} interface.
 *
 * @author John Blum
 * @see org.junit.Rule
 * @see org.junit.Test
 * @see org.junit.rules.ExpectedException
 * @see org.junit.runner.RunWith
 * @see org.mockito.Mock
 * @see org.mockito.Mockito
 * @see org.mockito.runners.MockitoJUnitRunner
 * @see java.util.concurrent.Callable
 * @see org.apache.geode.cache.CacheLoader
 * @see org.apache.geode.cache.LoaderHelper
 * @see org.apache.geode.cache.Region
 * @since 1.9.0
 */
@RunWith(MockitoJUnitRunner.class)
public class CallableCacheLoaderAdapterTest {

	@Mock
	private CacheLoader<String, Object> mockCacheLoader;

	@Rule
	public ExpectedException exception = ExpectedException.none();

	@Mock
	private LoaderHelper<String, Object> mockLoaderHelper;

	@Mock
	private Region<String, Object> mockRegion;

	@Test
	public void constructCallableCacheLoaderAdapterWithArgumentKeyAndRegion() {
		CallableCacheLoaderAdapter<String, Object> instance =
			new CallableCacheLoaderAdapter<>(mockCacheLoader, "key", mockRegion, "test");

		assertThat(instance, is(notNullValue()));
		assertThat(instance.getCacheLoader(), is(sameInstance(mockCacheLoader)));
		assertThat(instance.getKey(), is(equalTo("key")));
		assertThat(instance.getRegion(), is(sameInstance(mockRegion)));
		assertThat(String.valueOf(instance.getArgument()), is(equalTo("test")));
	}

	@Test
	public void constructCallableCacheLoaderAdapterWithKeyRegionAndNoArgument() {
		CallableCacheLoaderAdapter<String, Object> instance =
			new CallableCacheLoaderAdapter<>(mockCacheLoader, "key", mockRegion);

		assertThat(instance, is(notNullValue()));
		assertThat(instance.getCacheLoader(), is(sameInstance(mockCacheLoader)));
		assertThat(instance.getKey(), is(equalTo("key")));
		assertThat(instance.getRegion(), is(sameInstance(mockRegion)));
		assertThat(instance.getArgument(), is(nullValue()));
	}

	@Test
	public void constructCallableCacheLoaderAdapterWithNoArgumentKeyOrRegion() {
		CallableCacheLoaderAdapter<String, Object> instance =
			new CallableCacheLoaderAdapter<>(mockCacheLoader);

		assertThat(instance, is(notNullValue()));
		assertThat(instance.getCacheLoader(), is(sameInstance(mockCacheLoader)));
		assertThat(instance.getKey(), is(nullValue()));
		assertThat(instance.getRegion(), is(nullValue()));
		assertThat(instance.getArgument(), is(nullValue()));
	}

	@Test
	public void constructCallableCacheLoaderAdapterWithNullCacheLoader() {
		exception.expect(IllegalArgumentException.class);
		exception.expectCause(is(nullValue(Throwable.class)));
		exception.expectMessage("CacheLoader must not be null");

		new CallableCacheLoaderAdapter<>(null);
	}

	@Test
	@SuppressWarnings("unchecked")
	public void callDelegatesToLoad() throws Exception {
		CallableCacheLoaderAdapter<String, Object> instance =
			new CallableCacheLoaderAdapter<>(mockCacheLoader, "key", mockRegion, "test");

		when(mockCacheLoader.load(any(LoaderHelper.class))).thenAnswer(new Answer<String>() {
			public String answer(final InvocationOnMock invocation) throws Throwable {
				LoaderHelper<String, Object> loaderHelper = invocation.getArgument(0);

				assertThat(loaderHelper, is(notNullValue()));
				assertThat(loaderHelper.getArgument(), is(equalTo("test")));
				assertThat(loaderHelper.getKey(), is(equalTo("key")));
				assertThat(loaderHelper.getRegion(), is(sameInstance(mockRegion)));

				return "mockValue";
			}
		});

		assertThat(instance.call(), is(equalTo("mockValue")));

		verify(mockCacheLoader, times(1)).load(isA(LoaderHelper.class));
	}

	@Test
	public void callThrowsIllegalStateExceptionForNullKey() throws Exception {
		CallableCacheLoaderAdapter<String, Object> instance =
			new CallableCacheLoaderAdapter<>(mockCacheLoader, null, mockRegion);

		assertThat(instance.getKey(), is(nullValue()));
		assertThat(instance.getRegion(), is(sameInstance(mockRegion)));

		exception.expect(IllegalStateException.class);
		exception.expectCause(is(nullValue(Throwable.class)));
		exception.expectMessage("The key for which the value is loaded for cannot be null");

		instance.call();
	}

	@Test
	public void callThrowsIllegalStateExceptionForNullRegion() throws Exception {
		CallableCacheLoaderAdapter<String, Object> instance =
			new CallableCacheLoaderAdapter<>(mockCacheLoader, "key", null);

		assertThat(instance.getKey(), is(equalTo("key")));
		assertThat(instance.getRegion(), is(nullValue()));

		exception.expect(IllegalStateException.class);
		exception.expectCause(is(nullValue(Throwable.class)));
		exception.expectMessage("The Region to load cannot be null");

		instance.call();
	}

	@Test
	public void closeDelegatesToCacheLoaderClose() {
		new CallableCacheLoaderAdapter<>(mockCacheLoader).close();
		verify(mockCacheLoader, times(1)).close();
	}

	@Test
	public void loadDelegatesToCacheLoaderLoad() {
		CallableCacheLoaderAdapter<String, Object> instance = new CallableCacheLoaderAdapter<>(mockCacheLoader);

		when(mockCacheLoader.load(eq(mockLoaderHelper))).thenReturn("test");

		assertThat(instance.load(mockLoaderHelper), is(equalTo("test")));

		verify(mockCacheLoader, times(1)).load(eq(mockLoaderHelper));
	}
}