mirror of
https://github.com/OpenAPITools/openapi-generator.git
synced 2025-05-12 20:50:55 +00:00
* Adds @Nullable annotation to Spring Boot generator * issue-14427: [REQ][spring] Null-Safety annotations * issue-17382: [REQ] spring generator add Nullable annotations Motivations: * Have Spring Boot generator client properly annotated for nullability to be able to check code using them with tools like NullAway * As it is related to Spring then the `org.springframework.lang.Nullable` annotation was chosen to avoid discussion which `@Nullable` one is true one * `@NonNull` wasn't used as I didn't see much benefit of it. Anyhow, an empty constructor and/or setters allow to put a `null` value there Modifications: * Adds nullableAnnotation template to handle nullability annotation on vars * Adjust pojo templates to use the nullability template * Adapts tests Modifications: * Runs export_docs_generator.sh script to update samples * samples update * excludes Spring @Nullable from java-camel * ones with defaults shouldn't be annotated as @Nullable * updates samples * adds AllArgConstructor generation tests * adds container tests
OpenAPI generated API stub
Spring Framework stub
Overview
This code was generated by the OpenAPI Generator project. By using the OpenAPI-Spec, you can easily generate an API stub. This is an example of building API stub interfaces in Java using the Spring framework.
The stubs generated can be used in your existing Spring-MVC or Spring-Boot application to create controller endpoints
by adding @Controller
classes that implement the interface. Eg:
@Controller
public class PetController implements PetApi {
// implement all PetApi methods
}
You can also use the interface to create Spring-Cloud Feign clients.Eg:
@FeignClient(name="pet", url="http://petstore.swagger.io/v2")
public interface PetClient extends PetApi {
}