IGNITE-26608 Add JavaDocs and change pools package.

Author: petrov-mg

modules/commons/src/main/java/org/apache/ignite/internal/thread/context/Context.java

@@ -19,13 +19,14 @@
 
 import java.util.ArrayList;
 import java.util.List;
+import org.apache.ignite.internal.thread.context.concurrent.ContextAwareExecutor;
 import org.apache.ignite.internal.util.typedef.F;
 import org.jetbrains.annotations.Nullable;
 
 import static org.apache.ignite.internal.thread.context.Scope.NOOP_SCOPE;
 
 /**
- * Represents a storage of {@link ContextAttribute}s and their corresponding values bound to the thread.
+ * Represents a storage of {@link ContextAttribute}s and their corresponding values bound to the JVM thread.
  * The state of Context is determined by a sequence of {@link Update}s applied to it. Each Update stores the
  * updated or newly added {@link ContextAttribute} values and link to the previous Update.
  * <pre>
@@ -37,6 +38,16 @@
  *</pre>
  * Context Updates can be undone in the same order they were applied by closing the {@link Scope} associated with each
  * update (see {@link #set(ContextAttribute, Object)} and related methods).
+ *<p>
+ * Context bound to one JVM thread can be saved and restored in another thread using the snapshot mechanism
+ * (see {@link #createSnapshot()} and {@link #restoreSnapshot(ContextSnapshot) methods}). This provides basic
+ * functionality for implementing asynchronous executors that automatically propagate Context data between JVM threads.
+ *</p>
+ *
+ * @see Scope
+ * @see ContextSnapshot
+ * @see ContextAwareWrapper
+ * @see ContextAwareExecutor
  */
 public class Context {
     /** */

modules/core/src/main/java/org/apache/ignite/internal/processors/pool/PoolProcessor.java

@@ -45,10 +45,10 @@
 import org.apache.ignite.internal.processors.security.IgniteSecurity;
 import org.apache.ignite.internal.processors.timeout.GridTimeoutProcessor;
 import org.apache.ignite.internal.systemview.StripedExecutorTaskViewWalker;
-import org.apache.ignite.internal.thread.context.pool.ContextAwareIoPool;
-import org.apache.ignite.internal.thread.context.pool.ContextAwareStripedExecutor;
-import org.apache.ignite.internal.thread.context.pool.ContextAwareStripedThreadPoolExecutor;
-import org.apache.ignite.internal.thread.context.pool.ContextAwareThreadPoolExecutor;
+import org.apache.ignite.internal.thread.pool.ContextAwareIoPool;
+import org.apache.ignite.internal.thread.pool.ContextAwareStripedExecutor;
+import org.apache.ignite.internal.thread.pool.ContextAwareStripedThreadPoolExecutor;
+import org.apache.ignite.internal.thread.pool.ContextAwareThreadPoolExecutor;
 import org.apache.ignite.internal.util.StripedExecutor;
 import org.apache.ignite.internal.util.tostring.GridToStringExclude;
 import org.apache.ignite.internal.util.typedef.F;

…ead/context/pool/ContextAwareIoPool.java …rnal/thread/pool/ContextAwareIoPool.javamodules/core/src/main/java/org/apache/ignite/internal/thread/context/pool/ContextAwareIoPool.java renamed to modules/core/src/main/java/org/apache/ignite/internal/thread/pool/ContextAwareIoPool.java modules/core/src/main/java/org/apache/ignite/internal/thread/context/pool/ContextAwareIoPool.java renamed to modules/core/src/main/java/org/apache/ignite/internal/thread/pool/ContextAwareIoPool.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package org.apache.ignite.internal.thread.context.pool;
+package org.apache.ignite.internal.thread.pool;
 
 import java.util.concurrent.Executor;
 import org.apache.ignite.internal.thread.context.concurrent.ContextAwareExecutor;

…xt/pool/ContextAwareStripedExecutor.java …ad/pool/ContextAwareStripedExecutor.javamodules/core/src/main/java/org/apache/ignite/internal/thread/context/pool/ContextAwareStripedExecutor.java renamed to modules/core/src/main/java/org/apache/ignite/internal/thread/pool/ContextAwareStripedExecutor.java modules/core/src/main/java/org/apache/ignite/internal/thread/context/pool/ContextAwareStripedExecutor.java renamed to modules/core/src/main/java/org/apache/ignite/internal/thread/pool/ContextAwareStripedExecutor.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package org.apache.ignite.internal.thread.context.pool;
+package org.apache.ignite.internal.thread.pool;
 
 import org.apache.ignite.IgniteLogger;
 import org.apache.ignite.internal.thread.context.function.ContextAwareRunnable;

…ntextAwareStripedThreadPoolExecutor.java …ntextAwareStripedThreadPoolExecutor.javamodules/core/src/main/java/org/apache/ignite/internal/thread/context/pool/ContextAwareStripedThreadPoolExecutor.java renamed to modules/core/src/main/java/org/apache/ignite/internal/thread/pool/ContextAwareStripedThreadPoolExecutor.java modules/core/src/main/java/org/apache/ignite/internal/thread/context/pool/ContextAwareStripedThreadPoolExecutor.java renamed to modules/core/src/main/java/org/apache/ignite/internal/thread/pool/ContextAwareStripedThreadPoolExecutor.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package org.apache.ignite.internal.thread.context.pool;
+package org.apache.ignite.internal.thread.pool;
 
 import org.apache.ignite.internal.thread.context.function.ContextAwareRunnable;
 import org.apache.ignite.thread.IgniteStripedThreadPoolExecutor;

…pool/ContextAwareThreadPoolExecutor.java …pool/ContextAwareThreadPoolExecutor.javamodules/core/src/main/java/org/apache/ignite/internal/thread/context/pool/ContextAwareThreadPoolExecutor.java renamed to modules/core/src/main/java/org/apache/ignite/internal/thread/pool/ContextAwareThreadPoolExecutor.java modules/core/src/main/java/org/apache/ignite/internal/thread/context/pool/ContextAwareThreadPoolExecutor.java renamed to modules/core/src/main/java/org/apache/ignite/internal/thread/pool/ContextAwareThreadPoolExecutor.java

@@ -15,7 +15,7 @@
  * limitations under the License.
  */
 
-package org.apache.ignite.internal.thread.context.pool;
+package org.apache.ignite.internal.thread.pool;
 
 import java.util.Collection;
 import java.util.List;

modules/core/src/test/java/org/apache/ignite/internal/thread/context/ContextAttributesTest.java

@@ -26,9 +26,9 @@
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.LinkedBlockingQueue;
 import org.apache.ignite.internal.managers.communication.GridIoPolicy;
-import org.apache.ignite.internal.thread.context.pool.ContextAwareStripedExecutor;
-import org.apache.ignite.internal.thread.context.pool.ContextAwareStripedThreadPoolExecutor;
-import org.apache.ignite.internal.thread.context.pool.ContextAwareThreadPoolExecutor;
+import org.apache.ignite.internal.thread.pool.ContextAwareStripedExecutor;
+import org.apache.ignite.internal.thread.pool.ContextAwareStripedThreadPoolExecutor;
+import org.apache.ignite.internal.thread.pool.ContextAwareThreadPoolExecutor;
 import org.apache.ignite.testframework.junits.common.GridCommonAbstractTest;
 import org.junit.Test;