001/**
002 * Copyright 2005-2015 The Kuali Foundation
003 *
004 * Licensed under the Educational Community License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 * http://www.opensource.org/licenses/ecl2.php
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 * See the License for the specific language governing permissions and
014 * limitations under the License.
015 */
016package org.kuali.rice.kew.api.rule;
017
018import java.io.Serializable;
019import java.util.ArrayList;
020import java.util.Collection;
021import java.util.Collections;
022import java.util.List;
023import javax.xml.bind.annotation.XmlAccessType;
024import javax.xml.bind.annotation.XmlAccessorType;
025import javax.xml.bind.annotation.XmlAnyElement;
026import javax.xml.bind.annotation.XmlElement;
027import javax.xml.bind.annotation.XmlElementWrapper;
028import javax.xml.bind.annotation.XmlRootElement;
029import javax.xml.bind.annotation.XmlType;
030
031import org.apache.commons.collections.CollectionUtils;
032import org.apache.commons.lang.StringUtils;
033import org.kuali.rice.core.api.CoreConstants;
034import org.kuali.rice.core.api.mo.AbstractDataTransferObject;
035import org.kuali.rice.core.api.mo.ModelBuilder;
036import org.kuali.rice.kew.api.KewApiConstants;
037import org.w3c.dom.Element;
038
039@XmlRootElement(name = RuleTemplate.Constants.ROOT_ELEMENT_NAME)
040@XmlAccessorType(XmlAccessType.NONE)
041@XmlType(name = RuleTemplate.Constants.TYPE_NAME, propOrder = {
042    RuleTemplate.Elements.NAME,
043    RuleTemplate.Elements.DESCRIPTION,
044    RuleTemplate.Elements.DELEGATION_TEMPLATE,
045    RuleTemplate.Elements.RULE_TEMPLATE_ATTRIBUTES,
046    RuleTemplate.Elements.RULE_TEMPLATE_OPTIONS,
047    RuleTemplate.Elements.ID,
048    CoreConstants.CommonElements.VERSION_NUMBER,
049    CoreConstants.CommonElements.OBJECT_ID,
050    CoreConstants.CommonElements.FUTURE_ELEMENTS
051})
052public final class RuleTemplate
053    extends AbstractDataTransferObject
054    implements RuleTemplateContract
055{
056
057    @XmlElement(name = Elements.NAME, required = false)
058    private final String name;
059
060    @XmlElement(name = Elements.DESCRIPTION, required = false)
061    private final String description;
062
063    @XmlElement(name = Elements.DELEGATION_TEMPLATE, required = false)
064    private final RuleTemplate delegationTemplate;
065
066    @XmlElementWrapper(name = Elements.RULE_TEMPLATE_ATTRIBUTES, required = false)
067    @XmlElement(name = Elements.RULE_TEMPLATE_ATTRIBUTE, required = false)
068    private final List<RuleTemplateAttribute> ruleTemplateAttributes;
069
070    @XmlElementWrapper(name = Elements.RULE_TEMPLATE_OPTIONS, required = false)
071    @XmlElement(name = Elements.RULE_TEMPLATE_OPTION, required = false)
072    private final List<RuleTemplateOption> ruleTemplateOptions;
073
074    @XmlElement(name = Elements.ID, required = false)
075    private final String id;
076
077    @XmlElement(name = CoreConstants.CommonElements.VERSION_NUMBER, required = false)
078    private final Long versionNumber;
079
080    @XmlElement(name = CoreConstants.CommonElements.OBJECT_ID, required = false)
081    private final String objectId;
082
083    @SuppressWarnings("unused")
084    @XmlAnyElement
085    private final Collection<Element> _futureElements = null;
086
087    /**
088     * Private constructor used only by JAXB.
089     * 
090     */
091    private RuleTemplate() {
092        this.name = null;
093        this.description = null;
094        this.delegationTemplate = null;
095        this.ruleTemplateAttributes = null;
096        this.ruleTemplateOptions = null;
097        this.id = null;
098        this.versionNumber = null;
099        this.objectId = null;
100    }
101
102    private RuleTemplate(Builder builder) {
103        this.name = builder.getName();
104        this.description = builder.getDescription();
105        this.delegationTemplate = builder.getDelegationTemplate() == null ? null : builder.getDelegationTemplate().build();
106        if (CollectionUtils.isNotEmpty(builder.getRuleTemplateAttributes())) {
107            List<RuleTemplateAttribute> rta = new ArrayList<RuleTemplateAttribute>();
108            for (RuleTemplateAttribute.Builder attribute : builder.getRuleTemplateAttributes()) {
109                rta.add(attribute.build());
110            }
111            this.ruleTemplateAttributes = Collections.unmodifiableList(rta);
112        } else {
113            this.ruleTemplateAttributes = Collections.emptyList();
114        }
115        if (CollectionUtils.isNotEmpty(builder.getRuleTemplateOptions())) {
116            List<RuleTemplateOption> rto = new ArrayList<RuleTemplateOption>();
117            for (RuleTemplateOption.Builder option : builder.getRuleTemplateOptions()) {
118                rto.add(option.build());
119            }
120            this.ruleTemplateOptions = Collections.unmodifiableList(rto);
121        } else {
122            this.ruleTemplateOptions = Collections.emptyList();
123        }
124        this.id = builder.getId();
125        this.versionNumber = builder.getVersionNumber();
126        this.objectId = builder.getObjectId();
127    }
128
129    @Override
130    public String getName() {
131        return this.name;
132    }
133
134    @Override
135    public String getDescription() {
136        return this.description;
137    }
138
139    @Override
140    public RuleTemplate getDelegationTemplate() {
141        return this.delegationTemplate;
142    }
143
144    @Override
145    public List<RuleTemplateAttribute> getRuleTemplateAttributes() {
146        return this.ruleTemplateAttributes;
147    }
148
149    public List<RuleTemplateAttribute> getActiveRuleTemplateAttributes() {
150        List<RuleTemplateAttribute> activeAttributes = new ArrayList<RuleTemplateAttribute>();
151        for (RuleTemplateAttribute templateAttribute : getRuleTemplateAttributes())
152        {
153            if (templateAttribute.isActive())
154            {
155                activeAttributes.add(templateAttribute);
156            }
157        }
158        Collections.sort(activeAttributes);
159        return activeAttributes;
160    }
161
162    @Override
163    public List<RuleTemplateOption> getRuleTemplateOptions() {
164        return this.ruleTemplateOptions;
165    }
166
167    @Override
168    public String getId() {
169        return this.id;
170    }
171
172    @Override
173    public Long getVersionNumber() {
174        return this.versionNumber;
175    }
176
177    @Override
178    public String getObjectId() {
179        return this.objectId;
180    }
181
182
183    /**
184     * A builder which can be used to construct {@link RuleTemplate} instances.  Enforces the constraints of the {@link RuleTemplateContract}.
185     * 
186     */
187    public final static class Builder
188        implements Serializable, ModelBuilder, RuleTemplateContract
189    {
190
191        private String name;
192        private String description;
193        private RuleTemplate.Builder delegationTemplate;
194        private List<RuleTemplateAttribute.Builder> ruleTemplateAttributes;
195        private List<RuleTemplateOption.Builder> ruleTemplateOptions;
196        private String id;
197        private Long versionNumber;
198        private String objectId;
199
200        private Builder() {
201            // TODO modify this constructor as needed to pass any required values and invoke the appropriate 'setter' methods
202        }
203
204        public static Builder create() {
205            // TODO modify as needed to pass any required values and add them to the signature of the 'create' method
206            return new Builder();
207        }
208
209        public static Builder create(RuleTemplateContract contract) {
210            if (contract == null) {
211                throw new IllegalArgumentException("contract was null");
212            }
213            // TODO if create() is modified to accept required parameters, this will need to be modified
214            Builder builder = create();
215            builder.setName(contract.getName());
216            builder.setDescription(contract.getDescription());
217            builder.setDelegationTemplate(
218                    contract.getDelegationTemplate() == null ?
219                            null : RuleTemplate.Builder.create(contract.getDelegationTemplate()));
220            if (CollectionUtils.isNotEmpty(contract.getRuleTemplateAttributes())) {
221                List<RuleTemplateAttribute.Builder> attrs = new ArrayList<RuleTemplateAttribute.Builder>();
222                for (RuleTemplateAttributeContract attr : contract.getRuleTemplateAttributes()) {
223                    attrs.add(RuleTemplateAttribute.Builder.create(attr));
224                }
225                builder.setRuleTemplateAttributes(attrs);
226            } else {
227                builder.setRuleTemplateAttributes(Collections.<RuleTemplateAttribute.Builder>emptyList());
228            }
229            if (CollectionUtils.isNotEmpty(contract.getRuleTemplateOptions())) {
230                List<RuleTemplateOption.Builder> options = new ArrayList<RuleTemplateOption.Builder>();
231                for (RuleTemplateOptionContract option : contract.getRuleTemplateOptions()) {
232                    options.add(RuleTemplateOption.Builder.create(option));
233                }
234                builder.setRuleTemplateOptions(options);
235            } else {
236                builder.setRuleTemplateOptions(Collections.<RuleTemplateOption.Builder>emptyList());
237            }
238            builder.setId(contract.getId());
239            builder.setVersionNumber(contract.getVersionNumber());
240            builder.setObjectId(contract.getObjectId());
241            return builder;
242        }
243
244        public RuleTemplate build() {
245            return new RuleTemplate(this);
246        }
247
248        @Override
249        public String getName() {
250            return this.name;
251        }
252
253        @Override
254        public String getDescription() {
255            return this.description;
256        }
257
258        @Override
259        public RuleTemplate.Builder getDelegationTemplate() {
260            return this.delegationTemplate;
261        }
262
263        @Override
264        public List<RuleTemplateAttribute.Builder> getRuleTemplateAttributes() {
265            return this.ruleTemplateAttributes;
266        }
267
268        @Override
269        public List<RuleTemplateOption.Builder> getRuleTemplateOptions() {
270            return this.ruleTemplateOptions;
271        }
272
273        @Override
274        public String getId() {
275            return this.id;
276        }
277
278        @Override
279        public Long getVersionNumber() {
280            return this.versionNumber;
281        }
282
283        @Override
284        public String getObjectId() {
285            return this.objectId;
286        }
287
288        public void setName(String name) {
289            if (StringUtils.isBlank(name)) {
290                throw new IllegalArgumentException("name is null or blank");
291            }
292            this.name = name;
293        }
294
295        public void setDescription(String description) {
296            this.description = description;
297        }
298
299        public void setDelegationTemplate(RuleTemplate.Builder delegationTemplate) {
300            this.delegationTemplate = delegationTemplate;
301        }
302
303        public void setRuleTemplateAttributes(List<RuleTemplateAttribute.Builder> ruleTemplateAttributes) {
304            this.ruleTemplateAttributes = Collections.unmodifiableList(ruleTemplateAttributes);
305        }
306
307        public void setRuleTemplateOptions(List<RuleTemplateOption.Builder> ruleTemplateOptions) {
308            this.ruleTemplateOptions = Collections.unmodifiableList(ruleTemplateOptions);
309        }
310
311        public void setId(String id) {
312            if (StringUtils.isWhitespace(id)) {
313                throw new IllegalArgumentException("id was whitespace");
314            }
315            this.id = id;
316        }
317
318        public void setVersionNumber(Long versionNumber) {
319            this.versionNumber = versionNumber;
320        }
321
322        public void setObjectId(String objectId) {
323            this.objectId = objectId;
324        }
325
326    }
327
328
329    /**
330     * Defines some internal constants used on this class.
331     * 
332     */
333    static class Constants {
334
335        final static String ROOT_ELEMENT_NAME = "ruleTemplate";
336        final static String TYPE_NAME = "RuleTemplateType";
337
338    }
339
340
341    /**
342     * A private class which exposes constants which define the XML element names to use when this object is marshalled to XML.
343     * 
344     */
345    static class Elements {
346
347        final static String NAME = "name";
348        final static String DESCRIPTION = "description";
349        final static String DELEGATION_TEMPLATE = "delegationTemplate";
350        final static String RULE_TEMPLATE_ATTRIBUTES = "ruleTemplateAttributes";
351        final static String RULE_TEMPLATE_OPTIONS = "ruleTemplateOptions";
352        final static String RULE_TEMPLATE_ATTRIBUTE = "ruleTemplateAttribute";
353        final static String RULE_TEMPLATE_OPTION = "ruleTemplateOption";
354        final static String ID = "id";
355
356    }
357
358    public static class Cache {
359        public static final String NAME = KewApiConstants.Namespaces.KEW_NAMESPACE_2_0 + "/" + RuleTemplate.Constants.TYPE_NAME;
360    }
361}