01: /*
02: Copyright (c) 2002,2003, Dennis M. Sosnoski.
03: All rights reserved.
04:
05: Redistribution and use in source and binary forms, with or without modification,
06: are permitted provided that the following conditions are met:
07:
08: * Redistributions of source code must retain the above copyright notice, this
09: list of conditions and the following disclaimer.
10: * Redistributions in binary form must reproduce the above copyright notice,
11: this list of conditions and the following disclaimer in the documentation
12: and/or other materials provided with the distribution.
13: * Neither the name of JiBX nor the names of its contributors may be used
14: to endorse or promote products derived from this software without specific
15: prior written permission.
16:
17: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
18: ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19: WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20: DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
21: ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22: (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23: LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
24: ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
26: SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27: */
28:
29: package org.jibx.runtime.impl;
30:
31: import java.util.ArrayList;
32:
33: /**
34: * Holder used to collect forward references to a particular object. The
35: * references are processed when the object is defined.
36: *
37: * @author Dennis M. Sosnoski
38: * @version 1.0
39: */
40:
41: public class BackFillHolder {
42: /** Expected class name of tracked object. */
43: private String m_class;
44:
45: /** List of references to this object. */
46: private ArrayList m_list;
47:
48: /**
49: * Constructor. Just creates the backing list.
50: *
51: * @param name expected class name of tracked object
52: */
53:
54: public BackFillHolder(String name) {
55: m_class = name;
56: m_list = new ArrayList();
57: }
58:
59: /**
60: * Add forward reference to tracked object. This method is called by
61: * the framework when a reference item is created for the object
62: * associated with this holder.
63: *
64: * @param ref backfill reference item
65: */
66:
67: public void addBackFill(BackFillReference ref) {
68: m_list.add(ref);
69: }
70:
71: /**
72: * Define referenced object. This method is called by the framework
73: * when the forward-referenced object is defined, and in turn calls each
74: * reference to fill in the reference.
75: *
76: * @param obj referenced object
77: */
78:
79: public void defineValue(Object obj) {
80: for (int i = 0; i < m_list.size(); i++) {
81: BackFillReference ref = (BackFillReference) m_list.get(i);
82: ref.backfill(obj);
83: }
84: }
85:
86: /**
87: * Get expected class name of referenced object.
88: *
89: * @return expected class name of referenced object
90: */
91:
92: public String getExpectedClass() {
93: return m_class;
94: }
95: }
|