KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > openlaszlo > iv > flash > util > ScriptCopier


1 /*
2  * $Id: ScriptCopier.java,v 1.2 2002/02/15 23:44:28 skavish Exp $
3  *
4  * ===========================================================================
5  *
6  * The JGenerator Software License, Version 1.0
7  *
8  * Copyright (c) 2000 Dmitry Skavish (skavish@usa.net). All rights reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions are met:
12  *
13  * 1. Redistributions of source code must retain the above copyright
14  * notice, this list of conditions and the following disclaimer.
15  *
16  * 2. Redistributions in binary form must reproduce the above copyright
17  * notice, this list of conditions and the following disclaimer in
18  * the documentation and/or other materials provided with the
19  * distribution.
20  *
21  * 3. The end-user documentation included with the redistribution, if
22  * any, must include the following acknowlegement:
23  * "This product includes software developed by Dmitry Skavish
24  * (skavish@usa.net, http://www.flashgap.com/)."
25  * Alternately, this acknowlegement may appear in the software itself,
26  * if and wherever such third-party acknowlegements normally appear.
27  *
28  * 4. The name "The JGenerator" must not be used to endorse or promote
29  * products derived from this software without prior written permission.
30  * For written permission, please contact skavish@usa.net.
31  *
32  * 5. Products derived from this software may not be called "The JGenerator"
33  * nor may "The JGenerator" appear in their names without prior written
34  * permission of Dmitry Skavish.
35  *
36  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39  * DISCLAIMED. IN NO EVENT SHALL DMITRY SKAVISH OR THE OTHER
40  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
42  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
43  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
44  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
45  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
46  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47  * SUCH DAMAGE.
48  *
49  */
50
51 package org.openlaszlo.iv.flash.util;
52
53 import java.io.*;
54 import java.util.*;
55 import org.openlaszlo.iv.flash.api.*;
56
57 /**
58  * This class helps in copying of flash objects.
59  * <P>
60  * It remembers all copied objects and makes sure
61  * that an object will not be copied twice.
62  * All flash objects can be constant or not. Constant object is such
63  * an object which is invariant to generator processing, for example if an
64  * object represents some text and this text does not contain generator
65  * variable, then this object is constant, otherwise it is considered
66  * to be non-constant.<BR>
67  * So when an object is to be copied it's checked whether it's a constant
68  * or not. If the object is constant it's not copied, but rather it's reference
69  * is used. If the object is not a constant then it is copied using the same guidelines,
70  * i.e. if the object contains non-constant object, they will not be copied.
71  *
72  * @author Dmitry Skavish
73  */
74 public final class ScriptCopier {
75
76     private Hashtable hashTable = new Hashtable();
77
78     public ScriptCopier() {}
79
80     /**
81      * Copies the specified object.
82      * <P>
83      * Returns copy of the specified object or the object itself
84      * depending on whether the object is constant or not.
85      * Objects are not copied twice, i.e. all copied objects are
86      * remembered and on second request "remembered" object will be
87      * returned.
88      *
89      * @param def object to be copied
90      * @return the object's copy
91      */
92     public FlashDef copy( FlashDef def ) {
93         if( def == null ) return null;
94         if( def.isConstant() ) return def;
95         FlashDef myDef = (FlashDef) hashTable.get(def);
96         if( myDef != null ) return myDef;
97         myDef = (FlashDef) def.getCopy(this);
98         hashTable.put(def, myDef);
99         return myDef;
100     }
101
102     /**
103      * Returns remembered copy of this object or null.
104      *
105      * @param def object remembered copy of which is requested
106      * @return remembered copy of the object or null
107      */
108     public FlashDef get( FlashDef def ) {
109         if( def == null ) return null;
110         FlashDef myDef = (FlashDef) hashTable.get(def);
111         if( myDef == null ) return def;
112         return myDef;
113     }
114
115 }
116
Popular Tags