Skip to content

Commit 5298173

Browse files
committed
Docs reflect bean id change from xsd:ID->xsd:string
Issue: SPR-8054
1 parent 43676bd commit 5298173

File tree

1 file changed

+11
-10
lines changed

1 file changed

+11
-10
lines changed

spring-framework-reference/src/beans.xml

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -532,16 +532,17 @@ List userList service.getUsernameList();
532532
<para>In XML-based configuration metadata, you use the
533533
<literal>id</literal> and/or <literal>name</literal> attributes to
534534
specify the bean identifier(s). The <literal>id</literal> attribute
535-
allows you to specify exactly one id, and because it is a real XML
536-
element ID attribute, the XML parser can do some extra validation when
537-
other elements reference the id. As such, it is the preferred way to
538-
specify a bean identifier. However, the XML specification does limit the
539-
characters that are legal in XML ids. This is usually not a constraint,
540-
but if you need to use one of these special XML characters, or want to
541-
introduce other aliases to the bean, you can also specify them in the
542-
<literal>name</literal> attribute, separated by a comma
543-
(<literal>,</literal>), semicolon (<literal>;</literal>), or white
544-
space.</para>
535+
allows you to specify exactly one id. Conventionally these names are
536+
alphanumeric ('myBean', 'fooService', etc), but may special characters
537+
as well. If you want to introduce other aliases to the bean, you can
538+
also specify them in the <literal>name</literal> attribute, separated by
539+
a comma (<literal>,</literal>), semicolon (<literal>;</literal>), or
540+
white space. As a historical note, in versions prior to Spring 3.1, the
541+
<literal>id</literal> attribute was typed as an
542+
<literal>xsd:ID</literal>, which constrained possible characters. As of
543+
3.1, it is now <literal>xsd:string</literal>. Note that bean id
544+
uniqueness is still enforced by the container, though no longer by XML
545+
parsers.</para>
545546

546547
<para>You are not required to supply a name or id for a bean. If no name
547548
or id is supplied explicitly, the container generates a unique name for

0 commit comments

Comments
 (0)