You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@apisix.apache.org by 孙昊 <su...@gmail.com> on 2021/09/25 10:27:06 UTC
[DISCUSS] Java or other language SDK for APISIX's admin URL.
Hello, everyone:
Our company now uses apisix as our api gateway, and our main
development languages are Java and JavaScript.
In the process of using apisix, we often use the admin api of apisix.
We need to create and initiate requests repeatedly, which is very
cumbersome, and sometimes, the parameter names, parameter types, etc. are
mistaken. So, I suggest that the apisix team can release an SDK toolkit for
Java, Types can be defined inside, because Java is strongly typed.
Good luck to everyone!
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Ayush das <ay...@gmail.com>.
Hello ,
Previously one more guy in our slack channel was requesting for this
feature. So i guess it could be the next potential project under apisix.
Best regards
Ayush Das<https://github.com/iamayushdas>
On Sat, 25 Sep 2021 at 4:07 PM, Zhiyuan Ju <ju...@apache.org> wrote:
> Good suggestion! Does anyone else also like this kind of SDK? If so, would
> you like to take this project?
>
> BTW, may I know the details information about “mustake” you mean?
>
> 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
>
> > Hello, everyone:
> > Our company now uses apisix as our api gateway, and our main
> > development languages are Java and JavaScript.
> > In the process of using apisix, we often use the admin api of apisix.
> > We need to create and initiate requests repeatedly, which is very
> > cumbersome, and sometimes, the parameter names, parameter types, etc. are
> > mistaken. So, I suggest that the apisix team can release an SDK toolkit
> for
> > Java, Types can be defined inside, because Java is strongly typed.
> > Good luck to everyone!
> >
> --
> 来自 琚致远
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Zeping Bai <bz...@apache.org>.
It generates code.
The Java project will generate a gradle project, which can easily generate
a jar through the `build` instruction.
The golang project will generate complete code and documents, which can be
easily reused by hosting in Git repo.
ZhengSong Tu <tz...@gmail.com> 于2021年9月26日周日 上午11:07写道：
> if the SDK is generated by `openapi generator`, what is its form? code or
> jar?
>
> I think even if it was code, then as an SDK there would still be things
> like reading admin-keys, hosts etc from the config file that would still
> need to be written.
> *ZhengSong Tu*
> My GitHub: https://github.com/tzssangglass
> Apache APISIX: https://github.com/apache/apisix
>
>
> Zeping Bai <bz...@apache.org> 于2021年9月26日周日 上午9:51写道：
>
> > You may have misunderstood what I said about OpenAPI. In fact, we can
> > directly generate a multilingual SDK through a definition file conforming
> > to the OpenAPI specification and use the `openapi generator`[1] tool.
> > Therefore, OpenAPI will be used as the cornerstone.
> >
> > [1] https://openapi-generator.tech/docs/generators
> >
> > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
> >
> > > I mean: We must not only have the SDK, but also ensure the consistency
> > and
> > > correctness of the SDK and OpenAPI, and the most important thing is
> > > versatility.
> > >
> > > Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
> > >
> > > > > I think we should not only own the java sdk
> > > >
> > > > What does `should not` mean actually?
> > > >
> > > > Sheng Wu 吴晟
> > > > Twitter, wusheng1108
> > > >
> > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > > > >
> > > > > Hi:
> > > > > I think we should not only own the java sdk, we must also
> > > standardize
> > > > > it. In the future, we may also provide java sdk for spring and the
> > > > starter
> > > > > of spring boot, because more and more people are using the
> framework
> > > > around
> > > > > spring. Of course, SDKs in other languages cannot be forgotten,
> such
> > as
> > > > > JavaScript, Python, Go, etc.
> > > > >
> > > > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > > > >
> > > > > > Hi,
> > > > > > I very much agree to provide the Admin API SDK, but I see
> that
> > > you
> > > > > > only mentioned the Java language. In fact, I think if we can
> > provide
> > > an
> > > > > > OpenAPI (Swagger) [1] specification file, we can generate normal
> > API
> > > > > > documents and multi language SDKs with the help of OpenAPI
> > generator
> > > > > > tool [2].
> > > > > >
> > > > > > What do you think?
> > > > > >
> > > > > > [1] OpenAPI Specification <
> https://swagger.io/resources/open-api/>
> > > > > > [2] OpenAPITools/openapi-generator
> > > > > > <https://github.com/OpenAPITools/openapi-generator>
> > > > > >
> > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > > > >
> > > > > > > Hi:
> > > > > > > If your team thinks my suggestion is reasonable, I am very
> > > happy
> > > > to
> > > > > > > assist you in this matter. I have used Java as the main
> > development
> > > > > > > language for 10 years.
> > > > > > > About the "mustake":
> > > > > > > 1. When I want to use an API, I have to go to the official
> > > > website of
> > > > > > > apisix to find documentation. If we have a perfect javadoc, we
> > can
> > > > solve
> > > > > > > this problem greatly.
> > > > > > > 2. It may be due to carelessness, wrong parameter names and
> > > wrong
> > > > > > > types. This will cause a lot of trouble. But Java is strongly
> > > typed,
> > > > and
> > > > > > > this type of problem can be avoided.
> > > > > > >
> > > > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > > > > > >
> > > > > > > > Good suggestion! Does anyone else also like this kind of SDK?
> > If
> > > > so,
> > > > > > > would
> > > > > > > > you like to take this project?
> > > > > > > >
> > > > > > > > BTW, may I know the details information about “mustake” you
> > mean?
> > > > > > > >
> > > > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > > > >
> > > > > > > > > Hello, everyone:
> > > > > > > > > Our company now uses apisix as our api gateway, and our
> > > main
> > > > > > > > > development languages are Java and JavaScript.
> > > > > > > > > In the process of using apisix, we often use the admin
> > api
> > > of
> > > > > > > apisix.
> > > > > > > > > We need to create and initiate requests repeatedly, which
> is
> > > very
> > > > > > > > > cumbersome, and sometimes, the parameter names, parameter
> > > types,
> > > > etc.
> > > > > > > are
> > > > > > > > > mistaken. So, I suggest that the apisix team can release an
> > SDK
> > > > > > toolkit
> > > > > > > > for
> > > > > > > > > Java, Types can be defined inside, because Java is strongly
> > > > typed.
> > > > > > > > > Good luck to everyone!
> > > > > > > > >
> > > > > > > > --
> > > > > > > > 来自 琚致远
> > > > > > > >
> > > > > > >
> > > > > >
> > > >
> > >
> >
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by ZhengSong Tu <tz...@gmail.com>.
I don't know what the generated code looks like, I'll do some verification
when I have time.
Maybe we can use the generated code as basic, and write more functional
code manually.
*ZhengSong Tu*
My GitHub: https://github.com/tzssangglass
Apache APISIX: https://github.com/apache/apisix
Sheng Wu <wu...@gmail.com> 于2021年9月26日周日 上午11:39写道：
> Don't be too optimistic about the generator.
> All from my understanding, those generated codes are making you easier
> to write a SDK, rather than not writing a SDK.
>
> Sheng Wu 吴晟
> Twitter, wusheng1108
>
> Chao Zhang <zc...@gmail.com> 于2021年9月26日周日 上午11:29写道：
> >
> > I prefer to generate only the types with the protobuf or the OpenAPI.
> >
> > Best regards
> > Chao Zhang
> >
> > https://github.com/tokers
> >
> > On Sun, Sep 26, 2021 at 11:24 AM 孙昊 <su...@gmail.com> wrote:
> > >
> > > No code generator can be perfect. You always need to modify something,
> so
> > > it's better not to use it. Machines cannot do better than humans, we
> can
> > > optimize the code, improve performance and so on. Therefore, I think
> that
> > > an official SDK cannot be generated by a code generator. This is a
> serious
> > > problem.
> > >
> > > Zeping Bai <bz...@apache.org>于2021年9月26日 周日上午11:21写道：
> > >
> > > > Yes, it seems that it supports protobuf generation[1]
> experimentally. But
> > > > I'm not sure if it can meet our needs.
> > > >
> > > > [1] https://openapi-generator.tech/docs/generators/protobuf-schema
> > > >
> > > > Chao Zhang <to...@apache.org> 于2021年9月26日周日 上午11:12写道：
> > > >
> > > > > Can the OpenAPI help to generate protocol buffer types? Sometimes
> we
> > > > > may rely on it so that data can be transmitted with the gRPC
> protocol.
> > > > > Best regards
> > > > > Chao Zhang
> > > > >
> > > > > https://github.com/tokers
> > > > >
> > > > > On Sun, Sep 26, 2021 at 11:07 AM ZhengSong Tu <
> tzssangglass@gmail.com>
> > > > > wrote:
> > > > > >
> > > > > > if the SDK is generated by `openapi generator`, what is its
> form? code
> > > > or
> > > > > > jar?
> > > > > >
> > > > > > I think even if it was code, then as an SDK there would still be
> things
> > > > > > like reading admin-keys, hosts etc from the config file that
> would
> > > > still
> > > > > > need to be written.
> > > > > > *ZhengSong Tu*
> > > > > > My GitHub: https://github.com/tzssangglass
> > > > > > Apache APISIX: https://github.com/apache/apisix
> > > > > >
> > > > > >
> > > > > > Zeping Bai <bz...@apache.org> 于2021年9月26日周日 上午9:51写道：
> > > > > >
> > > > > > > You may have misunderstood what I said about OpenAPI. In fact,
> we can
> > > > > > > directly generate a multilingual SDK through a definition file
> > > > > conforming
> > > > > > > to the OpenAPI specification and use the `openapi
> generator`[1] tool.
> > > > > > > Therefore, OpenAPI will be used as the cornerstone.
> > > > > > >
> > > > > > > [1] https://openapi-generator.tech/docs/generators
> > > > > > >
> > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
> > > > > > >
> > > > > > > > I mean: We must not only have the SDK, but also ensure the
> > > > > consistency
> > > > > > > and
> > > > > > > > correctness of the SDK and OpenAPI, and the most important
> thing is
> > > > > > > > versatility.
> > > > > > > >
> > > > > > > > Sheng Wu <wu...@gmail.com> 于2021年9月25日周六
> 下午11:05写道：
> > > > > > > >
> > > > > > > > > > I think we should not only own the java sdk
> > > > > > > > >
> > > > > > > > > What does `should not` mean actually?
> > > > > > > > >
> > > > > > > > > Sheng Wu 吴晟
> > > > > > > > > Twitter, wusheng1108
> > > > > > > > >
> > > > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > > > > > > > > >
> > > > > > > > > > Hi:
> > > > > > > > > > I think we should not only own the java sdk, we must
> also
> > > > > > > > standardize
> > > > > > > > > > it. In the future, we may also provide java sdk for
> spring and
> > > > > the
> > > > > > > > > starter
> > > > > > > > > > of spring boot, because more and more people are using
> the
> > > > > framework
> > > > > > > > > around
> > > > > > > > > > spring. Of course, SDKs in other languages cannot be
> forgotten,
> > > > > such
> > > > > > > as
> > > > > > > > > > JavaScript, Python, Go, etc.
> > > > > > > > > >
> > > > > > > > > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > > > > > > > > >
> > > > > > > > > > > Hi,
> > > > > > > > > > > I very much agree to provide the Admin API SDK,
> but I see
> > > > > that
> > > > > > > > you
> > > > > > > > > > > only mentioned the Java language. In fact, I think if
> we can
> > > > > > > provide
> > > > > > > > an
> > > > > > > > > > > OpenAPI (Swagger) [1] specification file, we can
> generate
> > > > > normal
> > > > > > > API
> > > > > > > > > > > documents and multi language SDKs with the help of
> OpenAPI
> > > > > > > generator
> > > > > > > > > > > tool [2].
> > > > > > > > > > >
> > > > > > > > > > > What do you think?
> > > > > > > > > > >
> > > > > > > > > > > [1] OpenAPI Specification <
> > > > > https://swagger.io/resources/open-api/>
> > > > > > > > > > > [2] OpenAPITools/openapi-generator
> > > > > > > > > > > <https://github.com/OpenAPITools/openapi-generator>
> > > > > > > > > > >
> > > > > > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > > > > > > > > >
> > > > > > > > > > > > Hi:
> > > > > > > > > > > > If your team thinks my suggestion is reasonable,
> I am
> > > > > very
> > > > > > > > happy
> > > > > > > > > to
> > > > > > > > > > > > assist you in this matter. I have used Java as the
> main
> > > > > > > development
> > > > > > > > > > > > language for 10 years.
> > > > > > > > > > > > About the "mustake":
> > > > > > > > > > > > 1. When I want to use an API, I have to go to the
> > > > > official
> > > > > > > > > website of
> > > > > > > > > > > > apisix to find documentation. If we have a perfect
> javadoc,
> > > > > we
> > > > > > > can
> > > > > > > > > solve
> > > > > > > > > > > > this problem greatly.
> > > > > > > > > > > > 2. It may be due to carelessness, wrong
> parameter names
> > > > > and
> > > > > > > > wrong
> > > > > > > > > > > > types. This will cause a lot of trouble. But Java is
> > > > strongly
> > > > > > > > typed,
> > > > > > > > > and
> > > > > > > > > > > > this type of problem can be avoided.
> > > > > > > > > > > >
> > > > > > > > > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六
> 下午6:37写道：
> > > > > > > > > > > >
> > > > > > > > > > > > > Good suggestion! Does anyone else also like this
> kind of
> > > > > SDK?
> > > > > > > If
> > > > > > > > > so,
> > > > > > > > > > > > would
> > > > > > > > > > > > > you like to take this project?
> > > > > > > > > > > > >
> > > > > > > > > > > > > BTW, may I know the details information about
> “mustake”
> > > > you
> > > > > > > mean?
> > > > > > > > > > > > >
> > > > > > > > > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > > > > > > > > >
> > > > > > > > > > > > > > Hello, everyone:
> > > > > > > > > > > > > > Our company now uses apisix as our api
> gateway, and
> > > > > our
> > > > > > > > main
> > > > > > > > > > > > > > development languages are Java and JavaScript.
> > > > > > > > > > > > > > In the process of using apisix, we often use
> the
> > > > > admin
> > > > > > > api
> > > > > > > > of
> > > > > > > > > > > > apisix.
> > > > > > > > > > > > > > We need to create and initiate requests
> repeatedly,
> > > > > which is
> > > > > > > > very
> > > > > > > > > > > > > > cumbersome, and sometimes, the parameter names,
> > > > parameter
> > > > > > > > types,
> > > > > > > > > etc.
> > > > > > > > > > > > are
> > > > > > > > > > > > > > mistaken. So, I suggest that the apisix team can
> > > > release
> > > > > an
> > > > > > > SDK
> > > > > > > > > > > toolkit
> > > > > > > > > > > > > for
> > > > > > > > > > > > > > Java, Types can be defined inside, because Java
> is
> > > > > strongly
> > > > > > > > > typed.
> > > > > > > > > > > > > > Good luck to everyone!
> > > > > > > > > > > > > >
> > > > > > > > > > > > > --
> > > > > > > > > > > > > 来自 琚致远
> > > > > > > > > > > > >
> > > > > > > > > > > >
> > > > > > > > > > >
> > > > > > > > >
> > > > > > > >
> > > > > > >
> > > > >
> > > >
> > > --
> > > 发自移动版 Gmail
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Sheng Wu <wu...@gmail.com>.
Don't be too optimistic about the generator.
All from my understanding, those generated codes are making you easier
to write a SDK, rather than not writing a SDK.
Sheng Wu 吴晟
Twitter, wusheng1108
Chao Zhang <zc...@gmail.com> 于2021年9月26日周日 上午11:29写道：
>
> I prefer to generate only the types with the protobuf or the OpenAPI.
>
> Best regards
> Chao Zhang
>
> https://github.com/tokers
>
> On Sun, Sep 26, 2021 at 11:24 AM 孙昊 <su...@gmail.com> wrote:
> >
> > No code generator can be perfect. You always need to modify something, so
> > it's better not to use it. Machines cannot do better than humans, we can
> > optimize the code, improve performance and so on. Therefore, I think that
> > an official SDK cannot be generated by a code generator. This is a serious
> > problem.
> >
> > Zeping Bai <bz...@apache.org>于2021年9月26日 周日上午11:21写道：
> >
> > > Yes, it seems that it supports protobuf generation[1] experimentally. But
> > > I'm not sure if it can meet our needs.
> > >
> > > [1] https://openapi-generator.tech/docs/generators/protobuf-schema
> > >
> > > Chao Zhang <to...@apache.org> 于2021年9月26日周日 上午11:12写道：
> > >
> > > > Can the OpenAPI help to generate protocol buffer types? Sometimes we
> > > > may rely on it so that data can be transmitted with the gRPC protocol.
> > > > Best regards
> > > > Chao Zhang
> > > >
> > > > https://github.com/tokers
> > > >
> > > > On Sun, Sep 26, 2021 at 11:07 AM ZhengSong Tu <tz...@gmail.com>
> > > > wrote:
> > > > >
> > > > > if the SDK is generated by `openapi generator`, what is its form? code
> > > or
> > > > > jar?
> > > > >
> > > > > I think even if it was code, then as an SDK there would still be things
> > > > > like reading admin-keys, hosts etc from the config file that would
> > > still
> > > > > need to be written.
> > > > > *ZhengSong Tu*
> > > > > My GitHub: https://github.com/tzssangglass
> > > > > Apache APISIX: https://github.com/apache/apisix
> > > > >
> > > > >
> > > > > Zeping Bai <bz...@apache.org> 于2021年9月26日周日 上午9:51写道：
> > > > >
> > > > > > You may have misunderstood what I said about OpenAPI. In fact, we can
> > > > > > directly generate a multilingual SDK through a definition file
> > > > conforming
> > > > > > to the OpenAPI specification and use the `openapi generator`[1] tool.
> > > > > > Therefore, OpenAPI will be used as the cornerstone.
> > > > > >
> > > > > > [1] https://openapi-generator.tech/docs/generators
> > > > > >
> > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
> > > > > >
> > > > > > > I mean: We must not only have the SDK, but also ensure the
> > > > consistency
> > > > > > and
> > > > > > > correctness of the SDK and OpenAPI, and the most important thing is
> > > > > > > versatility.
> > > > > > >
> > > > > > > Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
> > > > > > >
> > > > > > > > > I think we should not only own the java sdk
> > > > > > > >
> > > > > > > > What does `should not` mean actually?
> > > > > > > >
> > > > > > > > Sheng Wu 吴晟
> > > > > > > > Twitter, wusheng1108
> > > > > > > >
> > > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > > > > > > > >
> > > > > > > > > Hi:
> > > > > > > > > I think we should not only own the java sdk, we must also
> > > > > > > standardize
> > > > > > > > > it. In the future, we may also provide java sdk for spring and
> > > > the
> > > > > > > > starter
> > > > > > > > > of spring boot, because more and more people are using the
> > > > framework
> > > > > > > > around
> > > > > > > > > spring. Of course, SDKs in other languages cannot be forgotten,
> > > > such
> > > > > > as
> > > > > > > > > JavaScript, Python, Go, etc.
> > > > > > > > >
> > > > > > > > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > > > > > > > >
> > > > > > > > > > Hi,
> > > > > > > > > > I very much agree to provide the Admin API SDK, but I see
> > > > that
> > > > > > > you
> > > > > > > > > > only mentioned the Java language. In fact, I think if we can
> > > > > > provide
> > > > > > > an
> > > > > > > > > > OpenAPI (Swagger) [1] specification file, we can generate
> > > > normal
> > > > > > API
> > > > > > > > > > documents and multi language SDKs with the help of OpenAPI
> > > > > > generator
> > > > > > > > > > tool [2].
> > > > > > > > > >
> > > > > > > > > > What do you think?
> > > > > > > > > >
> > > > > > > > > > [1] OpenAPI Specification <
> > > > https://swagger.io/resources/open-api/>
> > > > > > > > > > [2] OpenAPITools/openapi-generator
> > > > > > > > > > <https://github.com/OpenAPITools/openapi-generator>
> > > > > > > > > >
> > > > > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > > > > > > > >
> > > > > > > > > > > Hi:
> > > > > > > > > > > If your team thinks my suggestion is reasonable, I am
> > > > very
> > > > > > > happy
> > > > > > > > to
> > > > > > > > > > > assist you in this matter. I have used Java as the main
> > > > > > development
> > > > > > > > > > > language for 10 years.
> > > > > > > > > > > About the "mustake":
> > > > > > > > > > > 1. When I want to use an API, I have to go to the
> > > > official
> > > > > > > > website of
> > > > > > > > > > > apisix to find documentation. If we have a perfect javadoc,
> > > > we
> > > > > > can
> > > > > > > > solve
> > > > > > > > > > > this problem greatly.
> > > > > > > > > > > 2. It may be due to carelessness, wrong parameter names
> > > > and
> > > > > > > wrong
> > > > > > > > > > > types. This will cause a lot of trouble. But Java is
> > > strongly
> > > > > > > typed,
> > > > > > > > and
> > > > > > > > > > > this type of problem can be avoided.
> > > > > > > > > > >
> > > > > > > > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > > > > > > > > > >
> > > > > > > > > > > > Good suggestion! Does anyone else also like this kind of
> > > > SDK?
> > > > > > If
> > > > > > > > so,
> > > > > > > > > > > would
> > > > > > > > > > > > you like to take this project?
> > > > > > > > > > > >
> > > > > > > > > > > > BTW, may I know the details information about “mustake”
> > > you
> > > > > > mean?
> > > > > > > > > > > >
> > > > > > > > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > > > > > > > >
> > > > > > > > > > > > > Hello, everyone:
> > > > > > > > > > > > > Our company now uses apisix as our api gateway, and
> > > > our
> > > > > > > main
> > > > > > > > > > > > > development languages are Java and JavaScript.
> > > > > > > > > > > > > In the process of using apisix, we often use the
> > > > admin
> > > > > > api
> > > > > > > of
> > > > > > > > > > > apisix.
> > > > > > > > > > > > > We need to create and initiate requests repeatedly,
> > > > which is
> > > > > > > very
> > > > > > > > > > > > > cumbersome, and sometimes, the parameter names,
> > > parameter
> > > > > > > types,
> > > > > > > > etc.
> > > > > > > > > > > are
> > > > > > > > > > > > > mistaken. So, I suggest that the apisix team can
> > > release
> > > > an
> > > > > > SDK
> > > > > > > > > > toolkit
> > > > > > > > > > > > for
> > > > > > > > > > > > > Java, Types can be defined inside, because Java is
> > > > strongly
> > > > > > > > typed.
> > > > > > > > > > > > > Good luck to everyone!
> > > > > > > > > > > > >
> > > > > > > > > > > > --
> > > > > > > > > > > > 来自 琚致远
> > > > > > > > > > > >
> > > > > > > > > > >
> > > > > > > > > >
> > > > > > > >
> > > > > > >
> > > > > >
> > > >
> > >
> > --
> > 发自移动版 Gmail
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Chao Zhang <zc...@gmail.com>.
I prefer to generate only the types with the protobuf or the OpenAPI.
Best regards
Chao Zhang
https://github.com/tokers
On Sun, Sep 26, 2021 at 11:24 AM 孙昊 <su...@gmail.com> wrote:
>
> No code generator can be perfect. You always need to modify something, so
> it's better not to use it. Machines cannot do better than humans, we can
> optimize the code, improve performance and so on. Therefore, I think that
> an official SDK cannot be generated by a code generator. This is a serious
> problem.
>
> Zeping Bai <bz...@apache.org>于2021年9月26日 周日上午11:21写道：
>
> > Yes, it seems that it supports protobuf generation[1] experimentally. But
> > I'm not sure if it can meet our needs.
> >
> > [1] https://openapi-generator.tech/docs/generators/protobuf-schema
> >
> > Chao Zhang <to...@apache.org> 于2021年9月26日周日 上午11:12写道：
> >
> > > Can the OpenAPI help to generate protocol buffer types? Sometimes we
> > > may rely on it so that data can be transmitted with the gRPC protocol.
> > > Best regards
> > > Chao Zhang
> > >
> > > https://github.com/tokers
> > >
> > > On Sun, Sep 26, 2021 at 11:07 AM ZhengSong Tu <tz...@gmail.com>
> > > wrote:
> > > >
> > > > if the SDK is generated by `openapi generator`, what is its form? code
> > or
> > > > jar?
> > > >
> > > > I think even if it was code, then as an SDK there would still be things
> > > > like reading admin-keys, hosts etc from the config file that would
> > still
> > > > need to be written.
> > > > *ZhengSong Tu*
> > > > My GitHub: https://github.com/tzssangglass
> > > > Apache APISIX: https://github.com/apache/apisix
> > > >
> > > >
> > > > Zeping Bai <bz...@apache.org> 于2021年9月26日周日 上午9:51写道：
> > > >
> > > > > You may have misunderstood what I said about OpenAPI. In fact, we can
> > > > > directly generate a multilingual SDK through a definition file
> > > conforming
> > > > > to the OpenAPI specification and use the `openapi generator`[1] tool.
> > > > > Therefore, OpenAPI will be used as the cornerstone.
> > > > >
> > > > > [1] https://openapi-generator.tech/docs/generators
> > > > >
> > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
> > > > >
> > > > > > I mean: We must not only have the SDK, but also ensure the
> > > consistency
> > > > > and
> > > > > > correctness of the SDK and OpenAPI, and the most important thing is
> > > > > > versatility.
> > > > > >
> > > > > > Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
> > > > > >
> > > > > > > > I think we should not only own the java sdk
> > > > > > >
> > > > > > > What does `should not` mean actually?
> > > > > > >
> > > > > > > Sheng Wu 吴晟
> > > > > > > Twitter, wusheng1108
> > > > > > >
> > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > > > > > > >
> > > > > > > > Hi:
> > > > > > > > I think we should not only own the java sdk, we must also
> > > > > > standardize
> > > > > > > > it. In the future, we may also provide java sdk for spring and
> > > the
> > > > > > > starter
> > > > > > > > of spring boot, because more and more people are using the
> > > framework
> > > > > > > around
> > > > > > > > spring. Of course, SDKs in other languages cannot be forgotten,
> > > such
> > > > > as
> > > > > > > > JavaScript, Python, Go, etc.
> > > > > > > >
> > > > > > > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > > > > > > >
> > > > > > > > > Hi,
> > > > > > > > > I very much agree to provide the Admin API SDK, but I see
> > > that
> > > > > > you
> > > > > > > > > only mentioned the Java language. In fact, I think if we can
> > > > > provide
> > > > > > an
> > > > > > > > > OpenAPI (Swagger) [1] specification file, we can generate
> > > normal
> > > > > API
> > > > > > > > > documents and multi language SDKs with the help of OpenAPI
> > > > > generator
> > > > > > > > > tool [2].
> > > > > > > > >
> > > > > > > > > What do you think?
> > > > > > > > >
> > > > > > > > > [1] OpenAPI Specification <
> > > https://swagger.io/resources/open-api/>
> > > > > > > > > [2] OpenAPITools/openapi-generator
> > > > > > > > > <https://github.com/OpenAPITools/openapi-generator>
> > > > > > > > >
> > > > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > > > > > > >
> > > > > > > > > > Hi:
> > > > > > > > > > If your team thinks my suggestion is reasonable, I am
> > > very
> > > > > > happy
> > > > > > > to
> > > > > > > > > > assist you in this matter. I have used Java as the main
> > > > > development
> > > > > > > > > > language for 10 years.
> > > > > > > > > > About the "mustake":
> > > > > > > > > > 1. When I want to use an API, I have to go to the
> > > official
> > > > > > > website of
> > > > > > > > > > apisix to find documentation. If we have a perfect javadoc,
> > > we
> > > > > can
> > > > > > > solve
> > > > > > > > > > this problem greatly.
> > > > > > > > > > 2. It may be due to carelessness, wrong parameter names
> > > and
> > > > > > wrong
> > > > > > > > > > types. This will cause a lot of trouble. But Java is
> > strongly
> > > > > > typed,
> > > > > > > and
> > > > > > > > > > this type of problem can be avoided.
> > > > > > > > > >
> > > > > > > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > > > > > > > > >
> > > > > > > > > > > Good suggestion! Does anyone else also like this kind of
> > > SDK?
> > > > > If
> > > > > > > so,
> > > > > > > > > > would
> > > > > > > > > > > you like to take this project?
> > > > > > > > > > >
> > > > > > > > > > > BTW, may I know the details information about “mustake”
> > you
> > > > > mean?
> > > > > > > > > > >
> > > > > > > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > > > > > > >
> > > > > > > > > > > > Hello, everyone:
> > > > > > > > > > > > Our company now uses apisix as our api gateway, and
> > > our
> > > > > > main
> > > > > > > > > > > > development languages are Java and JavaScript.
> > > > > > > > > > > > In the process of using apisix, we often use the
> > > admin
> > > > > api
> > > > > > of
> > > > > > > > > > apisix.
> > > > > > > > > > > > We need to create and initiate requests repeatedly,
> > > which is
> > > > > > very
> > > > > > > > > > > > cumbersome, and sometimes, the parameter names,
> > parameter
> > > > > > types,
> > > > > > > etc.
> > > > > > > > > > are
> > > > > > > > > > > > mistaken. So, I suggest that the apisix team can
> > release
> > > an
> > > > > SDK
> > > > > > > > > toolkit
> > > > > > > > > > > for
> > > > > > > > > > > > Java, Types can be defined inside, because Java is
> > > strongly
> > > > > > > typed.
> > > > > > > > > > > > Good luck to everyone!
> > > > > > > > > > > >
> > > > > > > > > > > --
> > > > > > > > > > > 来自 琚致远
> > > > > > > > > > >
> > > > > > > > > >
> > > > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > >
> >
> --
> 发自移动版 Gmail
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Zeping Bai <bz...@gmail.com>.
> No code generator can be perfect.
I agree with it.
-----
However, only in this way can we provide a relatively stable SDK and reduce
the code that needs to be changed when upgrading the version. New versions
of SDK can be released in time.
孙昊 <su...@gmail.com> 于2021年9月26日周日 上午11:24写道：
> No code generator can be perfect. You always need to modify something, so
> it's better not to use it. Machines cannot do better than humans, we can
> optimize the code, improve performance and so on. Therefore, I think that
> an official SDK cannot be generated by a code generator. This is a serious
> problem.
>
> Zeping Bai <bz...@apache.org>于2021年9月26日 周日上午11:21写道：
>
> > Yes, it seems that it supports protobuf generation[1] experimentally. But
> > I'm not sure if it can meet our needs.
> >
> > [1] https://openapi-generator.tech/docs/generators/protobuf-schema
> >
> > Chao Zhang <to...@apache.org> 于2021年9月26日周日 上午11:12写道：
> >
> > > Can the OpenAPI help to generate protocol buffer types? Sometimes we
> > > may rely on it so that data can be transmitted with the gRPC protocol.
> > > Best regards
> > > Chao Zhang
> > >
> > > https://github.com/tokers
> > >
> > > On Sun, Sep 26, 2021 at 11:07 AM ZhengSong Tu <tz...@gmail.com>
> > > wrote:
> > > >
> > > > if the SDK is generated by `openapi generator`, what is its form?
> code
> > or
> > > > jar?
> > > >
> > > > I think even if it was code, then as an SDK there would still be
> things
> > > > like reading admin-keys, hosts etc from the config file that would
> > still
> > > > need to be written.
> > > > *ZhengSong Tu*
> > > > My GitHub: https://github.com/tzssangglass
> > > > Apache APISIX: https://github.com/apache/apisix
> > > >
> > > >
> > > > Zeping Bai <bz...@apache.org> 于2021年9月26日周日 上午9:51写道：
> > > >
> > > > > You may have misunderstood what I said about OpenAPI. In fact, we
> can
> > > > > directly generate a multilingual SDK through a definition file
> > > conforming
> > > > > to the OpenAPI specification and use the `openapi generator`[1]
> tool.
> > > > > Therefore, OpenAPI will be used as the cornerstone.
> > > > >
> > > > > [1] https://openapi-generator.tech/docs/generators
> > > > >
> > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
> > > > >
> > > > > > I mean: We must not only have the SDK, but also ensure the
> > > consistency
> > > > > and
> > > > > > correctness of the SDK and OpenAPI, and the most important thing
> is
> > > > > > versatility.
> > > > > >
> > > > > > Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
> > > > > >
> > > > > > > > I think we should not only own the java sdk
> > > > > > >
> > > > > > > What does `should not` mean actually?
> > > > > > >
> > > > > > > Sheng Wu 吴晟
> > > > > > > Twitter, wusheng1108
> > > > > > >
> > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > > > > > > >
> > > > > > > > Hi:
> > > > > > > > I think we should not only own the java sdk, we must also
> > > > > > standardize
> > > > > > > > it. In the future, we may also provide java sdk for spring
> and
> > > the
> > > > > > > starter
> > > > > > > > of spring boot, because more and more people are using the
> > > framework
> > > > > > > around
> > > > > > > > spring. Of course, SDKs in other languages cannot be
> forgotten,
> > > such
> > > > > as
> > > > > > > > JavaScript, Python, Go, etc.
> > > > > > > >
> > > > > > > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > > > > > > >
> > > > > > > > > Hi,
> > > > > > > > > I very much agree to provide the Admin API SDK, but I
> see
> > > that
> > > > > > you
> > > > > > > > > only mentioned the Java language. In fact, I think if we
> can
> > > > > provide
> > > > > > an
> > > > > > > > > OpenAPI (Swagger) [1] specification file, we can generate
> > > normal
> > > > > API
> > > > > > > > > documents and multi language SDKs with the help of OpenAPI
> > > > > generator
> > > > > > > > > tool [2].
> > > > > > > > >
> > > > > > > > > What do you think?
> > > > > > > > >
> > > > > > > > > [1] OpenAPI Specification <
> > > https://swagger.io/resources/open-api/>
> > > > > > > > > [2] OpenAPITools/openapi-generator
> > > > > > > > > <https://github.com/OpenAPITools/openapi-generator>
> > > > > > > > >
> > > > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > > > > > > >
> > > > > > > > > > Hi:
> > > > > > > > > > If your team thinks my suggestion is reasonable, I am
> > > very
> > > > > > happy
> > > > > > > to
> > > > > > > > > > assist you in this matter. I have used Java as the main
> > > > > development
> > > > > > > > > > language for 10 years.
> > > > > > > > > > About the "mustake":
> > > > > > > > > > 1. When I want to use an API, I have to go to the
> > > official
> > > > > > > website of
> > > > > > > > > > apisix to find documentation. If we have a perfect
> javadoc,
> > > we
> > > > > can
> > > > > > > solve
> > > > > > > > > > this problem greatly.
> > > > > > > > > > 2. It may be due to carelessness, wrong parameter
> names
> > > and
> > > > > > wrong
> > > > > > > > > > types. This will cause a lot of trouble. But Java is
> > strongly
> > > > > > typed,
> > > > > > > and
> > > > > > > > > > this type of problem can be avoided.
> > > > > > > > > >
> > > > > > > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六
> 下午6:37写道：
> > > > > > > > > >
> > > > > > > > > > > Good suggestion! Does anyone else also like this kind
> of
> > > SDK?
> > > > > If
> > > > > > > so,
> > > > > > > > > > would
> > > > > > > > > > > you like to take this project?
> > > > > > > > > > >
> > > > > > > > > > > BTW, may I know the details information about “mustake”
> > you
> > > > > mean?
> > > > > > > > > > >
> > > > > > > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > > > > > > >
> > > > > > > > > > > > Hello, everyone:
> > > > > > > > > > > > Our company now uses apisix as our api gateway,
> and
> > > our
> > > > > > main
> > > > > > > > > > > > development languages are Java and JavaScript.
> > > > > > > > > > > > In the process of using apisix, we often use the
> > > admin
> > > > > api
> > > > > > of
> > > > > > > > > > apisix.
> > > > > > > > > > > > We need to create and initiate requests repeatedly,
> > > which is
> > > > > > very
> > > > > > > > > > > > cumbersome, and sometimes, the parameter names,
> > parameter
> > > > > > types,
> > > > > > > etc.
> > > > > > > > > > are
> > > > > > > > > > > > mistaken. So, I suggest that the apisix team can
> > release
> > > an
> > > > > SDK
> > > > > > > > > toolkit
> > > > > > > > > > > for
> > > > > > > > > > > > Java, Types can be defined inside, because Java is
> > > strongly
> > > > > > > typed.
> > > > > > > > > > > > Good luck to everyone!
> > > > > > > > > > > >
> > > > > > > > > > > --
> > > > > > > > > > > 来自 琚致远
> > > > > > > > > > >
> > > > > > > > > >
> > > > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > >
> >
> --
> 发自移动版 Gmail
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by 孙昊 <su...@gmail.com>.
No code generator can be perfect. You always need to modify something, so
it's better not to use it. Machines cannot do better than humans, we can
optimize the code, improve performance and so on. Therefore, I think that
an official SDK cannot be generated by a code generator. This is a serious
problem.
Zeping Bai <bz...@apache.org>于2021年9月26日 周日上午11:21写道：
> Yes, it seems that it supports protobuf generation[1] experimentally. But
> I'm not sure if it can meet our needs.
>
> [1] https://openapi-generator.tech/docs/generators/protobuf-schema
>
> Chao Zhang <to...@apache.org> 于2021年9月26日周日 上午11:12写道：
>
> > Can the OpenAPI help to generate protocol buffer types? Sometimes we
> > may rely on it so that data can be transmitted with the gRPC protocol.
> > Best regards
> > Chao Zhang
> >
> > https://github.com/tokers
> >
> > On Sun, Sep 26, 2021 at 11:07 AM ZhengSong Tu <tz...@gmail.com>
> > wrote:
> > >
> > > if the SDK is generated by `openapi generator`, what is its form? code
> or
> > > jar?
> > >
> > > I think even if it was code, then as an SDK there would still be things
> > > like reading admin-keys, hosts etc from the config file that would
> still
> > > need to be written.
> > > *ZhengSong Tu*
> > > My GitHub: https://github.com/tzssangglass
> > > Apache APISIX: https://github.com/apache/apisix
> > >
> > >
> > > Zeping Bai <bz...@apache.org> 于2021年9月26日周日 上午9:51写道：
> > >
> > > > You may have misunderstood what I said about OpenAPI. In fact, we can
> > > > directly generate a multilingual SDK through a definition file
> > conforming
> > > > to the OpenAPI specification and use the `openapi generator`[1] tool.
> > > > Therefore, OpenAPI will be used as the cornerstone.
> > > >
> > > > [1] https://openapi-generator.tech/docs/generators
> > > >
> > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
> > > >
> > > > > I mean: We must not only have the SDK, but also ensure the
> > consistency
> > > > and
> > > > > correctness of the SDK and OpenAPI, and the most important thing is
> > > > > versatility.
> > > > >
> > > > > Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
> > > > >
> > > > > > > I think we should not only own the java sdk
> > > > > >
> > > > > > What does `should not` mean actually?
> > > > > >
> > > > > > Sheng Wu 吴晟
> > > > > > Twitter, wusheng1108
> > > > > >
> > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > > > > > >
> > > > > > > Hi:
> > > > > > > I think we should not only own the java sdk, we must also
> > > > > standardize
> > > > > > > it. In the future, we may also provide java sdk for spring and
> > the
> > > > > > starter
> > > > > > > of spring boot, because more and more people are using the
> > framework
> > > > > > around
> > > > > > > spring. Of course, SDKs in other languages cannot be forgotten,
> > such
> > > > as
> > > > > > > JavaScript, Python, Go, etc.
> > > > > > >
> > > > > > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > > > > > >
> > > > > > > > Hi,
> > > > > > > > I very much agree to provide the Admin API SDK, but I see
> > that
> > > > > you
> > > > > > > > only mentioned the Java language. In fact, I think if we can
> > > > provide
> > > > > an
> > > > > > > > OpenAPI (Swagger) [1] specification file, we can generate
> > normal
> > > > API
> > > > > > > > documents and multi language SDKs with the help of OpenAPI
> > > > generator
> > > > > > > > tool [2].
> > > > > > > >
> > > > > > > > What do you think?
> > > > > > > >
> > > > > > > > [1] OpenAPI Specification <
> > https://swagger.io/resources/open-api/>
> > > > > > > > [2] OpenAPITools/openapi-generator
> > > > > > > > <https://github.com/OpenAPITools/openapi-generator>
> > > > > > > >
> > > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > > > > > >
> > > > > > > > > Hi:
> > > > > > > > > If your team thinks my suggestion is reasonable, I am
> > very
> > > > > happy
> > > > > > to
> > > > > > > > > assist you in this matter. I have used Java as the main
> > > > development
> > > > > > > > > language for 10 years.
> > > > > > > > > About the "mustake":
> > > > > > > > > 1. When I want to use an API, I have to go to the
> > official
> > > > > > website of
> > > > > > > > > apisix to find documentation. If we have a perfect javadoc,
> > we
> > > > can
> > > > > > solve
> > > > > > > > > this problem greatly.
> > > > > > > > > 2. It may be due to carelessness, wrong parameter names
> > and
> > > > > wrong
> > > > > > > > > types. This will cause a lot of trouble. But Java is
> strongly
> > > > > typed,
> > > > > > and
> > > > > > > > > this type of problem can be avoided.
> > > > > > > > >
> > > > > > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > > > > > > > >
> > > > > > > > > > Good suggestion! Does anyone else also like this kind of
> > SDK?
> > > > If
> > > > > > so,
> > > > > > > > > would
> > > > > > > > > > you like to take this project?
> > > > > > > > > >
> > > > > > > > > > BTW, may I know the details information about “mustake”
> you
> > > > mean?
> > > > > > > > > >
> > > > > > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > > > > > >
> > > > > > > > > > > Hello, everyone:
> > > > > > > > > > > Our company now uses apisix as our api gateway, and
> > our
> > > > > main
> > > > > > > > > > > development languages are Java and JavaScript.
> > > > > > > > > > > In the process of using apisix, we often use the
> > admin
> > > > api
> > > > > of
> > > > > > > > > apisix.
> > > > > > > > > > > We need to create and initiate requests repeatedly,
> > which is
> > > > > very
> > > > > > > > > > > cumbersome, and sometimes, the parameter names,
> parameter
> > > > > types,
> > > > > > etc.
> > > > > > > > > are
> > > > > > > > > > > mistaken. So, I suggest that the apisix team can
> release
> > an
> > > > SDK
> > > > > > > > toolkit
> > > > > > > > > > for
> > > > > > > > > > > Java, Types can be defined inside, because Java is
> > strongly
> > > > > > typed.
> > > > > > > > > > > Good luck to everyone!
> > > > > > > > > > >
> > > > > > > > > > --
> > > > > > > > > > 来自 琚致远
> > > > > > > > > >
> > > > > > > > >
> > > > > > > >
> > > > > >
> > > > >
> > > >
> >
>
--
发自移动版 Gmail
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Zeping Bai <bz...@apache.org>.
Yes, it seems that it supports protobuf generation[1] experimentally. But
I'm not sure if it can meet our needs.
[1] https://openapi-generator.tech/docs/generators/protobuf-schema
Chao Zhang <to...@apache.org> 于2021年9月26日周日 上午11:12写道：
> Can the OpenAPI help to generate protocol buffer types? Sometimes we
> may rely on it so that data can be transmitted with the gRPC protocol.
> Best regards
> Chao Zhang
>
> https://github.com/tokers
>
> On Sun, Sep 26, 2021 at 11:07 AM ZhengSong Tu <tz...@gmail.com>
> wrote:
> >
> > if the SDK is generated by `openapi generator`, what is its form? code or
> > jar?
> >
> > I think even if it was code, then as an SDK there would still be things
> > like reading admin-keys, hosts etc from the config file that would still
> > need to be written.
> > *ZhengSong Tu*
> > My GitHub: https://github.com/tzssangglass
> > Apache APISIX: https://github.com/apache/apisix
> >
> >
> > Zeping Bai <bz...@apache.org> 于2021年9月26日周日 上午9:51写道：
> >
> > > You may have misunderstood what I said about OpenAPI. In fact, we can
> > > directly generate a multilingual SDK through a definition file
> conforming
> > > to the OpenAPI specification and use the `openapi generator`[1] tool.
> > > Therefore, OpenAPI will be used as the cornerstone.
> > >
> > > [1] https://openapi-generator.tech/docs/generators
> > >
> > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
> > >
> > > > I mean: We must not only have the SDK, but also ensure the
> consistency
> > > and
> > > > correctness of the SDK and OpenAPI, and the most important thing is
> > > > versatility.
> > > >
> > > > Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
> > > >
> > > > > > I think we should not only own the java sdk
> > > > >
> > > > > What does `should not` mean actually?
> > > > >
> > > > > Sheng Wu 吴晟
> > > > > Twitter, wusheng1108
> > > > >
> > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > > > > >
> > > > > > Hi:
> > > > > > I think we should not only own the java sdk, we must also
> > > > standardize
> > > > > > it. In the future, we may also provide java sdk for spring and
> the
> > > > > starter
> > > > > > of spring boot, because more and more people are using the
> framework
> > > > > around
> > > > > > spring. Of course, SDKs in other languages cannot be forgotten,
> such
> > > as
> > > > > > JavaScript, Python, Go, etc.
> > > > > >
> > > > > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > > > > >
> > > > > > > Hi,
> > > > > > > I very much agree to provide the Admin API SDK, but I see
> that
> > > > you
> > > > > > > only mentioned the Java language. In fact, I think if we can
> > > provide
> > > > an
> > > > > > > OpenAPI (Swagger) [1] specification file, we can generate
> normal
> > > API
> > > > > > > documents and multi language SDKs with the help of OpenAPI
> > > generator
> > > > > > > tool [2].
> > > > > > >
> > > > > > > What do you think?
> > > > > > >
> > > > > > > [1] OpenAPI Specification <
> https://swagger.io/resources/open-api/>
> > > > > > > [2] OpenAPITools/openapi-generator
> > > > > > > <https://github.com/OpenAPITools/openapi-generator>
> > > > > > >
> > > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > > > > >
> > > > > > > > Hi:
> > > > > > > > If your team thinks my suggestion is reasonable, I am
> very
> > > > happy
> > > > > to
> > > > > > > > assist you in this matter. I have used Java as the main
> > > development
> > > > > > > > language for 10 years.
> > > > > > > > About the "mustake":
> > > > > > > > 1. When I want to use an API, I have to go to the
> official
> > > > > website of
> > > > > > > > apisix to find documentation. If we have a perfect javadoc,
> we
> > > can
> > > > > solve
> > > > > > > > this problem greatly.
> > > > > > > > 2. It may be due to carelessness, wrong parameter names
> and
> > > > wrong
> > > > > > > > types. This will cause a lot of trouble. But Java is strongly
> > > > typed,
> > > > > and
> > > > > > > > this type of problem can be avoided.
> > > > > > > >
> > > > > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > > > > > > >
> > > > > > > > > Good suggestion! Does anyone else also like this kind of
> SDK?
> > > If
> > > > > so,
> > > > > > > > would
> > > > > > > > > you like to take this project?
> > > > > > > > >
> > > > > > > > > BTW, may I know the details information about “mustake” you
> > > mean?
> > > > > > > > >
> > > > > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > > > > >
> > > > > > > > > > Hello, everyone:
> > > > > > > > > > Our company now uses apisix as our api gateway, and
> our
> > > > main
> > > > > > > > > > development languages are Java and JavaScript.
> > > > > > > > > > In the process of using apisix, we often use the
> admin
> > > api
> > > > of
> > > > > > > > apisix.
> > > > > > > > > > We need to create and initiate requests repeatedly,
> which is
> > > > very
> > > > > > > > > > cumbersome, and sometimes, the parameter names, parameter
> > > > types,
> > > > > etc.
> > > > > > > > are
> > > > > > > > > > mistaken. So, I suggest that the apisix team can release
> an
> > > SDK
> > > > > > > toolkit
> > > > > > > > > for
> > > > > > > > > > Java, Types can be defined inside, because Java is
> strongly
> > > > > typed.
> > > > > > > > > > Good luck to everyone!
> > > > > > > > > >
> > > > > > > > > --
> > > > > > > > > 来自 琚致远
> > > > > > > > >
> > > > > > > >
> > > > > > >
> > > > >
> > > >
> > >
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Chao Zhang <to...@apache.org>.
Can the OpenAPI help to generate protocol buffer types? Sometimes we
may rely on it so that data can be transmitted with the gRPC protocol.
Best regards
Chao Zhang
https://github.com/tokers
On Sun, Sep 26, 2021 at 11:07 AM ZhengSong Tu <tz...@gmail.com> wrote:
>
> if the SDK is generated by `openapi generator`, what is its form? code or
> jar?
>
> I think even if it was code, then as an SDK there would still be things
> like reading admin-keys, hosts etc from the config file that would still
> need to be written.
> *ZhengSong Tu*
> My GitHub: https://github.com/tzssangglass
> Apache APISIX: https://github.com/apache/apisix
>
>
> Zeping Bai <bz...@apache.org> 于2021年9月26日周日 上午9:51写道：
>
> > You may have misunderstood what I said about OpenAPI. In fact, we can
> > directly generate a multilingual SDK through a definition file conforming
> > to the OpenAPI specification and use the `openapi generator`[1] tool.
> > Therefore, OpenAPI will be used as the cornerstone.
> >
> > [1] https://openapi-generator.tech/docs/generators
> >
> > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
> >
> > > I mean: We must not only have the SDK, but also ensure the consistency
> > and
> > > correctness of the SDK and OpenAPI, and the most important thing is
> > > versatility.
> > >
> > > Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
> > >
> > > > > I think we should not only own the java sdk
> > > >
> > > > What does `should not` mean actually?
> > > >
> > > > Sheng Wu 吴晟
> > > > Twitter, wusheng1108
> > > >
> > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > > > >
> > > > > Hi:
> > > > > I think we should not only own the java sdk, we must also
> > > standardize
> > > > > it. In the future, we may also provide java sdk for spring and the
> > > > starter
> > > > > of spring boot, because more and more people are using the framework
> > > > around
> > > > > spring. Of course, SDKs in other languages cannot be forgotten, such
> > as
> > > > > JavaScript, Python, Go, etc.
> > > > >
> > > > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > > > >
> > > > > > Hi,
> > > > > > I very much agree to provide the Admin API SDK, but I see that
> > > you
> > > > > > only mentioned the Java language. In fact, I think if we can
> > provide
> > > an
> > > > > > OpenAPI (Swagger) [1] specification file, we can generate normal
> > API
> > > > > > documents and multi language SDKs with the help of OpenAPI
> > generator
> > > > > > tool [2].
> > > > > >
> > > > > > What do you think?
> > > > > >
> > > > > > [1] OpenAPI Specification <https://swagger.io/resources/open-api/>
> > > > > > [2] OpenAPITools/openapi-generator
> > > > > > <https://github.com/OpenAPITools/openapi-generator>
> > > > > >
> > > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > > > >
> > > > > > > Hi:
> > > > > > > If your team thinks my suggestion is reasonable, I am very
> > > happy
> > > > to
> > > > > > > assist you in this matter. I have used Java as the main
> > development
> > > > > > > language for 10 years.
> > > > > > > About the "mustake":
> > > > > > > 1. When I want to use an API, I have to go to the official
> > > > website of
> > > > > > > apisix to find documentation. If we have a perfect javadoc, we
> > can
> > > > solve
> > > > > > > this problem greatly.
> > > > > > > 2. It may be due to carelessness, wrong parameter names and
> > > wrong
> > > > > > > types. This will cause a lot of trouble. But Java is strongly
> > > typed,
> > > > and
> > > > > > > this type of problem can be avoided.
> > > > > > >
> > > > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > > > > > >
> > > > > > > > Good suggestion! Does anyone else also like this kind of SDK?
> > If
> > > > so,
> > > > > > > would
> > > > > > > > you like to take this project?
> > > > > > > >
> > > > > > > > BTW, may I know the details information about “mustake” you
> > mean?
> > > > > > > >
> > > > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > > > >
> > > > > > > > > Hello, everyone:
> > > > > > > > > Our company now uses apisix as our api gateway, and our
> > > main
> > > > > > > > > development languages are Java and JavaScript.
> > > > > > > > > In the process of using apisix, we often use the admin
> > api
> > > of
> > > > > > > apisix.
> > > > > > > > > We need to create and initiate requests repeatedly, which is
> > > very
> > > > > > > > > cumbersome, and sometimes, the parameter names, parameter
> > > types,
> > > > etc.
> > > > > > > are
> > > > > > > > > mistaken. So, I suggest that the apisix team can release an
> > SDK
> > > > > > toolkit
> > > > > > > > for
> > > > > > > > > Java, Types can be defined inside, because Java is strongly
> > > > typed.
> > > > > > > > > Good luck to everyone!
> > > > > > > > >
> > > > > > > > --
> > > > > > > > 来自 琚致远
> > > > > > > >
> > > > > > >
> > > > > >
> > > >
> > >
> >
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by ZhengSong Tu <tz...@gmail.com>.
if the SDK is generated by `openapi generator`, what is its form? code or
jar?
I think even if it was code, then as an SDK there would still be things
like reading admin-keys, hosts etc from the config file that would still
need to be written.
*ZhengSong Tu*
My GitHub: https://github.com/tzssangglass
Apache APISIX: https://github.com/apache/apisix
Zeping Bai <bz...@apache.org> 于2021年9月26日周日 上午9:51写道：
> You may have misunderstood what I said about OpenAPI. In fact, we can
> directly generate a multilingual SDK through a definition file conforming
> to the OpenAPI specification and use the `openapi generator`[1] tool.
> Therefore, OpenAPI will be used as the cornerstone.
>
> [1] https://openapi-generator.tech/docs/generators
>
> 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
>
> > I mean: We must not only have the SDK, but also ensure the consistency
> and
> > correctness of the SDK and OpenAPI, and the most important thing is
> > versatility.
> >
> > Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
> >
> > > > I think we should not only own the java sdk
> > >
> > > What does `should not` mean actually?
> > >
> > > Sheng Wu 吴晟
> > > Twitter, wusheng1108
> > >
> > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > > >
> > > > Hi:
> > > > I think we should not only own the java sdk, we must also
> > standardize
> > > > it. In the future, we may also provide java sdk for spring and the
> > > starter
> > > > of spring boot, because more and more people are using the framework
> > > around
> > > > spring. Of course, SDKs in other languages cannot be forgotten, such
> as
> > > > JavaScript, Python, Go, etc.
> > > >
> > > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > > >
> > > > > Hi,
> > > > > I very much agree to provide the Admin API SDK, but I see that
> > you
> > > > > only mentioned the Java language. In fact, I think if we can
> provide
> > an
> > > > > OpenAPI (Swagger) [1] specification file, we can generate normal
> API
> > > > > documents and multi language SDKs with the help of OpenAPI
> generator
> > > > > tool [2].
> > > > >
> > > > > What do you think?
> > > > >
> > > > > [1] OpenAPI Specification <https://swagger.io/resources/open-api/>
> > > > > [2] OpenAPITools/openapi-generator
> > > > > <https://github.com/OpenAPITools/openapi-generator>
> > > > >
> > > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > > >
> > > > > > Hi:
> > > > > > If your team thinks my suggestion is reasonable, I am very
> > happy
> > > to
> > > > > > assist you in this matter. I have used Java as the main
> development
> > > > > > language for 10 years.
> > > > > > About the "mustake":
> > > > > > 1. When I want to use an API, I have to go to the official
> > > website of
> > > > > > apisix to find documentation. If we have a perfect javadoc, we
> can
> > > solve
> > > > > > this problem greatly.
> > > > > > 2. It may be due to carelessness, wrong parameter names and
> > wrong
> > > > > > types. This will cause a lot of trouble. But Java is strongly
> > typed,
> > > and
> > > > > > this type of problem can be avoided.
> > > > > >
> > > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > > > > >
> > > > > > > Good suggestion! Does anyone else also like this kind of SDK?
> If
> > > so,
> > > > > > would
> > > > > > > you like to take this project?
> > > > > > >
> > > > > > > BTW, may I know the details information about “mustake” you
> mean?
> > > > > > >
> > > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > > >
> > > > > > > > Hello, everyone:
> > > > > > > > Our company now uses apisix as our api gateway, and our
> > main
> > > > > > > > development languages are Java and JavaScript.
> > > > > > > > In the process of using apisix, we often use the admin
> api
> > of
> > > > > > apisix.
> > > > > > > > We need to create and initiate requests repeatedly, which is
> > very
> > > > > > > > cumbersome, and sometimes, the parameter names, parameter
> > types,
> > > etc.
> > > > > > are
> > > > > > > > mistaken. So, I suggest that the apisix team can release an
> SDK
> > > > > toolkit
> > > > > > > for
> > > > > > > > Java, Types can be defined inside, because Java is strongly
> > > typed.
> > > > > > > > Good luck to everyone!
> > > > > > > >
> > > > > > > --
> > > > > > > 来自 琚致远
> > > > > > >
> > > > > >
> > > > >
> > >
> >
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Zeping Bai <bz...@apache.org>.
You may have misunderstood what I said about OpenAPI. In fact, we can
directly generate a multilingual SDK through a definition file conforming
to the OpenAPI specification and use the `openapi generator`[1] tool.
Therefore, OpenAPI will be used as the cornerstone.
[1] https://openapi-generator.tech/docs/generators
孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
> I mean: We must not only have the SDK, but also ensure the consistency and
> correctness of the SDK and OpenAPI, and the most important thing is
> versatility.
>
> Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
>
> > > I think we should not only own the java sdk
> >
> > What does `should not` mean actually?
> >
> > Sheng Wu 吴晟
> > Twitter, wusheng1108
> >
> > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > >
> > > Hi:
> > > I think we should not only own the java sdk, we must also
> standardize
> > > it. In the future, we may also provide java sdk for spring and the
> > starter
> > > of spring boot, because more and more people are using the framework
> > around
> > > spring. Of course, SDKs in other languages cannot be forgotten, such as
> > > JavaScript, Python, Go, etc.
> > >
> > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > >
> > > > Hi,
> > > > I very much agree to provide the Admin API SDK, but I see that
> you
> > > > only mentioned the Java language. In fact, I think if we can provide
> an
> > > > OpenAPI (Swagger) [1] specification file, we can generate normal API
> > > > documents and multi language SDKs with the help of OpenAPI generator
> > > > tool [2].
> > > >
> > > > What do you think?
> > > >
> > > > [1] OpenAPI Specification <https://swagger.io/resources/open-api/>
> > > > [2] OpenAPITools/openapi-generator
> > > > <https://github.com/OpenAPITools/openapi-generator>
> > > >
> > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > >
> > > > > Hi:
> > > > > If your team thinks my suggestion is reasonable, I am very
> happy
> > to
> > > > > assist you in this matter. I have used Java as the main development
> > > > > language for 10 years.
> > > > > About the "mustake":
> > > > > 1. When I want to use an API, I have to go to the official
> > website of
> > > > > apisix to find documentation. If we have a perfect javadoc, we can
> > solve
> > > > > this problem greatly.
> > > > > 2. It may be due to carelessness, wrong parameter names and
> wrong
> > > > > types. This will cause a lot of trouble. But Java is strongly
> typed,
> > and
> > > > > this type of problem can be avoided.
> > > > >
> > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > > > >
> > > > > > Good suggestion! Does anyone else also like this kind of SDK? If
> > so,
> > > > > would
> > > > > > you like to take this project?
> > > > > >
> > > > > > BTW, may I know the details information about “mustake” you mean?
> > > > > >
> > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > >
> > > > > > > Hello, everyone:
> > > > > > > Our company now uses apisix as our api gateway, and our
> main
> > > > > > > development languages are Java and JavaScript.
> > > > > > > In the process of using apisix, we often use the admin api
> of
> > > > > apisix.
> > > > > > > We need to create and initiate requests repeatedly, which is
> very
> > > > > > > cumbersome, and sometimes, the parameter names, parameter
> types,
> > etc.
> > > > > are
> > > > > > > mistaken. So, I suggest that the apisix team can release an SDK
> > > > toolkit
> > > > > > for
> > > > > > > Java, Types can be defined inside, because Java is strongly
> > typed.
> > > > > > > Good luck to everyone!
> > > > > > >
> > > > > > --
> > > > > > 来自 琚致远
> > > > > >
> > > > >
> > > >
> >
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Sheng Wu <wu...@gmail.com>.
Make sense.
Sheng Wu 吴晟
Twitter, wusheng1108
孙昊 <su...@gmail.com> 于2021年9月25日周六 下午11:23写道：
>
> I mean: We must not only have the SDK, but also ensure the consistency and
> correctness of the SDK and OpenAPI, and the most important thing is
> versatility.
>
> Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
>
> > > I think we should not only own the java sdk
> >
> > What does `should not` mean actually?
> >
> > Sheng Wu 吴晟
> > Twitter, wusheng1108
> >
> > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> > >
> > > Hi:
> > > I think we should not only own the java sdk, we must also standardize
> > > it. In the future, we may also provide java sdk for spring and the
> > starter
> > > of spring boot, because more and more people are using the framework
> > around
> > > spring. Of course, SDKs in other languages cannot be forgotten, such as
> > > JavaScript, Python, Go, etc.
> > >
> > > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> > >
> > > > Hi,
> > > > I very much agree to provide the Admin API SDK, but I see that you
> > > > only mentioned the Java language. In fact, I think if we can provide an
> > > > OpenAPI (Swagger) [1] specification file, we can generate normal API
> > > > documents and multi language SDKs with the help of OpenAPI generator
> > > > tool [2].
> > > >
> > > > What do you think?
> > > >
> > > > [1] OpenAPI Specification <https://swagger.io/resources/open-api/>
> > > > [2] OpenAPITools/openapi-generator
> > > > <https://github.com/OpenAPITools/openapi-generator>
> > > >
> > > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > > >
> > > > > Hi:
> > > > > If your team thinks my suggestion is reasonable, I am very happy
> > to
> > > > > assist you in this matter. I have used Java as the main development
> > > > > language for 10 years.
> > > > > About the "mustake":
> > > > > 1. When I want to use an API, I have to go to the official
> > website of
> > > > > apisix to find documentation. If we have a perfect javadoc, we can
> > solve
> > > > > this problem greatly.
> > > > > 2. It may be due to carelessness, wrong parameter names and wrong
> > > > > types. This will cause a lot of trouble. But Java is strongly typed,
> > and
> > > > > this type of problem can be avoided.
> > > > >
> > > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > > > >
> > > > > > Good suggestion! Does anyone else also like this kind of SDK? If
> > so,
> > > > > would
> > > > > > you like to take this project?
> > > > > >
> > > > > > BTW, may I know the details information about “mustake” you mean?
> > > > > >
> > > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > > >
> > > > > > > Hello, everyone:
> > > > > > > Our company now uses apisix as our api gateway, and our main
> > > > > > > development languages are Java and JavaScript.
> > > > > > > In the process of using apisix, we often use the admin api of
> > > > > apisix.
> > > > > > > We need to create and initiate requests repeatedly, which is very
> > > > > > > cumbersome, and sometimes, the parameter names, parameter types,
> > etc.
> > > > > are
> > > > > > > mistaken. So, I suggest that the apisix team can release an SDK
> > > > toolkit
> > > > > > for
> > > > > > > Java, Types can be defined inside, because Java is strongly
> > typed.
> > > > > > > Good luck to everyone!
> > > > > > >
> > > > > > --
> > > > > > 来自 琚致远
> > > > > >
> > > > >
> > > >
> >
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by 孙昊 <su...@gmail.com>.
I mean: We must not only have the SDK, but also ensure the consistency and
correctness of the SDK and OpenAPI, and the most important thing is
versatility.
Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午11:05写道：
> > I think we should not only own the java sdk
>
> What does `should not` mean actually?
>
> Sheng Wu 吴晟
> Twitter, wusheng1108
>
> 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
> >
> > Hi:
> > I think we should not only own the java sdk, we must also standardize
> > it. In the future, we may also provide java sdk for spring and the
> starter
> > of spring boot, because more and more people are using the framework
> around
> > spring. Of course, SDKs in other languages cannot be forgotten, such as
> > JavaScript, Python, Go, etc.
> >
> > Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> >
> > > Hi,
> > > I very much agree to provide the Admin API SDK, but I see that you
> > > only mentioned the Java language. In fact, I think if we can provide an
> > > OpenAPI (Swagger) [1] specification file, we can generate normal API
> > > documents and multi language SDKs with the help of OpenAPI generator
> > > tool [2].
> > >
> > > What do you think?
> > >
> > > [1] OpenAPI Specification <https://swagger.io/resources/open-api/>
> > > [2] OpenAPITools/openapi-generator
> > > <https://github.com/OpenAPITools/openapi-generator>
> > >
> > > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> > >
> > > > Hi:
> > > > If your team thinks my suggestion is reasonable, I am very happy
> to
> > > > assist you in this matter. I have used Java as the main development
> > > > language for 10 years.
> > > > About the "mustake":
> > > > 1. When I want to use an API, I have to go to the official
> website of
> > > > apisix to find documentation. If we have a perfect javadoc, we can
> solve
> > > > this problem greatly.
> > > > 2. It may be due to carelessness, wrong parameter names and wrong
> > > > types. This will cause a lot of trouble. But Java is strongly typed,
> and
> > > > this type of problem can be avoided.
> > > >
> > > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > > >
> > > > > Good suggestion! Does anyone else also like this kind of SDK? If
> so,
> > > > would
> > > > > you like to take this project?
> > > > >
> > > > > BTW, may I know the details information about “mustake” you mean?
> > > > >
> > > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > > >
> > > > > > Hello, everyone:
> > > > > > Our company now uses apisix as our api gateway, and our main
> > > > > > development languages are Java and JavaScript.
> > > > > > In the process of using apisix, we often use the admin api of
> > > > apisix.
> > > > > > We need to create and initiate requests repeatedly, which is very
> > > > > > cumbersome, and sometimes, the parameter names, parameter types,
> etc.
> > > > are
> > > > > > mistaken. So, I suggest that the apisix team can release an SDK
> > > toolkit
> > > > > for
> > > > > > Java, Types can be defined inside, because Java is strongly
> typed.
> > > > > > Good luck to everyone!
> > > > > >
> > > > > --
> > > > > 来自 琚致远
> > > > >
> > > >
> > >
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Sheng Wu <wu...@gmail.com>.
> I think we should not only own the java sdk
What does `should not` mean actually?
Sheng Wu 吴晟
Twitter, wusheng1108
孙昊 <su...@gmail.com> 于2021年9月25日周六 下午10:32写道：
>
> Hi:
> I think we should not only own the java sdk, we must also standardize
> it. In the future, we may also provide java sdk for spring and the starter
> of spring boot, because more and more people are using the framework around
> spring. Of course, SDKs in other languages cannot be forgotten, such as
> JavaScript, Python, Go, etc.
>
> Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
>
> > Hi,
> > I very much agree to provide the Admin API SDK, but I see that you
> > only mentioned the Java language. In fact, I think if we can provide an
> > OpenAPI (Swagger) [1] specification file, we can generate normal API
> > documents and multi language SDKs with the help of OpenAPI generator
> > tool [2].
> >
> > What do you think?
> >
> > [1] OpenAPI Specification <https://swagger.io/resources/open-api/>
> > [2] OpenAPITools/openapi-generator
> > <https://github.com/OpenAPITools/openapi-generator>
> >
> > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> >
> > > Hi:
> > > If your team thinks my suggestion is reasonable, I am very happy to
> > > assist you in this matter. I have used Java as the main development
> > > language for 10 years.
> > > About the "mustake":
> > > 1. When I want to use an API, I have to go to the official website of
> > > apisix to find documentation. If we have a perfect javadoc, we can solve
> > > this problem greatly.
> > > 2. It may be due to carelessness, wrong parameter names and wrong
> > > types. This will cause a lot of trouble. But Java is strongly typed, and
> > > this type of problem can be avoided.
> > >
> > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > >
> > > > Good suggestion! Does anyone else also like this kind of SDK? If so,
> > > would
> > > > you like to take this project?
> > > >
> > > > BTW, may I know the details information about “mustake” you mean?
> > > >
> > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > >
> > > > > Hello, everyone:
> > > > > Our company now uses apisix as our api gateway, and our main
> > > > > development languages are Java and JavaScript.
> > > > > In the process of using apisix, we often use the admin api of
> > > apisix.
> > > > > We need to create and initiate requests repeatedly, which is very
> > > > > cumbersome, and sometimes, the parameter names, parameter types, etc.
> > > are
> > > > > mistaken. So, I suggest that the apisix team can release an SDK
> > toolkit
> > > > for
> > > > > Java, Types can be defined inside, because Java is strongly typed.
> > > > > Good luck to everyone!
> > > > >
> > > > --
> > > > 来自 琚致远
> > > >
> > >
> >
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by 孙昊 <su...@gmail.com>.
Hi:
I think we should not only own the java sdk, we must also standardize
it. In the future, we may also provide java sdk for spring and the starter
of spring boot, because more and more people are using the framework around
spring. Of course, SDKs in other languages cannot be forgotten, such as
JavaScript, Python, Go, etc.
Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> Hi,
> I very much agree to provide the Admin API SDK, but I see that you
> only mentioned the Java language. In fact, I think if we can provide an
> OpenAPI (Swagger) [1] specification file, we can generate normal API
> documents and multi language SDKs with the help of OpenAPI generator
> tool [2].
>
> What do you think?
>
> [1] OpenAPI Specification <https://swagger.io/resources/open-api/>
> [2] OpenAPITools/openapi-generator
> <https://github.com/OpenAPITools/openapi-generator>
>
> 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
>
> > Hi:
> > If your team thinks my suggestion is reasonable, I am very happy to
> > assist you in this matter. I have used Java as the main development
> > language for 10 years.
> > About the "mustake":
> > 1. When I want to use an API, I have to go to the official website of
> > apisix to find documentation. If we have a perfect javadoc, we can solve
> > this problem greatly.
> > 2. It may be due to carelessness, wrong parameter names and wrong
> > types. This will cause a lot of trouble. But Java is strongly typed, and
> > this type of problem can be avoided.
> >
> > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> >
> > > Good suggestion! Does anyone else also like this kind of SDK? If so,
> > would
> > > you like to take this project?
> > >
> > > BTW, may I know the details information about “mustake” you mean?
> > >
> > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > >
> > > > Hello, everyone:
> > > > Our company now uses apisix as our api gateway, and our main
> > > > development languages are Java and JavaScript.
> > > > In the process of using apisix, we often use the admin api of
> > apisix.
> > > > We need to create and initiate requests repeatedly, which is very
> > > > cumbersome, and sometimes, the parameter names, parameter types, etc.
> > are
> > > > mistaken. So, I suggest that the apisix team can release an SDK
> toolkit
> > > for
> > > > Java, Types can be defined inside, because Java is strongly typed.
> > > > Good luck to everyone!
> > > >
> > > --
> > > 来自 琚致远
> > >
> >
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by 孙昊 <su...@gmail.com>.
Yes, I very much agree with you, the coexistence of the two is the best
way. You can choose which way to use according to your wishes, OpenApi or
SDK. If we do this, we must ensure a high degree of consistency between SDK
and OpenAPI, as well as SDK standard annotations.
Sheng Wu <wu...@gmail.com> 于2021年9月25日周六 下午8:46写道：
> I am not using this API manually but considering mentioned OpenAPI V.S.
> SDK.
> Take a good reference from k8s APIs, it has very clear OpenAPI definitions,
> meanwhile, the SDK projects are continuously being set up.
> I am using k8s-api-java-client daily.
> My point is, these two are both meaningful, we should consider both.
>
> Sheng Wu 吴晟
> Twitter, wusheng1108
>
>
> Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
>
> > Hi,
> > I very much agree to provide the Admin API SDK, but I see that you
> > only mentioned the Java language. In fact, I think if we can provide an
> > OpenAPI (Swagger) [1] specification file, we can generate normal API
> > documents and multi language SDKs with the help of OpenAPI generator
> > tool [2].
> >
> > What do you think?
> >
> > [1] OpenAPI Specification <https://swagger.io/resources/open-api/>
> > [2] OpenAPITools/openapi-generator
> > <https://github.com/OpenAPITools/openapi-generator>
> >
> > 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> >
> > > Hi:
> > > If your team thinks my suggestion is reasonable, I am very happy to
> > > assist you in this matter. I have used Java as the main development
> > > language for 10 years.
> > > About the "mustake":
> > > 1. When I want to use an API, I have to go to the official website
> of
> > > apisix to find documentation. If we have a perfect javadoc, we can
> solve
> > > this problem greatly.
> > > 2. It may be due to carelessness, wrong parameter names and wrong
> > > types. This will cause a lot of trouble. But Java is strongly typed,
> and
> > > this type of problem can be avoided.
> > >
> > > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> > >
> > > > Good suggestion! Does anyone else also like this kind of SDK? If so,
> > > would
> > > > you like to take this project?
> > > >
> > > > BTW, may I know the details information about “mustake” you mean?
> > > >
> > > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > > >
> > > > > Hello, everyone:
> > > > > Our company now uses apisix as our api gateway, and our main
> > > > > development languages are Java and JavaScript.
> > > > > In the process of using apisix, we often use the admin api of
> > > apisix.
> > > > > We need to create and initiate requests repeatedly, which is very
> > > > > cumbersome, and sometimes, the parameter names, parameter types,
> etc.
> > > are
> > > > > mistaken. So, I suggest that the apisix team can release an SDK
> > toolkit
> > > > for
> > > > > Java, Types can be defined inside, because Java is strongly typed.
> > > > > Good luck to everyone!
> > > > >
> > > > --
> > > > 来自 琚致远
> > > >
> > >
> >
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Sheng Wu <wu...@gmail.com>.
I am not using this API manually but considering mentioned OpenAPI V.S. SDK.
Take a good reference from k8s APIs, it has very clear OpenAPI definitions,
meanwhile, the SDK projects are continuously being set up.
I am using k8s-api-java-client daily.
My point is, these two are both meaningful, we should consider both.
Sheng Wu 吴晟
Twitter, wusheng1108
Zeping Bai <bz...@apache.org> 于2021年9月25日周六 下午8:29写道：
> Hi,
> I very much agree to provide the Admin API SDK, but I see that you
> only mentioned the Java language. In fact, I think if we can provide an
> OpenAPI (Swagger) [1] specification file, we can generate normal API
> documents and multi language SDKs with the help of OpenAPI generator
> tool [2].
>
> What do you think?
>
> [1] OpenAPI Specification <https://swagger.io/resources/open-api/>
> [2] OpenAPITools/openapi-generator
> <https://github.com/OpenAPITools/openapi-generator>
>
> 孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
>
> > Hi:
> > If your team thinks my suggestion is reasonable, I am very happy to
> > assist you in this matter. I have used Java as the main development
> > language for 10 years.
> > About the "mustake":
> > 1. When I want to use an API, I have to go to the official website of
> > apisix to find documentation. If we have a perfect javadoc, we can solve
> > this problem greatly.
> > 2. It may be due to carelessness, wrong parameter names and wrong
> > types. This will cause a lot of trouble. But Java is strongly typed, and
> > this type of problem can be avoided.
> >
> > Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> >
> > > Good suggestion! Does anyone else also like this kind of SDK? If so,
> > would
> > > you like to take this project?
> > >
> > > BTW, may I know the details information about “mustake” you mean?
> > >
> > > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> > >
> > > > Hello, everyone:
> > > > Our company now uses apisix as our api gateway, and our main
> > > > development languages are Java and JavaScript.
> > > > In the process of using apisix, we often use the admin api of
> > apisix.
> > > > We need to create and initiate requests repeatedly, which is very
> > > > cumbersome, and sometimes, the parameter names, parameter types, etc.
> > are
> > > > mistaken. So, I suggest that the apisix team can release an SDK
> toolkit
> > > for
> > > > Java, Types can be defined inside, because Java is strongly typed.
> > > > Good luck to everyone!
> > > >
> > > --
> > > 来自 琚致远
> > >
> >
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Zeping Bai <bz...@apache.org>.
Hi,
I very much agree to provide the Admin API SDK, but I see that you
only mentioned the Java language. In fact, I think if we can provide an
OpenAPI (Swagger) [1] specification file, we can generate normal API
documents and multi language SDKs with the help of OpenAPI generator
tool [2].
What do you think?
[1] OpenAPI Specification <https://swagger.io/resources/open-api/>
[2] OpenAPITools/openapi-generator
<https://github.com/OpenAPITools/openapi-generator>
孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:45写道：
> Hi:
> If your team thinks my suggestion is reasonable, I am very happy to
> assist you in this matter. I have used Java as the main development
> language for 10 years.
> About the "mustake":
> 1. When I want to use an API, I have to go to the official website of
> apisix to find documentation. If we have a perfect javadoc, we can solve
> this problem greatly.
> 2. It may be due to carelessness, wrong parameter names and wrong
> types. This will cause a lot of trouble. But Java is strongly typed, and
> this type of problem can be avoided.
>
> Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
>
> > Good suggestion! Does anyone else also like this kind of SDK? If so,
> would
> > you like to take this project?
> >
> > BTW, may I know the details information about “mustake” you mean?
> >
> > 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> >
> > > Hello, everyone:
> > > Our company now uses apisix as our api gateway, and our main
> > > development languages are Java and JavaScript.
> > > In the process of using apisix, we often use the admin api of
> apisix.
> > > We need to create and initiate requests repeatedly, which is very
> > > cumbersome, and sometimes, the parameter names, parameter types, etc.
> are
> > > mistaken. So, I suggest that the apisix team can release an SDK toolkit
> > for
> > > Java, Types can be defined inside, because Java is strongly typed.
> > > Good luck to everyone!
> > >
> > --
> > 来自 琚致远
> >
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by 孙昊 <su...@gmail.com>.
Hi:
If your team thinks my suggestion is reasonable, I am very happy to
assist you in this matter. I have used Java as the main development
language for 10 years.
About the "mustake":
1. When I want to use an API, I have to go to the official website of
apisix to find documentation. If we have a perfect javadoc, we can solve
this problem greatly.
2. It may be due to carelessness, wrong parameter names and wrong
types. This will cause a lot of trouble. But Java is strongly typed, and
this type of problem can be avoided.
Zhiyuan Ju <ju...@apache.org> 于2021年9月25日周六 下午6:37写道：
> Good suggestion! Does anyone else also like this kind of SDK? If so, would
> you like to take this project?
>
> BTW, may I know the details information about “mustake” you mean?
>
> 孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
>
> > Hello, everyone:
> > Our company now uses apisix as our api gateway, and our main
> > development languages are Java and JavaScript.
> > In the process of using apisix, we often use the admin api of apisix.
> > We need to create and initiate requests repeatedly, which is very
> > cumbersome, and sometimes, the parameter names, parameter types, etc. are
> > mistaken. So, I suggest that the apisix team can release an SDK toolkit
> for
> > Java, Types can be defined inside, because Java is strongly typed.
> > Good luck to everyone!
> >
> --
> 来自 琚致远
>
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by Zhiyuan Ju <ju...@apache.org>.
Good suggestion! Does anyone else also like this kind of SDK? If so, would
you like to take this project?
BTW, may I know the details information about “mustake” you mean?
孙昊 <su...@gmail.com>于2021年9月25日 周六下午6:27写道：
> Hello, everyone:
> Our company now uses apisix as our api gateway, and our main
> development languages are Java and JavaScript.
> In the process of using apisix, we often use the admin api of apisix.
> We need to create and initiate requests repeatedly, which is very
> cumbersome, and sometimes, the parameter names, parameter types, etc. are
> mistaken. So, I suggest that the apisix team can release an SDK toolkit for
> Java, Types can be defined inside, because Java is strongly typed.
> Good luck to everyone!
>
--
来自 琚致远
Re: [DISCUSS] Java or other language SDK for APISIX's admin URL.
Posted by ZhengSong Tu <tz...@gmail.com>.
hello, I like this proposal and I think it makes sense.
As far as I know, in practice, for example, when doing secondary
development based on APISIX, or integrating apisix with internal projects,
many people do not use APISIX-Dashboard, but use admin-api. They all need
to write the logic to call admin-api in a language they are familiar with.
If an SDK is available, it is much easier to integrate APISIX with other
systems.
*ZhengSong Tu*
My GitHub: https://github.com/tzssangglass
Apache APISIX: https://github.com/apache/apisix
孙昊 <su...@gmail.com> 于2021年9月25日周六 下午6:27写道：
> Hello, everyone:
> Our company now uses apisix as our api gateway, and our main
> development languages are Java and JavaScript.
> In the process of using apisix, we often use the admin api of apisix.
> We need to create and initiate requests repeatedly, which is very
> cumbersome, and sometimes, the parameter names, parameter types, etc. are
> mistaken. So, I suggest that the apisix team can release an SDK toolkit for
> Java, Types can be defined inside, because Java is strongly typed.
> Good luck to everyone!
>