JabRef 6.0-beta.1 · org.jabref.model.database.BibDatabase

Modifier and Type	Field and Description
private static final int	BATCH_REPLACEMENT_THRESHOLD
private final Map<String, Set<BibEntry>>	citationIndex
private final ObservableList<BibEntry>	entries State attributes
private static final Comparator<BibEntry>	ENTRY_ID_COMPARATOR
private final Map<String, BibEntry>	entryIdToBibEntry
private String	epilog
private final EventBus	eventBus
private static final Logger	LOGGER
private String	newLineSeparator
private @Nullable String	preamble
private static final Pattern	RESOLVE_CONTENT_PATTERN
private @Nullable String	sharedDatabaseID
private Map<String, BibtexString>	stringToBibtexString

Access	Constructor and Description
public	BibDatabase(List<BibEntry> entries, String newLineSeparator)
public	BibDatabase(List<BibEntry> entries)
public	BibDatabase()

Method Summary

Modifier and Type	Method and Description
public synchronized void	addString(BibtexString string) Inserts a Bibtex String.
public void	clearSharedDatabaseID()
public boolean	containsEntryWithId(String id) Returns whether an entry with the given ID exists (-> entry_type + hashcode).
public void	copyPreamble(BibDatabase another BibDatabase database) Copies the preamble of another BibDatabase.
public boolean	equals(Object o) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
private void	forEachCitationKey(BibEntry entry, Consumer<String> keyConsumer)
public String	Returns: The generated sharedDatabaseID generateSharedDatabaseID() Generates and sets a random ID which is globally unique.
public Set<Field>	Returns: set of fieldnames, that are visible getAllVisibleFields() Returns a set of Strings, that contains all field names that are visible.
public ObservableList<BibEntry>	getEntries()
public synchronized List<BibEntry>	Returns: list of entries that contains the given key getEntriesByCitationKey(String key) Collects entries having the specified citation key and returns these entries as list.
public Set<BibEntry>	getEntriesForCitationKey(@Nullable String citationKey)
public synchronized List<BibEntry>	getEntriesSnapshot() Returns an immutable, stable snapshot of the current entries.
public List<BibEntry>	getEntriesSorted(Comparator<BibEntry> comparator) Returns the list of entries sorted by the given comparator.
public synchronized Optional<BibEntry>	getEntryByCitationKey(String key) Returns the entry with the given citation key.
public Optional<BibEntry>	getEntryById(String id)
public int	getEntryCount() Returns the number of entries.
public String	getEpilog()
public String	getNewLineSeparator() Returns the string used to indicate a linebreak
public long	getNumberOfCitationKeyOccurrences(String key) Returns the number of occurrences of the given citation key in this database.
public synchronized @NonNull Optional<String>	getPreamble() Returns the database's preamble.
private Set<String>	getReferencedCitationKeys(BibEntry entry)
public Optional<BibEntry>	getReferencedEntry(BibEntry entry)
public Optional<String>	getSharedDatabaseID()
public Optional<BibtexString>	getString(String id) Returns the string with the given id.
public Optional<BibtexString>	getStringByName(String name) Returns the string with the given name/label
public int	getStringCount() Returns the number of strings.
public Set<String>	getStringKeySet() Returns a Set of keys to all BibtexString objects in the database.
public Collection<BibtexString>	getStringValues() Returns a Collection of all BibtexString objects in the database.
public List<BibtexString>	getUsedStrings(Collection<BibEntry> entries) Get all strings used in the entries.
public boolean	hasEntries() Checks if the database contains entries.
public int	hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for this object.
public boolean	hasNoStrings() Check if there are strings.
public synchronized boolean	hasStringByName(String label) Returns true if a string with the given label already exists.
private void	indexEntry(BibEntry entry)
public int	indexOf(@NonNull BibEntry bibEntry) Returns: The index of the given entry in the list of entries, or -1 if the entry is not in the list.
public synchronized void	insertEntries(BibEntry... entries)
public synchronized void	insertEntries(List<BibEntry> entries)
public synchronized void	insertEntries(@NonNull List<BibEntry> newEntries, EntriesEventSource eventSource)
public synchronized void	insertEntry(BibEntry entry)
public synchronized void	insertEntry(BibEntry entry to insert entry, EntriesEventSource source the event is sent from eventSource) Inserts the entry.
private void	insertSmallBatch(List<BibEntry> sortedNewEntries)
public boolean	isDuplicateCitationKeyExisting(String key) Checks if there is more than one occurrence of the citation key.
public boolean	isShared()
private boolean	isSortedById(List<BibEntry> entries)
private List<BibEntry>	mergeSortedEntries(List<BibEntry> sortedNewEntries)
public void	postEvent(Object event)
public void	registerListener(Object listener (subscriber) to add listener) Registers a listener object (subscriber) to the internal event bus.
private void	relayEntryChangeEvent(FieldChangedEvent event)
public synchronized void	removeEntries(List<BibEntry> Entries to delete toBeDeleted) Removes the given entries.
public synchronized void	removeEntries(@NonNull List<BibEntry> Entry to delete toBeDeleted, EntriesEventSource Source the event is sent from eventSource) Removes the given entries.
public synchronized void	removeEntry(BibEntry bibEntry)
public synchronized void	removeEntry(BibEntry bibEntry, EntriesEventSource eventSource)
private void	removeEntryFromIndex(BibEntry entry)
public void	removeString(String id) Removes the string with the given id.
private String	resolveContent(String result, Set<String> usedIds, Set<String> allUsedIds)
public String	resolveForStrings(@NonNull String content) Resolves any references to strings contained in this field content, if possible.
public List<BibEntry>	Returns: a list of bibtexentries, with all strings resolved. It is dependent on the value of inPlace whether copies are made or the given BibtexEntries are modified. resolveForStrings(@NonNull Collection<BibEntry> A collection of BibtexEntries in which all strings of the form `#xxx#` will be resolved against the hash map of string references stored in the database. entriesToResolve, boolean If inPlace is true then the given BibtexEntries will be modified, if false then copies of the BibtexEntries are made before resolving the strings. inPlace) Take the given collection of BibEntry and resolve any string references.
public BibEntry	Returns: a BibEntry with all string references resolved. It is dependent on the value of inPlace whether a copy is made or the given BibtexEntries is modified. resolveForStrings(BibEntry A BibEntry in which all strings of the form #xxx# will be resolved against the hash map of string references stored in the database. entry, boolean If inPlace is true then the given BibEntry will be modified, if false then a copy is made using close made before resolving the strings. inPlace) Take the given BibEntry and resolve any string references.
private @NonNull Optional<String>	resolveString(@NonNull String label, @NonNull Set<String> usedIds, @NonNull Set<String> allUsedIds) If the label represents a string contained in this database, returns that string's content.
public void	setEpilog(String epilog)
public void	setNewLineSeparator(String newLineSeparator) Set the newline separator.
public synchronized void	setPreamble(@Nullable String preamble) Sets the database's preamble.
public void	setSharedDatabaseID(String sharedDatabaseID)
public void	setStrings(List<BibtexString> The collection of strings to set stringsToAdd) Replaces the existing lists of BibTexString with the given one Duplicates throw KeyCollisionException
private List<BibEntry>	sortEntriesById(List<BibEntry> newEntries)
public void	unregisterListener(Object listener (subscriber) to remove listener) Unregisters an listener object.
private void	updateCitationIndexForFieldChange(FieldChangedEvent event)

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll toString wait wait wait

BATCH_REPLACEMENT_THRESHOLD	back to summary
private static final int BATCH_REPLACEMENT_THRESHOLD

citationIndex	back to summary
private final Map<String, Set<BibEntry>> citationIndex

entries	back to summary
private final ObservableList<BibEntry> entries State attributes

ENTRY_ID_COMPARATOR	back to summary
private static final Comparator<BibEntry> ENTRY_ID_COMPARATOR

entryIdToBibEntry	back to summary
private final Map<String, BibEntry> entryIdToBibEntry

epilog	back to summary
private String epilog

eventBus	back to summary
private final EventBus eventBus

LOGGER	back to summary
private static final Logger LOGGER

newLineSeparator	back to summary
private String newLineSeparator

preamble	back to summary
private @Nullable String preamble

RESOLVE_CONTENT_PATTERN	back to summary
private static final Pattern RESOLVE_CONTENT_PATTERN

sharedDatabaseID	back to summary
private @Nullable String sharedDatabaseID

stringToBibtexString	back to summary
private Map<String, BibtexString> stringToBibtexString

BibDatabase	back to summary
public BibDatabase(List<BibEntry> entries, String newLineSeparator)

BibDatabase	back to summary
public BibDatabase(List<BibEntry> entries)

BibDatabase	back to summary
public BibDatabase()

Method Detail

addString	back to summary
public synchronized void addString(BibtexString string) throws KeyCollisionException Inserts a Bibtex String.

clearSharedDatabaseID	back to summary
public void clearSharedDatabaseID()

containsEntryWithId	back to summary
public boolean containsEntryWithId(String id) Returns whether an entry with the given ID exists (-> entry_type + hashcode).

copyPreamble	back to summary
public void copyPreamble(BibDatabase database) Copies the preamble of another BibDatabase. Parameters database:BibDatabase another BibDatabase

copyPreamble

back to summary

public void copyPreamble(BibDatabase database)

Copies the preamble of another BibDatabase.

Parameters

database:BibDatabase: another BibDatabase

equals back to summary

equals	back to summary
public boolean equals(Object o) Overrides java.lang.Object.equals. Doc from java.lang.Object.equals. Indicates whether some other object is "equal to" this one. The `equals` method implements an equivalence relation on non-null object references: It is reflexive: for any non-null reference value `x`, `x.equals(x)` should return `true`. It is symmetric: for any non-null reference values `x` and `y`, `x.equals(y)` should return `true` if and only if `y.equals(x)` returns `true`. It is transitive: for any non-null reference values `x`, `y`, and `z`, if `x.equals(y)` returns `true` and `y.equals(z)` returns `true`, then `x.equals(z)` should return `true`. It is consistent: for any non-null reference values `x` and `y`, multiple invocations of `x.equals(y)` consistently return `true` or consistently return `false`, provided no information used in `equals` comparisons on the objects is modified. For any non-null reference value `x`, `x.equals(null)` should return `false`. An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes. Annotations @Override

public boolean equals(Object o)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Annotations

@Override

forEachCitationKey	back to summary
private void forEachCitationKey(BibEntry entry, Consumer<String> keyConsumer)

generateSharedDatabaseID	back to summary
public String generateSharedDatabaseID() Generates and sets a random ID which is globally unique. Returns:String The generated sharedDatabaseID

generateSharedDatabaseID

back to summary

public String generateSharedDatabaseID()

Generates and sets a random ID which is globally unique.

Returns:String: The generated sharedDatabaseID

getAllVisibleFields	back to summary
public Set<Field> getAllVisibleFields() Returns a set of Strings, that contains all field names that are visible. This means that the fields are not internal fields. Internal fields are fields, that are starting with "_". Returns:Set<Field> set of fieldnames, that are visible

getAllVisibleFields

back to summary

public Set<Field> getAllVisibleFields()

Returns a set of Strings, that contains all field names that are visible. This means that the fields are not internal fields. Internal fields are fields, that are starting with "_".

Returns:Set<Field>: set of fieldnames, that are visible

getEntries	back to summary
public ObservableList<BibEntry> getEntries()

getEntriesByCitationKey	back to summary
public synchronized List<BibEntry> getEntriesByCitationKey(String key) Collects entries having the specified citation key and returns these entries as list. The order of the entries is the order they appear in the database. Returns:List<BibEntry> list of entries that contains the given key

getEntriesByCitationKey

back to summary

public synchronized List<BibEntry> getEntriesByCitationKey(String key)

Collects entries having the specified citation key and returns these entries as list. The order of the entries is the order they appear in the database.

Returns:List<BibEntry>: list of entries that contains the given key

getEntriesForCitationKey	back to summary
public Set<BibEntry> getEntriesForCitationKey(@Nullable String citationKey)

getEntriesSnapshot	back to summary
public synchronized List<BibEntry> getEntriesSnapshot() Returns an immutable, stable snapshot of the current entries.

getEntriesSorted	back to summary
public List<BibEntry> getEntriesSorted(Comparator<BibEntry> comparator) Returns the list of entries sorted by the given comparator.

getEntryByCitationKey	back to summary
public synchronized Optional<BibEntry> getEntryByCitationKey(String key) Returns the entry with the given citation key.

getEntryById	back to summary
public Optional<BibEntry> getEntryById(String id)

getEntryCount	back to summary
public int getEntryCount() Returns the number of entries.

getEpilog	back to summary
public String getEpilog()

getNewLineSeparator	back to summary
public String getNewLineSeparator() Returns the string used to indicate a linebreak

getNumberOfCitationKeyOccurrences	back to summary
public long getNumberOfCitationKeyOccurrences(String key) Returns the number of occurrences of the given citation key in this database.

getPreamble	back to summary
public synchronized @NonNull Optional<String> getPreamble() Returns the database's preamble. If the preamble text consists only of whitespace, then also an empty optional is returned.

getReferencedCitationKeys	back to summary
private Set<String> getReferencedCitationKeys(BibEntry entry)

getReferencedEntry	back to summary
public Optional<BibEntry> getReferencedEntry(BibEntry entry)

getSharedDatabaseID	back to summary
public Optional<String> getSharedDatabaseID()

getString	back to summary
public Optional<BibtexString> getString(String id) Returns the string with the given id.

getStringByName	back to summary
public Optional<BibtexString> getStringByName(String name) Returns the string with the given name/label

getStringCount	back to summary
public int getStringCount() Returns the number of strings.

getStringKeySet	back to summary
public Set<String> getStringKeySet() Returns a Set of keys to all BibtexString objects in the database. These are in no sorted order.

getStringValues	back to summary
public Collection<BibtexString> getStringValues() Returns a Collection of all BibtexString objects in the database. These are in no particular order.

getUsedStrings	back to summary
public List<BibtexString> getUsedStrings(Collection<BibEntry> entries) Get all strings used in the entries.

hasEntries	back to summary
public boolean hasEntries() Checks if the database contains entries.

hashCode back to summary

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Doc from java.lang.Object.hashCode. Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by `java.util.HashMap`. The general contract of `hashCode` is: Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. Annotations @Override

public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Annotations

@Override

hasNoStrings	back to summary
public boolean hasNoStrings() Check if there are strings.

hasStringByName	back to summary
public synchronized boolean hasStringByName(String label) Returns true if a string with the given label already exists.

indexEntry	back to summary
private void indexEntry(BibEntry entry)

indexOf	back to summary
public int indexOf(@NonNull BibEntry bibEntry) Implementation Note insertEntries keeps the list sorted by the ids handed out by IdGenerator, so binary search finds the index. Implementation Note IDs are zero-padded strings, so there is no need to convert them to integers for comparison. Returns:int The index of the given entry in the list of entries, or -1 if the entry is not in the list.

insertEntries	back to summary
public synchronized void insertEntries(BibEntry... entries)

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

insertEntries	back to summary
public synchronized void insertEntries(@NonNull List<BibEntry> newEntries, EntriesEventSource eventSource)

insertEntry	back to summary
public synchronized void insertEntry(BibEntry entry)

insertEntry

back to summary

public synchronized void insertEntry(BibEntry entry, EntriesEventSource eventSource)

Inserts the entry.

Parameters

entry:BibEntry: entry to insert
eventSource:EntriesEventSource: source the event is sent from

insertSmallBatch	back to summary
private void insertSmallBatch(List<BibEntry> sortedNewEntries)

isDuplicateCitationKeyExisting	back to summary
public boolean isDuplicateCitationKeyExisting(String key) Checks if there is more than one occurrence of the citation key.

isShared	back to summary
public boolean isShared()

isSortedById	back to summary
private boolean isSortedById(List<BibEntry> entries)

mergeSortedEntries	back to summary
private List<BibEntry> mergeSortedEntries(List<BibEntry> sortedNewEntries)

postEvent	back to summary
public void postEvent(Object event)

registerListener back to summary

public void registerListener(Object listener)

Registers a listener object (subscriber) to the internal event bus. The following events are posted:

Parameters

listener:Object: listener (subscriber) to add

relayEntryChangeEvent	back to summary
private void relayEntryChangeEvent(FieldChangedEvent event) Annotations @Subscribe

removeEntries back to summary

public synchronized void removeEntries(List<BibEntry> toBeDeleted)

Removes the given entries. The entries removed based on the id BibEntry#getId()

Parameters

toBeDeleted:List<BibEntry>: Entries to delete

removeEntries back to summary

public synchronized void removeEntries(@NonNull List<BibEntry> toBeDeleted, EntriesEventSource eventSource)

Removes the given entries. The entries are removed based on the id BibEntry#getId()

Parameters

toBeDeleted:@NonNull List<BibEntry>: Entry to delete
eventSource:EntriesEventSource: Source the event is sent from

removeEntry	back to summary
public synchronized void removeEntry(BibEntry bibEntry)

removeEntry	back to summary
public synchronized void removeEntry(BibEntry bibEntry, EntriesEventSource eventSource)

removeEntryFromIndex	back to summary
private void removeEntryFromIndex(BibEntry entry)

removeString	back to summary
public void removeString(String id) Removes the string with the given id.

resolveContent	back to summary
private String resolveContent(String result, Set<String> usedIds, Set<String> allUsedIds)

resolveForStrings	back to summary
public String resolveForStrings(@NonNull String content) Resolves any references to strings contained in this field content, if possible.

resolveForStrings back to summary

public List<BibEntry> resolveForStrings(@NonNull Collection<BibEntry> entriesToResolve, boolean inPlace)

Take the given collection of BibEntry and resolve any string references.

Parameters

entriesToResolve:@NonNull Collection<BibEntry>: A collection of BibtexEntries in which all strings of the form #xxx# will be resolved against the hash map of string references stored in the database.
inPlace:boolean: If inPlace is true then the given BibtexEntries will be modified, if false then copies of the BibtexEntries are made before resolving the strings.

Returns:List<BibEntry>

a list of bibtexentries, with all strings resolved. It is dependent on the value of inPlace whether copies are made or the given BibtexEntries are modified.

resolveForStrings

back to summary

public BibEntry resolveForStrings(BibEntry entry, boolean inPlace)

Take the given BibEntry and resolve any string references.

Parameters

entry:BibEntry: A BibEntry in which all strings of the form #xxx# will be resolved against the hash map of string references stored in the database.
inPlace:boolean: If inPlace is true then the given BibEntry will be modified, if false then a copy is made using close made before resolving the strings.

Returns:BibEntry

a BibEntry with all string references resolved. It is dependent on the value of inPlace whether a copy is made or the given BibtexEntries is modified.

resolveString	back to summary
private @NonNull Optional<String> resolveString(@NonNull String label, @NonNull Set<String> usedIds, @NonNull Set<String> allUsedIds) If the label represents a string contained in this database, returns that string's content. Resolves references to other strings, taking care not to follow a circular reference pattern. If the string is undefined, returns null.

setEpilog	back to summary
public void setEpilog(String epilog)

setNewLineSeparator	back to summary
public void setNewLineSeparator(String newLineSeparator) Set the newline separator.

setPreamble	back to summary
public synchronized void setPreamble(@Nullable String preamble) Sets the database's preamble.

setSharedDatabaseID	back to summary
public void setSharedDatabaseID(String sharedDatabaseID)

setStrings

back to summary

public void setStrings(List<BibtexString> stringsToAdd)

Replaces the existing lists of BibTexString with the given one Duplicates throw KeyCollisionException

Parameters

stringsToAdd:List<BibtexString>: The collection of strings to set

sortEntriesById	back to summary
private List<BibEntry> sortEntriesById(List<BibEntry> newEntries)

unregisterListener

back to summary

public void unregisterListener(Object listener)

Unregisters an listener object.

Parameters

listener:Object: listener (subscriber) to remove

updateCitationIndexForFieldChange	back to summary
private void updateCitationIndexForFieldChange(FieldChangedEvent event)

public Class BibDatabase

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail