Skip to content

Commit a0c0836

Browse files
committed
Consistent line breaks in reference documentation
1 parent 983fdeb commit a0c0836

File tree

365 files changed

+399
-1867
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

365 files changed

+399
-1867
lines changed

framework-docs/antora.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ nav:
66
ext:
77
collector:
88
run:
9-
command: gradlew -q -PbuildSrc.skipTests=true "-Dorg.gradle.jvmargs=-Xmx3g -XX:+HeapDumpOnOutOfMemoryError" :framework-docs:generateAntoraResources
9+
command: gradlew -q -PbuildSrc.skipTests=true "-Dorg.gradle.jvmargs=-Xmx3g" :framework-docs:generateAntoraResources
1010
local: true
1111
scan:
1212
dir: ./build/generated-antora-resources

framework-docs/modules/ROOT/pages/core.adoc

Lines changed: 0 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -17,14 +17,3 @@ is also provided.
1717

1818
AOT processing can be used to optimize your application ahead-of-time. It is typically
1919
used for native image deployment using GraalVM.
20-
21-
22-
23-
24-
25-
26-
27-
28-
29-
30-

framework-docs/modules/ROOT/pages/core/aop-api.adoc

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,3 @@ The previous chapter described the Spring's support for AOP with @AspectJ and sc
66
aspect definitions. In this chapter, we discuss the lower-level Spring AOP APIs. For common
77
applications, we recommend the use of Spring AOP with AspectJ pointcuts as described in the
88
previous chapter.
9-
10-
11-
12-

framework-docs/modules/ROOT/pages/core/aop-api/advice.adoc

Lines changed: 0 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@
44
Now we can examine how Spring AOP handles advice.
55

66

7-
87
[[aop-api-advice-lifecycle]]
98
== Advice Lifecycles
109

@@ -22,14 +21,12 @@ the advice adds state to the proxied object.
2221
You can use a mix of shared and per-instance advice in the same AOP proxy.
2322

2423

25-
2624
[[aop-api-advice-types]]
2725
== Advice Types in Spring
2826

2927
Spring provides several advice types and is extensible to support
3028
arbitrary advice types. This section describes the basic concepts and standard advice types.
3129

32-
3330
[[aop-api-advice-around]]
3431
=== Interception Around Advice
3532

@@ -101,7 +98,6 @@ you are likely to want to run the aspect in another AOP framework. Note that poi
10198
are not currently interoperable between frameworks, and the AOP Alliance does not
10299
currently define pointcut interfaces.
103100

104-
105101
[[aop-api-advice-before]]
106102
=== Before Advice
107103

@@ -168,7 +164,6 @@ Kotlin::
168164

169165
TIP: Before advice can be used with any pointcut.
170166

171-
172167
[[aop-api-advice-throws]]
173168
=== Throws Advice
174169

@@ -297,7 +292,6 @@ exception that is incompatible with the target method's signature!_
297292

298293
TIP: Throws advice can be used with any pointcut.
299294

300-
301295
[[aop-api-advice-after-returning]]
302296
=== After Returning Advice
303297

@@ -361,7 +355,6 @@ thrown up the interceptor chain instead of the return value.
361355

362356
TIP: After returning advice can be used with any pointcut.
363357

364-
365358
[[aop-api-advice-introduction]]
366359
=== Introduction Advice
367360

@@ -501,7 +494,6 @@ Java::
501494
}
502495
return super.invoke(invocation);
503496
}
504-
505497
}
506498
----
507499
@@ -531,7 +523,6 @@ Kotlin::
531523
}
532524
return super.invoke(invocation)
533525
}
534-
535526
}
536527
----
537528
======
@@ -582,8 +573,3 @@ We can apply this advisor programmatically by using the `Advised.addAdvisor()` m
582573
(the recommended way) in XML configuration, as any other advisor. All proxy creation
583574
choices discussed below, including "`auto proxy creators,`" correctly handle introductions
584575
and stateful mixins.
585-
586-
587-
588-
589-

framework-docs/modules/ROOT/pages/core/aop-api/advised.adoc

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,3 @@ case, the `Advised` `isFrozen()` method returns `true`, and any attempts to modi
142142
advice through addition or removal results in an `AopConfigException`. The ability
143143
to freeze the state of an advised object is useful in some cases (for example, to
144144
prevent calling code removing a security interceptor).
145-
146-
147-
148-

framework-docs/modules/ROOT/pages/core/aop-api/advisor.adoc

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,3 @@ It is possible to mix advisor and advice types in Spring in the same AOP proxy.
1414
example, you could use an interception around advice, throws advice, and before advice in
1515
one proxy configuration. Spring automatically creates the necessary interceptor
1616
chain.
17-
18-
19-
20-

framework-docs/modules/ROOT/pages/core/aop-api/autoproxy.adoc

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -19,14 +19,12 @@ There are two ways to do this:
1919
auto-proxy creation driven by source-level metadata attributes.
2020

2121

22-
2322
[[aop-autoproxy-choices]]
2423
== Auto-proxy Bean Definitions
2524

2625
This section covers the auto-proxy creators provided by the
2726
`org.springframework.aop.framework.autoproxy` package.
2827

29-
3028
[[aop-api-autoproxy]]
3129
=== `BeanNameAutoProxyCreator`
3230

@@ -61,7 +59,6 @@ automatically created by the `BeanNameAutoProxyCreator`. The same advice is appl
6159
to all matching beans. Note that, if advisors are used (rather than the interceptor in
6260
the preceding example), the pointcuts may apply differently to different beans.
6361

64-
6562
[[aop-api-autoproxy-default]]
6663
=== `DefaultAdvisorAutoProxyCreator`
6764

@@ -125,7 +122,3 @@ differently configured, AdvisorAutoProxyCreators in the same factory) and orderi
125122
Advisors can implement the `org.springframework.core.Ordered` interface to ensure
126123
correct ordering if this is an issue. The `TransactionAttributeSourceAdvisor` used in the
127124
preceding example has a configurable order value. The default setting is unordered.
128-
129-
130-
131-

framework-docs/modules/ROOT/pages/core/aop-api/concise-proxy.adoc

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,3 @@ that, if you have a (parent) bean definition that you intend to use only as a te
6565
and this definition specifies a class, you must make sure to set the `abstract`
6666
attribute to `true`. Otherwise, the application context actually tries to
6767
pre-instantiate it.
68-
69-
70-
71-

framework-docs/modules/ROOT/pages/core/aop-api/pfb.adoc

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,6 @@ the pointcuts, any advice that applies, and their ordering. However, there are s
1414
options that are preferable if you do not need such control.
1515

1616

17-
1817
[[aop-pfb-1]]
1918
== Basics
2019

@@ -32,7 +31,6 @@ application objects (besides the target, which should be available in any AOP
3231
framework), benefiting from all the pluggability provided by Dependency Injection.
3332

3433

35-
3634
[[aop-pfb-2]]
3735
== JavaBean Properties
3836

@@ -87,7 +85,6 @@ to be applied. You can find an example of using this feature in xref:core/aop-ap
8785
`false`.
8886

8987

90-
9188
[[aop-pfb-proxy-types]]
9289
== JDK- and CGLIB-based proxies
9390

@@ -137,7 +134,6 @@ interface that the target class implements to the `proxyInterfaces` property. Ho
137134
it is significantly less work and less prone to typographical errors.
138135

139136

140-
141137
[[aop-api-proxying-intf]]
142138
== Proxying Interfaces
143139

@@ -263,7 +259,6 @@ However, there are times when being able to obtain the un-advised target from th
263259
factory might actually be an advantage (for example, in certain test scenarios).
264260

265261

266-
267262
[[aop-api-proxying-class]]
268263
== Proxying Classes
269264

@@ -302,7 +297,6 @@ There is little performance difference between CGLIB proxies and dynamic proxies
302297
Performance should not be a decisive consideration in this case.
303298

304299

305-
306300
[[aop-global-advisors]]
307301
== Using "`Global`" Advisors
308302

@@ -325,7 +319,3 @@ two global advisors:
325319
<bean id="global_debug" class="org.springframework.aop.interceptor.DebugInterceptor"/>
326320
<bean id="global_performance" class="org.springframework.aop.interceptor.PerformanceMonitorInterceptor"/>
327321
----
328-
329-
330-
331-

framework-docs/modules/ROOT/pages/core/aop-api/pointcuts.adoc

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@
44
This section describes how Spring handles the crucial pointcut concept.
55

66

7-
87
[[aop-api-concepts]]
98
== Concepts
109

@@ -69,7 +68,6 @@ TIP: If possible, try to make pointcuts static, allowing the AOP framework to ca
6968
results of pointcut evaluation when an AOP proxy is created.
7069

7170

72-
7371
[[aop-api-pointcut-ops]]
7472
== Operations on Pointcuts
7573

@@ -84,7 +82,6 @@ You can compose pointcuts by using the static methods in the
8482
expressions is usually a simpler approach.
8583

8684

87-
8885
[[aop-api-pointcuts-aspectj]]
8986
== AspectJ Expression Pointcuts
9087

@@ -95,14 +92,12 @@ uses an AspectJ-supplied library to parse an AspectJ pointcut expression string.
9592
See the xref:core/aop.adoc[previous chapter] for a discussion of supported AspectJ pointcut primitives.
9693

9794

98-
9995
[[aop-api-pointcuts-impls]]
10096
== Convenience Pointcut Implementations
10197

10298
Spring provides several convenient pointcut implementations. You can use some of them
10399
directly; others are intended to be subclassed in application-specific pointcuts.
104100

105-
106101
[[aop-api-pointcuts-static]]
107102
=== Static Pointcuts
108103

@@ -146,7 +141,6 @@ You can use `RegexpMethodPointcutAdvisor` with any `Advice` type.
146141
An important type of static pointcut is a metadata-driven pointcut. This uses the
147142
values of metadata attributes (typically, source-level metadata).
148143

149-
150144
[[aop-api-pointcuts-dynamic]]
151145
=== Dynamic pointcuts
152146

@@ -172,7 +166,6 @@ other dynamic pointcuts. In Java 1.4, the cost is about five times that of other
172166
pointcuts.
173167

174168

175-
176169
[[aop-api-pointcuts-superclasses]]
177170
== Pointcut Superclasses
178171

@@ -214,7 +207,6 @@ There are also superclasses for dynamic pointcuts.
214207
You can use custom pointcuts with any advice type.
215208

216209

217-
218210
[[aop-api-pointcuts-custom]]
219211
== Custom Pointcuts
220212

@@ -225,7 +217,3 @@ expression language, if you can.
225217

226218
NOTE: Later versions of Spring may offer support for "`semantic pointcuts`" as offered by JAC --
227219
for example, "`all methods that change instance variables in the target object.`"
228-
229-
230-
231-

0 commit comments

Comments
 (0)