tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 47769] New: documentation on web.xml resource-ref does'nt state optional
Date Mon, 31 Aug 2009 11:49:16 GMT
https://issues.apache.org/bugzilla/show_bug.cgi?id=47769

           Summary: documentation on web.xml resource-ref does'nt state
                    optional
           Product: Tomcat 6
           Version: unspecified
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
        AssignedTo: dev@tomcat.apache.org
        ReportedBy: mgainty@hotmail.com


--- Comment #0 from Martin Gainty <mgainty@hotmail.com> 2009-08-31 04:49:13 PDT ---
<snip> from users@tomcat.apache.org
 There has to be some use of that resource-ref element. All the Tomcat
> examples and tutorials instruct you to create this element. Someone
> really badly wants you to use it, yet it seemingly has not function
> whatsoever. Something just doesn't add up, or maybe it's just me...

It's not just you. I've also been wondering why you should need it when
obviously you don't as your <Resource> works without a <resource-ref>.

<commentary>
if web.xml <resource-ref> and <resource-env-ref> tags are optional 
could the documentation be updated to say web.xml <resource-ref> and
<resource-env-ref> tags are 'optional'

<Existing Documentation considerations>
change tomcat-docs/config/context.html#Resource Definitions
You can declare the characteristics of the resource to be returned for JNDI
lookups of <resource-ref> and <resource-env-ref> elements in the web
application deployment descriptor. You MUST also define the needed resource
parameters as attributes of the Resource element, to configure the object
factory to be used (if not known to Tomcat already), and the properties used to
configure that object factory.

change Documentation to:
Optionally you can declare the characteristics of the resource to be returned
for JNDI lookups of <resource-ref> and <resource-env-ref> elements in the web
application deployment descriptor. Be advised that both <resource-ref> and
<resource-env-ref> tags are OPTIONAL tags within web.xml
You MUST define the needed resource parameters as attributes of the Resource
element, to configure the object factory to be used (if not known to Tomcat
already), and the properties used to configure that object factory.
The ApplicationContext.xml <Resource> tag within <Context> is mandatory for the
resource to be recognised.

....
The valid attributes for a <Resource> element are as follows:
...

Thanks,
Martin-
For example, you can create a resource definition like this:

Thanks 
Martin

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message