1 /*
2 * $Header: /home/cvs/jakarta-commons-sandbox/jelly/src/java/org/apache/commons/jelly/tags/define/TaglibTag.java,v 1.8 2002/08/09 17:26:40 jstrachan Exp $
3 * $Revision: 1.8 $
4 * $Date: 2002/08/09 17:26:40 $
5 *
6 * ====================================================================
7 *
8 * The Apache Software License, Version 1.1
9 *
10 * Copyright (c) 1999-2002 The Apache Software Foundation. All rights
11 * reserved.
12 *
13 * Redistribution and use in source and binary forms, with or without
14 * modification, are permitted provided that the following conditions
15 * are met:
16 *
17 * 1. Redistributions of source code must retain the above copyright
18 * notice, this list of conditions and the following disclaimer.
19 *
20 * 2. Redistributions in binary form must reproduce the above copyright
21 * notice, this list of conditions and the following disclaimer in
22 * the documentation and/or other materials provided with the
23 * distribution.
24 *
25 * 3. The end-user documentation included with the redistribution, if
26 * any, must include the following acknowlegement:
27 * "This product includes software developed by the
28 * Apache Software Foundation (http://www.apache.org/)."
29 * Alternately, this acknowlegement may appear in the software itself,
30 * if and wherever such third-party acknowlegements normally appear.
31 *
32 * 4. The names "The Jakarta Project", "Commons", and "Apache Software
33 * Foundation" must not be used to endorse or promote products derived
34 * from this software without prior written permission. For written
35 * permission, please contact apache@apache.org.
36 *
37 * 5. Products derived from this software may not be called "Apache"
38 * nor may "Apache" appear in their names without prior written
39 * permission of the Apache Group.
40 *
41 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
42 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
43 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
44 * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
45 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
46 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
47 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
48 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
49 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
50 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
51 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
52 * SUCH DAMAGE.
53 * ====================================================================
54 *
55 * This software consists of voluntary contributions made by many
56 * individuals on behalf of the Apache Software Foundation. For more
57 * information on the Apache Software Foundation, please see
58 * <http://www.apache.org/>.
59 *
60 * $Id: TaglibTag.java,v 1.8 2002/08/09 17:26:40 jstrachan Exp $
61 */
62 package org.apache.commons.jelly.tags.define;
63
64 import org.apache.commons.jelly.JellyContext;
65 import org.apache.commons.jelly.DynaTag;
66 import org.apache.commons.jelly.TagLibrary;
67 import org.apache.commons.jelly.TagSupport;
68 import org.apache.commons.jelly.XMLOutput;
69 import org.apache.commons.jelly.impl.DynamicTagLibrary;
70
71 import org.xml.sax.Attributes;
72 import org.xml.sax.helpers.AttributesImpl;
73
74 /***
75 * The <taglib> tag is used to define a new tag library
76 * using a Jelly script..</p>
77 *
78 * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
79 * @version $Revision: 1.8 $
80 */
81 public class TaglibTag extends TagSupport {
82
83 /*** The namespace URI */
84 private String uri;
85 /*** The new tags being added */
86 private DynamicTagLibrary tagLibrary;
87 /*** Whether or not inheritence is enabled */
88 private boolean inherit = true;
89
90 public TaglibTag() {
91 }
92
93 public TaglibTag(String uri) {
94 this.uri = uri;
95 }
96
97 // Tag interface
98 //-------------------------------------------------------------------------
99 public void doTag(XMLOutput output) throws Exception {
100 String uri = getUri();
101 tagLibrary = new DynamicTagLibrary( uri );
102
103 // inherit tags from an existing tag library
104 if ( isInherit() ) {
105 tagLibrary.setParent( context.getTagLibrary( uri ) );
106 }
107 context.registerTagLibrary( uri, tagLibrary );
108
109 invokeBody(output);
110
111 tagLibrary = null;
112 }
113
114 // Properties
115 //-------------------------------------------------------------------------
116 public String getUri() {
117 return uri;
118 }
119
120 /***
121 * Sets the namespace URI to register this new dynamic tag library with
122 */
123 public void setUri(String uri) {
124 this.uri = uri;
125 }
126
127 public DynamicTagLibrary getTagLibrary() {
128 return tagLibrary;
129 }
130
131 /***
132 * Returns the inherit.
133 * @return boolean
134 */
135 public boolean isInherit() {
136 return inherit;
137 }
138
139 /***
140 * Sets whether this dynamic tag should inherit from the current existing tag library
141 * of the same URI. This feature is enabled by default so that tags can easily be
142 * some tags can be overridden in an existing library, such as when making Mock Tags.
143 *
144 * You can disable this option if you want to disable any tags in the base library,
145 * turning them into just normal static XML.
146 *
147 * @param inherit The inherit to set
148 */
149 public void setInherit(boolean inherit) {
150 this.inherit = inherit;
151 }
152
153 }
This page was automatically generated by Maven