grpc
/
grpc.io
mirror of https://github.com/grpc/grpc.io.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Java: Update basics.md - Format file extensions in code font (#1161)

This commit is contained in:
Seetarama Raju 2023-07-12 20:33:34 +05:30 committed by GitHub
parent 9fca0325a9
commit 0597f48700
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
content/en/docs/languages/java/basics.md
View File

@ -9,7 +9,7 @@ working with gRPC.
By walking through this example you'll learn how to:
- Define a service in a .proto file.
- Define a service in a `.proto` file.
- Generate server and client code using the protocol buffer compiler.
- Use the Java gRPC API to write a simple client and server for your service.
@ -50,24 +50,24 @@ Our first step (as you'll know from the [Introduction to gRPC](/docs/what-is-grp
define the gRPC *service* and the method *request* and *response* types using
[protocol
buffers](https://protobuf.dev/overview). You can
see the complete .proto file in
see the complete `.proto` file in
[grpc-java/examples/src/main/proto/route_guide.proto](https://github.com/grpc/grpc-java/blob/master/examples/src/main/proto/route_guide.proto).
As we're generating Java code in this example, we've specified a `java_package`
file option in our .proto:
file option in our `.proto`:
```proto
option java_package = "io.grpc.examples.routeguide";
```
This specifies the package we want to use for our generated Java classes. If no
explicit `java_package` option is given in the .proto file, then by default the
explicit `java_package` option is given in the `.proto` file, then by default the
proto package (specified using the "package" keyword) will be used. However,
proto packages generally do not make good Java packages since proto packages are
not expected to start with reverse domain names. If we generate code in another
language from this .proto, the `java_package` option has no effect.
language from this `.proto`, the `java_package` option has no effect.
To define a service, we specify a named `service` in the .proto file:
To define a service, we specify a named `service` in the `.proto` file:
```proto
service RouteGuide {
@ -145,7 +145,7 @@ message Point {
### Generating client and server code
Next we need to generate the gRPC client and server interfaces from our .proto
Next we need to generate the gRPC client and server interfaces from our `.proto`
service definition. We do this using the protocol buffer compiler `protoc` with
a special gRPC Java plugin. You need to use the
[proto3](https://github.com/google/protobuf/releases) compiler (which supports
@ -457,7 +457,7 @@ We use a `ManagedChannelBuilder` to create the channel.
Now we can use the channel to create our stubs using the `newStub` and
`newBlockingStub` methods provided in the `RouteGuideGrpc` class we generated
from our .proto.
from our `.proto`.
```java
blockingStub = RouteGuideGrpc.newBlockingStub(channel);