Browse Source

Revised alias definition example in reference documentation

Issue: SPR-17536
pull/2030/head
Juergen Hoeller 6 years ago
parent
commit
80b8382f00
  1. 20
      src/docs/asciidoc/core/core-beans.adoc

20
src/docs/asciidoc/core/core-beans.adoc

@ -565,9 +565,9 @@ itself. @@ -565,9 +565,9 @@ itself.
Specifying all aliases where the bean is actually defined is not always adequate,
however. It is sometimes desirable to introduce an alias for a bean that is defined
elsewhere. This is commonly the case in large systems where configuration is split
amongst each subsystem, with each subsystem having its own set of object definitions. In
XML-based configuration metadata, you can use the `<alias/>` element to accomplish this.
The following example shows how to do so:
amongst each subsystem, with each subsystem having its own set of object definitions.
In XML-based configuration metadata, you can use the `<alias/>` element to accomplish
this. The following example shows how to do so:
====
[source,xml,indent=0]
@ -580,19 +580,19 @@ The following example shows how to do so: @@ -580,19 +580,19 @@ The following example shows how to do so:
In this case, a bean (in the same container) named `fromName` may also,
after the use of this alias definition, be referred to as `toName`.
For example, the configuration metadata for subsystem A may refer to a DataSource by
the name of `subsystemA-dataSource`. The configuration metadata for subsystem B may refer to
For example, the configuration metadata for subsystem A may refer to a DataSource by the
name of `subsystemA-dataSource`. The configuration metadata for subsystem B may refer to
a DataSource by the name of `subsystemB-dataSource`. When composing the main application
that uses both these subsystems, the main application refers to the DataSource by the
name of `myApp-dataSource`. To have all three names refer to the same object, you can add
the following alias definitions to the configuration metadata:
name of `myApp-dataSource`. To have all three names refer to the same object, you can
add the following alias definitions to the configuration metadata:
====
[source,xml,indent=0]
[subs="verbatim,quotes"]
----
<alias name="subsystemA-dataSource" alias="subsystemB-dataSource"/>
<alias name="subsystemA-dataSource" alias="myApp-dataSource" />
<alias name="myApp-dataSource" alias="subsystemA-dataSource"/>
<alias name="myApp-dataSource" alias="subsystemB-dataSource"/>
----
====
@ -7231,7 +7231,7 @@ a number of aliases for a bean: @@ -7231,7 +7231,7 @@ a number of aliases for a bean:
@Configuration
public class AppConfig {
@Bean(name = { "dataSource", "subsystemA-dataSource", "subsystemB-dataSource" })
@Bean({"dataSource", "subsystemA-dataSource", "subsystemB-dataSource"})
public DataSource dataSource() {
// instantiate, configure and return DataSource bean...
}

Loading…
Cancel
Save