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: mgai...@hotmail.com
--- Comment #0 from Martin Gainty <mgai...@hotmail.com> 2009-08-31 04:49:13 PDT
---
<snip> from us...@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-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
