[r8483]: ooDialog / trunk / examples / userGuide / exercises / Support / Model.rex Maximize Restore History

Download this file

Model.rex    184 lines (163 with data), 9.0 kB

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
/*----------------------------------------------------------------------------*/
/* */
/* Copyright (c) 2011-2012 Rexx Language Association. All rights reserved. */
/* */
/* This program and the accompanying materials are made available under */
/* the terms of the Common Public License v1.0 which accompanies this */
/* distribution. A copy is also available at the following address: */
/* http://www.oorexx.org/license.html */
/* */
/* Redistribution and use in source and binary forms, with or */
/* without modification, are permitted provided that the following */
/* conditions are met: */
/* */
/* Redistributions of source code must retain the above copyright */
/* notice, this list of conditions and the following disclaimer. */
/* Redistributions in binary form must reproduce the above copyright */
/* notice, this list of conditions and the following disclaimer in */
/* the documentation and/or other materials provided with the distribution. */
/* */
/* Neither the name of Rexx Language Association nor the names */
/* of its contributors may be used to endorse or promote products */
/* derived from this software without specific prior written permission. */
/* */
/* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS */
/* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT */
/* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS */
/* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT */
/* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, */
/* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED */
/* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, */
/* OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY */
/* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING */
/* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS */
/* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */
/* */
/*----------------------------------------------------------------------------*/
/* ooDialog User Guide
Support - Model v00-02 09Aug12
----------------
A simple superclass class for the Model-View framework.
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = */
--::REQUIRES "ooDialog.cls"
--::REQUIRES "ObjectMgr.rex"
/*============================================================================*/
::CLASS 'Model' PUBLIC
::ATTRIBUTE wantList CLASS PUBLIC -- for List subclasses
::ATTRIBUTE myData
--::ATTRIBUTE instanceName CLASS PUBLIC -- for Anonymous subclasses
/*----------------------------------------------------------------------------
newInstance - must be invoked by subclass.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
::METHOD newInstance CLASS PUBLIC
expose noDataError -- .true if data not found.
use strict arg instanceName
say ".Model-newInstance-01: instanceName =" instanceName
-- Check that the model's Data object is up and running. If not, then return .false:
if noDataError = .true then return .false
-- Now get the name of the Data component (FredModel or FredListModel --> FredData):
-- Get my root name (i.e. the root name of the subclass):
className = self~objectName -- objectName for a class Foo is "The Foo class"
className = className~upper() -- When class name is in quotes, then it's mixed case.
-- Upper here to make everthing upper case for parse var.
-- Addition of Forms
-- If this is a "Form" then there's no data to get (the user will provide
-- the data). So just create the Form Model and return.
-- Assume that the instance name is the Form Number (e.g. for an OrderForm,
-- the Form Number will be the new Order Number).
p = className~pos("FORM")
if p > 0 then do -- if this is a "Form" component.
myData = .Directory~new
myData[formNumber] = instanceName
formObject = self~new(myData)
say ".Model-newInstance-011: formObj, instanceName =" formObject||"," instanceName
return formObject
end
-- End of addition for Forms.
-- If there's "LIST" in the name, then set "get all" for the file access
-- (as opposed to the default of "get 1 record")
getAllRecords = .false
p = className~pos("LIST")
if p > 0 then getAllRecords = .true
-- if there's a "LIST" in the name, strip it out 'cos an xListModel gets data from xData
parse var className . root1 "MODEL" .
parse var root1 root "LIST"
dataClassName = root||"Data"
say ".Model-newInstance-02, dataClassName =" dataClassName
-- Get the id of Data component:
objMgr = .local~my.ObjectMgr
--say ".Model-newInstance-03: objMgr =" objMgr
myDataId = objMgr~getComponentId(dataClassName, "The")
if myDataId = .false then do -- if instantiation failed
say ".Model-newInstance-04: getting ID of Data Class failed."
noDataError = .true
return .false
end
-- Got my data id, now get data for this model instance.
-- But distinguish between Entity Models and List Models - the former needs
-- a single record, the latter a group of records.
-- say ".Model-newInstance-05a: getAllRecords =" getAllRecords
if getAllRecords then myData = myDataId~getFile() -- returns a 2D array
else myData = myDataId~getRecord(instanceName) -- a directory
-- say ".Model-newInstance-05b: array dimensions: =" myData~dimension
if myData = .false then return .false -- if ID (key) not found
-- All is well, then make new instance:
say ".Model-newInstance-06: myData =" myData
id = self~new(myData)
return id
/*- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
/*----------------------------------------------------------------------------
getInstanceName - For an "anonymous" instance only (e.g. CustomerList)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
::METHOD getInstanceName CLASS PUBLIC
expose anonInstanceName
if anonInstanceName = "ANONINSTANCENAME" then anonInstanceName = 1
else anonInstanceName = anonInstanceName + 1
return anonInstanceName
/*----------------------------------------------------------------------------
query - returns a Model's data.
Standard protocol:
Accept a .nil, directory, array, or string of names.
if .nil then return all fields; else return values for the names in
the directory, array, or string. String is assumed to be data
names separated by one or more spaces.
All returns are a Directory containing names and values.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
::METHOD query PUBLIC
use arg dataNames
say "Model-query-01: dataNames:" dataNames
dirReturn = .Directory~new
say "Model-query-01a: args =" arg()
select
when arg() = 0 then do
return self~myData
end
-- Caller is requesting specific data items:
when dataNames~isa(.Directory) then do
do i over dataNames
dirReturn[i] = self~dirData[i]
end
end
when dataNames~isa(.Array) then do
do i over dataNames
say "Model-query-03: dataNames: '"||dataNames"'"
dirReturn[i] = self~dirData[i]
end
end
-- dataNames must be separated by a *single* space.
when dataNames~isa(.String) then do
dataNames = dataNames~strip
--say "Model-query-04: dataNames: '"||dataNames"'"
n = dataNames~countStr(" ")+1
do i = 1 to n
parse var dataNames name " " dataNames
if name = " " then iterate -- ignore extraneous leading spaces.
--say "Model-query-05: name: '"name"'"
dirReturn[name] = self~dirData[name]
end
end
otherwise return .false
end
return dirReturn
/*============================================================================*/
/*============================================================================*/