View Javadoc
1   /*
2    * Redistribution and use of this software and associated documentation
3    * ("Software"), with or without modification, are permitted provided
4    * that the following conditions are met:
5    *
6    * 1. Redistributions of source code must retain copyright
7    *    statements and notices.  Redistributions must also contain a
8    *    copy of this document.
9    *
10   * 2. Redistributions in binary form must reproduce the
11   *    above copyright notice, this list of conditions and the
12   *    following disclaimer in the documentation and/or other
13   *    materials provided with the distribution.
14   *
15   * 3. The name "Exolab" must not be used to endorse or promote
16   *    products derived from this Software without prior written
17   *    permission of Intalio, Inc.  For written permission,
18   *    please contact info@exolab.org.
19   *
20   * 4. Products derived from this Software may not be called "Exolab"
21   *    nor may "Exolab" appear in their names without prior written
22   *    permission of Intalio, Inc. Exolab is a registered
23   *    trademark of Intalio, Inc.
24   *
25   * 5. Due credit should be given to the Exolab Project
26   *    (http://www.exolab.org/).
27   *
28   * THIS SOFTWARE IS PROVIDED BY INTALIO, INC. AND CONTRIBUTORS
29   * ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT
30   * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
31   * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL
32   * INTALIO, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
33   * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
34   * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
35   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
36   * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
37   * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
38   * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
39   * OF THE POSSIBILITY OF SUCH DAMAGE.
40   *
41   * Copyright 1999 (C) Intalio, Inc. All Rights Reserved.
42   *
43   * $Id$
44   */
45  package org.exolab.castor.builder.util;
46  
47  import java.util.Enumeration;
48  import java.util.Hashtable;
49  
50  import org.exolab.castor.builder.ClassInfoResolver;
51  import org.exolab.castor.builder.info.ClassInfo;
52  
53  /**
54   * A class for "caching" ClassInfo's which later need to be resolved
55   * (retrieved).
56   *
57   * @author <a href="mailto:kvisco@intalio.com">Keith Visco</a>
58   * @version $Revision$ $Date: 2003-03-03 00:05:44 -0700 (Mon, 03 Mar 2003) $
59   */
60  public class ClassInfoResolverImpl implements ClassInfoResolver {
61      /** ClassInfo cache. */
62      private Hashtable<Object, ClassInfo> _cache = null;
63  
64      /**
65       * Default constructor.
66       */
67      public ClassInfoResolverImpl() {
68          _cache = new Hashtable<Object, ClassInfo>();
69      }
70  
71      /**
72       * Adds the given Reference to this ClassInfo resolver.
73       *
74       * @param key the key to bind a reference to.
75       * @param classInfo the ClassInfo which is being referenced.
76       */
77      public final void bindReference(final Object key, final ClassInfo classInfo) {
78          if (key == null) {
79              String err = "null passed as argument to ClassInfoResolver#bindReference";
80              throw new NullPointerException(err);
81          }
82          _cache.put(key, classInfo);
83      }
84  
85      /**
86       * Returns all the keys used for binding ClassInfo objects.
87       *
88       * @return an Enumeration over the keys using for binding ClassInfo objects.
89       */
90      public final Enumeration<?> keys() {
91          return _cache.keys();
92      }
93  
94      /**
95       * Returns the ClassInfo which has been bound to the given key.
96       *
97       * @param key the object to which the ClassInfo has been bound.
98       * @return the ClassInfo which has been bound to the given key.
99       */
100     public final ClassInfo resolve(final Object key) {
101         return _cache.get(key);
102     }
103 
104 }