Return-Path: Delivered-To: apmail-jakarta-tomcat-dev-archive@apache.org Received: (qmail 17134 invoked from network); 3 Jun 2002 22:48:21 -0000 Received: from unknown (HELO nagoya.betaversion.org) (192.18.49.131) by daedalus.apache.org with SMTP; 3 Jun 2002 22:48:21 -0000 Received: (qmail 4612 invoked by uid 97); 3 Jun 2002 22:48:21 -0000 Delivered-To: qmlist-jakarta-archive-tomcat-dev@jakarta.apache.org Received: (qmail 4602 invoked by uid 97); 3 Jun 2002 22:48:21 -0000 Mailing-List: contact tomcat-dev-help@jakarta.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Tomcat Developers List" Reply-To: "Tomcat Developers List" Delivered-To: mailing list tomcat-dev@jakarta.apache.org Received: (qmail 26195 invoked by uid 98); 3 Jun 2002 22:38:20 -0000 X-Antivirus: nagoya (v4198 created Apr 24 2002) From: bob@jadn.com Message-Id: <200206032240.g53Meq512878@jadn.com> Subject: doc fix to globalresources.xml To: tomcat-dev@jakarta.apache.org (Tomcat Developers) Date: Mon, 3 Jun 2002 18:40:52 -0400 (EDT) X-Mailer: ELM [version 2.5 PL6] MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N Global Resources are a little confusing. Declaring a resource in the GlobalNamingResources section of the server.xml doesn't make the resource visible to webapps until the context for the webapp includes a ResourceLink. This obscurity is for security. It seems weird to declare something 'global' and have it visible nowhere. (until it is linked.) Tempting to call a "GlobalNamingResources" a "HiddenGlobalNamingResources" or "BackgroundGlobalNamingResources" or "MightBeGlobalNamingResources" In any event, I tried to update "globalresources.xml" to refer to the needed ResourceLink so developers don't get tripped up on the documentation. I am not sure I am happy with my exact text. Remmy, what do you think? Cheers, -bob Index: globalresources.xml =================================================================== RCS file: /home/cvspublic/jakarta-tomcat-4.0/webapps/tomcat-docs/config/globalresources.xml,v retrieving revision 1.1 diff -u -r1.1 globalresources.xml --- globalresources.xml 30 Nov 2001 06:23:13 -0000 1.1 +++ globalresources.xml 3 Jun 2002 22:20:50 -0000 @@ -51,7 +51,19 @@ </GlobalNamingResources> -

This is equivalent to the inclusion of the following element in the +

You must then make the this global setting visible to the context by using a Resource Link, like this:

+ + +<Context ...> + ... + <ResourceLink name="maxExemptions" + global="maxExemptions" + type="java.lang.Integer"/> + ... +</Context> + + +

This is then equivalent to the inclusion of the following element in the web application deployment descriptor (/WEB-INF/web.xml):

@@ -129,7 +141,19 @@ </GlobalNamingResources> -

This is equivalent to the inclusion of the following element in the +

You must then make the this global setting visible to the context by using a Resource Link, like this:

+ + +<Context ...> + ... + <ResourceLink name="jdbc/EmployeeDB" + global="jdbc/EmployeeDB" + type="javax.sql.DataSource"/> + ... +</Context> + + +

This is then equivalent to the inclusion of the following element in the web application deployment descriptor (/WEB-INF/web.xml):

<resource-ref> Cheers, -bob Cheers, -bob -- To unsubscribe, e-mail: For additional commands, e-mail: