From 5963a2d3d6860fe57afc138f095bf2d2eb5a7b80 Mon Sep 17 00:00:00 2001 From: lresende Date: Mon, 7 Oct 2013 22:23:21 +0000 Subject: Official Tuscany 2.0.1 Release git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@1530096 13f79535-47bb-0310-9956-ffa450edef68 --- .../invocation/impl/AsyncInvocationFutureImpl.java | 285 --------------------- 1 file changed, 285 deletions(-) delete mode 100644 sca-java-2.x/tags/2.0.1-RC1/modules/core/src/main/java/org/apache/tuscany/sca/core/invocation/impl/AsyncInvocationFutureImpl.java (limited to 'sca-java-2.x/tags/2.0.1-RC1/modules/core/src/main/java/org/apache/tuscany/sca/core/invocation/impl/AsyncInvocationFutureImpl.java') diff --git a/sca-java-2.x/tags/2.0.1-RC1/modules/core/src/main/java/org/apache/tuscany/sca/core/invocation/impl/AsyncInvocationFutureImpl.java b/sca-java-2.x/tags/2.0.1-RC1/modules/core/src/main/java/org/apache/tuscany/sca/core/invocation/impl/AsyncInvocationFutureImpl.java deleted file mode 100644 index 66b9516738..0000000000 --- a/sca-java-2.x/tags/2.0.1-RC1/modules/core/src/main/java/org/apache/tuscany/sca/core/invocation/impl/AsyncInvocationFutureImpl.java +++ /dev/null @@ -1,285 +0,0 @@ -/* - * Licensed to the Apache Software Foundation (ASF) under one - * or more contributor license agreements. See the NOTICE file - * distributed with this work for additional information - * regarding copyright ownership. The ASF licenses this file - * to you 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.apache.tuscany.sca.core.invocation.impl; - -import java.util.HashMap; -import java.util.Map; -import java.util.UUID; -import java.util.concurrent.ExecutionException; -import java.util.concurrent.Future; -import java.util.concurrent.TimeUnit; -import java.util.concurrent.TimeoutException; -import java.util.concurrent.locks.Condition; -import java.util.concurrent.locks.Lock; -import java.util.concurrent.locks.ReentrantLock; - -import javax.xml.ws.AsyncHandler; -import javax.xml.ws.Response; - -import org.apache.tuscany.sca.core.invocation.AsyncContext; -import org.apache.tuscany.sca.core.invocation.AsyncFaultWrapper; -import org.apache.tuscany.sca.core.invocation.AsyncResponseHandler; - -/** - * A class which provides an Implementation of a Future and Response for use with the JAXWS defined client - * asynchronous APIs. - * - * This implementation class provides the interfaces for use by the client code, but also provides methods for the - * Tuscany system code to set the result of the asynchronous service invocation, both Regular and Fault responses. - * - * This class is constructed to be fully thread-safe - * - * @param - this is the type of the response message from the invoked service. - */ -public class AsyncInvocationFutureImpl implements Future, Response, AsyncContext, AsyncResponseHandler { - - // Lock for handling the completion of this Future - private final Lock lock = new ReentrantLock(); - private final Condition isDone = lock.newCondition(); - - // The result - private volatile V response = null; - private volatile Throwable fault = null; - - private String uniqueID = UUID.randomUUID().toString(); - - private Class businessInterface = null; - private AsyncHandler callback; - - private Map attributes = new HashMap(); - - protected AsyncInvocationFutureImpl() { - super(); - } // end constructor - - /** - * Public constructor for AsyncInvocationFutureImpl - newInstance is necessary in order to enable the Type variable - * to be set for the class instances - * @param - the type of the response from the asynchronously invoked service - * @param type - the type of the AsyncInvocationFutureImpl expressed as a parameter - * @param classLoader - the classloader used for the business interface to which this Future applies - * @return - an instance of AsyncInvocationFutureImpl - */ - public static AsyncInvocationFutureImpl newInstance( Class type, Class businessInterface ) { - AsyncInvocationFutureImpl future = new AsyncInvocationFutureImpl(); - future.setBusinessInterface( businessInterface ); - return future; - } - - /** - * Cancels the asynchronous process - * - not possible in this version, so always returns false - */ - public boolean cancel(boolean mayInterruptIfRunning) { - return false; - } - - /** - * Gets the response value returned by the asynchronous process - * - waits forever - * @return - the response value of type V - * @throws InterruptedException if the get() method was interrupted while waiting for the async process to finish - * @throws ExecutionException if the async process threw an exception - the exception thrown is nested - */ - public V get() throws InterruptedException, ExecutionException { - try { - V response = get(Long.MAX_VALUE, TimeUnit.SECONDS); - return response; - } catch (TimeoutException t) { - throw new InterruptedException("Timed out waiting for Future to complete"); - } // end try - } // end method get() - - /** - * Gets the response value returned by the asynchronous process - * @return - the response value of type V - * @throws InterruptedException if the get() method was interrupted while waiting for the async process to finish - * @throws ExecutionException if the async process threw an exception - the exception thrown is nested - * @throws TimeoutException if the get() method timed out waiting for the async process to finish - */ - public V get(long timeout, TimeUnit unit) throws InterruptedException, - ExecutionException, TimeoutException { - lock.lock(); - try { - // wait for result to be available - if( notSetYet() ) isDone.await( timeout, unit); - if( response != null ) return response; - if( fault != null ) throw new ExecutionException( fault ); - throw new TimeoutException("get on this Future timed out"); - } finally { - lock.unlock(); - } // end try - - } // end method get(long timeout, TimeUnit unit) - - /** - * Indicates if the asynchronous process has been cancelled - * - not possible in this version so always returns false - */ - public boolean isCancelled() { - return false; - } - - /** - * Indicates if the asynchronous process is completed - * @return - true if the process is completed, false otherwise - */ - public boolean isDone() { - lock.lock(); - try { - return !notSetYet(); - } finally { - lock.unlock(); - } // end try - } // end method isDone - - /** - * Async process completed with a Fault. Must only be invoked once. - * @param e - the Fault to send - * @throws IllegalStateException if either the setResponse method or the setFault method have been called previously - */ - public void setFault( Throwable e ) { - lock.lock(); - try { - if( notSetYet() ) { - fault = e; - isDone.signalAll(); - } else { - throw new IllegalStateException("setResponse() or setFault() has been called previously"); - } // end if - } finally { - lock.unlock(); - } // end try - if (callback != null) { - callback.handleResponse(this); - } - } // end method setFault( Throwable ) - - /** - * Async process completed with a wrapped Fault. Must only be invoked once. - * @param w - the wrapped Fault to send - * @throws IllegalStateException if either the setResponse method or the setFault method have been called previously - */ - public void setWrappedFault(AsyncFaultWrapper w) { - - ClassLoader tccl = Thread.currentThread().getContextClassLoader(); - Throwable e; - try { - // Set the TCCL to the classloader of the business interface - Thread.currentThread().setContextClassLoader(this.getBusinessInterface().getClassLoader()); - e = w.retrieveFault(); - } finally { - Thread.currentThread().setContextClassLoader(tccl); - } // end try - - if( e == null ) throw new IllegalArgumentException("AsyncFaultWrapper did not return an Exception"); - setFault( e ); - - } // end method setFault( AsyncFaultWrapper ) - - /** - * Async process completed with a response message. Must only be invoked once - * @throws IllegalStateException if either the setResponse method or the setFault method have been called previously - * @param res - the response message, which is of type V - */ - public void setResponse(V res) { - - lock.lock(); - try { - if( notSetYet() ) { - response = res; - isDone.signalAll(); - } else { - throw new IllegalStateException("setResponse() or setFault() has been called previously"); - } - } finally { - lock.unlock(); - } // end try - if (callback != null) { - callback.handleResponse(this); - } - - } // end method setResponse - - /** - * Gets the unique ID of this future as a String - */ - public String getUniqueID() { return uniqueID; } - - /** - * Indicates that setting a response value is OK - can only set the response value or fault once - * @return - true if it is OK to set the response, false otherwise - */ - private boolean notSetYet() { - return ( response == null && fault == null ); - } - - /** - * Returns the JAXWS context for the response - * @return - a Map containing the context - */ - public Map getContext() { - // Intentionally returns null - return null; - } - - /** - * Gets the business interface to which this Future relates - * @return the business interface - */ - public Class getBusinessInterface() { - return businessInterface; - } - - /** - * Sets the business interface to which this Future relates - * @param classLoader - the classloader of the business interface - */ - public void setBusinessInterface(Class businessInterface) { - this.businessInterface = businessInterface; - } - - /** - * Sets the callback handler, when the client uses the async callback method - * @param callback - the client's callback object - */ - public void setCallback(AsyncHandler callback) { - this.callback = callback; - } - - /** - * Look up an attribute value by name. - * @param name The name of the attribute - * @return The value of the attribute - */ - public Object getAttribute(String name) { - return attributes.get(name); - } - - /** - * Set the value of an attribute. Allows extensions to associate other data with an async response. - * @param name The name of the attribute - * @param value - */ - public void setAttribute(String name, Object value) { - attributes.put(name, value); - } - -} // end class AsyncInvocationFutureImpl -- cgit v1.2.3