com.finbourne.notifications.extensions.ApiFactory Maven / Gradle / Ivy
package com.finbourne.notifications.extensions;
import com.finbourne.notifications.ApiClient;
import java.lang.reflect.Constructor;
import java.util.HashMap;
import java.util.Map;
/**
* Utility class that builds pre-configured notifications API instances to access notifications.
*
*/
public class ApiFactory {
/**
* The unique package that hosts all the notifications API classes
*/
public static final String API_PACKAGE = "com.finbourne.notifications.api";
private final ApiClient apiClient;
private final Map initialisedApis;
/**
* Create a API factory based on an {@link ApiClient}
*
* @param apiClient configured to a specific application
*/
public ApiFactory(ApiClient apiClient) {
this.apiClient = apiClient;
initialisedApis = new HashMap<>();
}
/**
* Builds an instance of a notifications API
*
* For each instance of an {@link ApiFactory} only a singleton instance of each notifications API class exist. The APIs
* are lazily initialised on request.
*
*
* @param apiClass - class of the notifications API to create
* @param notifications API type
* @return instance of the notifications API type configured as per the {@link ApiClient}
*
* @throws UnsupportedOperationException is the apiClass does not belong to the import com.finbourne.notifications.api package or
* if the class has no constructor that accepts an {@link ApiClient} parameter.
*/
public synchronized T build(Class apiClass) {
@SuppressWarnings (value="unchecked")
T apiInstance = (T) initialisedApis.get(apiClass);
if (apiInstance == null) {
checkIsSupportedApiClass(apiClass);
Constructor constructor = getApiConstructor(apiClass);
apiInstance = createInstance(constructor);
initialisedApis.put(apiClass, apiInstance);
}
return apiInstance;
};
/*
* Create an instance of a notifications API configured by an {@link ApiClient}
*
* @throws UnsupportedOperationException on any reflection related issues on constructing the notifications API object
*/
private T createInstance(Constructor constructor){
try {
return constructor.newInstance(apiClient);
} catch (ReflectiveOperationException e) {
throw new UnsupportedOperationException("Construction of " + constructor.getClass().getName() + " failed " +
"due to an invalid instantiation call.",e);
}
}
/*
* Retrieves the constructor for the notifications API that accepts an {@link ApiClient}
*
* @throws UnsupportedOperationException if the class doesn't have a valid constructor that takes
* an {@link ApiClient} as an argument to ensure proper construction of a notifications API instance.
*/
private Constructor getApiConstructor(Class apiClass){
try {
return apiClass.getDeclaredConstructor(ApiClient.class);
} catch (NoSuchMethodException e) {
throw new UnsupportedOperationException(apiClass.getName() + " has no single argument constructor taking " +
"in " + ApiClient.class.getName());
}
}
/*
* Checks the class lives in the set package for notifications API classes.
*
* @throws UnsupportedOperationException if API class does not live in notifications API package
*/
private void checkIsSupportedApiClass(Class apiClass){
if (!isInApiPackage(apiClass)) {
throw new UnsupportedOperationException(apiClass.getName() + " class is not a supported API class. " +
"Supported API classes live in the " + ApiFactory.API_PACKAGE + " package.");
}
}
private boolean isInApiPackage(Class clazz){
return API_PACKAGE.equals(clazz.getPackage().getName());
}
}