org.eclipse.microprofile.fault.tolerance.tck.FallbackTest Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of microprofile-fault-tolerance-tck Show documentation
Show all versions of microprofile-fault-tolerance-tck Show documentation
Fault Tolerance for MicroProfile :: TCK
/*
*******************************************************************************
* Copyright (c) 2017 Contributors to the Eclipse Foundation
*
* See the NOTICE file(s) distributed with this work for additional
* information regarding copyright ownership.
*
* 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.eclipse.microprofile.fault.tolerance.tck;
import org.eclipse.microprofile.fault.tolerance.tck.fallback.clientserver.FallbackClassLevelClient;
import org.eclipse.microprofile.fault.tolerance.tck.fallback.clientserver.FallbackClient;
import org.eclipse.microprofile.fault.tolerance.tck.fallback.clientserver.FallbackOnlyClient;
import org.eclipse.microprofile.fault.tolerance.tck.fallback.clientserver.FallbackWithBeanClient;
import org.eclipse.microprofile.fault.tolerance.tck.fallback.clientserver.MyBean;
import org.eclipse.microprofile.fault.tolerance.tck.fallback.clientserver.SecondStringFallbackHandler;
import org.eclipse.microprofile.fault.tolerance.tck.fallback.clientserver.StringFallbackHandler;
import org.eclipse.microprofile.fault.tolerance.tck.fallback.clientserver.StringFallbackHandlerWithBean;
import org.eclipse.microprofile.faulttolerance.exceptions.TimeoutException;
import org.jboss.arquillian.container.test.api.Deployment;
import org.jboss.arquillian.testng.Arquillian;
import org.jboss.shrinkwrap.api.ShrinkWrap;
import org.jboss.shrinkwrap.api.asset.EmptyAsset;
import org.jboss.shrinkwrap.api.spec.JavaArchive;
import org.jboss.shrinkwrap.api.spec.WebArchive;
import org.testng.Assert;
import org.testng.annotations.Test;
import jakarta.inject.Inject;
/**
* Test fallback was invoked correctly; fallback handler supporting CDI injection; type safety on fallback class.
*
* @author Neil Young
*
*/
public class FallbackTest extends Arquillian {
private @Inject FallbackClient fallbackClient;
private @Inject FallbackWithBeanClient fallbackWithBeanClient;
private @Inject FallbackClassLevelClient fallbackClassLevelClient;
private @Inject FallbackOnlyClient fallbackOnlyClient;
@Deployment
public static WebArchive deploy() {
JavaArchive testJar = ShrinkWrap.create(JavaArchive.class, "ftfallback.jar")
.addClasses(FallbackClient.class, FallbackWithBeanClient.class,
FallbackClassLevelClient.class, StringFallbackHandler.class,
SecondStringFallbackHandler.class,
StringFallbackHandlerWithBean.class, MyBean.class,
FallbackOnlyClient.class)
.addAsManifestResource(EmptyAsset.INSTANCE, "beans.xml")
.as(JavaArchive.class);
WebArchive war = ShrinkWrap.create(WebArchive.class, "ftFallback.war")
.addAsLibrary(testJar);
return war;
}
/**
* Test that a Fallback service is driven after the specified number of retries are executed.
*
* Each of serviceA and serviceB specify the same FallbackHandler. The test checks that the handler has been driven
* in the correct ExecutionContext and that the Service has been executed the correct number of times.
*/
@Test
public void testFallbackSuccess() {
try {
String result = fallbackClient.serviceA();
Assert.assertTrue(result.contains("serviceA"),
"The message should be \"fallback for serviceA\"");
} catch (RuntimeException ex) {
Assert.fail("serviceA should not throw a RuntimeException in testFallbackSuccess");
}
Assert.assertEquals(fallbackClient.getCounterForInvokingServiceA(), 2,
"The execution count should be 2 (1 retry + 1)");
try {
String result = fallbackClient.serviceB();
Assert.assertTrue(result.contains("serviceB"),
"The message should be \"fallback for serviceB\"");
} catch (RuntimeException ex) {
Assert.fail("serviceB should not throw a RuntimeException in testFallbackSuccess");
}
Assert.assertEquals(fallbackClient.getCounterForInvokingServiceB(), 3,
"The execution count should be 3 (2 retries + 1)");
}
/**
* A refinement on testFallbackSuccess to test that a bean may be injected in the FallbackHandler.
*
* Each of serviceA and serviceB specify the same FallbackHandler. The test checks that the handler has been driven
* in the correct ExecutionContext and that the Service has been executed the correct number of times.
*/
@Test
public void testFallbackWithBeanSuccess() {
try {
String result = fallbackWithBeanClient.serviceA();
Assert.assertTrue(result.contains("serviceA"),
"The message should be \"fallback for serviceA\"");
// MyBean should be injected to the fallbackA
Assert.assertTrue(result.contains("34"),
"The message should be \"fallback for serviceA myBean.getCount()=34\"");
} catch (RuntimeException ex) {
Assert.fail("serviceA should not throw a RuntimeException in testFallbackWithBeanSuccess");
}
Assert.assertEquals(fallbackWithBeanClient.getCounterForInvokingServiceA(), 2,
"The execution count should be 2 (1 retry + 1)");
try {
String result = fallbackWithBeanClient.serviceB();
Assert.assertTrue(result.contains("serviceB"),
"The message should be \"fallback for serviceB\"");
// MyBean should be injected to the fallbackA, MyBean is application scoped,
// so the same instance should be injected to the fallback handler
Assert.assertTrue(result.contains("35"),
"The message should be \"fallback for serviceB myBean.getCount()=35\"");
} catch (RuntimeException ex) {
Assert.fail("serviceB should not throw a RuntimeException in testFallbackWithBeanSuccess");
}
Assert.assertEquals(fallbackWithBeanClient.getCounterForInvokingServiceB(), 3,
"The execution count should be 3 (2 retries + 1)");
}
/**
* Analogous to testFallbackSuccess with Class level annotations that are inherited by serviceA but overridden by
* serviceB.
*/
@Test
public void testClassLevelFallbackSuccess() {
try {
String result = fallbackClassLevelClient.serviceA();
Assert.assertTrue(result.contains("serviceA"),
"The message should be \"fallback for serviceA\"");
} catch (RuntimeException ex) {
Assert.fail("serviceA should not throw a RuntimeException in testFallbackSuccess");
}
Assert.assertEquals(fallbackClassLevelClient.getCounterForInvokingServiceA(), 2,
"The execution count should be 2 (1 retry + 1)");
try {
String result = fallbackClassLevelClient.serviceB();
Assert.assertTrue(result.contains("second fallback for serviceB"),
"The message should be \"second fallback for serviceB\"");
Assert.assertTrue(result.contains(RuntimeException.class.getName()),
"The message should be " + RuntimeException.class.getName());
} catch (RuntimeException ex) {
Assert.fail("serviceB should not throw a RuntimeException in testFallbackSuccess");
}
Assert.assertEquals(fallbackClassLevelClient.getCounterForInvokingServiceB(), 3,
"The execution count should be 3 (2 retries + 1)");
}
/**
* Test that a Fallback service is driven after the specified number of retries are executed.
*
* A timeout is configured for serviceC but the service should fail before the timeout is reached and generate a
* RuntimeException. After a retry the Fallback will be executed.
*/
@Test
public void testFallbacktNoTimeout() {
try {
String result = fallbackClient.serviceC(10);
Assert.assertTrue(result.contains("serviceC"),
"The message should be \"fallback for serviceC\"");
} catch (TimeoutException ex) {
// Not Expected
Assert.fail("serviceC should not throw a TimeoutException in testFallbacktNoTimeout");
} catch (RuntimeException ex) {
// Not expected
Assert.fail("serviceC should not throw a RuntimeException in testFallbacktNoTimeout");
}
Assert.assertEquals(fallbackClient.getCounterForInvokingServiceC(), 2,
"The execution count should be 2 (1 retry + 1)");
}
/**
* Test that a Fallback service is driven after the specified number of retries are executed.
*
* A timeout is configured for serviceC and in this case the service should generate Timeout exceptions. After a
* retry the Fallback will be executed.
*/
@Test
public void testFallbackTimeout() {
try {
String result = fallbackClient.serviceC(1000);
Assert.assertTrue(result.contains("serviceC"),
"The message should be \"fallback for serviceC\"");
} catch (TimeoutException ex) {
// Not Expected
Assert.fail("serviceC should not throw a TimeoutException in testFallbackTimeout");
} catch (RuntimeException ex) {
// Not Expected
Assert.fail("serviceC should not throw a RuntimeException in testFallbackTimeout");
}
Assert.assertEquals(fallbackClient.getCounterForInvokingServiceC(), 2,
"The execution count should be 2 (1 retry + 1)");
}
/**
* Test that a method in a Fallback service is driven after the specified number of retries are executed.
*
* ServiceD specifies a method on a FallbackHandler. The test checks that the FallbackHandler method has been driven
* and that the Service has been executed the correct number of times.
*/
@Test
public void testFallbackMethodSuccess() {
try {
String result = fallbackClient.serviceD();
Assert.assertTrue(result.contains("method for serviceD"),
"The message should be \"fallback method for serviceD\"");
} catch (RuntimeException ex) {
Assert.fail("serviceD should not throw a RuntimeException in testFallbackMethodSuccess");
}
Assert.assertEquals(fallbackClient.getCounterForInvokingServiceD(), 2,
"The execution count should be 2 (1 retry + 1)");
}
/**
* Analogous to testFallbackMethodSuccess but serviceE has a pair of parameters.
*
* ServiceE specifies a method on a FallbackHandler. The test checks that the FallbackHandler method has been driven
* and that the Service has been executed the correct number of times.
*/
@Test
public void testFallbackMethodWithArgsSuccess() {
try {
String result = fallbackClient.serviceE("serviceE", 42);
Assert.assertTrue(result.contains("method for serviceE"),
"The message should be \"fallback method for serviceE\"");
} catch (RuntimeException ex) {
Assert.fail("serviceE should not throw a RuntimeException in testFallbackMethodWithArgsSuccess");
}
Assert.assertEquals(fallbackClient.getCounterForInvokingServiceE(), 2,
"The execution count should be 2 (1 retry + 1)");
}
/**
* Test that a Fallback service can work alone, without other annotations.
*
* ServiceA fallback is driven by a class implementing FallbackHandler. ServiceA is only called once.
*/
@Test
public void testStandaloneHandlerFallback() {
try {
String result = fallbackOnlyClient.serviceA();
Assert.assertTrue(result.contains("serviceA"),
"The message should be \"fallback for serviceA\"");
} catch (RuntimeException ex) {
Assert.fail("serviceA should not throw a RuntimeException in testStandaloneClassLevelFallback");
}
Assert.assertEquals(fallbackOnlyClient.getCounterForInvokingServiceA(), 1,
"The getCounterForInvokingServiceA should be 1");
}
/**
* Test that a Fallback service can work alone, without other annotations.
*
* ServiceB fallback is driven by a FallbackHandler method in the same class. ServiceB is only called once.
*/
@Test
public void testStandaloneMethodFallback() {
try {
String result = fallbackOnlyClient.serviceB();
Assert.assertTrue(result.contains("serviceB"),
"The message should be \"fallback method for serviceB\"");
} catch (RuntimeException ex) {
Assert.fail("serviceB should not throw a RuntimeException in testStandaloneMethodFallback");
}
Assert.assertEquals(fallbackOnlyClient.getCounterForInvokingServiceB(), 1,
"The getCounterForInvokingServiceB should be 1");
}
}