Update or add javadoc for new 2.2 classes.

Author: kwwall

src/main/java/org/owasp/esapi/configuration/AbstractPrioritizedPropertyLoader.java

@@ -4,6 +4,26 @@
 import java.io.File;
 import java.util.Properties;
 
+/**
+ * Abstrace class that supports two "levels" of priorities for ESAPI properties.
+ * The higher level is the property file supported by an "operations" team and
+ * the lower level is the property file intended to be supported by the
+ * "development" team. ESAPI properties defined in the lower level properties
+ * file cannot supersede properties defined in the higher level properties file.
+ *
+ * The intent os to place ESAPI properties related to enterprise-wide security
+ * policy (e.g., the minimum sized encryption key,
+ * <b>Encryptor.MinEncryptionKeyLength</b> in the higher level so the
+ * development team cannot dumb down the policy, either accidentally or
+ * intentionally. (This of course requires that the developers don't provide the
+ * operations team the properties file for them to use. :) This is also good for
+ * allowing the productions operations team to select property values for
+ * properties such as <b>Encryptor.MasterKey</b> and <b>Encryptor.MasterSalt</b>
+ * so that they are only on a "need-to-know" basis and don't accidentally get
+ * committed to the development team's SCM repository.
+ *
+ * @since 2.2
+ *
 public abstract class AbstractPrioritizedPropertyLoader implements EsapiPropertyLoader,
         Comparable<AbstractPrioritizedPropertyLoader> {
 

src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoader.java

@@ -4,6 +4,8 @@
 
 /**
  * Generic interface for loading security configuration properties.
+ *
+ * @since 2.2
  */
 public interface EsapiPropertyLoader {
 

src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoaderFactory.java

@@ -11,6 +11,8 @@
 /**
  * Factory class that takes care of initialization of proper instance of EsapiPropertyLoader
  * based on EsapiPropertiesStore
+ *
+ * @since 2.2
  */
 public class EsapiPropertyLoaderFactory {
 

src/main/java/org/owasp/esapi/configuration/EsapiPropertyManager.java

@@ -10,8 +10,12 @@
 /**
  * Manager used for loading security configuration properties. Does all the logic to obtain the correct property from
  * correct source. Uses following system properties to find configuration files:
+ * <pre>
  * - org.owasp.esapi.devteam - lower priority dev file path
  * - org.owasp.esapi.opsteam - higher priority ops file path
+ * </pre>
+ *
+ * @since 2.2
  */
 public class EsapiPropertyManager implements EsapiPropertyLoader {
 

src/main/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoader.java

@@ -7,6 +7,8 @@
 
 /**
  * Loader capable of loading single security configuration property from standard java properties configuration file.
+ *
+ * @since 2.2
  */
 public class StandardEsapiPropertyLoader extends AbstractPrioritizedPropertyLoader {
 

src/main/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoader.java

@@ -21,6 +21,8 @@
 
 /**
  * Loader capable of loading single security configuration property from xml configuration file.
+ *
+ * @since 2.2
  */
 public class XmlEsapiPropertyLoader extends AbstractPrioritizedPropertyLoader {
 

src/main/java/org/owasp/esapi/configuration/consts/EsapiConfiguration.java

@@ -2,6 +2,8 @@
 
 /**
  * Enum used for initialization of esapi configuration files. 
+ *
+ * @since 2.2
  */
 public enum EsapiConfiguration {
 

src/main/java/org/owasp/esapi/configuration/consts/EsapiConfigurationType.java

@@ -3,6 +3,8 @@
 
 /**
  * Supported esapi configuration file types.
+ *
+ * @since 2.2
  */
 public enum EsapiConfigurationType {
     PROPERTIES("properties"), XML("xml");