JabRef 5.15 · org.jabref.gui.LibraryTab · APIdia, the JavaDoc alternative

Modifier and Type	Class and Description
public static class	LibraryTab.DatabaseNotification
private class	LibraryTab.EntriesRemovedListener
private class	LibraryTab.GroupTreeListener
private class	LibraryTab.IndexUpdateListener
private static enum	LibraryTab.PanelMode Defines the different modes that the tab can operate in

Modifier and Type	Field and Description
private FileAnnotationCache	annotationCache
private BibDatabaseContext	bibDatabaseContext
private final BooleanProperty	changedProperty
private Optional<DatabaseChangeMonitor>	changeMonitor
private CitationStyleCache	citationStyleCache
private final ClipBoardManager	clipBoardManager
private Optional<SearchQuery>	currentSearchQuery
private LibraryTab.DatabaseNotification	databaseNotificationPane
private BackgroundTask<ParserResult>	dataLoadingTask
private final DialogService	dialogService
private final DirectoryMonitorManager	directoryMonitorManager
private com.tobiasdiez.easybind.Subscription	dividerPositionSubscription
private EntryEditor	entryEditor
private final BibEntryTypesManager	entryTypesManager
private final FileUpdateMonitor	fileUpdateMonitor
private final IndexingTaskManager	indexingTaskManager
private final SimpleBooleanProperty	loading
private static final Logger	LOGGER
private MainTable	mainTable
private LibraryTab.PanelMode	mode
private final BooleanProperty	nonUndoableChangeProperty
private final PreferencesService	preferencesService
private boolean	saving
private PersonNameSuggestionProvider	searchAutoCompleter
private BibEntry	showing
private SplitPane	splitPane
private final StateManager	stateManager
private SuggestionProviders	suggestionProviders
private final LibraryTabContainer	tabContainer
private MainTableDataModel	tableModel
private final TaskExecutor	taskExecutor
private final CountingUndoManager	undoManager

Access	Constructor and Description
private	LibraryTab(BibDatabaseContext bibDatabaseContext, LibraryTabContainer tabContainer, DialogService dialogService, PreferencesService preferencesService, StateManager stateManager, FileUpdateMonitor fileUpdateMonitor, BibEntryTypesManager entryTypesManager, CountingUndoManager undoManager, ClipBoardManager clipBoardManager, TaskExecutor taskExecutor)

Method Summary

Modifier and Type	Method and Description
private static void	addChangedInformation(StringBuilder text, String fileName)
private static void	addModeInfo(StringBuilder text, BibDatabaseContext bibDatabaseContext)
private static void	addSharedDbInformation(StringBuilder text, BibDatabaseContext bibDatabaseContext)
public void	clearAndSelect(final BibEntry bibEntry) This method selects the given entry, and scrolls it into view in the table.
public void	closeBottomPane() Removes the bottom component.
private boolean	Returns: `true` if the user choose to close the database confirmClose() Ask if the user really wants to close the given database.
public void	copy()
private EntryEditor	createEntryEditor()
public static LibraryTab	createLibraryTab(BackgroundTask<ParserResult> The task to execute to load the data asynchronously. dataLoadingTask, Path the path to the file (loaded by the dataLoadingTask) file, DialogService dialogService, PreferencesService preferencesService, StateManager stateManager, LibraryTabContainer tabContainer, FileUpdateMonitor fileUpdateMonitor, BibEntryTypesManager entryTypesManager, CountingUndoManager undoManager, ClipBoardManager clipBoardManager, TaskExecutor taskExecutor) Creates a new library tab.
public static LibraryTab	createLibraryTab(BibDatabaseContext databaseContext, LibraryTabContainer tabContainer, DialogService dialogService, PreferencesService preferencesService, StateManager stateManager, FileUpdateMonitor fileUpdateMonitor, BibEntryTypesManager entryTypesManager, UndoManager undoManager, ClipBoardManager clipBoardManager, TaskExecutor taskExecutor)
private Node	createLoadingAnimationLayout() The layout to display in the tab when it is loading
private void	createMainTable()
public void	cut()
public void	delete(StandardActions If DELETE_ENTRY the user will get asked if he really wants to delete the entries, and it will be localized as "deleted". If true the action will be localized as "cut" mode) Removes the selected entries and files linked to selected entries from the database
private void	delete(StandardActions If DELETE_ENTRY the user will get asked if he really wants to delete the entries, and it will be localized as "deleted". If true the action will be localized as "cut" mode, List<BibEntry> entries) Removes the selected entries and files linked to selected entries from the database
public void	delete(BibEntry entry)
public void	dropEntry(List<BibEntry> entriesToAdd)
public void	editEntryAndFocusField(BibEntry entry, Field field)
private void	ensureNotShowingBottomPanel(List<BibEntry> entriesToCheck) Closes the entry editor if it is showing any of the given entries.
public void	entryEditorClosing() This method is called from an EntryEditor when it should be closed.
public FileAnnotationCache	getAnnotationCache()
public SuggestionProvider<Author>	getAutoCompleter()
public BibDatabaseContext	getBibDatabaseContext()
public CitationStyleCache	getCitationStyleCache()
public Optional<SearchQuery>	getCurrentSearchQuery()
public BibDatabase	getDatabase()
public DirectoryMonitorManager	getDirectoryMonitorManager()
public EntryEditor	getEntryEditor()
public IndexingTaskManager	getIndexingTaskManager()
public ObservableBooleanValue	getLoading()
public MainTable	getMainTable()
public LibraryTab.DatabaseNotification	getNotificationPane()
public List<BibEntry>	Returns: A list containing the selected entries. Is never null. getSelectedEntries() Get an array containing the currently selected entries.
public SuggestionProviders	getSuggestionProviders() Returns a collection of suggestion providers, which are populated from the current library.
public CountingUndoManager	getUndoManager()
public void	insertEntries(final List<BibEntry> entries)
public void	insertEntry(final BibEntry bibEntry)
public void	installAutosaveManagerAndBackupManager()
private boolean	isDatabaseReadyForAutoSave(BibDatabaseContext context)
private boolean	isDatabaseReadyForBackup(BibDatabaseContext context)
public boolean	isModified()
public boolean	isSaving()
public void	listen(BibDatabaseContextChangedEvent event)
public void	markBaseChanged()
public synchronized void	markChangedOrUnChanged() Put an asterisk behind the filename to indicate the database has changed.
public void	markNonUndoableBaseChanged()
private void	onClosed(Event event) Perform necessary cleanup when this Library is closed.
private void	onCloseRequest(Event event)
private void	onDatabaseLoadingFailed(Exception ex)
private void	onDatabaseLoadingStarted()
private void	onDatabaseLoadingSucceed(ParserResult result)
public void	paste()
public void	registerUndoableChanges(List<FieldChange> changes)
public boolean	requestClose()
public void	resetChangedProperties()
public void	resetChangeMonitor()
private void	saveDividerLocation(Number position) Depending on whether a preview or an entry editor is showing, save the current divider location in the correct preference setting.
public void	selectNextEntry()
public void	selectPreviousEntry()
public void	setCurrentSearchQuery(Optional<SearchQuery> currentSearchQuery) Set the query the user currently searches while this basepanel is active
private void	setDatabaseContext(BibDatabaseContext bibDatabaseContext)
private void	setDataLoadingTask(BackgroundTask<ParserResult> dataLoadingTask)
public void	setSaving(boolean saving)
private void	setupAutoCompletion() Set up autocompletion for this database
public void	setupMainPanel()
public void	showAndEdit(BibEntry The entry to edit. entry) Sets the entry editor as the bottom component in the split pane.
private boolean	Returns: true if user confirm to delete entry showDeleteConfirmationDialog(int number of entries user is selecting numberOfEntries) Initializes a pop-up dialog box to confirm whether the user wants to delete the selected entry Keep track of user preference: if the user prefers not to ask before deleting, delete the selected entry without displaying the dialog box
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
public void	updateEntryEditorIfShowing()
public void	updateTabTitle(boolean isChanged) Sets the title of the tab modification-asterisk filename – path-fragment The modification-asterisk () is shown if the file was modified since last save (path-fragment is only shown if filename is not (globally) unique) Example: jabref-authors.bib – testbib

Field Detail

annotationCache	back to summary
private FileAnnotationCache annotationCache

bibDatabaseContext	back to summary
private BibDatabaseContext bibDatabaseContext

changedProperty	back to summary
private final BooleanProperty changedProperty

changeMonitor	back to summary
private Optional<DatabaseChangeMonitor> changeMonitor

citationStyleCache	back to summary
private CitationStyleCache citationStyleCache

clipBoardManager	back to summary
private final ClipBoardManager clipBoardManager

currentSearchQuery	back to summary
private Optional<SearchQuery> currentSearchQuery

databaseNotificationPane	back to summary
private LibraryTab.DatabaseNotification databaseNotificationPane

dataLoadingTask	back to summary
private BackgroundTask<ParserResult> dataLoadingTask

dialogService	back to summary
private final DialogService dialogService

directoryMonitorManager	back to summary
private final DirectoryMonitorManager directoryMonitorManager

dividerPositionSubscription	back to summary
private com.tobiasdiez.easybind.Subscription dividerPositionSubscription Annotations @SuppressWarnings:FieldCanBeLocal

entryEditor	back to summary
private EntryEditor entryEditor

entryTypesManager	back to summary
private final BibEntryTypesManager entryTypesManager

fileUpdateMonitor	back to summary
private final FileUpdateMonitor fileUpdateMonitor

indexingTaskManager	back to summary
private final IndexingTaskManager indexingTaskManager

loading	back to summary
private final SimpleBooleanProperty loading

LOGGER	back to summary
private static final Logger LOGGER

mainTable	back to summary
private MainTable mainTable

mode	back to summary
private LibraryTab.PanelMode mode

nonUndoableChangeProperty	back to summary
private final BooleanProperty nonUndoableChangeProperty

preferencesService	back to summary
private final PreferencesService preferencesService

saving	back to summary
private boolean saving

searchAutoCompleter	back to summary
private PersonNameSuggestionProvider searchAutoCompleter

showing	back to summary
private BibEntry showing

splitPane	back to summary
private SplitPane splitPane

stateManager	back to summary
private final StateManager stateManager

suggestionProviders	back to summary
private SuggestionProviders suggestionProviders

tabContainer	back to summary
private final LibraryTabContainer tabContainer

tableModel	back to summary
private MainTableDataModel tableModel

taskExecutor	back to summary
private final TaskExecutor taskExecutor

undoManager	back to summary
private final CountingUndoManager undoManager

Constructor Detail

LibraryTab	back to summary
private LibraryTab(BibDatabaseContext bibDatabaseContext, LibraryTabContainer tabContainer, DialogService dialogService, PreferencesService preferencesService, StateManager stateManager, FileUpdateMonitor fileUpdateMonitor, BibEntryTypesManager entryTypesManager, CountingUndoManager undoManager, ClipBoardManager clipBoardManager, TaskExecutor taskExecutor)

Method Detail

addChangedInformation	back to summary
private static void addChangedInformation(StringBuilder text, String fileName)

addModeInfo	back to summary
private static void addModeInfo(StringBuilder text, BibDatabaseContext bibDatabaseContext)

addSharedDbInformation	back to summary
private static void addSharedDbInformation(StringBuilder text, BibDatabaseContext bibDatabaseContext)

clearAndSelect	back to summary
public void clearAndSelect(final BibEntry bibEntry) This method selects the given entry, and scrolls it into view in the table. If an entryEditor is shown, it is given focus afterwards.

closeBottomPane	back to summary
public void closeBottomPane() Removes the bottom component.

confirmClose back to summary

confirmClose	back to summary
private boolean confirmClose() Ask if the user really wants to close the given database. Offers to save or discard the changes -- or return to the library Returns:boolean `true` if the user choose to close the database

private boolean confirmClose()

Ask if the user really wants to close the given database. Offers to save or discard the changes -- or return to the library

Returns:boolean: true if the user choose to close the database

copy	back to summary
public void copy()

createEntryEditor	back to summary
private EntryEditor createEntryEditor()

createLibraryTab back to summary

createLibraryTab	back to summary
public static LibraryTab createLibraryTab(BackgroundTask<ParserResult> dataLoadingTask, Path file, DialogService dialogService, PreferencesService preferencesService, StateManager stateManager, LibraryTabContainer tabContainer, FileUpdateMonitor fileUpdateMonitor, BibEntryTypesManager entryTypesManager, CountingUndoManager undoManager, ClipBoardManager clipBoardManager, TaskExecutor taskExecutor) Creates a new library tab. Contents are loaded by the `dataLoadingTask`. Most of the other parameters are required by `resetChangeMonitor()`. Parameters dataLoadingTask:BackgroundTask<ParserResult> The task to execute to load the data asynchronously. file:Path the path to the file (loaded by the dataLoadingTask)

public static LibraryTab createLibraryTab(BackgroundTask<ParserResult> dataLoadingTask, Path file, DialogService dialogService, PreferencesService preferencesService, StateManager stateManager, LibraryTabContainer tabContainer, FileUpdateMonitor fileUpdateMonitor, BibEntryTypesManager entryTypesManager, CountingUndoManager undoManager, ClipBoardManager clipBoardManager, TaskExecutor taskExecutor)

Creates a new library tab. Contents are loaded by the dataLoadingTask. Most of the other parameters are required by resetChangeMonitor().

Parameters

dataLoadingTask:BackgroundTask<ParserResult>: The task to execute to load the data asynchronously.
file:Path: the path to the file (loaded by the dataLoadingTask)

createLibraryTab	back to summary
public static LibraryTab createLibraryTab(BibDatabaseContext databaseContext, LibraryTabContainer tabContainer, DialogService dialogService, PreferencesService preferencesService, StateManager stateManager, FileUpdateMonitor fileUpdateMonitor, BibEntryTypesManager entryTypesManager, UndoManager undoManager, ClipBoardManager clipBoardManager, TaskExecutor taskExecutor)

createLoadingAnimationLayout	back to summary
private Node createLoadingAnimationLayout() The layout to display in the tab when it is loading

createMainTable	back to summary
private void createMainTable()

cut	back to summary
public void cut()

delete

back to summary

public void delete(StandardActions mode)

Removes the selected entries and files linked to selected entries from the database

Parameters

mode:StandardActions: If DELETE_ENTRY the user will get asked if he really wants to delete the entries, and it will be localized as "deleted". If true the action will be localized as "cut"

delete

back to summary

private void delete(StandardActions mode, List<BibEntry> entries)

Removes the selected entries and files linked to selected entries from the database

Parameters

mode:StandardActions: If DELETE_ENTRY the user will get asked if he really wants to delete the entries, and it will be localized as "deleted". If true the action will be localized as "cut"

delete	back to summary
public void delete(BibEntry entry)

dropEntry	back to summary
public void dropEntry(List<BibEntry> entriesToAdd)

editEntryAndFocusField	back to summary
public void editEntryAndFocusField(BibEntry entry, Field field)

ensureNotShowingBottomPanel	back to summary
private void ensureNotShowingBottomPanel(List<BibEntry> entriesToCheck) Closes the entry editor if it is showing any of the given entries.

entryEditorClosing	back to summary
public void entryEditorClosing() This method is called from an EntryEditor when it should be closed. We relay to the selection listener, which takes care of the rest.

getAnnotationCache	back to summary
public FileAnnotationCache getAnnotationCache()

getAutoCompleter	back to summary
public SuggestionProvider<Author> getAutoCompleter()

getBibDatabaseContext	back to summary
public BibDatabaseContext getBibDatabaseContext()

getCitationStyleCache	back to summary
public CitationStyleCache getCitationStyleCache()

getCurrentSearchQuery	back to summary
public Optional<SearchQuery> getCurrentSearchQuery()

getDatabase	back to summary
public BibDatabase getDatabase()

getDirectoryMonitorManager	back to summary
public DirectoryMonitorManager getDirectoryMonitorManager()

getEntryEditor	back to summary
public EntryEditor getEntryEditor()

getIndexingTaskManager	back to summary
public IndexingTaskManager getIndexingTaskManager()

getLoading	back to summary
public ObservableBooleanValue getLoading()

getMainTable	back to summary
public MainTable getMainTable()

getNotificationPane	back to summary
public LibraryTab.DatabaseNotification getNotificationPane()

getSelectedEntries

back to summary

public List<BibEntry> getSelectedEntries()

Get an array containing the currently selected entries. The array is stable and not changed if the selection changes

Returns:List<BibEntry>: A list containing the selected entries. Is never null.

getSuggestionProviders	back to summary
public SuggestionProviders getSuggestionProviders() Returns a collection of suggestion providers, which are populated from the current library.

getUndoManager	back to summary
public CountingUndoManager getUndoManager()

insertEntries	back to summary
public void insertEntries(final List<BibEntry> entries)

insertEntry	back to summary
public void insertEntry(final BibEntry bibEntry)

installAutosaveManagerAndBackupManager	back to summary
public void installAutosaveManagerAndBackupManager()

isDatabaseReadyForAutoSave	back to summary
private boolean isDatabaseReadyForAutoSave(BibDatabaseContext context)

isDatabaseReadyForBackup	back to summary
private boolean isDatabaseReadyForBackup(BibDatabaseContext context)

isModified	back to summary
public boolean isModified()

isSaving	back to summary
public boolean isSaving()

listen	back to summary
public void listen(BibDatabaseContextChangedEvent event) Annotations @Subscribe

markBaseChanged	back to summary
public void markBaseChanged()

markChangedOrUnChanged	back to summary
public synchronized void markChangedOrUnChanged() Put an asterisk behind the filename to indicate the database has changed.

markNonUndoableBaseChanged	back to summary
public void markNonUndoableBaseChanged()

onClosed	back to summary
private void onClosed(Event event) Perform necessary cleanup when this Library is closed.

onCloseRequest	back to summary
private void onCloseRequest(Event event)

onDatabaseLoadingFailed	back to summary
private void onDatabaseLoadingFailed(Exception ex)

onDatabaseLoadingStarted	back to summary
private void onDatabaseLoadingStarted()

onDatabaseLoadingSucceed	back to summary
private void onDatabaseLoadingSucceed(ParserResult result)

paste	back to summary
public void paste()

registerUndoableChanges	back to summary
public void registerUndoableChanges(List<FieldChange> changes)

requestClose	back to summary
public boolean requestClose()

resetChangedProperties	back to summary
public void resetChangedProperties()

resetChangeMonitor	back to summary
public void resetChangeMonitor()

saveDividerLocation	back to summary
private void saveDividerLocation(Number position) Depending on whether a preview or an entry editor is showing, save the current divider location in the correct preference setting.

selectNextEntry	back to summary
public void selectNextEntry()

selectPreviousEntry	back to summary
public void selectPreviousEntry()

setCurrentSearchQuery	back to summary
public void setCurrentSearchQuery(Optional<SearchQuery> currentSearchQuery) Set the query the user currently searches while this basepanel is active

setDatabaseContext	back to summary
private void setDatabaseContext(BibDatabaseContext bibDatabaseContext)

setDataLoadingTask	back to summary
private void setDataLoadingTask(BackgroundTask<ParserResult> dataLoadingTask)

setSaving	back to summary
public void setSaving(boolean saving)

setupAutoCompletion	back to summary
private void setupAutoCompletion() Set up autocompletion for this database

setupMainPanel	back to summary
public void setupMainPanel()

showAndEdit

back to summary

public void showAndEdit(BibEntry entry)

Sets the entry editor as the bottom component in the split pane. If an entry editor already was shown, makes sure that the divider doesn't move. Updates the mode to SHOWING_EDITOR. Then shows the given entry.

Parameters

entry:BibEntry: The entry to edit.

showDeleteConfirmationDialog

back to summary

private boolean showDeleteConfirmationDialog(int numberOfEntries)

Initializes a pop-up dialog box to confirm whether the user wants to delete the selected entry Keep track of user preference: if the user prefers not to ask before deleting, delete the selected entry without displaying the dialog box

Parameters

numberOfEntries:int: number of entries user is selecting

Returns:boolean

true if user confirm to delete entry

toString back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Returns:String

a string representation of the object

Annotations

@Override

updateEntryEditorIfShowing	back to summary
public void updateEntryEditorIfShowing()

updateTabTitle

back to summary

public void updateTabTitle(boolean isChanged)

Sets the title of the tab modification-asterisk filename – path-fragment

The modification-asterisk (*) is shown if the file was modified since last save (path-fragment is only shown if filename is not (globally) unique)

Example: *jabref-authors.bib – testbib

Modifier and Type	Field and Description
public static final LibraryTab.PanelMode	MAIN_TABLE
public static final LibraryTab.PanelMode	MAIN_TABLE_AND_ENTRY_EDITOR

Modifier and Type	Method and Description
public static LibraryTab.PanelMode	valueOf(String name)
public static LibraryTab.PanelMode[]	values()

public Class LibraryTab

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class LibraryTab.DatabaseNotification

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class LibraryTab.EntriesRemovedListener

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class LibraryTab.GroupTreeListener

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class LibraryTab.IndexUpdateListener

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private final Enum LibraryTab.PanelMode

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

Modifier and Type	Method and Description
public void	listen(EntriesAddedEvent addedEntryEvent)
public void	listen(EntriesRemovedEvent removedEntriesEvent)
public void	listen(FieldChangedEvent fieldChangedEvent)