Programming WebLogic JSP Tag Extensions

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Administration and Configuration

The following sections provide an overview of administration and configuration tasks for using JSP tag extensions:

 


Configuring JSP Tag Libraries

The following steps describe how to configure a JSP tag library. You can also package a tag library as a jar file (see Packaging a JSP Tag Library as JAR File).

  1. Create a tag library descriptor (TLD).
  2. For more information, see Creating a Tag Library Descriptor.

  3. Reference this TLD in the Web application deployment descriptor, web.xml. For example:
  4. <taglib>
      <taglib-uri>myTLD</taglib-uri>
    <taglib-location>WEB-INF/library.tld</taglib-location>
    </taglib>

    In this example the tag library descriptor is a file called library.tld. Always specify the location of the tld relative to the root of the Web application.

  5. Place the tag library descriptor file in the WEB-INF directory of the Web application.
  6. Reference the tag library in the JSP page.
  7. In your JSP, reference the tag library with a JSP directive. For example:

    <%@ taglib uri="myTLD" prefix="mytaglib" %>
  8. Place the tag handler Java class files for your tags in the WEB-INF/classes directory of your Web application.
  9. Deploy the Web application on WebLogic Server. For more information, see “Deploying and Packaging from a Split Development Directory” in Developing WebLogic Server Applications.

 


Packaging a JSP Tag Library as JAR File

In addition to the procedure described in the previous section Configuring JSP Tag Libraries, you can also package a JSP tag library as a jar file:

  1. Create a TLD (tag library descriptor) file named taglib.tld.
  2. For more information, see Creating a Tag Library Descriptor.

  3. Create a directory containing the compiled Java tag handler class files used in your tag library.
  4. Create a subdirectory of the directory you created in step 2 and call it META-INF.
  5. Copy the taglib.tld file you created in step 1 into the META-INF directory you created in step 3
  6. Archive your compiled Java class files into a jar file by executing the following command from the directory you created in step 2
  7. jar cv0f myTagLibrary.jar

    (where myTagLibrary.jar is a name you provide)

  8. Copy the jar file into the WEB-INF/lib directory of the Web application that uses your tag library.
  9. Reference this tag library descriptor in the Web application deployment descriptor, web.xml. For example:
  10. <taglib>
      <taglib-uri>myjar.tld</taglib-uri>
      <taglib-location>
         /WEB-INF/lib/myTagLibrary.jar
      </taglib-location>
    </taglib>
  11. Reference the tag library in your JSP. For example:
  12. <%@ taglib uri="myjar.tld" prefix="wl" %>

  Back to Top       Previous  Next