clarify that the eval methods throw certain runtime exceptions

Author: sammefford

src/main/java/com/marklogic/client/eval/ServerEvaluationCall.java

@@ -15,6 +15,8 @@
  */
 package com.marklogic.client.eval;
 
+import com.marklogic.client.FailedRequestException;
+import com.marklogic.client.ForbiddenUserException;
 import com.marklogic.client.Transaction;
 import com.marklogic.client.io.marker.AbstractReadHandle;
 import com.marklogic.client.io.marker.AbstractWriteHandle;
@@ -37,7 +39,10 @@ public interface ServerEvaluationCall {
     public ServerEvaluationCall transaction(Transaction transaction);
     public ServerEvaluationCall addNamespace(String prefix, String namespaceURI);
     public ServerEvaluationCall namespaceContext(EditableNamespaceContext namespaces);
-    public <T> T evalAs(Class<T> responseType);
-    public <H extends AbstractReadHandle> H eval(H responseHandle);
-    public EvalResultIterator eval();
+    public <T> T evalAs(Class<T> responseType)
+        throws ForbiddenUserException, FailedRequestException;
+    public <H extends AbstractReadHandle> H eval(H responseHandle)
+        throws ForbiddenUserException, FailedRequestException;
+    public EvalResultIterator eval()
+        throws ForbiddenUserException, FailedRequestException;
 }

src/main/java/com/marklogic/client/impl/ServerEvaluationCallImpl.java

@@ -18,6 +18,8 @@
 import java.util.HashMap;
 
 import com.marklogic.client.DatabaseClientFactory.HandleFactoryRegistry;
+import com.marklogic.client.FailedRequestException;
+import com.marklogic.client.ForbiddenUserException;
 import com.marklogic.client.Transaction;
 import com.marklogic.client.eval.EvalResultIterator;
 import com.marklogic.client.eval.ServerEvaluationCall;
@@ -131,7 +133,9 @@ public ServerEvaluationCall transaction(Transaction transaction) {
     }
 
     @Override
-    public <T> T evalAs(Class<T> responseType) {
+    public <T> T evalAs(Class<T> responseType) 
+        throws ForbiddenUserException, FailedRequestException
+    {
         if (responseType == null) throw new IllegalArgumentException("responseType cannot be null");
 
         ContentHandle<T> readHandle = handleRegistry.makeHandle(responseType);
@@ -142,7 +146,9 @@ public <T> T evalAs(Class<T> responseType) {
     }
 
     @Override
-    public <H extends AbstractReadHandle> H eval(H responseHandle) {
+    public <H extends AbstractReadHandle> H eval(H responseHandle) 
+        throws ForbiddenUserException, FailedRequestException
+    {
         EvalResultIterator iterator = eval();
         try {
             if ( iterator == null || iterator.hasNext() == false ) return null;
@@ -151,7 +157,9 @@ public <H extends AbstractReadHandle> H eval(H responseHandle) {
     }
 
     @Override
-    public EvalResultIterator eval() {
+    public EvalResultIterator eval() 
+        throws ForbiddenUserException, FailedRequestException
+    {
         return services.postEvalInvoke(requestLogger, code, modulePath, evalContext,
             vars, namespaceContext, transactionId);
     }