#137 - Merged Link and LinkTemplate.

Link now exposes additional methods like isTemplate(), getTemplateVariables() and expand(…).

src/test/java/org/springframework/hateoas/UriTemplateUnitTest.java

@@ -0,0 +1,184 @@
+/*
+ * Copyright 2014 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.hateoas;
+
+import static org.hamcrest.Matchers.*;
+import static org.junit.Assert.*;
+
+import java.net.URI;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+
+import org.junit.Test;
+import org.springframework.hateoas.UriTemplate.TemplateVariable;
+import org.springframework.hateoas.UriTemplate.VariableType;
+
+/**
+ * Unit tests for {@link UriTemplate}.
+ * 
+ * @author Oliver Gierke
+ */
+public class UriTemplateUnitTest {
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void discoversTemplate() {
+
+		assertThat(UriTemplate.isTemplate("/foo{?bar}"), is(true));
+		assertThat(UriTemplate.isTemplate("/foo"), is(false));
+		assertThat(UriTemplate.isTemplate(null), is(false));
+		assertThat(UriTemplate.isTemplate(""), is(false));
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void discoversRequestParam() {
+
+		UriTemplate template = new UriTemplate("/foo{?bar}");
+
+		assertVariables(template, new TemplateVariable("bar", VariableType.REQUEST_PARAM));
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void discoversRequestParamCntinued() {
+
+		UriTemplate template = new UriTemplate("/foo?bar{&foobar}");
+
+		assertVariables(template, new TemplateVariable("foobar", VariableType.REQUEST_PARAM_CONTINUED));
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void discoversOptionalPathVariable() {
+
+		UriTemplate template = new UriTemplate("/foo{/bar}");
+
+		assertVariables(template, new TemplateVariable("bar", VariableType.SEGMENT));
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void discoversPathVariable() {
+
+		UriTemplate template = new UriTemplate("/foo/{bar}");
+
+		assertVariables(template, new TemplateVariable("bar", VariableType.PATH_VARIABLE));
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void discoversFragment() {
+
+		UriTemplate template = new UriTemplate("/foo{#bar}");
+
+		assertVariables(template, new TemplateVariable("bar", VariableType.FRAGMENT));
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void discoversMultipleRequestParam() {
+
+		UriTemplate template = new UriTemplate("/foo{?bar,foobar}");
+
+		assertVariables(template, new TemplateVariable("bar", VariableType.REQUEST_PARAM), new TemplateVariable("foobar",
+				VariableType.REQUEST_PARAM));
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void expandsRequestParameter() {
+
+		UriTemplate template = new UriTemplate("/foo{?bar}");
+
+		URI uri = template.expand(Collections.<String, Object> singletonMap("bar", "myBar"));
+		assertThat(uri.toString(), is("/foo?bar=myBar"));
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void expandsMultipleRequestParameters() {
+
+		Map<String, Object> parameters = new HashMap<String, Object>();
+		parameters.put("bar", "myBar");
+		parameters.put("fooBar", "myFooBar");
+
+		UriTemplate template = new UriTemplate("/foo{?bar,fooBar}");
+
+		URI uri = template.expand(parameters);
+		assertThat(uri.toString(), is("/foo?bar=myBar&fooBar=myFooBar"));
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test(expected = IllegalArgumentException.class)
+	public void rejectsMissingRequiredPathVariable() {
+
+		UriTemplate template = new UriTemplate("/foo/{bar}");
+		template.expand(Collections.<String, Object> emptyMap());
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void expandsMultipleVariablesViaArray() {
+
+		UriTemplate template = new UriTemplate("/foo{/bar}{?firstname,lastname}{#anchor}");
+		URI uri = template.expand("path", "Dave", "Matthews", "discography");
+		assertThat(uri.toString(), is("/foo/path?firstname=Dave&lastname=Matthews#discography"));
+	}
+
+	/**
+	 * @see #137
+	 */
+	@Test
+	public void expandsTemplateWithoutVariablesCorrectly() {
+		assertThat(new UriTemplate("/foo").expand().toString(), is("/foo"));
+	}
+
+	private static void assertVariables(UriTemplate template, TemplateVariable... variables) {
+
+		assertThat(template.getVariableNames(), hasSize(variables.length));
+		assertThat(template.getVariables(), hasSize(variables.length));
+
+		for (TemplateVariable variable : variables) {
+
+			assertThat(template, hasItem(variable));
+			assertThat(template.getVariableNames(), hasItems(variable.getName()));
+		}
+	}
+}