1 /*
2 * Copyright 2001-2004 (C) MetaStuff, Ltd. All Rights Reserved.
3 *
4 * This software is open source.
5 * See the bottom of this file for the licence.
6 *
7 * $Id: UserDataDocumentFactory.java,v 1.9 2004/06/25 08:03:41 maartenc Exp $
8 */
9
10 package org.dom4j.util;
11
12 import org.dom4j.Attribute;
13 import org.dom4j.DocumentFactory;
14 import org.dom4j.Element;
15 import org.dom4j.QName;
16
17 /*** <p><code>UserDataDocumentFactory</code> is a factory of XML objects which
18 * support the adornment of a user data object on an Element or Attribute
19 * instance such that the methods <code>getData()</code> and
20 * <code>setData()</code> will get and set the values of a user data object.
21 * This can be useful for developers wishing to create XML trees and
22 * adorn the trees with user defined objects.</p>
23 *
24 * @author <a href="mailto:jstrachan@apache.org">James Strachan</a>
25 * @version $Revision: 1.9 $
26 */
27 public class UserDataDocumentFactory extends DocumentFactory {
28
29 /*** The Singleton instance */
30 static transient UserDataDocumentFactory singleton = new UserDataDocumentFactory();
31
32
33 /*** <p>Access to the singleton instance of this factory.</p>
34 *
35 * @return the default singleon instance
36 */
37 public static DocumentFactory getInstance() {
38 return singleton;
39 }
40
41
42 // DocumentFactory methods
43 //-------------------------------------------------------------------------
44
45 public Element createElement(QName qname) {
46 return new UserDataElement(qname);
47 }
48
49 public Attribute createAttribute(Element owner, QName qname, String value) {
50 return new UserDataAttribute(qname, value);
51 }
52
53 }
54
55
56
57
58 /*
59 * Redistribution and use of this software and associated documentation
60 * ("Software"), with or without modification, are permitted provided
61 * that the following conditions are met:
62 *
63 * 1. Redistributions of source code must retain copyright
64 * statements and notices. Redistributions must also contain a
65 * copy of this document.
66 *
67 * 2. Redistributions in binary form must reproduce the
68 * above copyright notice, this list of conditions and the
69 * following disclaimer in the documentation and/or other
70 * materials provided with the distribution.
71 *
72 * 3. The name "DOM4J" must not be used to endorse or promote
73 * products derived from this Software without prior written
74 * permission of MetaStuff, Ltd. For written permission,
75 * please contact dom4j-info@metastuff.com.
76 *
77 * 4. Products derived from this Software may not be called "DOM4J"
78 * nor may "DOM4J" appear in their names without prior written
79 * permission of MetaStuff, Ltd. DOM4J is a registered
80 * trademark of MetaStuff, Ltd.
81 *
82 * 5. Due credit should be given to the DOM4J Project -
83 * http://www.dom4j.org
84 *
85 * THIS SOFTWARE IS PROVIDED BY METASTUFF, LTD. AND CONTRIBUTORS
86 * ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT
87 * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
88 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
89 * METASTUFF, LTD. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
90 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
91 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
92 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
93 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
94 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
95 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
96 * OF THE POSSIBILITY OF SUCH DAMAGE.
97 *
98 * Copyright 2001-2004 (C) MetaStuff, Ltd. All Rights Reserved.
99 *
100 * $Id: UserDataDocumentFactory.java,v 1.9 2004/06/25 08:03:41 maartenc Exp $
101 */