This is an automated email from the ASF dual-hosted git repository.

ahuber pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/causeway.git


The following commit(s) were added to refs/heads/master by this push:
     new 1c9a4dfc99 CAUSEWAY-3711: update ref. index
1c9a4dfc99 is described below

commit 1c9a4dfc99b4aa0b23f734594ed86de8eb51f8ff
Author: andi-huber <[email protected]>
AuthorDate: Mon Apr 1 06:57:03 2024 +0200

    CAUSEWAY-3711: update ref. index
---
 .../applib/pages/index/graph/tree/TreeAdapter.adoc |  5 --
 .../applib/pages/index/graph/tree/TreeNode.adoc    | 44 ++++++++++++------
 .../applib/pages/index/graph/tree/TreePath.adoc    | 44 ++++++++++++++++--
 .../applib/pages/index/graph/tree/TreeState.adoc   |  2 +-
 .../modules/applib/pages/index/value/Blob.adoc     |  2 +-
 core/adoc/modules/_overview/pages/about.adoc       | 53 +++++++++++++++++++++-
 6 files changed, 125 insertions(+), 25 deletions(-)

diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeAdapter.adoc
 
b/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeAdapter.adoc
index 496f1f6193..22f4090343 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeAdapter.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeAdapter.adoc
@@ -9,21 +9,16 @@ Provides the parent/child relationship information between 
pojos to derive a tre
 .TreeAdapter.java
 ----
 interface TreeAdapter<T> {
-  Optional<T> parentOf(T value)     // <.>
   int childCountOf(T value)     // <.>
   Stream<T> childrenOf(T value)     // <.>
 }
 ----
 
-<.> xref:#parentOf_T[parentOf(T)]
 <.> xref:#childCountOf_T[childCountOf(T)]
 <.> xref:#childrenOf_T[childrenOf(T)]
 
 == Members
 
-[#parentOf_T]
-=== parentOf(T)
-
 [#childCountOf_T]
 === childCountOf(T)
 
diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeNode.adoc
 
b/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeNode.adoc
index 817d989709..92145fabbf 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeNode.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeNode.adoc
@@ -9,16 +9,18 @@ Fundamental building block of Tree structures.
 .TreeNode.java
 ----
 class TreeNode<T> {
-  TreeNode<T> of(T value, Class<? extends TreeAdapter<T>> treeAdapterClass, 
TreeState sharedState)
+  TreeNode<T> root(T value, TreeAdapter<T> treeAdapter, TreeState sharedState)
+  TreeNode<T> root(T value, Class<? extends TreeAdapter<T>> treeAdapterClass, 
TreeState sharedState, FactoryService factoryService)
+  T getRootValue()
   T getValue()
   int getIncomingCount()
   int getOutgoingCount()
   Stream<Edge<T>> streamIncoming()
   Stream<Edge<T>> streamOutgoing()
-  TreeNode<T> getParentIfAny()
+  Optional<TreeNode<T>> resolve(TreePath absolutePath)     // <.>
+  Optional<TreeNode<T>> lookupParent()
   int getChildCount()
   Stream<TreeNode<T>> streamChildren()
-  boolean isRoot()
   boolean isLeaf()
   TreePath getPositionAsPath()
   TreeState getTreeState()     // <.>
@@ -29,17 +31,22 @@ class TreeNode<T> {
   void clearSelection()     // <.>
   boolean isSelected(TreePath treePath)     // <.>
   void select(TreePath... treePaths)     // <.>
-  TreeNode<T> lazy(T node, Class<? extends TreeAdapter<T>> treeAdapterClass)   
  // <.>
+  TreeNode<T> root(T rootNode, TreeAdapter<T> treeAdapter)     // <.>
+  TreeNode<T> root(T rootNode, Class<? extends TreeAdapter<T>> 
treeAdapterClass, FactoryService factoryService)     // <.>
   Iterator<TreeNode<T>> iteratorHierarchyUp()
   Stream<TreeNode<T>> streamHierarchyUp()
   Iterator<TreeNode<T>> iteratorDepthFirst()
   Iterator<TreeNode<T>> iteratorBreadthFirst()
   Stream<TreeNode<T>> streamDepthFirst()
   Stream<TreeNode<T>> streamBreadthFirst()
-  Class<? extends TreeAdapter<T>> getTreeAdapterClass()     // <.>
 }
 ----
 
+<.> xref:#resolve_TreePath[resolve(TreePath)]
++
+--
+Resolves given path relative to the root of this tree.
+--
 <.> xref:#getTreeState_[getTreeState()]
 <.> xref:#expand_TreePath[expand(TreePath)]
 +
@@ -71,15 +78,24 @@ Whether node that corresponds to given 
xref:refguide:applib:index/graph/tree/Tre
 --
 Select nodes by their corresponding 
xref:refguide:applib:index/graph/tree/TreePath.adoc[TreePath] , that is, 
activate their selection marker.
 --
-<.> xref:#lazy_T_Class[lazy(T, Class)]
+<.> xref:#root_T_TreeAdapter[root(T, TreeAdapter)]
 +
 --
-Convenient shortcut.
+Creates the root node of a tree structure as inferred from given treeAdapter.
+--
+<.> xref:#root_T_Class_FactoryService[root(T, Class, FactoryService)]
++
+--
+Creates the root node of a tree structure as inferred from given treeAdapter.
 --
-<.> xref:#getTreeAdapterClass_[getTreeAdapterClass()]
 
 == Members
 
+[#resolve_TreePath]
+=== resolve(TreePath)
+
+Resolves given path relative to the root of this tree.
+
 [#getTreeState_]
 === getTreeState()
 
@@ -122,10 +138,12 @@ With the _Wicket Viewer_ corresponds to expressing CSS 
class _tree-node-selected
 }
 ----
 
-[#lazy_T_Class]
-=== lazy(T, Class)
+[#root_T_TreeAdapter]
+=== root(T, TreeAdapter)
+
+Creates the root node of a tree structure as inferred from given treeAdapter.
 
-Convenient shortcut.
+[#root_T_Class_FactoryService]
+=== root(T, Class, FactoryService)
 
-[#getTreeAdapterClass_]
-=== getTreeAdapterClass()
+Creates the root node of a tree structure as inferred from given treeAdapter.
diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreePath.adoc
 
b/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreePath.adoc
index 95e4ec82c7..1fc21e65ca 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreePath.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreePath.adoc
@@ -12,25 +12,48 @@ Provides an unambiguous way to address nodes by position 
within a tree-structure
 [source,java]
 .TreePath.java
 ----
-interface TreePath {
+class TreePath {
+  TreePath(int[] canonicalPath)
+  TreePath of(int... canonicalPath)
+  TreePath root()
+  int size()     // <.>
   TreePath append(int indexWithinSiblings)     // <.>
+  TreePath subPath(int startIndex)     // <.>
   TreePath getParentIfAny()     // <.>
   boolean isRoot()
+  boolean startsWith(TreePath other)
   IntStream streamPathElements()
+  OptionalInt childIndex()     // <.>
   String stringify(String delimiter)
   Stream<TreePath> streamUpTheHierarchyStartingAtSelf()
-  TreePath of(int... canonicalPath)
-  TreePath root()
   TreePath parse(String treePathStringified, String delimiter)     // <.>
+  boolean equals(Object obj)
+  int hashCode()
+  String toString()
 }
 ----
 
+<.> xref:#size_[size()]
++
+--
+Number of path-elements.
+--
 <.> xref:#append_int[append(int)]
+<.> xref:#subPath_int[subPath(int)]
++
+--
+Returns a sub-path containing all the path-elements of this path, skipping 
startIndex number of path elements at the start.
+--
 <.> xref:#getParentIfAny_[getParentIfAny()]
 +
 --
 Returns a TreePath instance that represents the parent path of this TreePath, 
if this is not the root.
 --
+<.> xref:#childIndex_[childIndex()]
++
+--
+Optionally the 2nd path-element's value, based on presence. It corresponds to 
the sibling index of the child node this tree-path (either directly references 
or) includes.
+--
 <.> xref:#parse_String_String[parse(String, String)]
 +
 --
@@ -39,14 +62,29 @@ Parses stringified tree path of format _031_ ..., as 
returned by _TreePath#strin
 
 == Members
 
+[#size_]
+=== size()
+
+Number of path-elements.
+
 [#append_int]
 === append(int)
 
+[#subPath_int]
+=== subPath(int)
+
+Returns a sub-path containing all the path-elements of this path, skipping 
startIndex number of path elements at the start.
+
 [#getParentIfAny_]
 === getParentIfAny()
 
 Returns a TreePath instance that represents the parent path of this TreePath, 
if this is not the root.
 
+[#childIndex_]
+=== childIndex()
+
+Optionally the 2nd path-element's value, based on presence. It corresponds to 
the sibling index of the child node this tree-path (either directly references 
or) includes.
+
 [#parse_String_String]
 === parse(String, String)
 
diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeState.adoc
 
b/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeState.adoc
index 24baf9409e..02e71586a1 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeState.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/graph/tree/TreeState.adoc
@@ -6,7 +6,7 @@
 [source,java]
 .TreeState.java
 ----
-interface TreeState {
+class TreeState {
   TreeState rootCollapsed()
   Set<TreePath> getExpandedNodePaths()
   Set<TreePath> getSelectedNodePaths()
diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/value/Blob.adoc 
b/antora/components/refguide-index/modules/applib/pages/index/value/Blob.adoc
index c3cdd1545e..9deb9e3376 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/value/Blob.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/value/Blob.adoc
@@ -33,8 +33,8 @@ class Blob {
   Blob unZip(CommonMimeType resultingMimeType)
   Blob unZip(CommonMimeType resultingMimeType, ZipOptions zipOptions)
   Try<HashUtils.Hash> tryHash(HashAlgorithm hashAlgorithm)
-  Try<HashUtils.Hash> tryMd5()
   String md5Hex()
+  String sha256Hex()
   boolean equals(Object o)
   int hashCode()
   String toString()
diff --git a/core/adoc/modules/_overview/pages/about.adoc 
b/core/adoc/modules/_overview/pages/about.adoc
index 352b501230..3113438f98 100644
--- a/core/adoc/modules/_overview/pages/about.adoc
+++ b/core/adoc/modules/_overview/pages/about.adoc
@@ -615,7 +615,7 @@ Directory: /testing/specsupport/applib
 io.cucumber:cucumber-java:jar:<managed> +
 io.cucumber:cucumber-junit-platform-engine:jar:<managed> +
 io.cucumber:cucumber-spring:jar:<managed> +
-io.cucumber:messages:jar:24.0.1 +
+io.cucumber:messages:jar:24.1.0 +
 org.apache.causeway.testing:causeway-testing-fakedata-applib:jar:<managed> +
 org.apache.causeway.testing:causeway-testing-fixtures-applib:jar:<managed> +
 
org.apache.causeway.testing:causeway-testing-integtestsupport-applib:jar:<managed>
 +
@@ -1243,6 +1243,7 @@ 
o.a.i.core.metamodel.valuesemantics.PasswordValueSemantics +
 o.a.i.core.metamodel.valuesemantics.ShortValueSemantics +
 o.a.i.core.metamodel.valuesemantics.StringValueSemantics +
 o.a.i.core.metamodel.valuesemantics.TreeNodeValueSemantics +
+o.a.i.core.metamodel.valuesemantics.TreePathValueSemantics +
 o.a.i.core.metamodel.valuesemantics.URLValueSemantics +
 o.a.i.core.metamodel.valuesemantics.UUIDValueSemantics +
 o.a.i.core.metamodel.valuesemantics.temporal.LocalDateTimeValueSemantics +
@@ -5759,6 +5760,14 @@ Directory: /extensions/core/docgen
 ----
 |Provides a set of code mining features that can help building documentation 
for your application.
 
+.Components
+****
+o.a.i.extensions.docgen.topics.domainobjects.CausewayEntityDiagramPage +
+o.a.i.extensions.docgen.topics.domainobjects.DomainEntityDiagramPage +
+o.a.i.extensions.docgen.topics.domainobjects.EntityDiagramPageAbstract +
+o.a.i.extensions.docgen.topics.welcome.WelcomeHelpPage +
+****
+
 |Apache Causeway Ext - Docgen Help
 [source,yaml]
 ----
@@ -6911,7 +6920,31 @@ Artifact: causeway-regressiontests-base
 Type: jar
 Directory: /regressiontests/base
 ----
-|.Dependencies
+|.Components
+****
+o.a.i.testdomain.jdo.JdoInventoryDao +
+o.a.i.testdomain.jdo.JdoTestFixtures +
+o.a.i.testdomain.jpa.JpaInventoryDao +
+o.a.i.testdomain.jpa.JpaTestFixtures +
+o.a.i.testdomain.jpa.springdata.EmployeeRepository +
+o.a.i.testdomain.model.valuetypes.ValueTypeExampleService +
+o.a.i.testdomain.publishing.PublishingTestFactoryAbstract$CommitListener +
+o.a.i.testdomain.publishing.PublishingTestFactoryJdo +
+o.a.i.testdomain.publishing.PublishingTestFactoryJpa +
+o.a.i.testdomain.publishing.subscriber.CommandSubscriberForTesting +
+o.a.i.testdomain.publishing.subscriber.EntityChangesSubscriberForTesting +
+o.a.i.testdomain.publishing.subscriber.EntityPropertyChangeSubscriberForTesting
 +
+o.a.i.testdomain.publishing.subscriber.ExecutionSubscriberForTesting +
+o.a.i.testdomain.util.event.LifecycleEventSubscriberJdoForTesting +
+o.a.i.testdomain.util.event.LifecycleEventSubscriberJpaForTesting +
+o.a.i.testdomain.util.interaction.DomainObjectTesterFactory +
+o.a.i.testdomain.util.interaction.InteractionBoundaryProbe +
+o.a.i.testdomain.util.kv.KVStoreForTesting +
+o.a.i.testdomain.util.rest.RestEndpointService +
+o.a.i.testdomain.wrapperfactory.CounterRepository +
+****
+
+.Dependencies
 ****
 
org.apache.causeway.extensions:causeway-extensions-fullcalendar-applib:jar:<managed>
 +
 
org.apache.causeway.extensions:causeway-extensions-secman-encryption-jbcrypt:jar:<managed>
 +
@@ -7394,6 +7427,12 @@ Directory: 
/incubator/extensions/core/commandreplay/primary
 ----
 |A module for obtaining commands from a primary
 
+.Components
+****
+o.a.i.extensions.commandreplay.primary.config.PrimaryConfig +
+o.a.i.extensions.commandreplay.primary.spiimpl.CaptureResultOfCommand +
+****
+
 .Dependencies
 ****
 org.apache.causeway.core:causeway-core-config:jar:<managed> +
@@ -7419,6 +7458,16 @@ Directory: 
/incubator/extensions/core/commandreplay/secondary
 |A module providing a Quartz Job to run on a secondary system,
 for obtaining commands from a primary and saving them so that they are 
replayed.
 
+.Components
+****
+o.a.i.extensions.commandreplay.secondary.analyser.CommandReplayAnalyserException
 +
+o.a.i.extensions.commandreplay.secondary.analyser.CommandReplayAnalyserResult +
+o.a.i.extensions.commandreplay.secondary.analysis.CommandReplayAnalysisService 
+
+o.a.i.extensions.commandreplay.secondary.config.SecondaryConfig +
+o.a.i.extensions.commandreplay.secondary.fetch.CommandFetcher +
+o.a.i.extensions.commandreplay.secondary.job.ReplicateAndReplayJob +
+****
+
 .Dependencies
 ****
 org.apache.causeway.core:causeway-core-config:jar:<managed> +

Reply via email to