X-Git-Url: https://git.argeo.org/?a=blobdiff_plain;f=org.argeo.util%2Fsrc%2Forg%2Fargeo%2Futil%2Fdirectory%2FHierarchyUnit.java;h=1acd34f487278a5e1c06a2d978f97980abc75aa0;hb=6aae2af9d483bef26ca8c5be37c9702f839443db;hp=68cc1bb2d5de7cbe308dd1322b8c0c656f025455;hpb=0ce8ecfe974cec9f524c16884209cd08544d890d;p=lgpl%2Fargeo-commons.git

diff --git a/org.argeo.util/src/org/argeo/util/directory/HierarchyUnit.java b/org.argeo.util/src/org/argeo/util/directory/HierarchyUnit.java
index 68cc1bb2d..1acd34f48 100644
--- a/org.argeo.util/src/org/argeo/util/directory/HierarchyUnit.java
+++ b/org.argeo.util/src/org/argeo/util/directory/HierarchyUnit.java
@@ -4,17 +4,35 @@ import java.util.Dictionary;
 
 /** A unit within the high-level organisational structure of a directory. */
 public interface HierarchyUnit {
+	/** Name to use in paths. */
 	String getHierarchyUnitName();
 
+	/**
+	 * The parent {@link HierarchyUnit}, or <code>null</code> if a
+	 * {@link Directory}.
+	 */
 	HierarchyUnit getParent();
 
-	Iterable<HierarchyUnit> getDirectHierachyUnits(boolean functionalOnly);
+	/** Direct children {@link HierarchyUnit}s. */
+	Iterable<HierarchyUnit> getDirectHierarchyUnits(boolean functionalOnly);
 
+	/**
+	 * Whether this is an arbitrary named and placed {@link HierarchyUnit}.
+	 * 
+	 * @return <code>true</code> if functional, <code>false</code> is technical
+	 *         (e.g. People, Groups, etc.)
+	 */
 	boolean isFunctional();
 
-	String getContext();
+	/**
+	 * The base of this organisational unit within the hierarchy. This would
+	 * typically be an LDAP base DN.
+	 */
+	String getBase();
 
+	/** The related {@link Directory}. */
 	Directory getDirectory();
 
+	/** Its metadata (typically LDAP attributes). */
 	Dictionary<String, Object> getProperties();
 }