/*
* This file is part of the Illarion project.
*
* Copyright © 2015 - Illarion e.V.
*
* Illarion is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Illarion is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*/
package illarion.common.config.entries;
import illarion.common.config.Config;
import org.jetbrains.annotations.Contract;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import java.nio.file.Path;
import java.util.Objects;
/**
* This is a configuration entry that is used to set a directory select entry in
* the configuration. It will display a short text field along with a button to
* search for the directory. The default search directory will be the home
* directory of the user.
*
* @author Martin Karing <nitram@illarion.org>
*/
public final class DirectoryEntry implements ConfigEntry {
/**
* The configuration that is controlled by this directory entry.
*/
@Nullable
private Config cfg;
/**
* The key in the configuration that is handled by this configuration.
*/
@Nonnull
private final String configEntry;
/**
* The directory that is displayed by default.
*/
@Nonnull
private final String dir;
/**
* Create a new configuration entry that is handled by this entry.
*
* @param entry the configuration key that is handled by this file entry
* @param defaultDir the default directory that is opened in case no file is
* selected
*/
public DirectoryEntry(@Nonnull String entry, @Nullable String defaultDir) {
configEntry = entry;
dir = Objects.requireNonNull((defaultDir == null) ? System.getProperty("user.home") : defaultDir);
}
/**
* Get the directory that is displayed by default.
*
* @return the directory displayed by default
*/
@Nonnull
@Contract(pure = true)
public String getDefaultDir() {
return dir;
}
/**
* Get the value set in the configuration for this text entry.
*
* @return the configuration stored for this text entry
*/
@Nullable
@Contract(pure = true)
public Path getValue() {
if (cfg == null) {
throw new IllegalStateException("There is no reference to the configuration system set.");
}
return cfg.getPath(configEntry);
}
/**
* Set the configuration handled by this configuration entry.
*
* @param config the configuration that is supposed to be handled by this
* configuration entry
*/
@Override
public void setConfig(@Nonnull Config config) {
cfg = config;
}
/**
* Set the new value of the configuration entry that is controlled by this.
*
* @param newValue the new configuration value
*/
public void setValue(@Nonnull Path newValue) {
if (cfg == null) {
throw new IllegalStateException("There is no reference to the configuration system set.");
}
cfg.set(configEntry, newValue);
}
}