DBObjImpl


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.controller.ControllerRequest;
68  import com.jcorporate.expresso.core.db.DBException;
69  import com.jcorporate.expresso.core.dbobj.DBObject;
70  import com.jcorporate.expresso.core.dbobj.Schema;
71  import com.jcorporate.expresso.core.dbobj.SchemaFactory;
72  import com.jcorporate.expresso.core.dbobj.SecuredDBObject;
73  import com.jcorporate.expresso.core.dbobj.ValidValue;
74  
75  import java.util.Enumeration  ;
76  import java.util.Iterator  ;
77  import java.util.Vector  ;
78  
79  
80  /**
81   * A DBObjImpl defines the class used as the "implementation" for a
82   * specific DBObject. See com.jcorporate.expresso.core.dbobj.DBObject and
83   * com.jcorporate.expresso.core.dbobj.DBObjectImpl for details
84   *
85   * @author Michael Nash
86   * @version $Revision: 1.14 $  $Date: 2004/11/17 20:48:18 $
87   * @deprecated since Expresso 5.3 [never used]
88   */
89  public class DBObjImpl
90          extends SecuredDBObject {
91      private Vector   dbObjList = null;
92  
93      /**
94       * @see com.jcorporate.expresso.core.dbobj.SecuredDBObject#SecuredDBObject
95       */
96      public DBObjImpl()
97              throws DBException {
98          super();
99      } /* DBObjImpl() */
100 
101 
102     /**
103      *
104      */
105     public DBObjImpl(int uid)
106             throws DBException {
107         super(uid);
108     }
109 
110     /**
111      * For using DBObjects within Controllers.  Initializes based upon the current
112      * user and the requested db. [Of course this can be modified later]
113      *
114      * @param request - The controller request handed to you by the framework.
115      */
116     public DBObjImpl(ControllerRequest request)
117             throws DBException {
118         super(request);
119     }
120 
121     /**
122      * @param schemaName
123      * @param schemaDescrip
124      * @param oList
125      */
126     private void doSchema(String   schemaName, String   schemaDescrip,
127                           Vector   oList)
128             throws DBException {
129         Schema oneSchema = SchemaFactory.getInstance().getSchema(schemaName);
130         DBObject oneDBObj = null;
131         ValidValue oneVal = null;
132 
133         if (oneSchema == null) {
134             throw new DBException("Error instantiating class '" + schemaName);
135         }
136 
137         /* Now add all of the objects in this schema to our list */
138         for (Enumeration   e = oneSchema.getMembers(); e.hasMoreElements();) {
139             oneDBObj = (DBObject) e.nextElement();
140             oneVal = new ValidValue(oneDBObj.getClass().getName(),
141                     schemaDescrip + ": " +
142                     oneDBObj.getJDBCMetaData().getDescription());
143             oList.addElement(oneVal);
144         }
145     } /* doSchema(String, String, Vector) */
146 
147 
148     /**
149      * Override the method getValidValues to provide specific values for our
150      * multi-valued fields
151      *
152      * @param fieldName Fielname to retrieve values for
153      * @return Hashtable Value/description pairs for this field
154      * @throws DBException If the values cannot be retrieved
155      */
156     public synchronized Vector   getValidValues(String   fieldName)
157             throws DBException {
158         if (fieldName.equals("DBObjectName")) {
159             if (dbObjList == null) {
160                 SchemaList myList = new SchemaList(SecuredDBObject.SYSTEM_ACCOUNT);
161                 myList.setDataContext(getDataContext());
162 
163                 SchemaList oneList = null;
164 
165                 /* Get any database objects listed as existing in another */
166 
167                 /* database */
168                 DBOtherMap otherList = new DBOtherMap();
169                 otherList.setDataContext(getDataContext());
170 
171                 DBOtherMap oneOther = null;
172                 ValidValue oneVal;
173 
174                 for (Iterator   e2 = otherList.searchAndRetrieveList().iterator();
175                      e2.hasNext();) {
176                     oneOther = (DBOtherMap) e2.next();
177                     oneVal = new ValidValue(oneOther.getField("DBObjName"),
178                             oneOther.getField("Descrip"));
179                     dbObjList.addElement(oneVal);
180                 }
181 
182                 doSchema("com.jcorporate.expresso.core.ExpressoSchema",
183                         "Expresso", dbObjList);
184 
185                 /* Now get all of the schemas listed in the database as well */
186                 for (Iterator   sl = myList.searchAndRetrieveList().iterator();
187                      sl.hasNext();) {
188                     oneList = (SchemaList) sl.next();
189                     doSchema(oneList.getField("SchemaClass"),
190                             oneList.getField("Descrip"), dbObjList);
191                 } /* for each schema list */
192 
193             }
194 
195             return dbObjList;
196         }
197 
198         return super.getValidValues(fieldName);
199     } /* getValidValues(String) */
200 
201 
202     /**
203      * @see com.jcorporate.expresso.core.dbobj.SecuredDBObject#setupFields
204      */
205     public void setupFields()
206             throws DBException {
207         setTargetTable("DBOBJIMPL");
208         setDescription("Database Object Implementation Mappings");
209         setCharset("ISO-8859-1");
210         addField("DBObjectName", "varchar", 80, false, "Database Object Name");
211         addField("DBObjectImpl", "varchar", 132, false,
212                 "Implementation Class Name");
213         addField("ImplParams", "text", 0, true, "Implementation Parameters");
214         setStringFilter("DBObjectName", "stripFilter");
215         addKey("DBObjectName");
216         setMultiValued("DBObjectName");
217     } /*setupFields() */
218 
219 
220 } /* DBObjImpl */
221 
222 /* DBObjImpl */
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags