/*
* Copyright 2012-2016 Credit Suisse
* Copyright 2018-2020 Werner Keil, Otavio Santana, Trivadis AG
*
* 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 javax.money.spi;
import java.util.*;
import java.util.logging.Logger;
This singleton provides access to the services available in the current runtime environment and context. The behaviour can be adapted, by calling init(ServiceProvider)
before accessing any monetary services. Author: Anatole Tresch
/**
* This singleton provides access to the services available in the current runtime environment and context. The
* behaviour can be adapted, by calling {@link Bootstrap#init(ServiceProvider)} before accessing any monetary
* services.
*
* @author Anatole Tresch
*/
public final class Bootstrap {
The ServiceProvider used.
/**
* The ServiceProvider used.
*/
private static volatile ServiceProvider serviceProviderDelegate;
The shared lock instance user.
/**
* The shared lock instance user.
*/
private static final Object LOCK = new Object();
Private singletons constructor.
/**
* Private singletons constructor.
*/
private Bootstrap() {
}
Load the ServiceProvider
to be used. Returns: ServiceProvider
to be used for loading the services.
/**
* Load the {@link ServiceProvider} to be used.
*
* @return {@link ServiceProvider} to be used for loading the services.
*/
private static ServiceProvider loadDefaultServiceProvider() {
try {
//noinspection LoopStatementThatDoesntLoop
for (ServiceProvider sp : ServiceLoader.load(ServiceProvider.class)) {
return sp;
}
} catch (Exception e) {
Logger.getLogger(Bootstrap.class.getName()).info("No ServiceProvider loaded, using default.");
}
return new DefaultServiceProvider();
}
Replace the current ServiceProvider
in use. Params: - serviceProvider – the new
ServiceProvider
Returns: the removed , or null.
/**
* Replace the current {@link ServiceProvider} in use.
*
* @param serviceProvider the new {@link ServiceProvider}
* @return the removed , or null.
*/
public static ServiceProvider init(ServiceProvider serviceProvider) {
Objects.requireNonNull(serviceProvider);
synchronized (LOCK) {
if (Objects.isNull(Bootstrap.serviceProviderDelegate)) {
Bootstrap.serviceProviderDelegate = serviceProvider;
Logger.getLogger(Bootstrap.class.getName())
.info("Money Bootstrap: new ServiceProvider set: " + serviceProvider.getClass().getName());
return null;
} else {
ServiceProvider prevProvider = Bootstrap.serviceProviderDelegate;
Bootstrap.serviceProviderDelegate = serviceProvider;
Logger.getLogger(Bootstrap.class.getName())
.warning("Money Bootstrap: ServiceProvider replaced: " + serviceProvider.getClass().getName());
return prevProvider;
}
}
}
Ge ServiceProvider
. If necessary the ServiceProvider
will be lazily loaded. Returns: the ServiceProvider
used.
/**
* Ge {@link ServiceProvider}. If necessary the {@link ServiceProvider} will be lazily loaded.
*
* @return the {@link ServiceProvider} used.
*/
static ServiceProvider getServiceProvider() {
if (Objects.isNull(serviceProviderDelegate)) {
synchronized (LOCK) {
if (Objects.isNull(serviceProviderDelegate)) {
serviceProviderDelegate = loadDefaultServiceProvider();
}
}
}
return serviceProviderDelegate;
}
Delegate method for ServiceProvider.getServices(Class<Object>)
. Params: - serviceType – the service type.
See Also: Returns: the services found.
/**
* Delegate method for {@link ServiceProvider#getServices(Class)}.
*
* @param serviceType the service type.
* @return the services found.
* @see ServiceProvider#getServices(Class)
*/
public static <T> Collection<T> getServices(Class<T> serviceType) {
return getServiceProvider().getServices(serviceType);
}
Delegate method for ServiceProvider.getServices(Class<Object>)
. Params: - serviceType – the service type.
See Also: Returns: the service found, or null
.
/**
* Delegate method for {@link ServiceProvider#getServices(Class)}.
*
* @param serviceType the service type.
* @return the service found, or {@code null}.
* @see ServiceProvider#getServices(Class)
*/
public static <T> T getService(Class<T> serviceType) {
List<T> services = getServiceProvider().getServices(serviceType);
return services
.stream()
.findFirst()
.orElse(null);
}
}