I'm new to gRPC's Java implementation. I've generated the gRPC API for Helm's server-side component, Tiller, in Java. You can see the Javadocs here: https://microbean.github.io/microbean-helm/apidocs/index.html The packages under the hapi.* prefix are generated off of Helm's .proto files (https://github.com/kubernetes/helm/tree/master/_proto).
My question is around some of the collection types and methods that gRPC Java generates. I'll pick an arbitrary example. Here is a Chart: https://microbean.github.io/microbean-helm/apidocs/hapi/chart/ChartOuterClass.Chart.html Here is its builder: https://microbean.github.io/microbean-helm/apidocs/hapi/chart/ChartOuterClass.Chart.Builder.html As you can see, logically a Chart can have "dependencies", which are other Charts (subcharts). Here is a "getter" on the Chart: https://microbean.github.io/microbean-helm/apidocs/hapi/chart/ChartOuterClass.Chart.html#getDependenciesList-- Now, that getter I understand. It returns a List. (Is the list mutable? The documentation doesn't say, nor does the gRPC Java page have anything about the code it generates.) But when I'm building this Chart, I don't understand the various "setters" in the builder. For example, here's one that adds a Chart.Builder as a dependency: https://microbean.github.io/microbean-helm/apidocs/hapi/chart/ChartOuterClass.Chart.Builder.html#addDependencies-hapi.chart.ChartOuterClass.Chart.Builder- If I add a dependency this way, by adding another builder, must I call build() on this sub-builder, or will a build() on the top-level builder cascade down? Then here's one that adds a Chart: https://microbean.github.io/microbean-helm/apidocs/hapi/chart/ChartOuterClass.Chart.Builder.html#addDependencies-hapi.chart.ChartOuterClass.Chart- Is that a better way to do it? If so, then why the addDependencies() method that takes a Chart.Builder? Then there's a method called addAllDependencies(): https://microbean.github.io/microbean-helm/apidocs/hapi/chart/ChartOuterClass.Chart.Builder.html#addAllDependencies-java.lang.Iterable- I've noticed that if I call this a couple times, the toString() representation, at any rate, of the top-level Chart seems to contain a JSON-like structure for each time I've called the method. Is it intended that this method should only be called once? Finally, there are various getters that seem to indicate that perhaps all these things are unrelated. For example, I see https://microbean.github.io/microbean-helm/apidocs/hapi/chart/ChartOuterClass.Chart.Builder.html#getDependenciesBuilderList--, which would seem to imply that subcharts added as builders are distinct from subcharts added as true Chart instances. Thanks for any pointers. Best, Laird -- You received this message because you are subscribed to the Google Groups "grpc.io" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/grpc-io. To view this discussion on the web visit https://groups.google.com/d/msgid/grpc-io/f3a91a1c-dd42-4625-9a5b-71dedaf92d00%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
