Standard code formatting

This commit is contained in:
Peter Lawrey
2018-04-21 10:49:49 +01:00
parent c7efd950f8
commit 9323cf28a7
270 changed files with 2801 additions and 2551 deletions
@@ -42,7 +42,7 @@ public interface ChronicleHash<K, E extends HashEntry<K>, SC extends HashSegment
* i. e. if it is created by {@link ChronicleHashBuilder#create()} call.
*
* @return the file this {@link ChronicleMap} or {@link ChronicleSet} is mapped to,
* or {@code null} if it is not mapped to any file
* or {@code null} if it is not mapped to any file
* @see ChronicleHashBuilder#createPersistedTo(File)
*/
File file();
@@ -62,7 +62,7 @@ public interface ChronicleHash<K, E extends HashEntry<K>, SC extends HashSegment
* Map#toString()} and {@link Set#toString()} contracts respectively, making it not always
* useful (or even impossible to use, if this {@code ChronicleHash} contains a lot of entries)
* for the purposes listed above.
*
* <p>
* <p>This method return a string of the form:<br><br>
* [ChronicleMap|ChronicleSet]{name={@link #name()}, file={@link #file()},
* identityHashCode={@link System#identityHashCode System.identityHashCode(thisChronicleHash)}}
@@ -85,7 +85,7 @@ public interface ChronicleHash<K, E extends HashEntry<K>, SC extends HashSegment
/**
* Returns the amount of off-heap memory (in bytes), allocated by this {@code ChronicleHash} or
* shared with with other ChronicleHashes, persisting to the same {@link #file()}.
*
* <p>
* <p>After {@link #close()} this method returns 0.
*
* @return the amount of off-heap memory, used by this {@code ChronicleHash} (in bytes)
@@ -103,7 +103,7 @@ public interface ChronicleHash<K, E extends HashEntry<K>, SC extends HashSegment
* try (ExternalHashQueryContext<K> q = hash.queryContext(key)) {
* // ... do something
* }}</pre>
*
* <p>
* <p>See documentation to {@link HashQueryContext} interface and methods in {@link MapMethods}
* interface for examples of using contexts. Also see <a href="
* https://github.com/OpenHFT/Chronicle-Map#working-with-an-entry-within-a-context-section">
@@ -125,7 +125,7 @@ public interface ChronicleHash<K, E extends HashEntry<K>, SC extends HashSegment
* instead of object key. This method is useful, when you already have {@code Data}, calling
* this method instead of {@link #queryContext(Object)} might help to avoid unnecessary
* deserialization.
*
* <p>
* <p>See documentation to {@link HashQueryContext} interface and methods in {@link MapMethods}
* interface for examples of using contexts. Also see <a href="
* https://github.com/OpenHFT/Chronicle-Map#working-with-an-entry-within-a-context-section">
@@ -134,7 +134,8 @@ public interface ChronicleHash<K, E extends HashEntry<K>, SC extends HashSegment
* @param key the queried key as {@code Data}
* @return the context to perform operations with the key
*/
@NotNull EQC queryContext(Data<K> key);
@NotNull
EQC queryContext(Data<K> key);
/**
* Returns a context to perform arbitrary operations with the given key, provided in the
@@ -142,11 +143,12 @@ public interface ChronicleHash<K, E extends HashEntry<K>, SC extends HashSegment
* information on contexts semantics and usage patterns.
*
* @param keyBytes the bytes store with the key bytes to query
* @param offset actual offset of the key bytes within the given BytesStore
* @param size length of the key bytes sequence within the given BytesStore
* @param offset actual offset of the key bytes within the given BytesStore
* @param size length of the key bytes sequence within the given BytesStore
* @return the context to perform operations with the key
*/
@NotNull EQC queryContext(BytesStore keyBytes, long offset, long size);
@NotNull
EQC queryContext(BytesStore keyBytes, long offset, long size);
/**
* Returns a context of the segment with the given index. Segments are indexed from 0 to
@@ -168,11 +170,11 @@ public interface ChronicleHash<K, E extends HashEntry<K>, SC extends HashSegment
* Checks the given predicate on each entry in this {@code ChronicleHash} until all entries
* have been processed or the predicate returns {@code false} for some entry, or throws
* an {@code Exception}. Exceptions thrown by the predicate are relayed to the caller.
*
* <p>
* <p>The order in which the entries will be processed is unspecified. It might differ from
* the order of iteration via {@code Iterator} returned by any method of this
* {@code ChronicleHash} or it's collection view.
*
* <p>
* <p>If the {@code ChronicleHash} is empty, this method returns {@code true} immediately.
*
* @param predicate the predicate to be checked for each entry
@@ -185,7 +187,7 @@ public interface ChronicleHash<K, E extends HashEntry<K>, SC extends HashSegment
* Performs the given action for each entry in this {@code ChronicleHash} until all entries have
* been processed or the action throws an {@code Exception}. Exceptions thrown by the action are
* relayed to the caller.
*
* <p>
* <p>The order in which the entries will be processed is unspecified. It might differ from
* the order of iteration via {@code Iterator} returned by any method of this
* {@code ChronicleHash} or it's collection view.
@@ -200,11 +202,11 @@ public interface ChronicleHash<K, E extends HashEntry<K>, SC extends HashSegment
* and there are other instances mapping the same data on the server across JVMs, the memory
* won't be actually freed on operating system level. I. e. this method call doesn't affect
* other {@link ChronicleMap} or {@link ChronicleSet} instances mapping the same data.
*
* <p>
* <p>If you won't call this method, memory would be held at least until next garbage
* collection. This could be a problem if, for example, you target rare garbage collections,
* but load and drop {@code ChronicleHash}es regularly.
*
* <p>
* <p>After this method call, all methods, querying the {@code ChronicleHash}'s entries, {@link
* #longSize()} and {@code size()}), throw {@link ChronicleHashClosedException}. {@link
* #isOpen()} returns {@code false}, {@code close()} itself returns immediately without effects