在此篇中我们将简要介绍关于grpc对java客户端的实现。
在开始开发前,我们需要先导入
<dependency>
<groupId>io.grpc</groupId>
<artifactId>grpc-netty</artifactId>
<version>1.11.0</version>
</dependency>
<dependency>
<groupId>io.grpc</groupId>
<artifactId>grpc-protobuf</artifactId>
<version>1.11.0</version>
</dependency>
<dependency>
<groupId>io.grpc</groupId>
<artifactId>grpc-stub</artifactId>
<version>1.11.0</version>
</dependency>
如果是Android除了这几个包外,你可能还需要一个javax.annotation:javax.annotation-api:1.2包,这个大家可以自行百度。
当然你如果想自己编译proto文件,你还需要引用一些插件,具体你可以看:
https://github.com/grpc/grpc-java
完成包的导入后我们就可以正式开始开发了,首先需要导入proto的生成文件。
根据上篇中,大约有3个文件,在这里再说明一次,多文件必须把引用的文件一同编译。否则你将不会生成outerclass那个文件,导致报错。这点一定要注意。
接下来我们就可以编码了,在java端grpc存在3种stub,包括stub,blockingstub,和futurestub。
其中futurestub只支持普通的grpc服务,不支持流的形式。
blockingstub支持普通的和服务端流。
stub支持所有的形式。
先让我们看一下普通形式请求和服务端流形式请求。
int port = 50052;
String urlPath = "192.168.2.223";
Channel channel;
//设置grpc链接
channel = NettyChannelBuilder.forAddress(urlPath, port).negotiationType(NegotiationType.PLAINTEXT).build();
UserServerGrpc.UserServerBlockingStub userServerBlockingStub = UserServerGrpc.newBlockingStub(channel);
UserVo.User user = UserVo.User.newBuilder().setUserId("1").build();
//根据条件获得用户
UserVo.User u = userServerBlockingStub.getUserById(user);
System.out.println(u);
System.out.println("==================================");
//获得用户列表
UserVo.Empty empty = UserVo.Empty.newBuilder().build();
UserVo.UserList userList = userServerBlockingStub.getList(empty);
for(int i=0;i<userList.getUCount();i++){
System.out.println(userList.getUList().get(i).toString());
}
System.out.println("==================================");
//第二种获得列表的方式
Iterator<UserVo.User> userIterator = userServerBlockingStub.getListStream(empty);
while (userIterator.hasNext()){
System.out.println(userIterator.next().toString());
}
这两种比较简单,只需要我们建立一个stub,然后调用对应的方法填入数据即可。
对于客户端流和双向流是一样的,我们首先需要实现一个StreamObserver的接口,在onnext方法中拿到返回数据。在onCompleted中判断是否完成。
final StreamObserver<UserVo.UserList> streamObserver = new StreamObserver<UserVo.UserList>() {
@Override
public void onNext(UserVo.UserList userList) {
//拿到服务端返回值
}
@Override
public void onError(Throwable throwable) {
}
@Override
public void onCompleted() {
//完成
}
};
UserVo.User U1 = UserVo.User.newBuilder().setUserId("3").setUserName("小刘").setAge(10).build();
UserVo.User U2 = UserVo.User.newBuilder().setUserId("4").setUserName("小红").setAge(23).build();
UserVo.UserList userList1 = UserVo.UserList.newBuilder().setU(1,U1).setU(2,U2).build();
UserServerGrpc.UserServerStub userServerBlockingStub1 = UserServerGrpc.newStub(channel);
final StreamObserver<UserVo.User> streamObserver1 = userServerBlockingStub1.setUserStream(streamObserver);
//发送数据
streamObserver1.onNext(U1);
streamObserver1.onNext(U2);
//发送完成
streamObserver1.onCompleted();
到此,grpc的4种形式基本就算是结束,grpc在调用上比较简单,主要是在proto的编译上。如果编译正确基本使用还是比较简单的。
大家也可以去GitHub下载我的练习源码:
https://github.com/aixinaxc/grpcserver (服务端)