com.google.firebase.remoteconfig.FirebaseRemoteConfig Maven / Gradle / Ivy
/*
* Copyright 2020 Google LLC
*
* 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 com.google.firebase.remoteconfig;
import static com.google.common.base.Preconditions.checkNotNull;
import com.google.api.core.ApiFuture;
import com.google.common.annotations.VisibleForTesting;
import com.google.firebase.FirebaseApp;
import com.google.firebase.ImplFirebaseTrampolines;
import com.google.firebase.internal.CallableOperation;
import com.google.firebase.internal.FirebaseService;
import com.google.firebase.internal.NonNull;
/**
* This class is the entry point for all server-side Firebase Remote Config actions.
*
* You can get an instance of {@link FirebaseRemoteConfig} via {@link #getInstance(FirebaseApp)},
* and then use it to manage Remote Config templates.
*/
public final class FirebaseRemoteConfig {
private static final String SERVICE_ID = FirebaseRemoteConfig.class.getName();
private final FirebaseApp app;
private final FirebaseRemoteConfigClient remoteConfigClient;
@VisibleForTesting
FirebaseRemoteConfig(FirebaseApp app, FirebaseRemoteConfigClient client) {
this.app = checkNotNull(app);
this.remoteConfigClient = checkNotNull(client);
}
private FirebaseRemoteConfig(FirebaseApp app) {
this(app, FirebaseRemoteConfigClientImpl.fromApp(app));
}
/**
* Gets the {@link FirebaseRemoteConfig} instance for the default {@link FirebaseApp}.
*
* @return The {@link FirebaseRemoteConfig} instance for the default {@link FirebaseApp}.
*/
public static FirebaseRemoteConfig getInstance() {
return getInstance(FirebaseApp.getInstance());
}
/**
* Gets the {@link FirebaseRemoteConfig} instance for the specified {@link FirebaseApp}.
*
* @return The {@link FirebaseRemoteConfig} instance for the specified {@link FirebaseApp}.
*/
public static synchronized FirebaseRemoteConfig getInstance(FirebaseApp app) {
FirebaseRemoteConfigService service = ImplFirebaseTrampolines.getService(app, SERVICE_ID,
FirebaseRemoteConfigService.class);
if (service == null) {
service = ImplFirebaseTrampolines.addService(app, new FirebaseRemoteConfigService(app));
}
return service.getInstance();
}
/**
* Gets the current active version of the Remote Config template.
*
* @return A {@link Template}.
* @throws FirebaseRemoteConfigException If an error occurs while getting the template.
*/
public Template getTemplate() throws FirebaseRemoteConfigException {
return getTemplateOp().call();
}
/**
* Similar to {@link #getTemplate()} but performs the operation asynchronously.
*
* @return An {@code ApiFuture} that completes with a {@link Template} when
* the template is available.
*/
public ApiFuture getTemplateAsync() {
return getTemplateOp().callAsync(app);
}
private CallableOperation getTemplateOp() {
final FirebaseRemoteConfigClient remoteConfigClient = getRemoteConfigClient();
return new CallableOperation() {
@Override
protected Template execute() throws FirebaseRemoteConfigException {
return remoteConfigClient.getTemplate();
}
};
}
/**
* Gets the requested version of the of the Remote Config template.
*
* @param versionNumber The version number of the Remote Config template to get.
* @return A {@link Template}.
* @throws FirebaseRemoteConfigException If an error occurs while getting the template.
*/
public Template getTemplateAtVersion(
@NonNull String versionNumber) throws FirebaseRemoteConfigException {
return getTemplateAtVersionOp(versionNumber).call();
}
/**
* Gets the requested version of the of the Remote Config template.
*
* @param versionNumber The version number of the Remote Config template to get.
* @return A {@link Template}.
* @throws FirebaseRemoteConfigException If an error occurs while getting the template.
*/
public Template getTemplateAtVersion(long versionNumber) throws FirebaseRemoteConfigException {
String versionNumberString = String.valueOf(versionNumber);
return getTemplateAtVersionOp(versionNumberString).call();
}
/**
* Similar to {@link #getTemplateAtVersion(String versionNumber)} but performs the operation
* asynchronously.
*
* @param versionNumber The version number of the Remote Config template to get.
* @return An {@code ApiFuture} that completes with a {@link Template} when
* the requested template is available.
*/
public ApiFuture getTemplateAtVersionAsync(@NonNull String versionNumber) {
return getTemplateAtVersionOp(versionNumber).callAsync(app);
}
/**
* Similar to {@link #getTemplateAtVersion(long versionNumber)} but performs the operation
* asynchronously.
*
* @param versionNumber The version number of the Remote Config template to get.
* @return An {@code ApiFuture} that completes with a {@link Template} when
* the requested template is available.
*/
public ApiFuture getTemplateAtVersionAsync(long versionNumber) {
String versionNumberString = String.valueOf(versionNumber);
return getTemplateAtVersionOp(versionNumberString).callAsync(app);
}
private CallableOperation getTemplateAtVersionOp(
final String versionNumber) {
final FirebaseRemoteConfigClient remoteConfigClient = getRemoteConfigClient();
return new CallableOperation() {
@Override
protected Template execute() throws FirebaseRemoteConfigException {
return remoteConfigClient.getTemplateAtVersion(versionNumber);
}
};
}
/**
* Publishes a Remote Config template.
*
* @param template The Remote Config template to be published.
* @return The published {@link Template}.
* @throws FirebaseRemoteConfigException If an error occurs while publishing the template.
*/
public Template publishTemplate(@NonNull Template template) throws FirebaseRemoteConfigException {
return publishTemplateOp(template).call();
}
/**
* Similar to {@link #publishTemplate(Template template)} but performs the operation
* asynchronously.
*
* @param template The Remote Config template to be published.
* @return An {@code ApiFuture} that completes with a {@link Template} when
* the provided template is published.
*/
public ApiFuture publishTemplateAsync(@NonNull Template template) {
return publishTemplateOp(template).callAsync(app);
}
/**
* Validates a Remote Config template.
*
* @param template The Remote Config template to be validated.
* @return The validated {@link Template}.
* @throws FirebaseRemoteConfigException If an error occurs while validating the template.
*/
public Template validateTemplate(
@NonNull Template template) throws FirebaseRemoteConfigException {
return publishTemplateOp(template, new PublishOptions().setValidateOnly(true)).call();
}
/**
* Similar to {@link #validateTemplate(Template template)} but performs the operation
* asynchronously.
*
* @param template The Remote Config template to be validated.
* @return An {@code ApiFuture} that completes with a {@link Template} when
* the provided template is validated.
*/
public ApiFuture validateTemplateAsync(@NonNull Template template) {
return publishTemplateOp(template, new PublishOptions().setValidateOnly(true)).callAsync(app);
}
/**
* Force publishes a Remote Config template.
*
* This method forces the Remote Config template to be updated without evaluating the ETag
* values. This approach is not recommended because it risks causing the loss of updates to your
* Remote Config template if multiple clients are updating the Remote Config template.
* See
* ETag usage and forced updates.
*
* @param template The Remote Config template to be forcefully published.
* @return The published {@link Template}.
* @throws FirebaseRemoteConfigException If an error occurs while publishing the template.
*/
public Template forcePublishTemplate(
@NonNull Template template) throws FirebaseRemoteConfigException {
return publishTemplateOp(template, new PublishOptions().setForcePublish(true)).call();
}
/**
* Similar to {@link #forcePublishTemplate(Template template)} but performs the operation
* asynchronously.
*
* @param template The Remote Config template to be forcefully published.
* @return An {@code ApiFuture} that completes with a {@link Template} when
* the provided template is published.
*/
public ApiFuture forcePublishTemplateAsync(@NonNull Template template) {
return publishTemplateOp(template, new PublishOptions().setForcePublish(true)).callAsync(app);
}
private CallableOperation publishTemplateOp(
final Template template) {
return publishTemplateOp(template, new PublishOptions());
}
private CallableOperation publishTemplateOp(
final Template template, final PublishOptions options) {
final FirebaseRemoteConfigClient remoteConfigClient = getRemoteConfigClient();
return new CallableOperation() {
@Override
protected Template execute() throws FirebaseRemoteConfigException {
return remoteConfigClient
.publishTemplate(template, options.isValidateOnly(), options.isForcePublish());
}
};
}
/**
* Rolls back a project's published Remote Config template to the specified version.
*
* A rollback is equivalent to getting a previously published Remote Config
* template and re-publishing it using a force update.
*
* @param versionNumber The version number of the Remote Config template to roll back to.
* The specified version number must be lower than the current version
* number, and not have been deleted due to staleness. Only the last 300
* versions are stored. All versions that correspond to non-active Remote
* Config templates (that is, all except the template that is being fetched
* by clients) are also deleted if they are more than 90 days old.
* @return The rolled back {@link Template}.
* @throws FirebaseRemoteConfigException If an error occurs while rolling back the template.
*/
public Template rollback(long versionNumber) throws FirebaseRemoteConfigException {
String versionNumberString = String.valueOf(versionNumber);
return rollbackOp(versionNumberString).call();
}
/**
* Rolls back a project's published Remote Config template to the specified version.
*
*
A rollback is equivalent to getting a previously published Remote Config
* template and re-publishing it using a force update.
*
* @param versionNumber The version number of the Remote Config template to roll back to.
* The specified version number must be lower than the current version
* number, and not have been deleted due to staleness. Only the last 300
* versions are stored. All versions that correspond to non-active Remote
* Config templates (that is, all except the template that is being fetched
* by clients) are also deleted if they are more than 90 days old.
* @return The rolled back {@link Template}.
* @throws FirebaseRemoteConfigException If an error occurs while rolling back the template.
*/
public Template rollback(@NonNull String versionNumber) throws FirebaseRemoteConfigException {
return rollbackOp(versionNumber).call();
}
/**
* Similar to {@link #rollback(long versionNumber)} but performs the operation
* asynchronously.
*
* @param versionNumber The version number of the Remote Config template to roll back to.
* @return An {@code ApiFuture} that completes with a {@link Template} once
* the rollback operation is successful.
*/
public ApiFuture rollbackAsync(long versionNumber) {
String versionNumberString = String.valueOf(versionNumber);
return rollbackOp(versionNumberString).callAsync(app);
}
/**
* Similar to {@link #rollback(String versionNumber)} but performs the operation
* asynchronously.
*
* @param versionNumber The version number of the Remote Config template to roll back to.
* @return An {@code ApiFuture} that completes with a {@link Template} once
* the rollback operation is successful.
*/
public ApiFuture rollbackAsync(@NonNull String versionNumber) {
String versionNumberString = String.valueOf(versionNumber);
return rollbackOp(versionNumberString).callAsync(app);
}
private CallableOperation rollbackOp(
final String versionNumber) {
final FirebaseRemoteConfigClient remoteConfigClient = getRemoteConfigClient();
return new CallableOperation() {
@Override
protected Template execute() throws FirebaseRemoteConfigException {
return remoteConfigClient.rollback(versionNumber);
}
};
}
/**
* Gets a list of Remote Config template versions that have been published, sorted in reverse
* chronological order. Only the last 300 versions are stored.
*
* @return A {@link ListVersionsPage} instance.
* @throws FirebaseRemoteConfigException If an error occurs while retrieving versions list.
*/
public ListVersionsPage listVersions() throws FirebaseRemoteConfigException {
return listVersionsOp().call();
}
/**
* Gets a list of Remote Config template versions that have been published, sorted in reverse
* chronological order. Only the last 300 versions are stored.
*
* @param options List version options.
* @return A {@link ListVersionsPage} instance.
* @throws FirebaseRemoteConfigException If an error occurs while retrieving versions list.
*/
public ListVersionsPage listVersions(
@NonNull ListVersionsOptions options) throws FirebaseRemoteConfigException {
return listVersionsOp(options).call();
}
/**
* Similar to {@link #listVersions()} but performs the operation
* asynchronously.
*
* @return A {@link ListVersionsPage} instance.
*/
public ApiFuture listVersionsAsync() {
return listVersionsOp().callAsync(app);
}
/**
* Similar to {@link #listVersions(ListVersionsOptions options)} but performs the operation
* asynchronously.
*
* @param options List version options.
* @return A {@link ListVersionsPage} instance.
*/
public ApiFuture listVersionsAsync(@NonNull ListVersionsOptions options) {
return listVersionsOp(options).callAsync(app);
}
private CallableOperation listVersionsOp() {
return listVersionsOp(null);
}
private CallableOperation listVersionsOp(
final ListVersionsOptions options) {
final FirebaseRemoteConfigClient remoteConfigClient = getRemoteConfigClient();
final ListVersionsPage.DefaultVersionSource source =
new ListVersionsPage.DefaultVersionSource(remoteConfigClient);
final ListVersionsPage.Factory factory = new ListVersionsPage.Factory(source, options);
return new CallableOperation() {
@Override
protected ListVersionsPage execute() throws FirebaseRemoteConfigException {
return factory.create();
}
};
}
@VisibleForTesting
FirebaseRemoteConfigClient getRemoteConfigClient() {
return remoteConfigClient;
}
private static class FirebaseRemoteConfigService extends FirebaseService {
FirebaseRemoteConfigService(FirebaseApp app) {
super(SERVICE_ID, new FirebaseRemoteConfig(app));
}
@Override
public void destroy() {
// NOTE: We don't explicitly tear down anything here, but public methods of
// FirebaseRemoteConfig will now fail because calls to getOptions() and getToken()
// will hit FirebaseApp, which will throw once the app is deleted.
}
}
}