Documentation Improvements

This changes makes a bunch documentation improvements, case normalizations,
and general improvements left over from the previous addition of the
Kubernetes Service Binding support.

Signed-off-by: Ben Hale <bhale@vmware.com>

src/main/java/org/springframework/cloud/bindings/Binding.java

@@ -15,6 +15,8 @@
  */
 package org.springframework.cloud.bindings;
 
+import org.springframework.lang.Nullable;
+
 import java.io.IOException;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
@@ -72,8 +74,8 @@ public final class Binding {
         this.path = path;
         this.secret = new HashMap<>();
 
-        String provider = null;
         String type = null;
+        String provider = null;
         for (Map.Entry<String, String> entry : secret.entrySet()) {
             switch (entry.getKey()) {
                 case TYPE:
@@ -88,8 +90,12 @@ public final class Binding {
             }
         }
 
-        this.provider = provider;
+        if (type == null) {
+            throw new IllegalArgumentException(String.format("%s has no type and is not a valid binding", path));
+        }
+
         this.type = type;
+        this.provider = provider;
     }
 
     private static Map<String, String> createSecretMap(Path path) {
@@ -163,6 +169,7 @@ public final class Binding {
     /**
      * Returns the provider of the binding.
      */
+    @Nullable
     public String getProvider() {
         return provider;
     }

src/main/java/org/springframework/cloud/bindings/Bindings.java

@@ -49,9 +49,10 @@ public final class Bindings {
     private final List<Binding> bindings;
 
     /**
-     * Creates a new {@code Bindings} instance, using the {@code $CNB_BINDINGS} environment variable to determine the
-     * file system root.  If the {@code $CNB_BINDINGS} environment variable is not set, an empty {@code Bindings} is
-     * returned. If the directory does not exist, an empty {@code Bindings} is returned.
+     * Creates a new {@code Bindings} instance, using the {@code $SERVICE_BINDING_ROOT} environment variable or the
+     * {@code $CNB_BINDINGS} environment variable if it does not exist to determine the file system root.  If neither
+     * the {@code $SERVICE_BINDING_ROOT} nor {@code $CNB_BINDINGS} environment variables are set, an empty
+     * {@code Bindings} is returned. If the directory does not exist, an empty {@code Bindings} is returned.
      */
     public Bindings() {
         this(getBindingRoot());
@@ -150,9 +151,8 @@ public final class Bindings {
      */
     public List<Binding> filterBindings(@Nullable String type, @Nullable String provider) {
         return bindings.stream()
-                .filter(binding ->
-                        (type == null || binding.getType().equalsIgnoreCase(type)) &&
-                                (provider == null || binding.getProvider().equalsIgnoreCase(provider)))
+                .filter(b -> type == null || b.getType().equalsIgnoreCase(type))
+                .filter(b -> provider == null || b.getProvider() != null && b.getProvider().equalsIgnoreCase(provider))
                 .collect(Collectors.toList());
     }
 

src/main/java/org/springframework/cloud/bindings/boot/BindingFlattenedEnvironmentPostProcessor.java

@@ -33,12 +33,12 @@ import static org.springframework.cloud.bindings.boot.PropertySourceContributor.
 
 /**
  * An implementation of {@link EnvironmentPostProcessor} that generates properties from {@link Bindings} with a
- * flattened format: {@code cnb.bindings.{name}.{metadata,secret}.*}.
+ * flattened format: {@code k8s.bindings.{name}.*}.
  */
 public final class BindingFlattenedEnvironmentPostProcessor implements ApplicationListener<ApplicationPreparedEvent>,
         EnvironmentPostProcessor, Ordered {
 
-    public static final String BINDING_FLATTENED_PROPERTY_SOURCE_NAME = "cnbBindingFlattened";
+    public static final String BINDING_FLATTENED_PROPERTY_SOURCE_NAME = "kubernetesServiceBindingFlattened";
 
     private final DeferredLog log = new DeferredLog();
 
@@ -72,16 +72,16 @@ public final class BindingFlattenedEnvironmentPostProcessor implements Applicati
         Map<String, Object> properties = new HashMap<>();
         bindings.getBindings().forEach(binding -> {
             binding.getSecret().forEach((key, value) -> {
-                properties.put(String.format("cnb.bindings.%s.%s", binding.getName(), key), value);
+                properties.put(String.format("k8s.bindings.%s.%s", binding.getName(), key), value);
             });
         });
 
         if (properties.isEmpty()) {
-            log.debug("No properties set from CNB Bindings. Skipping PropertySource creation.");
+            log.debug("No properties set from Kubernetes Service Bindings. Skipping PropertySource creation.");
             return;
         }
 
-        log.info("Creating flattened PropertySource from CNB Bindings");
+        log.info("Creating flattened PropertySource from Kubernetes Service Bindings");
         contributePropertySource(BINDING_FLATTENED_PROPERTY_SOURCE_NAME, properties, environment);
     }
 

src/main/java/org/springframework/cloud/bindings/boot/BindingSpecificEnvironmentPostProcessor.java

@@ -51,7 +51,7 @@ public final class BindingSpecificEnvironmentPostProcessor implements Applicatio
     /**
      * The name of the {@link PropertySource} created by the {@code BindingsEnvironmentPostProcessor}: {@value}.
      */
-    public static final String BINDING_SPECIFIC_PROPERTY_SOURCE_NAME = "cnbBindingSpecific";
+    public static final String BINDING_SPECIFIC_PROPERTY_SOURCE_NAME = "kubernetesServiceBindingSpecific";
 
     private static final DeferredLog LOG = new DeferredLog();
 
@@ -92,18 +92,18 @@ public final class BindingSpecificEnvironmentPostProcessor implements Applicatio
         }
 
         if (bindings.getBindings().isEmpty()) {
-            LOG.debug("No CNB Bindings found. Skipping Environment post-processing.");
+            LOG.debug("No Kubernetes Service Bindings found. Skipping Environment post-processing.");
             return;
         }
 
         Map<String, Object> properties = new HashMap<>();
         processors.forEach(processor -> processor.process(environment, bindings, properties));
         if (properties.isEmpty()) {
-            LOG.debug("No properties set from CNB Bindings. Skipping PropertySource creation.");
+            LOG.debug("No properties set from Kubernetes Service Bindings. Skipping PropertySource creation.");
             return;
         }
 
-        LOG.info("Creating binding-specific PropertySource from CNB Bindings");
+        LOG.info("Creating binding-specific PropertySource from Kubernetes Service Bindings");
         contributePropertySource(BINDING_SPECIFIC_PROPERTY_SOURCE_NAME, properties, environment);
     }
 

src/main/java/org/springframework/cloud/bindings/boot/CassandraBindingsPropertiesProcessor.java

@@ -32,7 +32,7 @@ public final class CassandraBindingsPropertiesProcessor implements BindingsPrope
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Cassandra";
+    public static final String TYPE = "cassandra";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/ConfigServerBindingsPropertiesProcessor.java

@@ -31,7 +31,7 @@ final class ConfigServerBindingsPropertiesProcessor implements BindingsPropertie
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Config";
+    public static final String TYPE = "config";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/CouchbaseBindingsPropertiesProcessor.java

@@ -32,7 +32,7 @@ final class CouchbaseBindingsPropertiesProcessor implements BindingsPropertiesPr
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Couchbase";
+    public static final String TYPE = "couchbase";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/Db2BindingsPropertiesProcessor.java

@@ -34,7 +34,7 @@ public final class Db2BindingsPropertiesProcessor implements BindingsPropertiesP
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "DB2";
+    public static final String TYPE = "db2";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/ElasticsearchBindingsPropertiesProcessor.java

@@ -32,7 +32,7 @@ final class ElasticsearchBindingsPropertiesProcessor implements BindingsProperti
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Elasticsearch";
+    public static final String TYPE = "elasticsearch";
 
 
     @Override

src/main/java/org/springframework/cloud/bindings/boot/EurekaBindingsPropertiesProcessor.java

@@ -31,7 +31,7 @@ final class EurekaBindingsPropertiesProcessor implements BindingsPropertiesProce
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Eureka";
+    public static final String TYPE = "eureka";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/Guards.java

@@ -26,7 +26,7 @@ final class Guards {
 
     static boolean isTypeEnabled(Environment environment, String type) {
         return environment.getProperty(
-                String.format("org.springframework.cloud.bindings.boot.%s.enable", type.toLowerCase()),
+                String.format("org.springframework.cloud.bindings.boot.%s.enable", type),
                 Boolean.class, true);
     }
 

src/main/java/org/springframework/cloud/bindings/boot/KafkaBindingsPropertiesProcessor.java

@@ -31,7 +31,7 @@ final class KafkaBindingsPropertiesProcessor implements BindingsPropertiesProces
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Kafka";
+    public static final String TYPE = "kafka";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/LDAPBindingsPropertiesProcessor.java

@@ -31,7 +31,7 @@ public final class LDAPBindingsPropertiesProcessor implements BindingsProperties
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "LDAP";
+    public static final String TYPE = "ldap";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/MongoDbBindingsPropertiesProcessor.java

@@ -32,7 +32,7 @@ public final class MongoDbBindingsPropertiesProcessor implements BindingsPropert
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "MongoDB";
+    public static final String TYPE = "mongodb";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/MySqlBindingsPropertiesProcessor.java

@@ -34,7 +34,7 @@ public final class MySqlBindingsPropertiesProcessor implements BindingsPropertie
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "MySQL";
+    public static final String TYPE = "mysql";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/Neo4JBindingsPropertiesProcessor.java

@@ -31,7 +31,7 @@ final class Neo4JBindingsPropertiesProcessor implements BindingsPropertiesProces
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Neo4J";
+    public static final String TYPE = "neo4j";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/OracleBindingsPropertiesProcessor.java

@@ -34,7 +34,7 @@ public final class OracleBindingsPropertiesProcessor implements BindingsProperti
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Oracle";
+    public static final String TYPE = "oracle";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/PostgreSqlBindingsPropertiesProcessor.java

@@ -34,7 +34,7 @@ public final class PostgreSqlBindingsPropertiesProcessor implements BindingsProp
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "PostgreSQL";
+    public static final String TYPE = "postgresql";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/RabbitMqBindingsPropertiesProcessor.java

@@ -32,7 +32,7 @@ final class RabbitMqBindingsPropertiesProcessor implements BindingsPropertiesPro
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "RabbitMQ";
+    public static final String TYPE = "rabbitmq";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/RedisBindingsPropertiesProcessor.java

@@ -32,7 +32,7 @@ public final class RedisBindingsPropertiesProcessor implements BindingsPropertie
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Redis";
+    public static final String TYPE = "redis";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/SpringSecurityOAuth2BindingsPropertiesProcessor.java

@@ -35,7 +35,7 @@ public final class SpringSecurityOAuth2BindingsPropertiesProcessor implements Bi
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "OAuth2";
+    public static final String TYPE = "oauth2";
 
     private static final DeferredLog LOG = new DeferredLog();
 

src/main/java/org/springframework/cloud/bindings/boot/SqlServerBindingsPropertiesProcessor.java

@@ -34,7 +34,7 @@ public final class SqlServerBindingsPropertiesProcessor implements BindingsPrope
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "SQLServer";
+    public static final String TYPE = "sqlserver";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {

src/main/java/org/springframework/cloud/bindings/boot/VaultBindingsPropertiesProcessor.java

@@ -35,7 +35,7 @@ public final class VaultBindingsPropertiesProcessor implements BindingsPropertie
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Vault";
+    public static final String TYPE = "vault";
 
     private static final DeferredLog LOG = new DeferredLog();
 

src/main/java/org/springframework/cloud/bindings/boot/WavefrontBindingsPropertiesProcessor.java

@@ -32,7 +32,7 @@ public final class WavefrontBindingsPropertiesProcessor implements BindingsPrope
     /**
      * The {@link Binding} type that this processor is interested in: {@value}.
      **/
-    public static final String TYPE = "Wavefront";
+    public static final String TYPE = "wavefront";
 
     @Override
     public void process(Environment environment, Bindings bindings, Map<String, Object> properties) {