You are viewing a plain text version of this content. The canonical link for it is here.
Posted to taglibs-dev@jakarta.apache.org by mo...@apache.org on 2001/05/03 17:42:20 UTC

cvs commit: jakarta-taglibs/jdbc/examples/web index.html jdbc.jsp jndijdbc.jsp

morgand     01/05/03 08:42:19

  Modified:    jdbc     build.xml
               jdbc/doc/conf web.xml
               jdbc/doc/web changes.html index.html intro.xml
               jdbc/examples/conf web.xml
               jdbc/examples/web index.html jdbc.jsp jndijdbc.jsp
  Added:       jdbc/conf dbtags.tld
  Removed:     jdbc/conf jdbc.tld
  Log:
  renamed JDBC to "DBTags"
  
  Revision  Changes    Path
  1.3       +7 -7      jakarta-taglibs/jdbc/build.xml
  
  Index: build.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/jdbc/build.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- build.xml	2001/03/14 23:23:29	1.2
  +++ build.xml	2001/05/03 15:41:30	1.3
  @@ -1,5 +1,5 @@
  -<!-- ANT Build Script for the "jdbc" Custom Tag Library -->
  -<project name="jdbc" default="main" basedir=".">
  +<!-- ANT Build Script for the "dbtags" Custom Tag Library -->
  +<project name="dbtags" default="main" basedir=".">
   
       <!-- ******************** Adjustable Properties *********************** -->
   
  @@ -23,7 +23,7 @@
   
       -->
   
  -    <property name="taglib.name"    value="jdbc"/>
  +    <property name="taglib.name"    value="dbtags"/>
       <property name="ant.home"       value="../../jakarta-ant"/>
       <property name="servlet.jar"    value="../../jakarta-servletapi/lib/servlet.jar"/>
       <property name="jdbc-ext.jar"   value="lib/jdbc2_0-stdext.jar"/>
  @@ -139,8 +139,8 @@
                author="true"   
                version="true"
   	     use="true"
  -             windowtitle="Jakarta JDBC custom tag library API"
  -             doctitle="Jakarta JDBC custom tag library"
  +             windowtitle="Jakarta DBTags custom tag library API"
  +             doctitle="Jakarta DBTags custom tag library"
                bottom="Copyright &#169; 2000 Apache Software Foundation. All Rights Reserved."
       />
     </target>
  @@ -153,7 +153,7 @@
       <copy todir="${build.examples}">
         <fileset dir="${examples.src}/web"/>
       </copy>
  -    <copy file="${conf.src}/jdbc.tld" tofile="${dist.tld}"/>
  +    <copy file="${conf.src}/dbtags.tld" tofile="${dist.tld}"/>
       <copy file="${dist.tld}"
                 tofile="${build.examples}/WEB-INF/${taglib.name}.tld"/>
       <copy file="${dist.library}"
  @@ -164,7 +164,7 @@
   
     <!-- Compile the tag library itself -->
     <target name="library" depends="prepare">
  -    <copy file="${conf.src}/jdbc.tld"
  +    <copy file="${conf.src}/dbtags.tld"
                 tofile="${build.library}/META-INF/taglib.tld"/>
       <javac srcdir="${library.src}" destdir="${build.library}"
              classpath="${servlet.jar}:${jdbc-ext.jar}" debug="on"/>
  
  
  
  1.1                  jakarta-taglibs/jdbc/conf/dbtags.tld
  
  Index: dbtags.tld
  ===================================================================
  <?xml version="1.0" encoding="ISO-8859-1" ?>
  <!DOCTYPE taglib
    PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
    "http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">
  
  <!-- a tag library descriptor -->
  
  <taglib>
    <!-- after this the default space is
  	"http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd"
     -->
  
    <!-- The version number of this tag library -->
    <tlibversion>1.0</tlibversion>
  
    <!-- The JSP specification version required to function -->
    <jspversion>1.1</jspversion>
  
    <!-- The short name of this tag library -->
    <shortname>DBTags</shortname>
  
    <!-- Public URI that uniquely identifies this version of the tag library -->
    <uri>http://jakarta.apache.org/taglibs/dbtags</uri>
  
    <!-- General information about this tag library -->
    <info>
      The DBTags custom tag library contains tags that can retrieve data from 
      and insert data into databases.
    </info>
  
    <!-- ******************** Defined Custom Tags *************************** -->
  
  
    <!-- connection tags -->
  
    <tag>
      <name>connection</name>
      <tagclass>org.apache.taglibs.jdbc.connection.ConnectionTag</tagclass>
      <teiclass>org.apache.taglibs.jdbc.connection.ConnectionTEI</teiclass>
      <bodycontent>JSP</bodycontent>
      <info>Opens a connection based on either a url in the body of the tag 
      or by using the "datasource" tag attribute to reference to a 
      javax.sql.DataSource page attribute.  driver (optional),
      userid (optional), and password (optional) are also set in the
      body of the tag.</info>
      <attribute>
        <name>id</name>
        <required>true</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>jndiName</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>dataSource</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
    
    <tag>
      <name>url</name>
      <tagclass>org.apache.taglibs.jdbc.connection.DatabaseURLTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>Sets the database URL of the enclosing connection tag
  according to the initParameter, if specified, or from the body of
  the tag.</info>
      <attribute>
        <name>initParameter</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
  
    <tag>
      <name>driver</name>
      <tagclass>org.apache.taglibs.jdbc.connection.DriverTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>Sets the java.sql.Driver class name for the enclosing
  connection tag according to the initParameter, if specified, or the
  body of the tag.  The tag body will be trimmed.</info>
      <attribute>
        <name>initParameter</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
  
    <tag>
      <name>jndiName</name>
      <tagclass>org.apache.taglibs.jdbc.connection.JndiNameTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>Sets the jndi named javax.sql.DataSource for the enclosing
  connection tag according to the initParameter, if specified, or the
  body of the tag.  The tag body will be trimmed.</info>
      <attribute>
        <name>initParameter</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
  
    <tag>
      <name>userId</name>
      <tagclass>org.apache.taglibs.jdbc.connection.UserIdTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>JSP tag userid, sets the database user id for the
  enclosing connection tag.  This tag is optional if the user name has
  been encoded inside the database URL, or if the database does not
  require a user name.  The user name is read from the indicated
  initParameter, if the attribute is set, or from the body of the tag
  if it is not.  The tag body will be trimmed.</info>
      <attribute>
        <name>initParameter</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
    
    <tag>
      <name>password</name>
      <tagclass>org.apache.taglibs.jdbc.connection.PasswordTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>JSP tag password, sets the password for the
  enclosing connection tag.  This tag is optional if the password has
  been encoded inside the database URL, or if the database does not
  require a password.  The password is read from the indicated
  initParameter, if the parameter is set, or from the body of the tag
  if it is not.  The tag body will be trimmed.</info>
      <attribute>
        <name>initParameter</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
    
    <tag>
      <name>closeConnection</name>
      <tagclass>org.apache.taglibs.jdbc.connection.CloseConnectionTag</tagclass>
      <bodycontent>empty</bodycontent>
      <info>Close the specified connection.  The "conn" attribute is the name of a
  connection object in the page context.</info>
      <attribute>
        <name>conn</name>
        <required>true</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
  
  
    <!-- statement only tags -->
  
    <tag>
      <name>statement</name>
      <tagclass>org.apache.taglibs.jdbc.statement.StatementImplTag</tagclass>
      <teiclass>org.apache.taglibs.jdbc.statement.StatementTEI</teiclass>
      <bodycontent>JSP</bodycontent>
      <info>JSP tag statement, uses the enclosed query, resultset or
  execute tags to perform a database operation.</info>
      <attribute>
        <name>id</name>
        <required>true</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>conn</name>
        <required>true</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
    
    <tag>
      <name>escapeSql</name>
      <tagclass>org.apache.taglibs.jdbc.statement.EscapeSQLTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>Replaces each single quote in the tag body
  with a pair of single quotes.  Body content will not be trimmed.</info>
    </tag>
    
    <!-- statement and prepared statement tags -->
  
    <tag>
      <name>query</name>
      <tagclass>org.apache.taglibs.jdbc.statement.QueryTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>Sets the SQL query for the enclosing statement or
  preparedstatement tag.</info>
    </tag>
      
    <tag>
      <name>execute</name>
      <tagclass>org.apache.taglibs.jdbc.statement.ExecuteTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>Executes the query for the enclosing statement or
  preparedstatement tag.</info>
      <attribute>
        <name>ignoreErrors</name>
        <required>false</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
    </tag>
  
    <tag>
      <name>wasEmpty</name>
      <tagclass>org.apache.taglibs.jdbc.statement.WasEmptyTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>
        Executes its body if the last ResultSet tag received 0 rows
        from the database.  You must be after a ResultSet tag and inside
        a StatementTag or PreparedStatementTag, or an error will be generated.
      </info>
    </tag>
    
    <tag>
      <name>wasNotEmpty</name>
      <tagclass>org.apache.taglibs.jdbc.statement.WasNotEmptyTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>
        Executes its body if the last ResultSet tag received more than 0 rows
        from the database.  You must be after a ResultSet tag and inside
        a StatementTag or PreparedStatementTag, or an error will be generated.
      </info>
    </tag>
    
    <tag>
      <name>rowCount</name>
      <tagclass>org.apache.taglibs.jdbc.statement.RowCountTag</tagclass>
      <bodycontent>empty</bodycontent>
      <info>Prints out the number of rows retrieved from the database.
  It can be used inside a ResultSet tag to provide a running
  count of rows retreived, or after the ResultSet tag to
  display the total number.  Using the tag before the ResultSet
  or outside of a Statement or PreparedStatement will
  produce an error.</info>
    </tag>
    
    <!-- prepared statement only tags -->
    <tag>
      <name>preparedStatement</name>
      <tagclass>org.apache.taglibs.jdbc.preparedstatement.PreparedStatementImplTag</tagclass>
      <teiclass>org.apache.taglibs.jdbc.preparedstatement.PreparedStatementTEI</teiclass>
      <bodycontent>JSP</bodycontent>
      <info>JSP tag preparedstatement, used the enclosed query, 
      resultset/execute, and set* tags to perform a database operation.</info>
      <attribute>
        <name>id</name>
        <required>true</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>conn</name>
        <required>true</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
  
    <tag>
      <name>setColumn</name>
      <tagclass>org.apache.taglibs.jdbc.preparedstatement.SetColumnTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>Setter for the enclosing preparedstatement tag.  Set the String 
        inside the tag body.  Body content will
        not be trimmed.</info>
      <attribute>
        <name>position</name>
        <required>true</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
    
    <!-- resultset tags -->
    
    <tag>
      <name>resultSet</name>
      <tagclass>org.apache.taglibs.jdbc.resultset.ResultSetTag</tagclass>
      <teiclass>org.apache.taglibs.jdbc.resultset.ResultSetTEI</teiclass>
      <bodycontent>JSP</bodycontent>
      <info>JSP tag resulset, executes the query and loops through the results
  for the enclosing statement or preparedstatement tag.  The body of
  this tag is executed once per row in the resultset.  The optional
  "loop" attribute, which default to true, specifies whether to execute
  the tag body once per row "true", or to simply assign the ResultSet
  to the page attribute specified by "id".</info>
      <attribute>
        <name>id</name>
        <required>true</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>loop</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
  
    <tag> 
      <name>wasNull</name>
      <tagclass>org.apache.taglibs.jdbc.resultset.WasNullTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>Executes its body if the last getColumn tag received a null value
  from the database.  You must be inside a resultset tag and there must
  be a previous getColumn tag, or an error will be generated.</info>
    </tag>
    
    <tag> 
      <name>wasNotNull</name>
      <tagclass>org.apache.taglibs.jdbc.resultset.WasNotNullTag</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>Executes its body if the last getColumn tag did not receive a null value
  from the database.  You must be inside a resultset tag and there must
  be a previous getColumn tag, or an error will be generated.</info>
    </tag>
    
    <tag>
      <name>getColumn</name>
      <tagclass>org.apache.taglibs.jdbc.resultset.GetColumnTag</tagclass>
      <teiclass>org.apache.taglibs.jdbc.resultset.BaseGetterTEI</teiclass>
      <bodycontent>empty</bodycontent>
      <info>Gets the value, as a String, of a coulmn in the enclosing
  resultset.  Either set the column number via the "position" attribute,
  or set the column name with the "colName" attribute.
  You can optionally set the value, as a String, to a serlvet attribute 
  instead of the tag body with the "to" attribute.  The scope of the servlet
  attribute is specified by the "scope" XML attribute (default = page).  Dates,
  times, timestamps and numbers are output according to the JVM's defaults.</info>
      <attribute>
        <name>position</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>colName</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>to</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>scope</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
    </tag>
  
    <tag>
      <name>getNumber</name>
      <tagclass>org.apache.taglibs.jdbc.resultset.GetNumberTag</tagclass>
      <teiclass>org.apache.taglibs.jdbc.resultset.BaseGetterTEI</teiclass>
      <bodycontent>empty</bodycontent>
      <info>
      Similar to getColumn, but provides more precise control over
      number formatting.  
      
      The "format" attribute can be either a pattern as
      accepted by the DecimalFormat constructor or a style: "CURRENCY", 
      "PERCENT" or "NUMBER".  
      
      The "locale" attribute can have one to three 
      components as accepted by the Locale constructor: language,
      country and variant. They are separated by "_".
      
      If neither the format nor locale attribute is set, output should be
      identical to getColumn.
      </info>
      <attribute>
        <name>position</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>colName</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>to</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>scope</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>locale</name>
        <required>false</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
      <attribute>
        <name>format</name>
        <required>false</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
    </tag>
    
    <tag>
      <name>getTime</name>
      <tagclass>org.apache.taglibs.jdbc.resultset.GetTimeTag</tagclass>
      <teiclass>org.apache.taglibs.jdbc.resultset.BaseGetterTEI</teiclass>
      <bodycontent>empty</bodycontent>
      <info>
      Similar to getColumn, but provides more precise control over
      java.sql.Time formatting.  
      
      The "format" attribute can be either a pattern as
      accepted by SimpleDateFormat or a style: "FULL",
      "LONG", "MEDIUM" or "SHORT".  
      
      The "locale" attribute can have one to three 
      components as accepted by the Locale constructor: language,
      country and variant. They are separated by "_".
      
      If neither the format nor locale attribute is set, output should be
      identical to getColumn.
      </info>
      <attribute>
        <name>position</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>colName</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>to</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>scope</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>locale</name>
        <required>false</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
      <attribute>
        <name>format</name>
        <required>false</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
    </tag>
  
    <tag>
      <name>getDate</name>
      <tagclass>org.apache.taglibs.jdbc.resultset.GetDateTag</tagclass>
      <teiclass>org.apache.taglibs.jdbc.resultset.BaseGetterTEI</teiclass>
      <bodycontent>empty</bodycontent>
      <info>
      Similar to getColumn, but provides more precise control over
      java.sql.Date formatting.  
      
      The "format" attribute can be either a pattern as
      accepted by SimpleDateFormat or a style: "FULL",
      "LONG", "MEDIUM" or "SHORT".  
      
      The "locale" attribute can have one to three 
      components as accepted by the Locale constructor: language,
      country and variant. They are separated by "_".
      
      If neither the format nor locale attribute is set, output should be
      identical to getColumn.
      </info>
      <attribute>
        <name>position</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>colName</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>to</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>scope</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>locale</name>
        <required>false</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
      <attribute>
        <name>format</name>
        <required>false</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
    </tag>
  
    <tag>
      <name>getTimestamp</name>
      <tagclass>org.apache.taglibs.jdbc.resultset.GetTimestampTag</tagclass>
      <teiclass>org.apache.taglibs.jdbc.resultset.BaseGetterTEI</teiclass>
      <bodycontent>empty</bodycontent>
      <info>
      Similar to getColumn, but provides more precise control over
      java.sql.Timestamp formatting.  
      
      The required "format" attribute can be either a pattern as
      accepted by SimpleDateFormat or a style: "FULL",
      "LONG", "MEDIUM" or "SHORT".  It can also can be a comma separated 
      list of two styles, one for date and one for time.
      
      The "locale" attribute can have one to three 
      components as accepted by the Locale constructor: language,
      country and variant. They are separated by "_".
      </info>
      <attribute>
        <name>position</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>colName</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>to</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>scope</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
      </attribute>
      <attribute>
        <name>locale</name>
        <required>false</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
      <attribute>
        <name>format</name>
        <required>false</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
    </tag>
    
  </taglib>
  
  
  
  
  1.2       +1 -1      jakarta-taglibs/jdbc/doc/conf/web.xml
  
  Index: web.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/jdbc/doc/conf/web.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- web.xml	2001/01/08 21:16:09	1.1
  +++ web.xml	2001/05/03 15:41:45	1.2
  @@ -7,7 +7,7 @@
   <web-app>
   
     <description>
  -  Documentation for the "jdbc" custom tag library,
  +  Documentation for the "DBTags" custom tag library,
     from the JAKARTA-TAGLIBS project.
     </description>
   
  
  
  
  1.2       +5 -2      jakarta-taglibs/jdbc/doc/web/changes.html
  
  Index: changes.html
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/jdbc/doc/web/changes.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- changes.html	2001/01/08 21:16:32	1.1
  +++ changes.html	2001/05/03 15:41:52	1.2
  @@ -1,12 +1,15 @@
   <HTML>
   
   <HEAD>
  - <TITLE>Jakarta Project: JDBC JSP Tag Library Revision History</TITLE>
  + <TITLE>Jakarta Project: DBTags JSP Tag Library Revision History</TITLE>
   </HEAD>
   
   <BODY BGCOLOR="white">
   <CENTER>
  -<H1>Jakarta Project: JDBC JSP Tag Library Revision History</H1>
  +<H1>Jakarta Project: DBTags JSP Tag Library Revision History</H1>
  +
  +<B>05/01/2001 - Changed Tag Library Name from JDBC to DBTags</B>
  +
   </CENTER>
   </BODY>
   </HTML>
  
  
  
  1.9       +13 -13    jakarta-taglibs/jdbc/doc/web/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/jdbc/doc/web/index.html,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- index.html	2001/03/06 21:19:30	1.8
  +++ index.html	2001/05/03 15:41:54	1.9
  @@ -1,12 +1,12 @@
   <HTML>
   
   <HEAD>
  - <TITLE>Jakarta Project: JDBC JSP Tag Library</TITLE>
  + <TITLE>Jakarta Project: DBTags JSP Tag Library</TITLE>
   </HEAD>
   
   <BODY BGCOLOR="white">
   <CENTER>
  -<H1>Jakarta Project: JDBC JSP Tag Library</H1>
  +<H1>Jakarta Project: DBTags JSP Tag Library</H1>
   <h2>Version 1.0</h2>
   </CENTER>
   
  @@ -33,13 +33,13 @@
   </UL>
   
   <A NAME="overview"><h1>Overview</h1></A>
  -<P>The JDBC custom tag library contains tags which can be used to
  +<P>The DBTags custom tag library contains tags which can be used to
   read to and write from a SQL database.</P>
   
   <A NAME="overview.usage"><h2>Simple Usage Example</h2></A>
   <P>Here is a JSP page that prints out the names of books in a table:</P>
   
  -<pre>&lt;%@ taglib uri="http://jakarta.apache.org/taglibs/jdbc" prefix="sql" %>
  +<pre>&lt;%@ taglib uri="http://jakarta.apache.org/taglibs/dbtags" prefix="sql" %>
   
   &lt;%-- open a database connection --%>
   &lt;sql:connection id="conn1">
  @@ -71,7 +71,7 @@
         
   <A NAME="overview.tags"><h2>Tags in Detail</h2></A>      
   
  -<p>Here are general descriptions of the tags included in the JDBC tag library.  Some 
  +<p>Here are general descriptions of the tags included in the DBTags tag library.  Some 
   details, such as the possible properties of the connection, statement, resultSet, and 
   preparedStatement tags, are not covered here.  An enumeration of all the configurable 
   aspects of these tags is in the <a href="#reference">Tag Reference</a> section.
  @@ -401,9 +401,9 @@
   Weblogic users.  Sample source code for such a tag can be 
   found <a href="GetPropertyTag.java">here</a>.</P>
   
  -<p><i>JDBC requirements</i></p>
  +<p><i>DBTags requirements</i></p>
   
  -<p>The JDBC tag library supports the use of DataSource objects, which are 
  +<p>The DBTags tag library supports the use of DataSource objects, which are 
   not part of the Java 2 Standard Edition.  In order to use DataSources, 
   either use Java 2 Enterprise Edition, or download the Optional API for 
   JDBC 2.0.
  @@ -411,17 +411,17 @@
   <A NAME="config"><h1>Configuration</h1></A>
   <P>Follow these steps to configure your web application with this tag library:</P>
   <UL>
  -<LI>Copy the tag library descriptor file (jdbc/jdbc.tld) to the /WEB-INF
  +<LI>Copy the tag library descriptor file (dbtags.tld) to the /WEB-INF
   subdirectory of your web application.</LI>
  -<LI>Copy the tag library JAR file (jdbc/jdbc.jar) to the /WEB-INF/lib
  +<LI>Copy the tag library JAR file (dbtags.jar) to the /WEB-INF/lib
   subdirectory of your web application.</LI>
   <LI>Add a &lt;taglib&gt; element to your web application deployment 
   descriptor in /WEB-INF/web.xml like this:<BR>
   <BR>
   <PRE>
   &lt;taglib&gt;
  -  &lt;taglib-uri&gt;http://jakarta.apache.org/taglibs/jdbc&lt;/taglib-uri&gt;
  -  &lt;taglib-location&gt;/WEB-INF/jdbc.tld&lt;/taglib-location&gt;
  +  &lt;taglib-uri&gt;http://jakarta.apache.org/taglibs/dbtags&lt;/taglib-uri&gt;
  +  &lt;taglib-location&gt;/WEB-INF/dbtags.tld&lt;/taglib-location&gt;
   &lt;/taglib&gt;
   </PRE>
   </LI>
  @@ -429,7 +429,7 @@
   <P>To use the tags from this library in your JSP pages, add the following
   directive at the top of each page: </P>
   <PRE>
  -&lt;%@ taglib uri=&quot;http://jakarta.apache.org/taglibs/jdbc&quot; prefix=&quot;sql&quot; %&gt;
  +&lt;%@ taglib uri=&quot;http://jakarta.apache.org/taglibs/dbtags&quot; prefix=&quot;sql&quot; %&gt;
   </PRE>
   <P>where &quot;<I>sql</I>&quot; is the tag name prefix you wish to use for
   tags from this library. You can change this value to any prefix you like.
  @@ -2744,7 +2744,7 @@
   </TABLE>
   
   <A NAME="examples"><h1>Examples</h1></A>
  -<P>See the example application jdbc-examples.war for examples of the usage
  +<P>See the example application dbtags-examples.war for examples of the usage
   of the tags from this custom tag library.</P>
    
   <A NAME="javadocs"><h1>Java Docs</h1></A>
  
  
  
  1.5       +27 -12    jakarta-taglibs/jdbc/doc/web/intro.xml
  
  Index: intro.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/jdbc/doc/web/intro.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- intro.xml	2001/03/15 21:13:03	1.4
  +++ intro.xml	2001/05/03 15:41:56	1.5
  @@ -1,4 +1,6 @@
   <?xml version="1.0"?>
  +<!DOCTYPE personnel SYSTEM "../../../src/doc/taglibs_docs.dtd">
  +
   <document url="./intro.xml">
   
     <properties>
  @@ -9,46 +11,59 @@
     <body>
   
   
  -  <section name="JDBC Tag Library" href="Welcome">
  +  <section name="DBTags Tag Library" href="Welcome">
   
  -  <p>The JDBC custom tag library contains tags which can be used to
  +  <p>The DBTags custom tag library contains tags which can be used to
     read from and write to an SQL database.</p>
   
     </section>
   
  +  <section name="DBTags News" href="News">
  +    <news>
  +      <newsitem date="05/02/2001">
  +        The JDBC tag library has been renamed to DBTags!  The JAR and
  +        TLD files now have different names, but the functionality
  +        is identical.  You may continue to use the old URI to avoid
  +        changes to your JSPs.
  +      </newsitem>
  +    </news>
  +  </section>
  +
     <section name="Documentation" href="Documentation">
   
  -  <p>For more information about the Jdbc Tag Library, look at the on-line documentation:</p>
  +  <p>For more information about the DBTags Tag Library, look at the on-line documentation:
     <ul>
  -  <li>View the <a href="http://jakarta.apache.org/taglibs/doc/jdbc-doc/index.html">JDBC Taglib Documentation</a></li>
  +  <li>View the <a href="http://jakarta.apache.org/taglibs/doc/dbtags-doc/index.html">DBTags Taglib Documentation</a></li>
     </ul>
  +  </p>
   
  -  <p>For information on how to use the distributions, look at the following documentation:</p>
  -
  +  <p>For information on how to use the distributions, look at the following documentation:
     <ul>
     <li>Using the Jakarta-Taglibs <a href="http://jakarta.apache.org/taglibs/binarydist.html">Binary Distribution</a></li>
     <li>Using the Jakarta-Taglibs <a href="http://jakarta.apache.org/taglibs/sourcedist.html">Source Distribution</a></li>
     </ul>
  +</p>
   
     </section>
   
     <section name="Download" href="Download">
   
  -  <p>A binary download of the JDBC Tag Library is available</p>
  +  <p>A binary download of the DBTags Tag Library is available:
     <ul>
  -  <li><strong>Download <a href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/jdbc/">JDBC Tag Library</a></strong></li>
  +  <li><strong>Download <a href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/dbtags/">DBTags Tag Library</a></strong></li>
     </ul>
  -
  -  <p>The following distributions are also available for download:</p>
  +</p>
  +  <p>The following distributions are also available for download:
     <ul>
     <li>Download <a href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/src/">Jakarta-Taglibs Source</a></li>
     <li>Download entire <a href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly">Jakarta-Taglibs Distribution</a></li>
     </ul>
  +</p>
   
     </section>
   
     <section name="Contributors" href="Contributors">
  -  <p>List of contributors:</p>
  +  <p>List of contributors:
   
     <ul>
     <li>Rich Catlett</li>
  @@ -56,7 +71,7 @@
     <li>Glenn Nielsen</li>
     <li>Marius Scurtescu</li>
     </ul>
  -
  +</p>
     </section>
   
     </body>
  
  
  
  1.2       +3 -3      jakarta-taglibs/jdbc/examples/conf/web.xml
  
  Index: web.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/jdbc/examples/conf/web.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- web.xml	2001/01/08 21:16:38	1.1
  +++ web.xml	2001/05/03 15:42:04	1.2
  @@ -8,11 +8,11 @@
   
     <description>
     Example web application illustrating the use of tags in the
  -  "page" custom tag library, from the JAKARTA-TAGLIBS project.
  +  DBTags custom tag library, from the JAKARTA-TAGLIBS project.
     </description>
     <taglib>
  -    <taglib-uri>http://jakarta.apache.org/taglibs/jdbc</taglib-uri>
  -    <taglib-location>/WEB-INF/jdbc.tld</taglib-location>
  +    <taglib-uri>http://jakarta.apache.org/taglibs/dbtags</taglib-uri>
  +    <taglib-location>/WEB-INF/dbtags.tld</taglib-location>
     </taglib>
     <security-role>
       <role-name>admin</role-name>
  
  
  
  1.4       +3 -3      jakarta-taglibs/jdbc/examples/web/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/jdbc/examples/web/index.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- index.html	2001/03/04 18:58:54	1.3
  +++ index.html	2001/05/03 15:42:10	1.4
  @@ -1,9 +1,9 @@
   <html>
   <head>
  -<title>Examples of JDBC Tag Library Tag Usage</title>
  +<title>Examples of DBTags Tag Library Tag Usage</title>
   </head>
   <body bgcolor="white">
  -<h1>Testing the JDBC tags Library</h1>
  +<h1>Testing the DBTags tags Library</h1>
   
   <P>1. Setting up the sample table</P>
   
  @@ -12,7 +12,7 @@
   
   <P>2. Launch the test page</P>
   
  -<P>Enter your database URL and driver name and hit "submit" to test the JDBC tags.</P>
  +<P>Enter your database URL and driver name and hit "submit" to test DBTags.</P>
   
   <form name="form1" action="jdbc.jsp" method="get" >
     <table width="90%" border="0" cellspacing="0" cellpadding="0">
  
  
  
  1.7       +1 -1      jakarta-taglibs/jdbc/examples/web/jdbc.jsp
  
  Index: jdbc.jsp
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/jdbc/examples/web/jdbc.jsp,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- jdbc.jsp	2001/03/20 18:12:27	1.6
  +++ jdbc.jsp	2001/05/03 15:42:11	1.7
  @@ -1,4 +1,4 @@
  -<%@ taglib uri="http://jakarta.apache.org/taglibs/jdbc" prefix="sql" %>
  +<%@ taglib uri="http://jakarta.apache.org/taglibs/dbtags" prefix="sql" %>
   
   <P><B>Opening connection</B></P>
   
  
  
  
  1.3       +1 -1      jakarta-taglibs/jdbc/examples/web/jndijdbc.jsp
  
  Index: jndijdbc.jsp
  ===================================================================
  RCS file: /home/cvs/jakarta-taglibs/jdbc/examples/web/jndijdbc.jsp,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- jndijdbc.jsp	2001/03/06 21:19:32	1.2
  +++ jndijdbc.jsp	2001/05/03 15:42:12	1.3
  @@ -1,4 +1,4 @@
  -<%@ taglib uri="http://jakarta.apache.org/taglibs/jdbc" prefix="sql" %>
  +<%@ taglib uri="http://jakarta.apache.org/taglibs/dbtags" prefix="sql" %>
   
   <P><B>Opening connection</B></P>