connectrpc.com icon indicating copy to clipboard operation
connectrpc.com copied to clipboard

Hello world with Buf examples, starting from Java

Open edmondop opened this issue 2 years ago • 2 comments

At the moment, the documentation contains a non-trivial example for Kotlin, which is a little counterintuitive. I propose the documentation offer "hello world"-style examples that only focus on the specific of setting up Connect in a specific language, leaving more advanced features and use cases in a separate section of the doc.

Also, since Java is still a popular language, and Kotlin is Java compatible, probably it would be great to have a "Getting started with Java" that mentions that the code generated is in Kotlin, and you need a certain setup, but you can use Connect when coding in Java

Reference: https://connectrpc.com/docs/kotlin/getting-started/

edmondop avatar Oct 11 '23 19:10 edmondop

Hey @edmondop! We intended the Swift and Kotlin implementations to be primarily for mobile developers - that's why they're client-only. Eventually, we'd like to have a full Java implementation. (If you're interested, leave a response on https://github.com/orgs/connectrpc/discussions/11.)

All that said, we should provide a simpler example for server-side Java developers to get started with our Kotlin clients. It probably won't happen soon unless you'd like to open a PR 😉, but we'll get to this eventually!

akshayjshah avatar Oct 12 '23 04:10 akshayjshah

I'll open myself a PR soon :) I would have liked to do this sooner but I was too busy:)

edmondop avatar Oct 30 '23 22:10 edmondop