JabRefPreferences class provides the preferences and their defaults using
the JDK java.util.prefs class.
Internally it defines symbols used to pick a value from the java.util.prefs
interface and keeps a hashmap with all the default values.
There are still some similar preferences classes (OpenOfficePreferences and
SharedDatabasePreferences) which also use the java.util.prefs API.
contents of the defaults HashMap that are defined in this class. There are more default parameters in this map which belong to separate preference classes.
This class is injected into formatter using reflection to avoid tight coupling and is easier than injecting via constructor due to amount of refactoring
| Modifier and Type | Class and Description |
|---|---|
| private static record | JabRefCliPreferences.
Identifies a single secret in the system keyring by its |
| private static record |
| Modifier and Type | Field and Description |
|---|---|
| private AbbreviationPreferences | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private AiPreferences | |
| private final List | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| private AutoLinkPreferences | |
| private static final String | |
| private static final String | |
| private BibEntryPreferences | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| private CitationKeyPatternPreferences | |
| public static final String | |
| public static final String | |
| public static final String | |
| private CleanupPreferences | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| private DOIPreferences | |
| public static final String | |
| private static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| private static final int | |
| private static final int | |
| private static final int | |
| private ExportPreferences | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private FieldPreferences | |
| private FilePreferences | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private GitPreferences | |
| public static final String | |
| public static final String | |
| public static final String | |
| private GrobidPreferences | |
| public static final String | |
| public static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private ImporterPreferences | |
| private InternalPreferences | |
| public static final String | |
| public static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| public static final String | |
| private LastFilesOpenedPreferences | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| private LibraryPreferences | libraryPreferences
Cache variables |
| private static final Logger | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| private NameFormatterPreferences | |
| public static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private OcrPreferences | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | OO_EXECUTABLE_PATH
The OpenOffice/LibreOffice connection preferences are: OO_PATH main directory for OO/LO installation, used to detect location on Win/macOS when using manual connect OO_EXECUTABLE_PATH path to soffice-file OO_JARS_PATH directory that contains juh.jar, jurt.jar, ridl.jar, unoil.jar OO_SYNC_WHEN_CITING true if the reference list is updated when adding a new citation OO_SHOW_PANEL true if the OO panel is shown on startup OO_USE_ALL_OPEN_DATABASES true if all databases should be used when citing OO_BIBLIOGRAPHY_STYLE_FILE path to the used style file OO_EXTERNAL_STYLE_FILES list with paths to external style files STYLES__ size and position of "Select style" dialog |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| private OpenOfficePreferences | |
| public static final String | |
| public static final String | |
| public static final String | |
| private OwnerPreferences | |
| private static final String | |
| private static final String | |
| private static final Preferences | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private ProtectedTermsPreferences | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private ProxyPreferences | |
| private static final Map | |
| private static final String | PUSH_APPLICATIONS_PATHS_KEY
Synthetic registry key: command paths are persisted under per-application keys (see PUSH_APPLICATIONS_PATHS), not under this key |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private PushToApplicationPreferences | |
| private static final String | |
| private RemotePreferences | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| private SearchPreferences | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static final String | |
| private static JabRefCliPreferences | |
| private static final String | |
| private SSLPreferences | |
| public static final Character | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| private TimestampPreferences | |
| private static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| public static final String | |
| private XmpPreferences |
| Access | Constructor and Description |
|---|---|
| public |
| Modifier and Type | Method and Description |
|---|---|
| private void | addEntryTypesFromPreferences(Preferences prefsNode, Map<String, BibEntryType> storedEntryTypes, boolean allowOverWrite, String versionLabel)
|
| protected void | |
| protected void | bindBooleanInverted(BooleanProperty property, String key, boolean defaultValue)
Binds a boolean persisted inverted: the backing store holds |
| protected <T> void | bindCustom(Property<T> property, String key, T defaultValue, ChangeListener<? super T>
writes value changes to the backing store persistListener, Runnable loads the stored value (or the default) into the property importFromStore, Runnable restores the property to its default value resetToDefaults)General binding primitive that all scalar |
| protected <T> void | bindCustomList(ObservableList<T> list, String
the binding's reporting key in key, List<T> getPreferences() and getDefaults()restored on reset and reported as the default defaultList, Consumer<? super ObservableList<T>> rewrites the whole list to the backing store; receives the bound list, runs on every change persist, Supplier<? extends Collection<? extends T>> reads the stored list, falling back to loadFromStore)defaultList for absent entriesBinds an observable list with caller-supplied persistence; the general primitive behind the other
|
| private <T> void | bindCustomList(ObservableList<T> list, String key, List<T> defaultList, Function<List<T>, String>
converts the list to its stored String form serializer, Function<String, ? extends Collection<T>> reconstructs the list elements from their stored String form deserializer)Binds an observable list persisted as a single String. |
| protected void | |
| protected final <T> void | bindExclusiveFlags(ObjectProperty<T> property, T
reported as the default, restored on reset, and returned on load when no flag was ever stored defaultValue, T the value owning no key, encoded as all flags implicitValue, Map.falsethe backing-store key for each non-implicit value, in load lookup order (first match wins) flagsBinds an enum-valued property persisted as a set of mutually exclusive boolean keys, one per |
| protected void | |
| protected <K, V> void | bindMap(ObservableMap<K, V> map, String key, Map<K, V> defaultMap, MapChangeListener<? super K, ? super V>
persists individual entry changes to the backing store serializer, Function<Map<K, V>, Map<K, V>> reads the stored map, falling back to deserializer)defaultMap for missing entriesBinds a map-valued property. |
| protected <T> void | bindObject(ObjectProperty<T> property, String key, T defaultValue, Function<T, String>
converts a value to its stored String form serializer, Function<String, T> reconstructs a value from its stored String form deserializer)Binds an object-valued property persisted as a String. |
| private void | |
| protected void | bindPathList(ObservableList<Path> list, String
the binding's reporting key in key, List<Path> getPreferences() and getDefaults()restored on reset and reported as the default defaultList)Binds an observable list of paths persisted as a single delimited String (each path via |
| protected <T> void | bindSet(ObservableSet<T> set, String
the binding's reporting key in key, Set<T> getPreferences() and getDefaults()restored on reset and reported as the default defaultSet, Consumer<? super ObservableSet<T>> rewrites the whole set to the backing store; receives the bound set, runs on every change serializer, Supplier<? extends Collection<? extends T>> reads the stored set, falling back to deserializer)defaultSet for absent entriesBinds an observable set; the set counterpart of the primitive |
| protected void | |
| private void | bindToKeyring(StringProperty property, JabRefCliPreferences.
the keyring location to write to slot,gate evaluated on every change; the value is written only while it returns true shouldPersist)Persist-only binding for secrets kept in the system keyring rather than the backing store. |
| public void | |
| private void | |
| private void | |
| private void | |
| private void | |
| private void | |
| pack-priv static String | |
| pack-priv static List | |
| public void | deleteKey(String key)
Implements org. Removes the given key from the preferences. |
| public void | exportPreferences(Path
Path to export to path)Implements org. Exports Preferences to an XML file. |
| public void | flush()
Implements org. Calling this method will write all preferences into the preference store. |
| public String | |
| public AbbreviationPreferences | |
| public AiPreferences | |
| public AutoLinkPreferences | |
| public BibEntryPreferences | |
| private List | |
| public boolean | |
| private BstCitationFormat | |
| public CitationKeyPatternPreferences | |
| private CitationType | |
| private Set | |
| private FieldFormatterCleanupActions | |
| public CleanupPreferences | |
| private OOStyle | getCurrentOOStyle(OOStyle defaultStyle, JournalAbbreviationRepository journalAbbreviationRepository)
Reconstructs the persisted |
| public BibEntryTypesManager | |
| private List | |
| private Set | |
| protected Path | |
| private PlainCitationParserChoice | |
| public Map | |
| public DOIPreferences | |
| public double | |
| public ExportPreferences | |
| protected SaveOrder | |
| private Set | |
| private List | getFetcherKeysFromKeyring(List<String> names)
Reads the stored API keys aligned to |
| public FieldPreferences | |
| public SequencedSet | |
| public FilePreferences | |
| public GitPreferences | |
| private @NonNull GlobalCitationKeyPatterns | |
| public GrobidPreferences | |
| public ImporterPreferences | |
| public static JabRefCliPreferences | |
| public int | |
| public InternalPreferences | |
| protected Language | |
| public LastFilesOpenedPreferences | |
| public LibraryPreferences | |
| public NameFormatterPreferences | |
| private Object | |
| public OcrPreferences | |
| public OpenOfficePreferences | getOpenOfficePreferences(JournalAbbreviationRepository journalAbbreviationRepository)
Implements org.
|
| public OwnerPreferences | |
| private Path | |
| public Map | |
| private static Preferences | |
| private static Preferences | |
| public ProtectedTermsPreferences | |
| public ProxyPreferences | |
| public PushToApplicationPreferences | |
| public RemotePreferences | |
| private Set | |
| public SearchPreferences | |
| public SelfContainedSaveConfiguration | getSelfContainedExportConfiguration()
Implements org. Returns the export configuration. |
| protected List | |
| public SSLPreferences | |
| public List | |
| public TimestampPreferences | |
| public XmpPreferences | |
| private Set | |
| public boolean | |
| public void | importPreferences(Path
Path of file to import from path)Implements org. Imports Preferences from an XML file. |
| private static void | |
| protected void | initializeAll()
Instantiates every preference group so its bindings are registered in |
| private void | |
| private void | |
| protected boolean | |
| protected void | purgeSeries(String prefix, int
or higher. number)Removes all entries keyed by prefix+number, where number is equal to or higher than the given number. |
| public void | |
| public void | |
| public void | |
| public void | |
| public void | |
| public void | putStringList(String key, List<String> value)
Puts a list of strings into the Preferences, by linking its elements with a STRINGLIST_DELIMITER into a single string. |
| protected final <T> T | Returns: the stored enum value, ordefaultValue/implicitValue per the rules abovereturned when none of the flag keys exist defaultValue, T returned when all flag keys are stored implicitValue, Map.falsethe backing-store key for each non-implicit value, in lookup order (first match wins) flagsReads an enum persisted as mutually exclusive boolean keys (see |
| private Optional | readKeyring(JabRefCliPreferences.
Reads the secret at a single slot, or empty if it is absent/blank or the keyring is unavailable. |
| private Map | readKeyring(List<JabRefCliPreferences.
Reads and decrypts the secrets at the given slots in a single keyring session. |
| private Map | readPushToApplicationPath(Map<String, String> defaults)
An empty string is used as the default value to ensure that an installation of a tool leads to the new path (instead of leaving the empty one). |
| protected void | |
| private void | |
| public void | storeCustomEntryTypesRepository(BibEntryTypesManager entryTypesManager)
Implements org.
|
| private void | |
| private void | |
| private void | |
| private void | |
| public void | |
| private void | |
| private void | writeKeyring(JabRefCliPreferences.
Writes (or, for a blank secret, clears) a single slot. |
| private void | writeKeyring(Map<JabRefCliPreferences.
Encrypts and writes each secret to its slot in a single keyring session. |