KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > jcorporate > expresso > services > dbobj > ChangeLog


1 /* ====================================================================
2  * The Jcorporate Apache Style Software License, Version 1.2 05-07-2002
3  *
4  * Copyright (c) 1995-2002 Jcorporate Ltd. All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  *
10  * 1. Redistributions of source code must retain the above copyright
11  * notice, this list of conditions and the following disclaimer.
12  *
13  * 2. Redistributions in binary form must reproduce the above copyright
14  * notice, this list of conditions and the following disclaimer in
15  * the documentation and/or other materials provided with the
16  * distribution.
17  *
18  * 3. The end-user documentation included with the redistribution,
19  * if any, must include the following acknowledgment:
20  * "This product includes software developed by Jcorporate Ltd.
21  * (http://www.jcorporate.com/)."
22  * Alternately, this acknowledgment may appear in the software itself,
23  * if and wherever such third-party acknowledgments normally appear.
24  *
25  * 4. "Jcorporate" and product names such as "Expresso" must
26  * not be used to endorse or promote products derived from this
27  * software without prior written permission. For written permission,
28  * please contact info@jcorporate.com.
29  *
30  * 5. Products derived from this software may not be called "Expresso",
31  * or other Jcorporate product names; nor may "Expresso" or other
32  * Jcorporate product names appear in their name, without prior
33  * written permission of Jcorporate Ltd.
34  *
35  * 6. No product derived from this software may compete in the same
36  * market space, i.e. framework, without prior written permission
37  * of Jcorporate Ltd. For written permission, please contact
38  * partners@jcorporate.com.
39  *
40  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
41  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
42  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
43  * DISCLAIMED. IN NO EVENT SHALL JCORPORATE LTD OR ITS CONTRIBUTORS
44  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
45  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
46  * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
47  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
48  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
49  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
50  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51  * SUCH DAMAGE.
52  * ====================================================================
53  *
54  * This software consists of voluntary contributions made by many
55  * individuals on behalf of the Jcorporate Ltd. Contributions back
56  * to the project(s) are encouraged when you make modifications.
57  * Please send them to support@jcorporate.com. For more information
58  * on Jcorporate Ltd. and its products, please see
59  * <http://www.jcorporate.com/>.
60  *
61  * Portions of this software are based upon other open source
62  * products and are subject to their respective licenses.
63  */
64
65 package com.jcorporate.expresso.services.dbobj;
66
67 import com.jcorporate.expresso.core.db.DBException;
68 import com.jcorporate.expresso.core.dbobj.DBObject;
69 import com.jcorporate.expresso.core.i18n.Messages;
70
71 import java.util.Date JavaDoc;
72
73
74 /*
75  * A ChangeLog object is used to record changes to other DBObjects.
76  * If logging is enabled, whenever a database change is
77  * made (add, update or delete), a ChangeLog object is written. For
78  * updates, the actual field being updated is noted. If more
79  * than one field is updated, more than one ChangeLog item is written.
80  *
81  * @version $Revision: 1.11 $ $Date: 2004/11/27 22:34:29 $
82  * @author Michael Nash
83  */
84
85 public class ChangeLog
86         extends DBObject {
87     /**
88      * Constructor
89      * @throws DBException upon construction error.
90      */
91     public ChangeLog()
92             throws DBException {
93         super();
94     } /* ChangeLog() */
95
96     /**
97      * Override of DBObject.add() by setting the changetime to the current
98      * date.
99      * @throws DBException upon database creation error.
100      */
101     public synchronized void add()
102             throws DBException {
103         /** @todo to make it consistent with the updated API replace
104          Date d = new Date();
105          String currDate = DateFormat.getDateTimeInstance(DateFormat.SHORT,
106          DateFormat.MEDIUM).format(d);
107          setField("ChangeTime", currDate);
108
109          with:
110          *RD* Mon Jul 27 2004 */
111         setField("ChangeTime", new Date JavaDoc());
112         super.add();
113
114     } /* add() */
115
116
117     /**
118      * Initializes database setup fields.
119      * @throws DBException
120      * @throws DBException upon construction error.
121      */
122     protected synchronized void setupFields()
123             throws DBException {
124         setTargetTable("CHANGELOGTWO");
125         addField("ChangeKey", "auto-inc", 0, false, "Changelog Key");
126         addKey("ChangeKey");
127
128         addField("ObjectChanged", "varchar", 40, false, "Object_Changed");
129         addField("RecordKey", "varchar", 150, false, "Key_of_Changed_Object");
130         addField("Operation", "char", 1, false, "Operation_Code");
131
132         /* (A)dd , (D)elete, (U)pdate */
133         addField("ChangedField", "varchar", 40, false, "Field_Changed");
134
135         /* (if update) "ALL" for adds & deletes */
136         addField("ChangeTime", "datetime", 0, false, "Time_of_Change");
137
138 // addKey("ObjectChanged");
139 // addKey("RecordKey");
140 // addKey("Operation");
141 // addKey("ChangedField");
142 // addKey("ChangeTime");
143
144
145         addField("OldValue", "varchar", 255, true, "Old_Field_Value");
146         addField("NewValue", "varchar", 255, true, "New_Field_Value");
147     } /* setupFields() */
148
149
150     /**
151      * Override update to throw exception immediately - no updates allowed
152      * @throws DBException Always.
153      */
154     public synchronized void update()
155             throws DBException {
156         throw new DBException(Messages.getString("Updates_to_ChangeLog_object_not_permitted"));
157     }
158
159 }
160
161 /* ChangeLog */
162
Popular Tags