com.hazelcast.internal

Class PlatformSpecific

java.lang.Object

com.hazelcast.internal.PlatformSpecific

public final class PlatformSpecific
extends Object

Utility class to construct instances depending on the runtime platform. Steps to introduce Java 6 / 8 alternative implementations:

1. Define and use an interface in Hazelcast codebase
2. Implement the interface for Java 6
3. Implement the interface for Java 8+. Annotate this implementation with RequiresJdk8: animal-sniffer will not scan the annotated class or methods for Java 6 API compatibility, so use this annotation at the smallest possible scope
4. Add a createXYZ public static method in PlatformSpecific utility class
5. Use PlatformSpecific.createXYZ whenever you need a new instance

The implementation of a constructor utility method would look something like this example:

 public static <S> MethodProbe createLongMethodProbe(Method method, Probe probe, int type) {
   if (JavaVersion.isAtLeast(JAVA_8)) {
     return new LongMethodProbeJdk8<S>(method, probe, type);
   } else {
     return new MethodProbe.LongMethodProbe<S>(method, probe, type);
   }
 }
 

This should be tested in two separate tests, to ensure the proper instance is created depending on Java runtime version, like this:

     @Test
     public void testJdk8Probe() {
       // ensure this test only runs on JDK 8+
       assumeJdk8OrNewer();
       MethodProbe jdk8Probe = PlatformSpecific.createLongMethodProbe(...);
       assertTrue(jdk8Probe instanceof LongMethodProbeJdk8.class);
     }
 

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait