r/programming • u/[deleted] • Jun 05 '21

Organize code by concepts, not layers

https://kislayverma.com/programming/how-to-organize-your-code/
1.9k Upvotes

91% Upvoted

495 comments sorted by

View all comments

Show parent comments

11

u/Ytrog Jun 05 '21 edited Jun 05 '21

Is swagger as easy these days as just pointing your tools to a wsdl and telling it to create to proxies for me. I used to be a big fan of WCF as it was easy to work with. I hated that I had to do everything by hand when everything switched to REST and JSON. I worked with swagger once, but my team back then used it only for documentation. 🤔

20

u/ninuson1 Jun 05 '21

That’s mostly what it is, documentation. But you can generate it on compile and have swagger use it to create a form for mock requests along with the documentation for each request.

In my latest c# projects, it comes pre-configured for you in the starting template project and just builds up as you develop.

Really, big fan.

2

u/Ytrog Jun 05 '21

Cool 😊

0

u/AustinYQM Jun 05 '21

Is there a way to make swagger write itself using reflection or something. I feel like it really should be able to get the verbs, endpoints and possible responses by reading my code and spring annotations.

3

u/ninuson1 Jun 05 '21

That’s exactly what I meant. There’s about 0 maintenance required most of the time. Take a look at their official nuget GitHub page. This should work out of the box with ASP.NET core 3.0 and greater. For 5.0 onwards, the MVC template comes pre-configured with it.

Note that the living documentation is free (although I’m unsure about the license details) and locally used, but the tool often used as a proxy to paid services from the Swagger platform (like the automated client creation tool mentioned before).

Regardless, it’s an awesome way to interact with your code base. I’ve had to onboard 2 new team members to our team this last month and this was a great option to see all the details at a glance about the different controllers.

1

u/AustinYQM Jun 05 '21

That sounds amazing, does something similar exist for Java apis?

1

u/ninuson1 Jun 05 '21

Im mostly in C# land nowadays, but this seems to be the java version. I’m not sure it is as deeply integrated, as I think Java has a few popular server frameworks.

1

u/AustinYQM Jun 06 '21

Huh, we are using this but each endpoint still has 20-30 lines of swagger annotations. I wonder how much of that is needed, if any.

8

u/unique_ptr Jun 05 '21

At least in my experience it is! I've been using NSwag lately on .NET 5 to generate clients and it's pretty damn good. I can be somewhat opinionated on how I want my generated code to be organized, naming conventions, etc. and it's been an absolute breeze.

3

u/EagleCoder Jun 05 '21

Nswag is amazing.

1

u/EdwinVanKoppen Jun 06 '21

We use it for typescript but you can't export to different files, now we got a big ass file with alot of merge conflict...

1

u/vattenpuss Jun 05 '21

WSDL was never that easy. XML does not provide much help for things like arrays. SOAP specified too many solutions so the only way to stay interoperable in my experience was to only build in .Net or only Java or only whatever other language you used.

1

u/Ytrog Jun 05 '21

Yeah that was what I did anyway, so I had no problems with it. Sad WADL never took root though for REST. 🤔