Improve documentation of DirContextAdapter regarding UnsupportedOperationException (LDAP-208)

changelog.txt

@@ -37,6 +37,9 @@ Changes in version 1.3.1 (October 2010)
 * DefaultDirObjectFactory calls a Java5 version of the IllegalArgumentException
   constructor. (LDAP 196).
 
+* DirContextAdapter JavaDoc now states clearly that several methods are not
+  implemented on purpose. (LDAP-208)
+
 * Class-level JavaDoc for OrFilter no longer uses AndFilter in sample code. (LDAP-217)
 
 * Upgraded Spring to 2.5.6.SEC02 and 3.0.3.RELEASE. (LDAP-210)

core/src/main/java/org/springframework/ldap/core/DirContextAdapter.java

@@ -60,6 +60,10 @@ import org.springframework.util.StringUtils;
  * available as an array of <code>ModificationItem</code> objects, suitable as
  * input to {@link LdapTemplate#modifyAttributes(DirContextOperations)}.
  * 
+ * Note that this is not a complete implementation of DirContext. Several
+ * methods are not relevant for the intended usage of this class, so they
+ * throw UnsupportOperationException.
+ *
  * @see #setAttributeValue(String, Object)
  * @see #setAttributeValues(String, Object[])
  * @see #getStringAttribute(String)