1 /* 2 * 3 * Copyright 2019 gRPC authors. 4 * 5 * Licensed under the Apache License, Version 2.0 (the "License"); 6 * you may not use this file except in compliance with the License. 7 * You may obtain a copy of the License at 8 * 9 * http://www.apache.org/licenses/LICENSE-2.0 10 * 11 * Unless required by applicable law or agreed to in writing, software 12 * distributed under the License is distributed on an "AS IS" BASIS, 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 * 17 */ 18 19 // The global interceptor feature is experimental and might be modified or removed at any time. 20 21 #import "GRPCCall.h" 22 23 @protocol GRPCInterceptorFactory; 24 25 /** 26 * The interface for gRPC global interceptor. 27 * 28 * \sa GRPCInterceptor 29 */ 30 @interface GRPCCall2 (Interceptor) 31 32 /** 33 * Register a global interceptor's factory in the current process. Only one interceptor can be 34 * registered in a process. If another one attempts to be registered, an exception will be raised. 35 * 36 * \param[in] interceptorFactory The factory object that generates the global interceptor for each 37 * call. 38 */ 39 + (void)registerGlobalInterceptor:(nonnull id<GRPCInterceptorFactory>)interceptorFactory; 40 41 /** 42 * Get the global interceptor's factory object. 43 */ 44 + (nullable id<GRPCInterceptorFactory>)globalInterceptorFactory; 45 46 @end 47