...

1. Ability to pass custom context from caller to service (similar to HTTP request headers).
2. Ability to define custom interceptors for service calls.

Public API

New entities:

• ServiceCallContext -  immutable user parameter map that will be implicitly passed to the service (and interceptor) on every method call.
  

  Code Block
  language java theme RDark title ServiceCallContext.java linenumbers true collapse true
  public interface ServiceCallContext { public String attribute(String name); public byte[] binaryAttribute(String name); }

  
  

• ServiceCallInterceptor  - intercepts service method calls.
  

  Code Block
  language java theme RDark title ServiceCallInterceptor.java linenumbers true collapse true
  public interface ServiceCallInterceptor extends Serializable { public default void onInvoke(ServiceInterceptorContext ctx) throws ServiceInterceptException { // No-op. } public default void onComplete(@Nullable Object res, ServiceInterceptorContext ctx) throws ServiceInterceptException { // No-op. } public default void onError(Throwable err, ServiceInterceptorContext ctx) { // No-op. } }

  
  

• ServiceInterceptorContext -  extended mutable version of caller context (interceptor obtains method call parameters from it and can use it to update the caller context).

  Code Block
  language java theme RDark title ServiceInterceptorContext.java linenumbers true collapse true
  public interface ServiceInterceptorContext extends ServiceCallContext {   public String method(); public @Nullable Object[] arguments(); public void attribute(String name, String val); public void binaryAttribute(String name, byte[] val); }

  
  

• ServiceInterceptException - unchecked exception that is used to highlight the exception that occurred during method interception (not execution).

...