root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions 6 Packages Projects Releases Wiki Activity

Fix layout in "Determining Argument Names" section

This commit is contained in:
Sam Brannen 2023-02-24 11:17:50 +01:00
parent 9cb4c5565a
commit 8979ac789f
1 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
framework-docs/src/docs/asciidoc/core/core-aop.adoc
View File

@ -1536,7 +1536,7 @@ following strategy to determine parameter names:
an optional `argNames` attribute that you can use to specify the argument names of an optional `argNames` attribute that you can use to specify the argument names of
the annotated method. These argument names are available at runtime. The following example the annotated method. These argument names are available at runtime. The following example
shows how to use the `argNames` attribute: shows how to use the `argNames` attribute:
+
[source,java,indent=0,subs="verbatim",role="primary"] [source,java,indent=0,subs="verbatim",role="primary"]
.Java .Java
---- ----
@ -1549,7 +1549,7 @@ following strategy to determine parameter names:
} }
---- ----
<1> References the `publicMethod` named pointcut defined in <<aop-pointcuts-combining>>. <1> References the `publicMethod` named pointcut defined in <<aop-pointcuts-combining>>.
+
[source,kotlin,indent=0,subs="verbatim",role="secondary"] [source,kotlin,indent=0,subs="verbatim",role="secondary"]
.Kotlin .Kotlin
---- ----
@ -1562,12 +1562,12 @@ following strategy to determine parameter names:
} }
---- ----
<1> References the `publicMethod` named pointcut defined in <<aop-pointcuts-combining>>. <1> References the `publicMethod` named pointcut defined in <<aop-pointcuts-combining>>.
+
If the first parameter is of the `JoinPoint`, `ProceedingJoinPoint`, or If the first parameter is of the `JoinPoint`, `ProceedingJoinPoint`, or
`JoinPoint.StaticPart` type, you can leave out the name of the parameter from the value `JoinPoint.StaticPart` type, you can leave out the name of the parameter from the value
of the `argNames` attribute. For example, if you modify the preceding advice to receive of the `argNames` attribute. For example, if you modify the preceding advice to receive
the join point object, the `argNames` attribute need not include it: the join point object, the `argNames` attribute need not include it:
+
[source,java,indent=0,subs="verbatim",role="primary"] [source,java,indent=0,subs="verbatim",role="primary"]
.Java .Java
---- ----
@ -1580,7 +1580,7 @@ the join point object, the `argNames` attribute need not include it:
} }
---- ----
<1> References the `publicMethod` named pointcut defined in <<aop-pointcuts-combining>>. <1> References the `publicMethod` named pointcut defined in <<aop-pointcuts-combining>>.
+
[source,kotlin,indent=0,subs="verbatim",role="secondary"] [source,kotlin,indent=0,subs="verbatim",role="secondary"]
.Kotlin .Kotlin
---- ----
@ -1593,13 +1593,13 @@ the join point object, the `argNames` attribute need not include it:
} }
---- ----
<1> References the `publicMethod` named pointcut defined in <<aop-pointcuts-combining>>. <1> References the `publicMethod` named pointcut defined in <<aop-pointcuts-combining>>.
+
The special treatment given to the first parameter of the `JoinPoint`, The special treatment given to the first parameter of the `JoinPoint`,
`ProceedingJoinPoint`, and `JoinPoint.StaticPart` types is particularly convenient for `ProceedingJoinPoint`, and `JoinPoint.StaticPart` types is particularly convenient for
advice instances that do not collect any other join point context. In such situations, you may advice instances that do not collect any other join point context. In such situations, you may
omit the `argNames` attribute. For example, the following advice need not declare omit the `argNames` attribute. For example, the following advice need not declare
the `argNames` attribute: the `argNames` attribute:
+
[source,java,indent=0,subs="verbatim",role="primary"] [source,java,indent=0,subs="verbatim",role="primary"]
.Java .Java
---- ----
@ -1609,7 +1609,7 @@ the `argNames` attribute:
} }
---- ----
<1> References the `publicMethod` named pointcut defined in <<aop-pointcuts-combining>>. <1> References the `publicMethod` named pointcut defined in <<aop-pointcuts-combining>>.
+
[source,kotlin,indent=0,subs="verbatim",role="secondary"] [source,kotlin,indent=0,subs="verbatim",role="secondary"]
.Kotlin .Kotlin
---- ----
@ -1632,7 +1632,7 @@ the `argNames` attribute:
+ +
NOTE: If an @AspectJ aspect has been compiled by the AspectJ compiler (`ajc`) even NOTE: If an @AspectJ aspect has been compiled by the AspectJ compiler (`ajc`) even
without the debug information, you need not add the `argNames` attribute, as the compiler without the debug information, you need not add the `argNames` attribute, as the compiler
retain the needed information. retains the needed information.
* If the code has been compiled without the necessary debug information, Spring AOP * If the code has been compiled without the necessary debug information, Spring AOP
tries to deduce the pairing of binding variables to parameters (for example, if tries to deduce the pairing of binding variables to parameters (for example, if