KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > jcorporate > expresso > ext > dbobj > DownloadLog


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.ext.dbobj;
66
67 import com.jcorporate.expresso.core.controller.ControllerRequest;
68 import com.jcorporate.expresso.core.db.DBException;
69 import com.jcorporate.expresso.core.dbobj.SecuredDBObject;
70 import com.jcorporate.expresso.core.misc.DateTime;
71
72
73 /**
74  * DownloadLog
75  * Log the latest download of a file by a user
76  *
77  * @author Michael Nash
78  */
79 public class DownloadLog
80         extends SecuredDBObject {
81
82
83     /**
84      * Field name constant
85      */
86     public static final String JavaDoc FLD_LOG_ENTRY = "LogEntry";
87
88     /**
89      * Field name constant
90      */
91     public static final String JavaDoc FLD_FILE_NUMBER = "FileNumber";
92
93
94     /**
95      * Field name constant
96      */
97     public static final String JavaDoc FLD_EXP_UID = "ExpUid";
98
99     /**
100      * Field name constant
101      */
102     public static final String JavaDoc FLD_DOWNLOADED = "Downloaded";
103
104     /**
105      * Field name constant
106      */
107     public static final String JavaDoc FLD_FILEPATHNAME = "FilePathName";
108
109     /**
110      * Field name constant
111      */
112     public static final String JavaDoc FLD_IP = "IPNumber";
113
114     /**
115      * Constructor
116      */
117     public DownloadLog()
118             throws DBException {
119         super();
120     } /* DownloadLog() */
121
122     /**
123      * Use over (String) constructor. Initializes the object in the context
124      * of the user who's uid belongs to the parameter.
125      *
126      * @param uid the Uid of the user context
127      * @throws DBException if there's an initialization problem
128      */
129     public DownloadLog(int uid)
130             throws DBException {
131         super(uid);
132     }
133
134     /**
135      * For using DBObjects within Controllers. Initializes based upon the current
136      * user and the requested db. [Of course this can be modified later]
137      *
138      * @param request - The controller request handed to you by the framework.
139      * @throws DBException upon error
140      */
141     public DownloadLog(ControllerRequest request)
142             throws DBException {
143         super(request);
144     }
145
146     /**
147      * Define the table and fields for this object
148      *
149      * @throws DBException If the fields cannot be set up
150      */
151     public void setupFields()
152             throws DBException {
153         setTargetTable("DOWNLOADLOG");
154         setDescription("DBdownloadLog");
155         setCharset("ISO-8859-1");
156         addField("LogEntry", "auto-inc", 0, false, "logEntryNum");
157         addField("FileNumber", "int", 0, false, "fileNumber");
158         addField("ExpUid", "int", 0, false, "userId");
159         addField("Downloaded", "datetime", 0, true, "dateTimeDownloaded");
160         addField("FilePathName", "varchar", 128, false, "filePath");
161         addField("IPNumber", "char", 20, false, "ipAddress");
162         setStringFilter("FilePathName", "stripFilter");
163         setLookupObject("ExpUid", "com.jcorporate.expresso.core.security.User");
164         addKey("LogEntry");
165     }
166
167
168     /**
169      * Override of add to set the 'Downloaded' time to when the record was created.
170      */
171     public synchronized void add() throws com.jcorporate.expresso.core.db.DBException {
172         if (this.getDataField("Downloaded").isNull() || this.getDataField("Downloaded").asString().length() == 0) {
173             this.set("Downloaded", DateTime.getDateTimeForDB(new java.util.Date JavaDoc(), this.getDataContext()));
174         }
175
176         super.add();
177     }
178 }
179
180 /* DownloadLog */
Popular Tags