added uri syntax exceptions

src/main/java/io/usethesource/vallang/ISourceLocation.java

@@ -13,6 +13,7 @@
 package io.usethesource.vallang;
 
 import java.net.URI;
+import java.net.URISyntaxException;
 
 import io.usethesource.vallang.visitors.IValueVisitor;
 
@@ -139,23 +140,23 @@ public interface ISourceLocation extends IValue {
 
     public boolean hasFileName();
 
-    public ISourceLocation changeScheme(String newScheme);
+    public ISourceLocation changeScheme(String newScheme) throws URISyntaxException;
 
-    public ISourceLocation changeAuthority(String newAuthority);
+    public ISourceLocation changeAuthority(String newAuthority) throws URISyntaxException;
 
-    public ISourceLocation changePath(String newPath);
+    public ISourceLocation changePath(String newPath) throws URISyntaxException;
 
-    public ISourceLocation changeFile(String newFile);
+    public ISourceLocation changeFile(String newFile) throws URISyntaxException;
 
-    public ISourceLocation changeExtension(String newExtension);
+    public ISourceLocation changeExtension(String newExtension) throws URISyntaxException;
 
-    public ISourceLocation changeFragment(String newFragment);
+    public ISourceLocation changeFragment(String newFragment) throws URISyntaxException;
 
-    public ISourceLocation changeQuery(String newQuery);
+    public ISourceLocation changeQuery(String newQuery) throws URISyntaxException;
 
-    public ISourceLocation changeFileName(String newFileName);
+    public ISourceLocation changeFileName(String newFileName) throws URISyntaxException;
 
-    public ISourceLocation makeChildLocation(String childPath);
+    public ISourceLocation makeChildLocation(String childPath) throws URISyntaxException;
 
     public ISourceLocation getParentLocation();
 

src/main/java/io/usethesource/vallang/IValueFactory.java

@@ -443,7 +443,7 @@ public ISourceLocation sourceLocation(String scheme, String authority,
 
 	/**
 	 * Get a set writer of which the element type will be the least upper bound
-	 * of the element types
+	 * of the element types. ISetWriter instances are stream of IValue collectors.
 	 * 
 	 * @return a set writer
 	 */
@@ -461,7 +461,7 @@ public ISourceLocation sourceLocation(String scheme, String authority,
 
 	/**
 	 * Get a list writer of which the element type will be the least upper bound
-	 * of the element types
+	 * of the element types. IListWriter instances are stream of IValue collectors.
 	 * 
 	 * @return a list writer
 	 */
@@ -478,7 +478,8 @@ public ISourceLocation sourceLocation(String scheme, String authority,
 
 	/**
 	 * Get a map writer of which the key and value types will be the least upper
-	 * bound of the keys and values that are put in.
+	 * bound of the keys and values that are put in. IMapWriter instances are
+	 * stream collectors; the stream must be made of binary ITuple instances.
 	 * 
 	 * @return a list writer
 	 */

src/main/java/io/usethesource/vallang/impl/primitive/SourceLocationURIValues.java

@@ -273,11 +273,70 @@ public boolean hasOffsetLength() {
 		    return false;
 		}
 
-
 		@Override
 		public ISourceLocation top() {
 		    return this;
 		}
+
+		@Override
+		public ISourceLocation changeAuthority(String authority) throws URISyntaxException {
+			return newURI(scheme, authority, null, null, null);
+		}
+
+		@Override
+		public ISourceLocation changeScheme(String scheme) throws URISyntaxException {
+			return newURI(scheme, null, null, null, null);
+		}
+
+		@Override
+		public ISourceLocation changeFragment(String fragment) throws URISyntaxException {
+			return newURI(scheme, null, null, null, fragment);
+		}
+
+		@Override
+		public ISourceLocation changeQuery(String fragment) throws URISyntaxException {
+			return newURI(scheme, null, null, null, fragment);
+		}
+
+		@Override
+		public ISourceLocation getParentLocation() {
+			return this;
+		}
+
+		@Override
+		public boolean hasFileName() {
+			return false;
+		}
+
+		@Override
+		public ISourceLocation changeExtension(String ext) {
+			throw new UnsupportedOperationException();
+		}
+
+		@Override
+		public String getFileName() {
+			throw new UnsupportedOperationException();
+		}
+
+		@Override
+		public ISourceLocation changeFileName(String file) throws URISyntaxException {
+			throw new UnsupportedOperationException();
+		}
+
+		@Override
+		public ISourceLocation changeFile(String file) throws URISyntaxException {
+			throw new UnsupportedOperationException();
+		}
+
+		@Override
+		public ISourceLocation changePath(String path) throws URISyntaxException {
+			throw new UnsupportedOperationException();
+		}
+
+		@Override
+		public ISourceLocation makeChildLocation(String path) throws URISyntaxException {
+			return newURI(scheme, null, path, null, null);
+		}
 	}
 
 	private static final Pattern squareBrackets = Pattern.compile("(\\[|\\])");

src/main/java/io/usethesource/vallang/impl/primitive/SourceLocationValues.java

@@ -269,6 +269,7 @@ public int getLength() throws UnsupportedOperationException {
 		public int getOffset() throws UnsupportedOperationException {
 			throw new UnsupportedOperationException();
 		}
+
 	}
 
 	private static class IntIntIntIntIntInt extends Complete {