/** * Invokes a method in all members and expects responses from members contained in dests (or all * members if dests is null). * * @param dests A list of addresses. If null, we'll wait for responses from all cluster members * @param method_call The method (plus args) to be invoked * @param options A collection of call options, e.g. sync versus async, timeout etc * @param listener A FutureListener which will be registered (if non null) with the future * <em>before</em> the call is invoked * @return NotifyingFuture A future from which the results can be fetched * @throws Exception If the sending of the message threw an exception. Note that <em>no</em> * exception will be thrown if any of the target members threw an exception; such an exception * will be in the Rsp element for the particular member in the RspList */ public <T> NotifyingFuture<RspList<T>> callRemoteMethodsWithFuture( Collection<Address> dests, MethodCall method_call, RequestOptions options, FutureListener<RspList<T>> listener) throws Exception { if (dests != null && dests.isEmpty()) { // don't send if dest list is empty if (log.isTraceEnabled()) log.trace( "destination list of %s() is empty: no need to send message", method_call.getName()); return new NullFuture<>(new RspList()); } if (log.isTraceEnabled()) log.trace("dests=%s, method_call=%s, options=%s", dests, method_call, options); Buffer buf = req_marshaller != null ? req_marshaller.objectToBuffer(method_call) : Util.objectToBuffer(method_call); Message msg = new Message().setBuffer(buf); NotifyingFuture<RspList<T>> retval = super.castMessageWithFuture(dests, msg, options, listener); if (log.isTraceEnabled()) log.trace("responses: %s", retval); return retval; }
/** * Invokes a method in a cluster member and - if blocking - returns the result * * @param dest The target member on which to invoke the method * @param call The call to be invoked, including method are arguments * @param options The options (e.g. blocking, timeout etc) * @param listener A FutureListener which will be registered (if non null) with the future * <em>before</em> the call is invoked * @return A future from which the result can be fetched. If the callee threw an invocation, an * ExecutionException will be thrown on calling Future.get(). * @throws Exception Thrown if the method invocation threw an exception */ public <T> NotifyingFuture<T> callRemoteMethodWithFuture( Address dest, MethodCall call, RequestOptions options, FutureListener<T> listener) throws Exception { if (log.isTraceEnabled()) log.trace("dest=%s, method_call=%s, options=%s", dest, call, options); Buffer buf = req_marshaller != null ? req_marshaller.objectToBuffer(call) : Util.objectToBuffer(call); Message msg = new Message(dest, null, null).setBuffer(buf); return super.sendMessageWithFuture(msg, options, listener); }
/** * Invokes a method in a cluster member and - if blocking - returns the result * * @param dest The target member on which to invoke the method * @param call The call to be invoked, including method are arguments * @param options The options (e.g. blocking, timeout etc) * @return The result * @throws Exception Thrown if the method invocation threw an exception, either at the caller or * the callee */ public <T> T callRemoteMethod(Address dest, MethodCall call, RequestOptions options) throws Exception { if (log.isTraceEnabled()) log.trace("dest=%s, method_call=%s, options=%s", dest, call, options); Buffer buf = req_marshaller != null ? req_marshaller.objectToBuffer(call) : Util.objectToBuffer(call); Message msg = new Message(dest, null, null).setBuffer(buf); T retval = super.sendMessage(msg, options); if (log.isTraceEnabled()) log.trace("retval: %s", retval); return retval; }