Skip to content

Commit

Permalink
Stop documenting use of -debug compiler flag in reference manual
Browse files Browse the repository at this point in the history
Closes gh-33453
  • Loading branch information
sbrannen committed Aug 30, 2024
1 parent 61b5b1e commit dca5523
Show file tree
Hide file tree
Showing 4 changed files with 12 additions and 11 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -644,7 +644,7 @@ Each `SpEL` expression evaluates against a dedicated context. The following tabl
items made available to the context so that you can use them for conditional event processing:

[[context-functionality-events-annotation-tbl]]
.Event SpEL available metadata
.Event metadata available in SpEL expressions
|===
| Name| Location| Description| Example

Expand All @@ -660,8 +660,8 @@ items made available to the context so that you can use them for conditional eve

| __Argument name__
| evaluation context
| The name of any of the method arguments. If, for some reason, the names are not available
(for example, because there is no debug information in the compiled byte code), individual
| The name of a particular method argument. If the names are not available
(for example, because the code was compiled without the `-parameters` flag), individual
arguments are also available using the `#a<#arg>` syntax where `<#arg>` stands for the
argument index (starting from 0).
| `#blEvent` or `#a0` (you can also use `#p0` or `#p<#arg>` parameter notation as an alias)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -211,8 +211,8 @@ example shows:
----

Keep in mind that, to make this work out of the box, your code must be compiled with the
debug flag enabled so that Spring can look up the parameter name from the constructor.
If you cannot or do not want to compile your code with the debug flag, you can use the
`-parameters` flag enabled so that Spring can look up the parameter name from the constructor.
If you cannot or do not want to compile your code with the `-parameters` flag, you can use the
https://download.oracle.com/javase/8/docs/api/java/beans/ConstructorProperties.html[@ConstructorProperties]
JDK annotation to explicitly name your constructor arguments. The sample class would
then have to look as follows:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -582,7 +582,7 @@ it needs to be declared in the XML file even though it is not defined in an XSD
(it exists inside the Spring core).

For the rare cases where the constructor argument names are not available (usually if
the bytecode was compiled without debugging information), you can use fallback to the
the bytecode was compiled without the `-parameters` flag), you can fall back to the
argument indexes, as follows:

[source,xml,indent=0,subs="verbatim,quotes"]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -332,7 +332,7 @@ metadata, such as the argument names. The following table describes the items ma
available to the context so that you can use them for key and conditional computations:

[[cache-spel-context-tbl]]
.Cache SpEL available metadata
.Cache metadata available in SpEL expressions
|===
| Name| Location| Description| Example

Expand All @@ -358,7 +358,7 @@ available to the context so that you can use them for key and conditional comput

| `args`
| Root object
| The arguments (as array) used for invoking the target
| The arguments (as an object array) used for invoking the target
| `#root.args[0]`

| `caches`
Expand All @@ -368,9 +368,10 @@ available to the context so that you can use them for key and conditional comput

| Argument name
| Evaluation context
| Name of any of the method arguments. If the names are not available
(perhaps due to having no debug information), the argument names are also available under the `#a<#arg>`
where `#arg` stands for the argument index (starting from `0`).
| The name of a particular method argument. If the names are not available
(for example, because the code was compiled without the `-parameters` flag), individual
arguments are also available using the `#a<#arg>` syntax where `<#arg>` stands for the
argument index (starting from 0).
| `#iban` or `#a0` (you can also use `#p0` or `#p<#arg>` notation as an alias).

| `result`
Expand Down

0 comments on commit dca5523

Please sign in to comment.