xref: /aosp_15_r20/external/dagger2/java/dagger/grpc/server/InProcessServerModule.java (revision f585d8a307d0621d6060bd7e80091fdcbf94fe27)
1*f585d8a3SJacky Wang /*
2*f585d8a3SJacky Wang  * Copyright (C) 2016 The Dagger Authors.
3*f585d8a3SJacky Wang  *
4*f585d8a3SJacky Wang  * Licensed under the Apache License, Version 2.0 (the "License");
5*f585d8a3SJacky Wang  * you may not use this file except in compliance with the License.
6*f585d8a3SJacky Wang  * You may obtain a copy of the License at
7*f585d8a3SJacky Wang  *
8*f585d8a3SJacky Wang  * http://www.apache.org/licenses/LICENSE-2.0
9*f585d8a3SJacky Wang  *
10*f585d8a3SJacky Wang  * Unless required by applicable law or agreed to in writing, software
11*f585d8a3SJacky Wang  * distributed under the License is distributed on an "AS IS" BASIS,
12*f585d8a3SJacky Wang  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*f585d8a3SJacky Wang  * See the License for the specific language governing permissions and
14*f585d8a3SJacky Wang  * limitations under the License.
15*f585d8a3SJacky Wang  */
16*f585d8a3SJacky Wang 
17*f585d8a3SJacky Wang package dagger.grpc.server;
18*f585d8a3SJacky Wang 
19*f585d8a3SJacky Wang import static com.google.common.base.Preconditions.checkNotNull;
20*f585d8a3SJacky Wang 
21*f585d8a3SJacky Wang import dagger.Module;
22*f585d8a3SJacky Wang import dagger.Provides;
23*f585d8a3SJacky Wang import io.grpc.Server;
24*f585d8a3SJacky Wang import io.grpc.ServerBuilder;
25*f585d8a3SJacky Wang import io.grpc.inprocess.InProcessServerBuilder;
26*f585d8a3SJacky Wang import javax.inject.Singleton;
27*f585d8a3SJacky Wang 
28*f585d8a3SJacky Wang /**
29*f585d8a3SJacky Wang  * Installing this module into a {@link Singleton @Singleton} component means the component can
30*f585d8a3SJacky Wang  * provide a {@link Server} that serves {@linkplain InProcessServerBuilder in-process} requests.
31*f585d8a3SJacky Wang  */
32*f585d8a3SJacky Wang @Module(includes = ServerModule.class)
33*f585d8a3SJacky Wang public final class InProcessServerModule {
34*f585d8a3SJacky Wang 
35*f585d8a3SJacky Wang   private final String name;
36*f585d8a3SJacky Wang 
InProcessServerModule(String name)37*f585d8a3SJacky Wang   private InProcessServerModule(String name) {
38*f585d8a3SJacky Wang     this.name = checkNotNull(name);
39*f585d8a3SJacky Wang   }
40*f585d8a3SJacky Wang 
41*f585d8a3SJacky Wang   /**
42*f585d8a3SJacky Wang    * Creates a module that provides a server that binds to a given name
43*f585d8a3SJacky Wang    *
44*f585d8a3SJacky Wang    * @param name the identity of the server for clients to connect to
45*f585d8a3SJacky Wang    */
serverNamed(String name)46*f585d8a3SJacky Wang   public static InProcessServerModule serverNamed(String name) {
47*f585d8a3SJacky Wang     return new InProcessServerModule(name);
48*f585d8a3SJacky Wang   }
49*f585d8a3SJacky Wang 
50*f585d8a3SJacky Wang   @Provides
serverBuilder()51*f585d8a3SJacky Wang   ServerBuilder<?> serverBuilder() {
52*f585d8a3SJacky Wang     return InProcessServerBuilder.forName(name);
53*f585d8a3SJacky Wang   }
54*f585d8a3SJacky Wang }
55