Support beneathPath in MockMvcRestDocumentationWrapper (#250)

Co-authored-by: Phil Owen <phowen@cisco.com>

Author: philipowen

restdocs-api-spec-mockmvc/src/test/kotlin/com/epages/restdocs/apispec/MockMvcRestDocumentationWrapperIntegrationTest.kt

@@ -17,6 +17,7 @@ import org.springframework.restdocs.hypermedia.HypermediaDocumentation.links
 import org.springframework.restdocs.mockmvc.MockMvcRestDocumentation.document
 import org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.post
 import org.springframework.restdocs.operation.preprocess.OperationRequestPreprocessor
+import org.springframework.restdocs.payload.PayloadDocumentation.beneathPath
 import org.springframework.restdocs.payload.PayloadDocumentation.fieldWithPath
 import org.springframework.restdocs.payload.PayloadDocumentation.requestFields
 import org.springframework.restdocs.payload.PayloadDocumentation.responseFields
@@ -51,6 +52,15 @@ class MockMvcRestDocumentationWrapperIntegrationTest(@Autowired private val mock
         thenSnippetFileExists()
     }
 
+    @Test
+    fun should_document_both_restdocs_and_resource_with_path() {
+        givenEndpointInvoked()
+
+        whenDocumentedWithPayloadSubsectionExtractor()
+
+        thenSnippetFileExists()
+    }
+
     @Test
     fun should_document_using_the_passed_raml_snippet() {
         givenEndpointInvoked()
@@ -250,6 +260,39 @@ class MockMvcRestDocumentationWrapperIntegrationTest(@Autowired private val mock
             )
     }
 
+    @Throws(Exception::class)
+    private fun whenDocumentedWithPayloadSubsectionExtractor() {
+        val operationRequestPreprocessor = OperationRequestPreprocessor { r -> r }
+        resultActions
+            .andDo(
+                MockMvcRestDocumentationWrapper.document(
+                    identifier = operationName,
+                    privateResource = true,
+                    requestPreprocessor = operationRequestPreprocessor,
+                    snippets = arrayOf(
+                        requestFields(fieldDescriptors().fieldDescriptors),
+                        responseFields(
+                            fieldWithPath("comment").description("the comment"),
+                            fieldWithPath("flag").description("the flag"),
+                            fieldWithPath("count").description("the count"),
+                            fieldWithPath("id").description("id"),
+                            subsectionWithPath("_links").ignored()
+                        ),
+                        responseFields(
+                            beneathPath("_links").withSubsectionId("beneath-links"),
+                            fieldWithPath("self").description("self link"),
+                            fieldWithPath("self.href").description("self link href"),
+                            subsectionWithPath("multiple").ignored(),
+                        ),
+                        links(
+                            linkWithRel("self").description("some"),
+                            linkWithRel("multiple").description("multiple")
+                        )
+                    )
+                )
+            )
+    }
+
     @Throws(Exception::class)
     private fun whenDocumentedWithResourceSnippetDetails() {
         val operationRequestPreprocessor = OperationRequestPreprocessor { r -> r }

restdocs-api-spec/src/main/kotlin/com/epages/restdocs/apispec/DescriptorExtractor.kt

@@ -7,6 +7,9 @@ import org.springframework.restdocs.hypermedia.LinkDescriptor
 import org.springframework.restdocs.hypermedia.LinksSnippet
 import org.springframework.restdocs.payload.AbstractFieldsSnippet
 import org.springframework.restdocs.payload.FieldDescriptor
+import org.springframework.restdocs.payload.FieldPathPayloadSubsectionExtractor
+import org.springframework.restdocs.payload.PayloadDocumentation
+import org.springframework.restdocs.payload.PayloadSubsectionExtractor
 import org.springframework.restdocs.request.AbstractParametersSnippet
 import org.springframework.restdocs.request.ParameterDescriptor
 import org.springframework.restdocs.snippet.AbstractDescriptor
@@ -32,7 +35,17 @@ internal object DescriptorExtractor {
         try {
             val getFieldDescriptors = AbstractFieldsSnippet::class.java.getDeclaredMethod("getFieldDescriptors")
             getFieldDescriptors.isAccessible = true
-            return getFieldDescriptors.invoke(snippet) as List<FieldDescriptor>
+            var descriptors =  getFieldDescriptors.invoke(snippet) as List<FieldDescriptor>
+            val getSubsectionExtractor = AbstractFieldsSnippet::class.java.getDeclaredMethod("getSubsectionExtractor")
+            getSubsectionExtractor.isAccessible = true
+            val payloadSubsectionExtractor = getSubsectionExtractor.invoke(snippet) as PayloadSubsectionExtractor<*>?
+            if (payloadSubsectionExtractor is FieldPathPayloadSubsectionExtractor) {
+                val getFieldPath = FieldPathPayloadSubsectionExtractor::class.java.getDeclaredMethod("getFieldPath")
+                getFieldPath.isAccessible = true
+                val fieldPath = getFieldPath.invoke(payloadSubsectionExtractor) as String
+                descriptors = PayloadDocumentation.applyPathPrefix("$fieldPath.", descriptors)
+            }
+            return descriptors
         } catch (e: NoSuchMethodException) {
             e.printStackTrace()
         } catch (e: InvocationTargetException) {