Fix: keep the first parameter name of the Seek method the same (neo-p…

…roject#3652)

Co-authored-by: Shargon <[email protected]>

src/Neo/Persistence/IReadOnlyStore.cs

@@ -22,10 +22,10 @@ public interface IReadOnlyStore
         /// <summary>
         /// Seeks to the entry with the specified key.
         /// </summary>
-        /// <param name="key">The key to be sought.</param>
+        /// <param name="keyOrPrefix">The key(i.e. start key) or prefix to be sought.</param>
         /// <param name="direction">The direction of seek.</param>
         /// <returns>An enumerator containing all the entries after seeking.</returns>
-        IEnumerable<(byte[] Key, byte[] Value)> Seek(byte[] key, SeekDirection direction);
+        IEnumerable<(byte[] Key, byte[] Value)> Seek(byte[] keyOrPrefix, SeekDirection direction);
 
         /// <summary>
         /// Reads a specified entry from the database.

src/Neo/Persistence/MemorySnapshot.cs

@@ -54,6 +54,7 @@ public void Put(byte[] key, byte[] value)
             writeBatch[key[..]] = value[..];
         }
 
+        /// <inheritdoc/>
         public IEnumerable<(byte[] Key, byte[] Value)> Seek(byte[] keyOrPrefix, SeekDirection direction = SeekDirection.Forward)
         {
             ByteArrayComparer comparer = direction == SeekDirection.Forward ? ByteArrayComparer.Default : ByteArrayComparer.Reverse;

src/Neo/Persistence/MemoryStore.cs

@@ -47,6 +47,7 @@ public void Put(byte[] key, byte[] value)
             _innerData[key[..]] = value[..];
         }
 
+        /// <inheritdoc/>
         public IEnumerable<(byte[] Key, byte[] Value)> Seek(byte[] keyOrPrefix, SeekDirection direction = SeekDirection.Forward)
         {
             if (direction == SeekDirection.Backward && keyOrPrefix?.Length == 0) yield break;

src/Plugins/LevelDBStore/IO/Data/LevelDB/Helper.cs

@@ -18,22 +18,21 @@ namespace Neo.IO.Storage.LevelDB
 {
     public static class Helper
     {
-        public static IEnumerable<(byte[], byte[])> Seek(this DB db, ReadOptions options, byte[] prefix, SeekDirection direction)
+        public static IEnumerable<(byte[], byte[])> Seek(this DB db, ReadOptions options, byte[] keyOrPrefix, SeekDirection direction)
         {
             using Iterator it = db.CreateIterator(options);
             if (direction == SeekDirection.Forward)
             {
-                for (it.Seek(prefix); it.Valid(); it.Next())
+                for (it.Seek(keyOrPrefix); it.Valid(); it.Next())
                     yield return new(it.Key(), it.Value());
             }
             else
             {
                 // SeekForPrev
-
-                it.Seek(prefix);
+                it.Seek(keyOrPrefix);
                 if (!it.Valid())
                     it.SeekToLast();
-                else if (it.Key().AsSpan().SequenceCompareTo(prefix) > 0)
+                else if (it.Key().AsSpan().SequenceCompareTo(keyOrPrefix) > 0)
                     it.Prev();
 
                 for (; it.Valid(); it.Prev())

src/Plugins/LevelDBStore/Plugins/Storage/Snapshot.cs

@@ -54,9 +54,10 @@ public void Dispose()
             _readOptions.Dispose();
         }
 
-        public IEnumerable<(byte[] Key, byte[] Value)> Seek(byte[] prefix, SeekDirection direction = SeekDirection.Forward)
+        /// <inheritdoc/>
+        public IEnumerable<(byte[] Key, byte[] Value)> Seek(byte[] keyOrPrefix, SeekDirection direction = SeekDirection.Forward)
         {
-            return _db.Seek(_readOptions, prefix, direction);
+            return _db.Seek(_readOptions, keyOrPrefix, direction);
         }
 
         public void Put(byte[] key, byte[] value)

src/Plugins/LevelDBStore/Plugins/Storage/Store.cs

@@ -67,8 +67,9 @@ public bool TryGet(byte[] key, out byte[] value)
             return value != null;
         }
 
-        public IEnumerable<(byte[], byte[])> Seek(byte[] prefix, SeekDirection direction = SeekDirection.Forward) =>
-            _db.Seek(ReadOptions.Default, prefix, direction);
+        /// <inheritdoc/>
+        public IEnumerable<(byte[], byte[])> Seek(byte[] keyOrPrefix, SeekDirection direction = SeekDirection.Forward) =>
+            _db.Seek(ReadOptions.Default, keyOrPrefix, direction);
 
         public IEnumerator<KeyValuePair<byte[], byte[]>> GetEnumerator() =>
             _db.GetEnumerator();

src/Plugins/RocksDBStore/Plugins/Storage/Snapshot.cs

@@ -49,6 +49,7 @@ public void Put(byte[] key, byte[] value)
             batch.Put(key, value);
         }
 
+        /// <inheritdoc/>
         public IEnumerable<(byte[] Key, byte[] Value)> Seek(byte[] keyOrPrefix, SeekDirection direction)
         {
             if (keyOrPrefix == null) keyOrPrefix = Array.Empty<byte>();

src/Plugins/RocksDBStore/Plugins/Storage/Store.cs

@@ -36,6 +36,7 @@ public ISnapshot GetSnapshot()
             return new Snapshot(db);
         }
 
+        /// <inheritdoc/>
         public IEnumerable<(byte[] Key, byte[] Value)> Seek(byte[] keyOrPrefix, SeekDirection direction = SeekDirection.Forward)
         {
             if (keyOrPrefix == null) keyOrPrefix = Array.Empty<byte>();