Consistent anchor names for headings in documentation.

Author: odrotbohm

src/main/asciidoc/adding-sdr-to-spring-mvc-app.adoc

@@ -33,12 +33,14 @@ The following example shows the corresponding XML configuration:
 
 When your ApplicationContext comes across this bean definition, it bootstraps the necessary Spring MVC resources to fully configure the controller for exporting the repositories it finds in that `ApplicationContext` and any parent contexts.
 
+[[customizing-sdr.adding-sdr-to-spring-mvc-app.required-config]]
 == More on Required Configuration
 
 Spring Data REST depends on a couple Spring MVC resources that must be configured correctly for it to work inside an existing Spring MVC application. We tried to isolate those resources from whatever similar resources already exist within your application, but it may be that you want to customize some of the behavior of Spring Data REST by modifying these MVC components.
 
 You should pay special attention to configuring `RepositoryRestHandlerMapping`, covered in the next section.
 
+[[customizing-sdr.adding-sdr-to-spring-mvc-app.required-config.mapping]]
 === `RepositoryRestHandlerMapping`
 
 We register a custom `HandlerMapping` instance that responds only to the `RepositoryRestController` and only if a path is meant to be handled by Spring Data REST. In order to keep paths that are meant to be handled by your application separate from those handled by Spring Data REST, this custom `HandlerMapping` class inspects the URL path and checks to see if a repository has been exported under that name. If it has, the custom `HandlerMapping` class lets the request be handled by Spring Data REST. If there is no Repository exported under that name, it returns `null`, which means "`let other `HandlerMapping` instances try to service this request`".

src/main/asciidoc/configuring-cors.adoc

@@ -5,7 +5,7 @@ For security reasons, browsers prohibit AJAX calls to resources residing outside
 
 Spring Data REST, as of 2.6, supports https://en.wikipedia.org/wiki/Cross-origin_resource_sharing[Cross-Origin Resource Sharing] (CORS) through https://docs.spring.io/spring/docs/{springVersion}/spring-framework-reference/web.html#mvc-cors[Spring's CORS] support.
 
-
+[[customizing-sdr.configuring-cors.config]]
 == Repository Interface CORS Configuration
 
 You can add a `@CrossOrigin` annotation to your repository interfaces to enable CORS for the whole repository. By default, `@CrossOrigin` allows all origins and HTTP methods. The following example shows a cross-origin repository interface definition:
@@ -32,6 +32,7 @@ interface PersonRepository extends CrudRepository<Person, Long> {}
 
 The preceding example enables CORS support for the whole `PersonRepository` by providing one origin, restricted to the `GET`, `POST`, and `DELETE` methods and with a max age of 3600 seconds.
 
+[[customizing-sdr.configuring-cors.controller-config]]
 == Repository REST Controller Method CORS Configuration
 
 Spring Data REST fully supports https://docs.spring.io/spring/docs/{springVersion}/spring-framework-reference/web.html#controller-method-cors-configuration[Spring Web MVC's controller method configuration] on custom REST controllers that share repository base paths, as the following example shows:
@@ -53,6 +54,7 @@ public class PersonController {
 
 NOTE: Controllers annotated with `@RepositoryRestController` inherit `@CrossOrigin` configuration from their associated repositories.
 
+[[customizing-sdr.configuring-cors.global-config]]
 == Global CORS Configuration
 
 In addition to fine-grained, annotation-based configuration, you probably want to define some global CORS configuration as well. This is similar to Spring Web MVC'S CORS configuration but can be declared within Spring Data REST and combined with fine-grained `@CrossOrigin` configuration. By default, all origins and `GET`, `HEAD`, and `POST` methods are allowed.

src/main/asciidoc/configuring-the-rest-url-path.adoc

@@ -58,6 +58,7 @@ interface PersonRepository extends CrudRepository<Person, Long> {
 
 Now the query method in the preceding example is exposed at `http://localhost:8080/people/search/names`.
 
+[[customizing-sdr.configuring-the-rest-url-path.rels]]
 == Handling `rel` Attributes
 
 Since these resources are all discoverable, you can also affect how the `rel` attribute is displayed in the links sent out by the exporter.

src/main/asciidoc/custom-jackson-deserialization.adoc

@@ -5,6 +5,7 @@ Sometimes, the behavior of the Spring Data REST `ObjectMapper` (which has been s
 
 To accommodate the largest percentage of the use cases, Spring Data REST tries to render your object graph correctly. It tries to serialize unmanaged beans as normal POJOs, and tries to create links to managed beans where necessary. However, if your domain model does not easily lend itself to reading or writing plain JSON, you may want to configure Jackson's `ObjectMapper` with your own custom type mappings and (de)serializers.
 
+[[customizing-sdr.custom-jackson-deserialization.abstract-classes]]
 == Abstract Class Registration
 
 One key configuration point you might need to hook into is when you use an abstract class (or an interface) in your domain model. Jackson does not, by default, know what implementation to create for an interface. Consider the following example:
@@ -46,6 +47,7 @@ public class MyCustomModule extends SimpleModule {
 
 Once you have access to the `SetupContext` object in your `Module`, you can do all sorts of cool things to configure Jackon's JSON mapping. You can read more about how https://wiki.fasterxml.com/JacksonFeatureModules[Modules work on Jackson's wiki].
 
+[[customizing-sdr.custom-jackson-deserialization.custom-serializers]]
 == Adding Custom Serializers for Domain Types
 
 If you want to serialize or deserialize a domain type in a special way, you can register your own implementations with Jackson's `ObjectMapper`. Then the Spring Data REST exporter transparently handles those domain objects correctly.

src/main/asciidoc/customizing-json-output.adoc

@@ -3,6 +3,7 @@
 
 Sometimes in your application, you need to provide links to other resources from a particular entity. For example, a `Customer` response might be enriched with links to a current shopping cart or links to manage resources related to that entity. Spring Data REST provides integration with https://github.com/SpringSource/spring-hateoas[Spring HATEOAS] and provides an extension hook that lets you alter the representation of resources that go out to the client.
 
+[[customizing-sdr.customizing-json-output.representation-model-processor]]
 == The `RepresentationModelProcessor` Interface
 
 Spring HATEOAS defines a `RepresentationModelProcessor<>` interface for processing entities. All beans of type `RepresentationModelProcessor&lt;EntityModel&lt;T&gt;&gt;` are automatically picked up by the Spring Data REST exporter and triggered when serializing an entity of type `T`.
@@ -29,11 +30,12 @@ public RepresentationModelProcessor<EntityModel<Person>> personProcessor() {
 ====
 
 IMPORTANT: The preceding example hard codes a link to `http://localhost:8080/people`. If you have a Spring MVC endpoint inside your app to which you wish to link, consider using Spring HATEOAS's https://github.com/spring-projects/spring-hateoas#building-links-pointing-to-methods[`linkTo(...)`] method to avoid managing the URL.
-
+[[customizing-sdr.customizing-json-output.adding-links]]
 == Adding Links
 
 You can add links to the default representation of an entity by calling `model.add(Link)`, as the preceding example shows. Any links you add to the `EntityModel` are added to the final output.
 
+[[customizing-sdr.customizing-json-output.customizing-representation]]
 == Customizing the Representation
 
 The Spring Data REST exporter executes any discovered `RepresentationModelProcessor` instances before it creates the output representation. It does so by registering a `Converter<Entity, EntityModel>` instance with an internal `ConversionService`. This is the component responsible for creating the links to referenced entities (such as those objects under the `_links` property in the object's JSON representation). It takes an `@Entity` and iterates over its properties, creating links for those properties that are managed by a `Repository` and copying across any embedded or simple properties.

src/main/asciidoc/customizing-sdr.adoc

@@ -3,6 +3,7 @@
 
 There are many options to tailor Spring Data REST. These subsections show how.
 
+[[customizing-sdr.item-resource-uris]]
 == Customizing Item Resource URIs
 
 By default, the URI for item resources are comprised of the path segment used for the collection resource with the database identifier appended.

src/main/asciidoc/events.adoc

@@ -37,6 +37,7 @@ public class BeforeSaveEventListener extends AbstractRepositoryEventListener {
 
 One thing to note with this approach, however, is that it makes no distinction based on the type of the entity. You have to inspect that yourself.
 
+[[events.annotated-handler]]
 == Writing an Annotated Handler
 
 Another approach is to use an annotated handler, which filters events based on domain type.

src/main/asciidoc/index.adoc

@@ -1,6 +1,6 @@
 [[spring-data-rest-reference]]
 = Spring Data REST Reference Guide
-Jon Brisbin, Oliver Gierke, Greg Turnquist, Jay Bryant
+Jon Brisbin, Oliver Drotbohm, Greg Turnquist, Jay Bryant
 :revnumber: {version}
 :revdate: {localdate}
 ifdef::backend-epub3[:front-cover-image: image:epub-cover.png[Front Cover,1050,1600]]

src/main/asciidoc/integration.adoc

@@ -4,6 +4,7 @@
 
 This section details various ways to integrate with Spring Data REST components, whether from a Spring application that is using Spring Data REST or from other means.
 
+[[integration.programmatic-links]]
 == Programmatic Links
 
 Sometimes you need to add links to exported resources in your own custom-built Spring MVC controllers. There are three basic levels of linking available:

src/main/asciidoc/metadata.adoc

@@ -118,7 +118,6 @@ If you navigate to `/profile/persons` and look at the profile data for a `Person
   } ]
 }
 ----
-
 <1> A detailed listing of the attributes of a `Person` resource, identified as `#person-representation`, lists the names
 of the attributes.
 <2> The supported operations. This one indicates how to create a new `Person`.