X-Git-Url: https://git.argeo.org/?a=blobdiff_plain;f=org.argeo.util%2Fsrc%2Forg%2Fargeo%2Futil%2Fdirectory%2FHierarchyUnit.java;h=947b6bc8553124e189f16fc6ab64671fffc6f1ed;hb=3c1cdc594d954520b14646102b366290bdad58c7;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..947b6bc85 100644
--- a/org.argeo.util/src/org/argeo/util/directory/HierarchyUnit.java
+++ b/org.argeo.util/src/org/argeo/util/directory/HierarchyUnit.java
@@ -1,20 +1,42 @@
 package org.argeo.util.directory;
 
 import java.util.Dictionary;
+import java.util.Locale;
 
 /** A unit within the high-level organisational structure of a directory. */
 public interface HierarchyUnit {
+	/** Name to use in paths. */
 	String getHierarchyUnitName();
 
+	/** Name to use in UI. */
+	String getHierarchyUnitLabel(Locale locale);
+
+	/**
+	 * 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();
 }