KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > jeantessier > diff > DeprecatableDifferences


1 /*
2  * Copyright (c) 2001-2005, Jean Tessier
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * * Redistributions of source code must retain the above copyright
10  * notice, this list of conditions and the following disclaimer.
11  *
12  * * Redistributions in binary form must reproduce the above copyright
13  * notice, this list of conditions and the following disclaimer in the
14  * documentation and/or other materials provided with the distribution.
15  *
16  * * Neither the name of Jean Tessier nor the names of his contributors
17  * may be used to endorse or promote products derived from this software
18  * without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
24  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
26  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
27  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
28  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
29  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
30  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */

32
33 package com.jeantessier.diff;
34
35 import org.apache.log4j.*;
36
37 import com.jeantessier.classreader.*;
38
39 /**
40  * Documents the difference, if any, for a given programming
41  * element that can be deprecated through the use of javadoc
42  * tags.
43  */

44 public class DeprecatableDifferences extends DecoratorDifferences {
45     private boolean newDeprecation;
46     private boolean removedDeprecation;
47
48     /**
49      * Only the DifferencesFactory can create instances of this class.
50      */

51     DeprecatableDifferences(Differences component, Deprecatable oldDeprecatable, Deprecatable newDeprecatable) {
52         super(component);
53
54         Logger.getLogger(getClass()).debug("Begin " + getName());
55
56         if (oldDeprecatable != null && newDeprecatable != null) {
57             Logger.getLogger(getClass()).debug(" old deprecatable: " + oldDeprecatable.isDeprecated());
58             Logger.getLogger(getClass()).debug(" new deprecatable: " + newDeprecatable.isDeprecated());
59
60             setRemovedDeprecation(oldDeprecatable.isDeprecated() && !newDeprecatable.isDeprecated());
61             setNewDeprecation(!oldDeprecatable.isDeprecated() && newDeprecatable.isDeprecated());
62         }
63
64         Logger.getLogger(getClass()).debug("End " + getName() + ": " + (isEmpty() ? "empty" : "not empty"));
65     }
66
67     public boolean isNewDeprecation() {
68         Logger.getLogger(getClass()).debug(getName() + " NewDeprecation(): " + newDeprecation);
69         return newDeprecation;
70     }
71
72     public void setNewDeprecation(boolean newDeprecation) {
73         this.newDeprecation = newDeprecation;
74     }
75
76     public boolean isRemovedDeprecation() {
77         Logger.getLogger(getClass()).debug(getName() + " RemovedDeprecation(): " + removedDeprecation);
78         return removedDeprecation;
79     }
80
81     public void setRemovedDeprecation(boolean removedDeprecation) {
82         this.removedDeprecation = removedDeprecation;
83     }
84
85     public boolean isEmpty() {
86         return
87             !isNewDeprecation() &&
88             !isRemovedDeprecation() &&
89             getComponent().isEmpty();
90     }
91
92     public void accept(Visitor visitor) {
93         visitor.visitDeprecatableDifferences(this);
94     }
95 }
96
Popular Tags