8567402969
This commit extract spring-related links and recurring external links into asciidoctor attributes to be used by the Antora toolchain. It notably homogenizes links to: - IETF RFCs - Java Community Process JSRs - the Java API Documentation (on the Java 17 version) - Kotlin documentations (on the Kotlinlang.org version) - the Spring Boot reference guide (on the `html` version) This commit also reworks most link attributes to follow a Project-Category-Misc syntax. For example, `spring-boot-docs` rather than `docs-spring-boot`. Finally, it makes an effort to clean up remainders from the previous documentation toolchain, namely the `docs/asciidoc` folder and `modules/ROOT/pages/attributes.adoc` file. Closes gh-26864 Closes gh-31619
55 lines
1.4 KiB
Plaintext
55 lines
1.4 KiB
Plaintext
[[mvc-controller]]
|
|
= Annotated Controllers
|
|
|
|
[.small]#xref:web/webflux/controller.adoc[See equivalent in the Reactive stack]#
|
|
|
|
Spring MVC provides an annotation-based programming model where `@Controller` and
|
|
`@RestController` components use annotations to express request mappings, request input,
|
|
exception handling, and more. Annotated controllers have flexible method signatures and
|
|
do not have to extend base classes nor implement specific interfaces.
|
|
The following example shows a controller defined by annotations:
|
|
|
|
[tabs]
|
|
======
|
|
Java::
|
|
+
|
|
[source,java,indent=0,subs="verbatim,quotes",role="primary"]
|
|
----
|
|
@Controller
|
|
public class HelloController {
|
|
|
|
@GetMapping("/hello")
|
|
public String handle(Model model) {
|
|
model.addAttribute("message", "Hello World!");
|
|
return "index";
|
|
}
|
|
}
|
|
----
|
|
|
|
Kotlin::
|
|
+
|
|
[source,kotlin,indent=0,subs="verbatim,quotes",role="secondary"]
|
|
----
|
|
import org.springframework.ui.set
|
|
|
|
@Controller
|
|
class HelloController {
|
|
|
|
@GetMapping("/hello")
|
|
fun handle(model: Model): String {
|
|
model["message"] = "Hello World!"
|
|
return "index"
|
|
}
|
|
}
|
|
----
|
|
======
|
|
|
|
In the preceding example, the method accepts a `Model` and returns a view name as a `String`,
|
|
but many other options exist and are explained later in this chapter.
|
|
|
|
TIP: Guides and tutorials on {spring-site-guides}[spring.io] use the annotation-based
|
|
programming model described in this section.
|
|
|
|
|
|
|