Sfoglia il codice sorgente

Clean up text based on RestController

Greg Turnquist 10 anni fa
parent
commit
68c254eab4
5 ha cambiato i file con 3 aggiunte e 13 eliminazioni
  1. 3
    3
      README.adoc
  2. 0
    1
      complete/build.gradle
  3. 0
    4
      complete/pom.xml
  4. 0
    1
      initial/build.gradle
  5. 0
    4
      initial/pom.xml

+ 3
- 3
README.adoc Vedi File

@@ -102,7 +102,7 @@ Next you create the resource controller that will serve these greetings.
102 102
 
103 103
 == Create a resource controller
104 104
 
105
-In Spring's approach to building RESTful web services, HTTP requests are handled by a controller. These components are easily identified by the http://docs.spring.io/spring/docs/{spring_version}/javadoc-api/org/springframework/stereotype/Controller.html[`@Controller`] annotation, and the `GreetingController` below handles `GET` requests for `/greeting` by returning a new instance of the `Greeting` class:
105
+In Spring's approach to building RESTful web services, HTTP requests are handled by a controller. These components are easily identified by the http://docs.spring.io/spring/docs/{spring_version}/javadoc-api/org/springframework/web/bind/annotation/RestController.html[`@RestController`] annotation, and the `GreetingController` below handles `GET` requests for `/greeting` by returning a new instance of the `Greeting` class:
106 106
 
107 107
 `src/main/java/hello/GreetingController.java`
108 108
 [source,java]
@@ -122,7 +122,7 @@ The implementation of the method body creates and returns a new `Greeting` objec
122 122
 
123 123
 A key difference between a traditional MVC controller and the RESTful web service controller above is the way that the HTTP response body is created. Rather than relying on a link:/understanding/view-templates[view technology] to perform server-side rendering of the greeting data to HTML, this RESTful web service controller simply populates and returns a `Greeting` object. The object data will be written directly to the HTTP response as JSON.
124 124
 
125
-To accomplish this, the http://docs.spring.io/spring/docs/{spring_version}/javadoc-api/org/springframework/web/bind/annotation/ResponseBody.html[`@ResponseBody`] annotation on the `greeting()` method tells Spring MVC that it does not need to render the greeting object through a server-side view layer, but that instead that the greeting object returned _is_ the response body, and should be written out directly.
125
+This code usees Spring 4's new http://docs.spring.io/spring/doc/{spring_version}/javadoc-api/org/springframework/web/bind/annotation/RestController.html[`@RestController`] annotation, which marks the class as a controller where every method returns a domain object instead of a view. It's shorthand for `@Controller` and `@ResponseBody` rolled together.
126 126
 
127 127
 The `Greeting` object must be converted to JSON. Thanks to Spring's HTTP message converter support, you don't need to do this conversion manually. Because http://wiki.fasterxml.com/JacksonHome[Jackson 2] is on the classpath, Spring's http://docs.spring.io/spring/docs/{spring_version}/javadoc-api/org/springframework/http/converter/json/MappingJackson2HttpMessageConverter.html[`MappingJackson2HttpMessageConverter`] is automatically chosen to convert the `Greeting` instance to JSON.
128 128
 
@@ -140,7 +140,7 @@ include::complete/src/main/java/hello/Application.java[]
140 140
 
141 141
 The `main()` method defers to the http://docs.spring.io/spring-boot/docs/{spring_boot_version}/api/org/springframework/boot/SpringApplication.html[`SpringApplication`] helper class, providing `Application.class` as an argument to its `run()` method. This tells Spring to read the annotation metadata from `Application` and to manage it as a component in the link:/understanding/application-context[Spring application context].
142 142
 
143
-The `@ComponentScan` annotation tells Spring to search recursively through the `hello` package and its children for classes marked directly or indirectly with Spring's http://docs.spring.io/spring/docs/{spring_version}/javadoc-api/org/springframework/stereotype/Component.html[`@Component`] annotation. This directive ensures that Spring finds and registers the `GreetingController`, because it is marked with `@Controller`, which in turn is a kind of `@Component` annotation.
143
+The `@ComponentScan` annotation tells Spring to search recursively through the `hello` package and its children for classes marked directly or indirectly with Spring's http://docs.spring.io/spring/docs/{spring_version}/javadoc-api/org/springframework/stereotype/Component.html[`@Component`] annotation. This directive ensures that Spring finds and registers the `GreetingController`, because it is marked with `@RestController`, which in turn is a kind of `@Component` annotation.
144 144
 
145 145
 The http://docs.spring.io/spring-boot/docs/{spring_boot_version}/api/org/springframework/boot/autoconfigure/EnableAutoConfiguration.html[`@EnableAutoConfiguration`] annotation switches on reasonable default behaviors based on the content of your classpath. For example, because the application depends on the embeddable version of Tomcat (tomcat-embed-core.jar), a Tomcat server is set up and configured with reasonable defaults on your behalf. And because the application also depends on Spring MVC (spring-webmvc.jar), a Spring MVC http://docs.spring.io/spring/docs/{spring_version}/javadoc-api/org/springframework/web/servlet/DispatcherServlet.html[`DispatcherServlet`] is configured and registered for you — no `web.xml` necessary! Auto-configuration is a powerful, flexible mechanism. See the http://docs.spring.io/spring-boot/docs/{spring_boot_version}/api/org/springframework/boot/autoconfigure/EnableAutoConfiguration.html[API documentation] for further details.
146 146
 

+ 0
- 1
complete/build.gradle Vedi File

@@ -27,7 +27,6 @@ repositories {
27 27
 
28 28
 dependencies {
29 29
     compile("org.springframework.boot:spring-boot-starter-web")
30
-    compile("com.fasterxml.jackson.core:jackson-databind")
31 30
     testCompile("junit:junit")
32 31
 }
33 32
 

+ 0
- 4
complete/pom.xml Vedi File

@@ -18,10 +18,6 @@
18 18
             <groupId>org.springframework.boot</groupId>
19 19
             <artifactId>spring-boot-starter-web</artifactId>
20 20
         </dependency>
21
-        <dependency>
22
-            <groupId>com.fasterxml.jackson.core</groupId>
23
-            <artifactId>jackson-databind</artifactId>
24
-        </dependency>
25 21
     </dependencies>
26 22
 
27 23
     <properties>

+ 0
- 1
initial/build.gradle Vedi File

@@ -27,7 +27,6 @@ repositories {
27 27
 
28 28
 dependencies {
29 29
     compile("org.springframework.boot:spring-boot-starter-web")
30
-    compile("com.fasterxml.jackson.core:jackson-databind")
31 30
     testCompile("junit:junit")
32 31
 }
33 32
 

+ 0
- 4
initial/pom.xml Vedi File

@@ -18,10 +18,6 @@
18 18
             <groupId>org.springframework.boot</groupId>
19 19
             <artifactId>spring-boot-starter-web</artifactId>
20 20
         </dependency>
21
-        <dependency>
22
-            <groupId>com.fasterxml.jackson.core</groupId>
23
-            <artifactId>jackson-databind</artifactId>
24
-        </dependency>
25 21
     </dependencies>
26 22
 
27 23
     <properties>