KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > xmldb > xupdate > lexus > commands > TempTree


1 package org.xmldb.xupdate.lexus.commands;
2
3 /*
4  * The XML:DB Initiative Software License, Version 1.0
5  *
6  *
7  * Copyright (c) 2000-2003 The XML:DB Initiative. All rights
8  * reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  *
14  * 1. Redistributions of source code must retain the above copyright
15  * notice, this list of conditions and the following disclaimer.
16  *
17  * 2. Redistributions in binary form must reproduce the above copyright
18  * notice, this list of conditions and the following disclaimer in
19  * the documentation and/or other materials provided with the
20  * distribution.
21  *
22  * 3. The end-user documentation included with the redistribution,
23  * if any, must include the following acknowledgment:
24  * "This product includes software developed by the
25  * XML:DB Initiative (http://www.xmldb.org/)."
26  * Alternately, this acknowledgment may appear in the software itself,
27  * if and wherever such third-party acknowledgments normally appear.
28  *
29  * 4. The name "XML:DB Initiative" must not be used to endorse or
30  * promote products derived from this software without prior written
31  * permission. For written permission, please contact info@xmldb.org.
32  *
33  * 5. Products derived from this software may not be called "XML:DB",
34  * nor may "XML:DB" appear in their name, without prior written
35  * permission of the XML:DB Initiative.
36  *
37  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
38  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
39  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
40  * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
41  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
42  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
43  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
44  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
45  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
46  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
47  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
48  * SUCH DAMAGE.
49  * ====================================================================
50  *
51  * This software consists of voluntary contributions made by many
52  * individuals on behalf of the XML:DB Initiative. For more information
53  * on the XML:DB Initiative, please see <http://www.xmldb.org/>.
54  */
55
56 import org.w3c.dom.NodeList JavaDoc;
57
58 import java.util.Hashtable JavaDoc;
59
60 /**
61  * This class temporary stores variables with their name and selected
62  * nodes.
63  *
64  * @version $Id: TempTree.java,v 1.5 2003/05/21 08:17:38 jbreedveld Exp $
65  * @author <a HREF="http://www.smb-tec.com">SMB</a>
66  */
67 public class TempTree extends Object JavaDoc {
68
69   /* Contains variable names and values. */
70   protected Hashtable JavaDoc variables = null;
71
72
73   /**
74    * Add a new variable to the Hashtable. Existing variables will be
75    * overwritten.
76    * @param name the name of the variable.
77    * @param tree the selected nodes.
78    */
79   public void addVariable(String JavaDoc name, NodeList JavaDoc tree) {
80     if (name == null) {
81       throw new IllegalArgumentException JavaDoc("variable name must not be null !");
82     }
83     if (tree == null) {
84       throw new IllegalArgumentException JavaDoc("variable value must not be null !");
85     }
86     variables.put(name, tree);
87   }
88
89
90   /**
91    * Returns the selection for the given variable name.
92    * @return the selected nodes.
93    * @throws Exception if there is no such variable.
94    * @throws IllegalArgumentException if the variable name is null.
95    */
96   public NodeList JavaDoc getTreeForName(String JavaDoc name) throws Exception JavaDoc {
97     if (name == null) {
98       throw new IllegalArgumentException JavaDoc("variable-name must not be null !");
99     }
100
101     NodeList JavaDoc result = (NodeList JavaDoc) variables.get(name);
102     if (result == null) {
103       throw new Exception JavaDoc("no variable named " + name + " found !");
104     }
105
106     return result;
107   }
108
109
110   /**
111    *
112    */
113   public TempTree() {
114     variables = new Hashtable JavaDoc();
115   }
116 }
117
118
Popular Tags