You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ignite.apache.org by sb...@apache.org on 2017/05/29 07:33:59 UTC

[09/12] ignite git commit: Fixed PersistentStore configuration documentation

Fixed PersistentStore configuration documentation


Project: http://git-wip-us.apache.org/repos/asf/ignite/repo
Commit: http://git-wip-us.apache.org/repos/asf/ignite/commit/3450241f
Tree: http://git-wip-us.apache.org/repos/asf/ignite/tree/3450241f
Diff: http://git-wip-us.apache.org/repos/asf/ignite/diff/3450241f

Branch: refs/heads/ignite-5075-pds
Commit: 3450241fb101eaa6a6c0378f085097ba7609f1c0
Parents: a0fc2b0
Author: Denis Magda <dm...@gridgain.com>
Authored: Fri May 26 13:59:56 2017 -0700
Committer: Denis Magda <dm...@gridgain.com>
Committed: Fri May 26 13:59:56 2017 -0700

----------------------------------------------------------------------
 .../PersistentStoreConfiguration.java           | 39 ++++++++++----------
 1 file changed, 20 insertions(+), 19 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/ignite/blob/3450241f/modules/core/src/main/java/org/apache/ignite/configuration/PersistentStoreConfiguration.java
----------------------------------------------------------------------
diff --git a/modules/core/src/main/java/org/apache/ignite/configuration/PersistentStoreConfiguration.java b/modules/core/src/main/java/org/apache/ignite/configuration/PersistentStoreConfiguration.java
index b2e10f4..94923c8 100644
--- a/modules/core/src/main/java/org/apache/ignite/configuration/PersistentStoreConfiguration.java
+++ b/modules/core/src/main/java/org/apache/ignite/configuration/PersistentStoreConfiguration.java
@@ -71,10 +71,10 @@ public class PersistentStoreConfiguration implements Serializable {
     /** Number of WAL segments to keep. */
     private int walSegmentSize = DFLT_WAL_SEGMENT_SIZE;
 
-    /** Write-ahead log persistence path. */
+    /** WAL persistence path. */
     private String walStorePath;
 
-    /** Write-ahead log archive path. */
+    /** WAL archive path. */
     private String walArchivePath;
 
     /**
@@ -184,18 +184,18 @@ public class PersistentStoreConfiguration implements Serializable {
     }
 
     /**
-     * Gets the number checkpoints to keep in WAL history.
+     * Gets a total number of checkpoints to keep in the WAL history.
      *
-     * @return Number of WAL segments to keep after the checkpoint is finished.
+     * @return Number of WAL segments to keep after a checkpoint is finished.
      */
     public int getWalHistorySize() {
         return walHistSize <= 0 ? DFLT_WAL_HISTORY_SIZE : walHistSize;
     }
 
     /**
-     * Sets the number of checkpoints to keep in WAL history.
+     * Sets a total number of checkpoints to keep in the WAL history.
      *
-     * @param walHistSize Number of WAL segments to keep after the checkpoint is finished.
+     * @param walHistSize Number of WAL segments to keep after a checkpoint is finished.
      * @return {@code this} for chaining.
      */
     public PersistentStoreConfiguration setWalHistorySize(int walHistSize) {
@@ -205,7 +205,7 @@ public class PersistentStoreConfiguration implements Serializable {
     }
 
     /**
-     * Gets a number of Write-Ahead Log segments to work with.
+     * Gets a number of WAL segments to work with.
      *
      * @return Number of work WAL segments.
      */
@@ -214,10 +214,10 @@ public class PersistentStoreConfiguration implements Serializable {
     }
 
     /**
-     * Sets a number of Write Ahead Log segments to work with. Write-ahead log is written over a fixed number
-     * of pre-allocated file segments of fixed size. This parameter sets the number of these segments.
+     * Sets a number of WAL segments to work with. For performance reasons,
+     * the whole WAL is split into files of fixed length called segments.
      *
-     * @param walSegments Number of work WAL segments.
+     * @param walSegments Number of WAL segments.
      * @return {@code this} for chaining.
      */
     public PersistentStoreConfiguration setWalSegments(int walSegments) {
@@ -227,7 +227,7 @@ public class PersistentStoreConfiguration implements Serializable {
     }
 
     /**
-     * Gets size of a Write-Ahead Log segment.
+     * Gets size of a WAL segment.
      *
      * @return WAL segment size.
      */
@@ -236,7 +236,7 @@ public class PersistentStoreConfiguration implements Serializable {
     }
 
     /**
-     * Sets size of a Write-Ahead Log segment.
+     * Sets size of a WAL segment.
      *
      * @param walSegmentSize WAL segment size. 64 MB is used by default.
      * @return {@code this} for chaining.
@@ -248,19 +248,19 @@ public class PersistentStoreConfiguration implements Serializable {
     }
 
     /**
-     * Gets a path to the directory where Write-Ahead log is stored.
+     * Gets a path to the directory where WAL is stored.
      *
-     * @return Write-ahead log persistence path, absolute or relative to Ignite work directory.
+     * @return WAL persistence path, absolute or relative to Ignite work directory.
      */
     public String getWalStorePath() {
         return walStorePath;
     }
 
     /**
-     * Sets a path to the directory where Write-Ahead log is stored . If this path is relative, it will be resolved
-     * relative to Ignite work directory.
+     * Sets a path to the directory where WAL is stored . If this path is relative, it will be resolved
+     * relatively to Ignite work directory.
      *
-     * @param walStorePath Write-ahead log persistence path, absolute or relative to Ignite work directory.
+     * @param walStorePath WAL persistence path, absolute or relative to Ignite work directory.
      * @return {@code this} for chaining.
      */
     public PersistentStoreConfiguration setWalStorePath(String walStorePath) {
@@ -270,7 +270,7 @@ public class PersistentStoreConfiguration implements Serializable {
     }
 
     /**
-     * Gets a path to Write-Ahead log archive. Full WAL segments will be copied to this directory before reuse.
+     * Gets a path to the WAL archive directory.
      *
      *  @return WAL archive directory.
      */
@@ -279,7 +279,8 @@ public class PersistentStoreConfiguration implements Serializable {
     }
 
     /**
-     * Sets a path to store Write-Ahead log archive. Full WAL segments will be copied to this directory before reuse.
+     * Sets a path for the WAL archive directory. Every WAL segment will be fully copied to this directory before
+     * it can be reused for WAL purposes.
      *
      * @param walArchivePath WAL archive directory.
      * @return {@code this} for chaining.