File: Bindings.java

package info (click to toggle)
libxjavadoc-java 1.1-4
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 652 kB
  • ctags: 1,061
  • sloc: java: 6,259; xml: 505; makefile: 11
file content (398 lines) | stat: -rw-r--r-- 10,584 bytes parent folder | download
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
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
/*
 * Hanoi ProcessInstance Engine
 *
 * Distributable under LGPL license.
 * See terms of license at gnu.org.
 */

package hanoi;

import com.tirsen.hanoi.beans.InvalidDefinitionException;
import com.tirsen.hanoi.beans.PropertyAccessor;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

import java.util.*;

/**
 * In or out-parameters to activities are bound to the datasheet or resources by using this processor.
 *
 * Each step in a workflow has an instance of this associated with it.
 * It contains all the bindings to the input parameters and from the out parameters and the step.
 *
 * <p>
 * Input parameters can be bound to:
 * <li> A static/constant value.
 * <li> One of the variables in the datasheet.
 * <li> A named resouce of the resource registry.
 *
 * <p>
 * Output parameters can be bound to:
 * <li> One of the variables in the datasheet.
 *
 * <p>
 * Note that the only persistent state of an executing workflow is it's datasheet. If a step
 * contains state that is not bound to a variable in the datasheet that state will not be persisted.
 *
 * <!-- $Id: Bindings.java,v 1.1 2002/08/14 12:38:24 rinkrank Exp $ -->
 * <!-- $Author: rinkrank $ -->
 *
 * @author Jon Tirs&acute;n (tirsen@users.sourceforge.net)
 * @version $Revision: 1.1 $
 */
public class Bindings
{
    private static final Log logger = LogFactory.getLog(Bindings.class);

    private ProcessInstance instance;
    private ProcessDefinition definition;
    private Activity activity;
    private Collection inputBindings = new ArrayList();
    private Collection outputBindings = new ArrayList();

    /*
    // sorry, doesn't work yet...
    private static class MyPersistenceDelegate extends DefaultPersistenceDelegate
    {
        protected void initialize(Class type, Object oldInstance, Object newInstance, Encoder out)
        {
            super.initialize(type, oldInstance, newInstance, out);
            Bindings bindings = (Bindings) oldInstance;
            Binding[] before = bindings.getBefore();
            for(int i = 0; i < before.length; i++)
            {
                Binding binding = before[i];
                out.writeStatement(new Statement(oldInstance, "addBefore", new Object[] { binding }));
            }
            Binding[] after = bindings.getBefore();
            for(int i = 0; i < before.length; i++)
            {
                Binding binding = before[i];
                out.writeStatement(new Statement(oldInstance, "addAfter", new Object[] { binding }));
            }
        }
    }

    static
    {
        try
        {
            BeanInfo beanInfo = Introspector.getBeanInfo(Bindings.class);
            beanInfo.getBeanDescriptor().setValue("persistenceDelegate", new MyPersistenceDelegate());
        }
        catch(IntrospectionException e)
        {
            throw new Error("Could not initialize persistence-delegate. Bailing out!");
        }
    }
    */

    public static class Processor implements com.tirsen.hanoi.engine.Processor
    {
        private ProcessInstance instance;

        public void init(ProcessInstance instance)
        {
            this.instance = instance;
        }

        public int run(Next next, Activity activity)
        {
            Bindings bindings = (Bindings) instance.getDefinition().getProcessorConfig(this, activity);
            if(bindings != null)
            {
                bindings.setInstance(instance);
                bindings.setActivity(activity);
                bindings.beforeRun();
            }
            int result = next.runNext();
            if(bindings != null)
            {
                bindings.afterRun();
            }
            return result;
        }

        public Object createProcessorConfig(ProcessDefinition definition, Activity activity)
        {
            Bindings bindings = new Bindings();
            bindings.setDefinition(definition);
            bindings.setActivity(activity);
            return bindings;
        }
    }

    public static abstract class Binding
    {
        protected PropertyAccessor toAccessor;
        protected ProcessDefinition definition;

        public abstract void execute();

        public void setDefinition(ProcessDefinition definition)
        {
            this.definition = definition;
        }

        public String getToProperty()
        {
            return toAccessor == null ? null : toAccessor.getProperty();
        }

        public void setToProperty(String toProperty)
        {
            if(toProperty == null) toAccessor = null;
            else toAccessor = new PropertyAccessor(toProperty, true, false);
        }

        void setTo(Object to)
        {
            logger.debug("this = " + this);
            logger.debug("toAccessor = " + toAccessor);
            toAccessor.setBean(to);
        }

        public String toString()
        {
            return getClass().getName() + "[" + getToProperty() + "]";
        }
    }

    public static class ValueBinding extends Binding
    {
        private Object value;

        public ValueBinding()
        {
        }

        public ValueBinding(String toProperty, Object value)
        {
            setValue(value);
            setToProperty(toProperty);
        }

        public Object getValue()
        {
            return value;
        }

        public void setValue(Object value)
        {
            this.value = value;
        }

        public void execute()
        {
            toAccessor.set(value);
        }
    }

    public static class ResourceBinding extends Binding
    {
        private Object resource;

        public ResourceBinding()
        {
        }

        public ResourceBinding(String toProperty, Object resource)
        {
            setResource(resource);
            setToProperty(toProperty);
        }

        public void setResource(Object resource)
        {
            this.resource = resource;
        }

        public Object getResource()
        {
            return resource;
        }

        public void execute()
        {
            toAccessor.set(resource);
        }
    }

    public static class DynamicBinding extends Binding
    {
        private PropertyAccessor fromAccessor;

        public DynamicBinding()
        {
        }

        public DynamicBinding(String toProperty, String fromProperty)
        {
            setToProperty(toProperty);
            setFromProperty(fromProperty);
        }

        public void compile() throws InvalidDefinitionException
        {
        }

        public String getFromProperty()
        {
            return fromAccessor == null ? null : fromAccessor.getProperty();
        }

        public void setFromProperty(String fromProperty)
        {
            if(fromProperty == null) fromAccessor = null;
            else fromAccessor = new PropertyAccessor(fromProperty, false, true);
        }

        public void setFrom(Object from)
        {
            fromAccessor.setBean(from);
        }

        public void execute()
        {
            Object value = fromAccessor.get();

            toAccessor.set(value);
        }
    }

    public ProcessDefinition getDefinition()
    {
        return definition;
    }

    public void setDefinition(ProcessDefinition definition)
    {
        this.definition = definition;
        attachBindings();
    }

    public void setActivity(Activity activity)
    {
        this.activity = activity;
        attachBindings();
    }

    public Step getStep()
    {
        return activity;
    }

    public void removeBinding(Binding binding)
    {
        binding.setDefinition(null);
        inputBindings.remove(binding);
        outputBindings.remove(binding);
    }

    public void addInput(Binding binding)
    {
        binding.setDefinition(definition);
        inputBindings.add(binding);
    }

    public void addOutput(Binding binding)
    {
        binding.setDefinition(definition);
        outputBindings.add(binding);
    }

    private void attachBindings()
    {
        for(Iterator iterator = inputBindings.iterator(); iterator.hasNext();)
        {
            Binding binding = (Binding) iterator.next();
            attachInput(binding);
        }
        for(Iterator iterator = outputBindings.iterator(); iterator.hasNext();)
        {
            Binding binding = (Binding) iterator.next();
            attachOutput(binding);
        }
    }

    public void setInstance(ProcessInstance instance)
    {
        this.instance = instance;
        setDefinition(instance.getDefinition());
        attachBindings();
    }

    private void attachOutput(Binding binding)
    {
        if(definition != null)
        {
            binding.setDefinition(definition);
            binding.setTo(definition.getTemplateDatasheet());
        }
        if(instance != null)
        {
            binding.setTo(instance.getDatasheet());
        }
        if(binding instanceof DynamicBinding) ((DynamicBinding) binding).setFrom(activity);
    }

    private void attachInput(Binding binding)
    {
        if(definition != null)
        {
            binding.setDefinition(definition);
            if(binding instanceof DynamicBinding) ((DynamicBinding) binding).setFrom(definition.getTemplateDatasheet());
        }
        if(instance != null)
        {
            if(binding instanceof DynamicBinding) ((DynamicBinding) binding).setFrom(instance.getDatasheet());
        }
        binding.setTo(activity);
    }

    public void beforeRun()
    {
        for(Iterator iterator = inputBindings.iterator(); iterator.hasNext();)
        {
            Binding binding = (Binding) iterator.next();
            binding.execute();
        }
    }

    public void afterRun()
    {
        for(Iterator iterator = outputBindings.iterator(); iterator.hasNext();)
        {
            Binding binding = (Binding) iterator.next();
            binding.execute();
        }
    }

    public Binding[] getInput()
    {
        return (Binding[]) inputBindings.toArray(new Binding[0]);
    }

    public Binding[] getOutput()
    {
        return (Binding[]) outputBindings.toArray(new Binding[0]);
    }

    public void setInput(Binding[] bindings)
    {
        for(int i = 0; i < bindings.length; i++)
        {
            Binding binding = bindings[i];
            addInput(binding);
        }
    }

    public void setOutput(Binding[] bindings)
    {
        for(int i = 0; i < bindings.length; i++)
        {
            Binding binding = bindings[i];
            addOutput(binding);
        }
    }
}