ssouris

RestTemplate restTemplate = new RestTemplate();
Set<HttpMethod> allowHeaders = restTemplate.optionsForAllow(baseUrl);

URI uri = new URI(baseUrl);
Set<HttpMethod> allowHeadersURI = restTemplate.optionsForAllow(uri);

ssouris

RestTemplate restTemplate = new RestTemplate();
URI uri = new URI(baseUrl);

restTemplate.delete(baseUrl);
restTemplate.delete(uri);

ssouris

RestTemplate restTemplate = new RestTemplate();
URI uri = new URI(baseUrl);

String body = "The Body";

restTemplate.put(baseUrl, body);
restTemplate.put(uri, body);

ssouris

RestTemplate restTemplate = new RestTemplate();
URI uri = new URI(baseUrl);

String body = "The Body";

ResponseEntity<String> response=restTemplate.postForEntity(baseUrl, body, String.class);

HttpEntity<String> request = new HttpEntity<>(body);
ResponseEntity<String> responseExchange=restTemplate.exchange(baseUrl, HttpMethod.POST, request, String.class);

ssouris

RestTemplate restTemplate = new RestTemplate();

ResponseEntity<String> response = restTemplate.getForEntity(baseUrl, String.class);
ResponseEntity<String> responseExchange = restTemplate.exchange(baseUrl, HttpMethod.GET, null, String.class);

URI uri = new URI(baseUrl);
ResponseEntity<String> responseURI = restTemplate.getForEntity(uri, String.class);
ResponseEntity<String> responseExchangeURI = restTemplate.exchange(uri, HttpMethod.GET, null, String.class);

ssouris

/**
 * Simple CRUD RESTful controller for {@linkplain  User} object
 */
@RestController
@RequestMapping("/api/v1/users")
public class UserController {
    
    private final UserDatastore userDatastore;

    @Autowired

ssouris

@WebAppConfiguration
@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = Application.class)
public class UserControllerDocumentation {

    // setup MockMVC, RestDocumentation etc omitted

    /**
     * All documentation production happens here.
     * 

ssouris

<plugin>
    <artifactId>maven-resources-plugin</artifactId>
    <version>2.7</version>
    <executions>
        <execution>
            <id>copy-resources</id>
            <phase>prepare-package</phase>
            <goals>
                <goal>copy-resources</goal>
            </goals>

ssouris

[[resources-get-users]]
== Listing users
 
A `GET` request will list all of the users.
 
=== Response structure
 
include::{snippets}/getUsers/response-fields.adoc[]
 
=== Example request

ssouris

@Rule
public final RestDocumentation restDocumentation = new RestDocumentation(
            "target/generated-snippets"
);
 
@Autowired
private WebApplicationContext context;
 
private MockMvc mockMvc;