#728 - API polishing.

Renamed LinkBuilder implementations for the different web stacks Web(MVC|Flux)LinkBuilder for symmetry. Introduced dedicated builder types to be used from WebFluxLinkBuilder to more conveniently integrate with reactive flows (see the changes in WebFluxEmployeeController).

Deprecated ControllerLinkBuilder(Factory) in favor of WebMvcLinkBuilder(Factory).

Generally untangled the use of WebMvcLinkBuilder from the reactive examples.

Author: odrotbohm

src/main/java/org/springframework/hateoas/MethodLinkBuilderFactory.java

@@ -18,7 +18,7 @@
 import java.lang.reflect.Method;
 
 import org.springframework.hateoas.core.DummyInvocationUtils;
-import org.springframework.hateoas.mvc.ControllerLinkBuilder;
+import org.springframework.hateoas.mvc.WebMvcLinkBuilder;
 
 /**
  * Extension of {@link LinkBuilderFactory} for implementations that also support creating {@link LinkBuilder}s by
@@ -52,9 +52,9 @@ public interface MethodLinkBuilderFactory<T extends LinkBuilder> extends LinkBui
 	/**
 	 * Returns a {@link LinkBuilder} pointing to the URI mapped to the method the result is handed into this method. Use
 	 * {@link DummyInvocationUtils#methodOn(Class, Object...)} to obtain a dummy instance of a controller to record a
-	 * dummy method invocation on. See {@link ControllerLinkBuilder#linkTo(Object)} for an example.
-	 * 
-	 * @see ControllerLinkBuilder#linkTo(Object)
+	 * dummy method invocation on. See {@link WebMvcLinkBuilder#linkTo(Object)} for an example.
+	 *
+	 * @see WebMvcLinkBuilder#linkTo(Object)
 	 * @param methodInvocationResult must not be {@literal null}.
 	 * @return
 	 */

src/main/java/org/springframework/hateoas/config/EntityLinksConfiguration.java

@@ -22,7 +22,7 @@
 import org.springframework.hateoas.EntityLinks;
 import org.springframework.hateoas.core.ControllerEntityLinksFactoryBean;
 import org.springframework.hateoas.core.DelegatingEntityLinks;
-import org.springframework.hateoas.mvc.ControllerLinkBuilderFactory;
+import org.springframework.hateoas.mvc.WebMvcLinkBuilderFactory;
 import org.springframework.plugin.core.PluginRegistry;
 import org.springframework.plugin.core.support.PluginRegistryFactoryBean;
 import org.springframework.stereotype.Controller;
@@ -54,7 +54,7 @@ DelegatingEntityLinks delegatingEntityLinks(PluginRegistry<EntityLinks, Class<?>
 	}
 
 	@Bean
-	ControllerEntityLinksFactoryBean controllerEntityLinks(ControllerLinkBuilderFactory controllerLinkBuilderFactory) {
+	ControllerEntityLinksFactoryBean controllerEntityLinks(WebMvcLinkBuilderFactory controllerLinkBuilderFactory) {
 
 		ControllerEntityLinksFactoryBean factory = new ControllerEntityLinksFactoryBean();
 		factory.setAnnotation(Controller.class);
@@ -64,7 +64,7 @@ ControllerEntityLinksFactoryBean controllerEntityLinks(ControllerLinkBuilderFact
 	}
 
 	@Bean
-	ControllerLinkBuilderFactory controllerLinkBuilderFactoryBean() {
-		return new ControllerLinkBuilderFactory();
+	WebMvcLinkBuilderFactory webMvcLinkBuilderFactoryBean() {
+		return new WebMvcLinkBuilderFactory();
 	}
 }

src/main/java/org/springframework/hateoas/core/WebHandler.java

@@ -42,7 +42,6 @@
 import org.springframework.hateoas.LinkBuilder;
 import org.springframework.hateoas.TemplateVariable;
 import org.springframework.hateoas.TemplateVariables;
-import org.springframework.hateoas.mvc.ControllerLinkBuilder;
 import org.springframework.util.Assert;
 import org.springframework.util.ConcurrentReferenceHashMap;
 import org.springframework.util.MultiValueMap;
@@ -57,7 +56,7 @@
 import org.springframework.web.util.UriTemplate;
 
 /**
- * Utility for taking a method invocation and extracting a {@link ControllerLinkBuilder}.
+ * Utility for taking a method invocation and extracting a {@link LinkBuilder}.
  *
  * @author Greg Turnquist
  */

src/main/java/org/springframework/hateoas/mvc/ControllerLinkBuilder.java

@@ -55,7 +55,9 @@
  * @author Andrew Naydyonock
  * @author Oliver Trosien
  * @author Greg Turnquist
+ * @deprecated use {@link WebMvcLinkBuilder} instead.
  */
+@Deprecated
 public class ControllerLinkBuilder extends TemplateVariableAwareLinkBuilderSupport<ControllerLinkBuilder> {
 
 	private static final String REQUEST_ATTRIBUTES_MISSING = "Could not find current request via RequestContextHolder. Is this being called from a Spring MVC handler?";

src/main/java/org/springframework/hateoas/mvc/ControllerLinkBuilderFactory.java

@@ -42,7 +42,9 @@
  * @author Kevin Conaway
  * @author Andrew Naydyonock
  * @author Greg Turnquist
+ * @deprecated use {@link WebMvcLinkBuilderFactory} instead.
  */
+@Deprecated
 public class ControllerLinkBuilderFactory implements MethodLinkBuilderFactory<ControllerLinkBuilder> {
 
 	private List<UriComponentsContributor> uriComponentsContributors = new ArrayList<>();

src/main/java/org/springframework/hateoas/mvc/IdentifiableResourceAssemblerSupport.java

@@ -15,7 +15,7 @@
  */
 package org.springframework.hateoas.mvc;
 
-import static org.springframework.hateoas.mvc.ControllerLinkBuilder.*;
+import static org.springframework.hateoas.mvc.WebMvcLinkBuilder.*;
 
 import java.util.Arrays;
 

src/main/java/org/springframework/hateoas/mvc/ResourceAssemblerSupport.java

@@ -15,7 +15,7 @@
  */
 package org.springframework.hateoas.mvc;
 
-import static org.springframework.hateoas.mvc.ControllerLinkBuilder.*;
+import static org.springframework.hateoas.mvc.WebMvcLinkBuilder.*;
 
 import java.util.ArrayList;
 import java.util.List;