rpc.turbo.remote.RemoteInterface Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of turbo-rpc Show documentation

turbo rpc

The newest version!

package rpc.turbo.remote;

import java.util.concurrent.CompletableFuture;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

import rpc.turbo.invoke.Invoker;
import rpc.turbo.param.MethodParam;
import rpc.turbo.transport.client.App;

/**
 * 提供远程调用的模板方法，仅供内部使用
 * 
 * @author Hank
 *
 */
public interface RemoteInterface {
	static final Log logger = LogFactory.getLog(RemoteInterface.class);
	static final RemoteException IGNORED = new RemoteException("this method is ignored", false);

	public App getApp();

	/**
	 * 
	 * @param methodId
	 * @param timeout
	 *            超时时间，millseconds
	 * @param methodParam
	 * @param failoverInvoker
	 * @return
	 */
	default public CompletableFuture $remote_execute(int methodId, long timeout, MethodParam methodParam,
			Invoker> failoverInvoker) {
		try {
			return getApp().execute(methodId, timeout, methodParam, failoverInvoker);
		} catch (Exception e) {
			if (logger.isWarnEnabled()) {
				logger.warn("远程调用发生错误");
			}

			if (failoverInvoker == null) {
				return CompletableFuture.failedFuture(e);
			} else {
				if (logger.isInfoEnabled()) {
					logger.info("远程调用发生错误，使用本地回退方法执行");
				}

				return failoverInvoker.invoke(methodParam);
			}
		}
	}

	default public CompletableFuture $remote_ignore() {
		return CompletableFuture.failedFuture(IGNORED);
	}
}