Prüfen, ob sich das Verhalten durch die Zusammenführung von Ressourcenreferenz und Injektionsziel ändert

In der Servlet 3.0-Spezifikation werden die <injection-target>-Elemente einer Ressourcenreferenz, die in einer web-fragment.xml-Datei definiert ist, nur zur übergeordneten Datei web.xml hinzugefügt, wenn die web.xml-Ressourcenreferendefinition mit demselben Namen keine <injection-target>-Elemente hat. Die Servlet 3.1-Spezifikation legt fest, dass für eine Ressourcenreferenz mit demselben Namen alle <injection-target>-Elemente in web-fragment.xml-Deskriptoren der übergeordneten web.xml-Deskriptorenliste mit <injection-target>-Elementen hinzugefügt werden. Das Feature Servlet 3.1 kann das aktuelle Anwendungsverhalten durch die Aktivierung von Injektionszielen, die zuvor aus der Datei web.xml ausgeschlossen waren, ändern.

Diese Regel markiert das Element <injection-target> in der Datei web-fragment.xml, wenn die Datei web.xml ein <injection-target>-Element mit einem <resource-ref>-Element enthält, für das derselbe Name definiert wurde wie für das Element <resource-ref> in der Datei web-fragment.xml.

Die folgenden Beispiele veranschaulichen die Verhaltensänderung bei der kombinierten Verwendung der Dateien web.xml und web-fragment.xml:

web.xml:

<resource-ref>
	<res-ref-name>ReferenceName</res-ref-name>
	<res-type>javax.sql.DataSource</res-type>
	<res-auth>Container</res-auth>
	<res-sharing-scope>Shareable</res-sharing-scope>
	<injection-target>
		<injection-target-class>Class1</injection-target-class>
		<injection-target-name>Resource1</injection-target-name>
	</injection-target>
</resource-ref>

web-fragment.xml:

<resource-ref>
	<res-ref-name>ReferenceName</res-ref-name>
	<res-type>javax.sql.DataSource</res-type>
	<res-auth>Container</res-auth>
	<res-sharing-scope>Shareable</res-sharing-scope>
	<injection-target>
		<injection-target-class>Class2</injection-target-class>
		<injection-target-name>Resource2</injection-target-name>
	</injection-target>
</resource-ref>

In Servlet 3.0 ignoriert das kombinierte Ergebnis das Injektionsziel für Klasse 2:

<resource-ref>
	<res-ref-name>ReferenceName</res-ref-name>
	<res-type>javax.sql.DataSource</res-type>
	<res-auth>Container</res-auth>
	<res-sharing-scope>Shareable</res-sharing-scope>
	<injection-target>
		<injection-target-class>Class1</injection-target-class>
		<injection-target-name>Resource1</injection-target-name>
	</injection-target>
</resource-ref>

In Servlet 3.1 verwendet das kombinierte Ergebnis das Injektionsziel von Klasse 2:

<resource-ref>
	<res-ref-name>ReferenceName</res-ref-name>
	<res-type>javax.sql.DataSource</res-type>
	<res-auth>Container</res-auth>
	<res-sharing-scope>Shareable</res-sharing-scope>
	<injection-target>
		<injection-target-class>Class1</injection-target-class>
		<injection-target-name>Resource1</injection-target-name>
	</injection-target>
	<injection-target>
		<injection-target-class>Class2</injection-target-class>
		<injection-target-name>Resource2</injection-target-name>
	</injection-target>
</resource-ref>

Weitere Informationen zu den Verhaltensänderungen in Servlet 3.1 finden Sie unter Servlet 3.1 behavior changes.