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.peopleflow;
017
018import org.apache.commons.lang.StringUtils;
019import org.kuali.rice.core.api.CoreConstants;
020import org.kuali.rice.core.api.delegation.DelegationType;
021import org.kuali.rice.core.api.membership.MemberType;
022import org.kuali.rice.core.api.mo.AbstractDataTransferObject;
023import org.kuali.rice.core.api.mo.ModelBuilder;
024import org.kuali.rice.kew.api.action.ActionRequestPolicy;
025import org.w3c.dom.Element;
026
027import javax.xml.bind.annotation.XmlAccessType;
028import javax.xml.bind.annotation.XmlAccessorType;
029import javax.xml.bind.annotation.XmlAnyElement;
030import javax.xml.bind.annotation.XmlElement;
031import javax.xml.bind.annotation.XmlRootElement;
032import javax.xml.bind.annotation.XmlType;
033import java.io.Serializable;
034import java.util.Collection;
035
036@XmlRootElement(name = PeopleFlowDelegate.Constants.ROOT_ELEMENT_NAME)
037@XmlAccessorType(XmlAccessType.NONE)
038@XmlType(name = PeopleFlowDelegate.Constants.TYPE_NAME, propOrder = {
039        PeopleFlowDelegate.Elements.MEMBER_ID,
040        PeopleFlowDelegate.Elements.MEMBER_TYPE,
041        PeopleFlowDelegate.Elements.ACTION_REQUEST_POLICY,
042        PeopleFlowDelegate.Elements.DELEGATION_TYPE,
043        PeopleFlowDelegate.Elements.RESPONSIBILITY_ID,
044        CoreConstants.CommonElements.FUTURE_ELEMENTS
045})
046public final class PeopleFlowDelegate extends AbstractDataTransferObject implements PeopleFlowDelegateContract {
047
048    @XmlElement(name = Elements.MEMBER_ID, required = true)
049    private final String memberId;
050
051    @XmlElement(name = Elements.MEMBER_TYPE, required = true)
052    private final MemberType memberType;
053
054    @XmlElement(name = Elements.ACTION_REQUEST_POLICY, required = false)
055    private final ActionRequestPolicy actionRequestPolicy;
056
057    @XmlElement(name = Elements.DELEGATION_TYPE, required = true)
058    private final DelegationType delegationType;
059
060    @XmlElement(name = Elements.RESPONSIBILITY_ID, required = false)
061    private final String responsibilityId;
062
063    @SuppressWarnings("unused")
064    @XmlAnyElement
065    private final Collection<Element> _futureElements = null;
066
067    /**
068     * Private constructor used only by JAXB.
069     */
070    @SuppressWarnings("unused")
071    private PeopleFlowDelegate() {
072        this.memberId = null;
073        this.memberType = null;
074        this.actionRequestPolicy = null;
075        this.delegationType = null;
076        this.responsibilityId = null;
077    }
078
079    private PeopleFlowDelegate(Builder builder) {
080        this.memberId = builder.getMemberId();
081        this.memberType = builder.getMemberType();
082        this.actionRequestPolicy = builder.getActionRequestPolicy();
083        this.delegationType = builder.getDelegationType();
084        this.responsibilityId = builder.getResponsibilityId();
085    }
086
087    @Override
088    public String getMemberId() {
089        return this.memberId;
090    }
091
092    @Override
093    public MemberType getMemberType() {
094        return this.memberType;
095    }
096
097    @Override
098    public ActionRequestPolicy getActionRequestPolicy() {
099        return actionRequestPolicy;
100    }
101
102    @Override
103    public DelegationType getDelegationType() {
104        return this.delegationType;
105    }
106
107    @Override
108    public String getResponsibilityId() {
109        return responsibilityId;
110    }
111
112    /**
113     * A builder which can be used to construct {@link PeopleFlowDelegate} instances.  Enforces the constraints of the
114     * {@link PeopleFlowDelegateContract}.
115     * 
116     */
117    public final static class Builder implements Serializable, ModelBuilder, PeopleFlowDelegateContract {
118
119        private String memberId;
120        private MemberType memberType;
121        private ActionRequestPolicy actionRequestPolicy;
122        private DelegationType delegationType;
123        private String responsibilityId;
124
125        private Builder(String memberId, MemberType memberType) {
126            setMemberId(memberId);
127            setMemberType(memberType);
128            setDelegationType(DelegationType.SECONDARY);
129        }
130
131        public static Builder create(String memberId, MemberType memberType) {
132            return new Builder(memberId, memberType);
133        }
134
135        public static Builder create(PeopleFlowDelegateContract contract) {
136            if (contract == null) {
137                throw new IllegalArgumentException("contract was null");
138            }
139            Builder builder = create(contract.getMemberId(), contract.getMemberType());
140            builder.setActionRequestPolicy(contract.getActionRequestPolicy());
141            builder.setDelegationType(contract.getDelegationType());
142            builder.setResponsibilityId(contract.getResponsibilityId());
143            return builder;
144        }
145
146        public PeopleFlowDelegate build() {
147            return new PeopleFlowDelegate(this);
148        }
149
150        @Override
151        public String getMemberId() {
152            return this.memberId;
153        }
154
155        @Override
156        public MemberType getMemberType() {
157            return this.memberType;
158        }
159
160        @Override
161        public ActionRequestPolicy getActionRequestPolicy() {
162            return actionRequestPolicy;
163        }
164
165        @Override
166        public DelegationType getDelegationType() {
167            return this.delegationType;
168        }
169
170        @Override
171        public String getResponsibilityId() {
172            return responsibilityId;
173        }
174
175        public void setMemberId(String memberId) {
176            if (StringUtils.isBlank(memberId)) {
177                throw new IllegalArgumentException("memberId was a null or blank value");
178            }
179            this.memberId = memberId;
180        }
181
182        public void setMemberType(MemberType memberType) {
183            if (memberType == null) {
184                throw new IllegalArgumentException("memberType was null");
185            }
186            this.memberType = memberType;
187        }
188
189        public void setActionRequestPolicy(ActionRequestPolicy actionRequestPolicy) {
190            if (this.memberType.equals(MemberType.ROLE)) {
191                if (actionRequestPolicy == null) {
192                    throw new IllegalArgumentException("actionRequestPolicy was null");
193                }
194                this.actionRequestPolicy = actionRequestPolicy;
195            }
196        }
197
198        public void setDelegationType(DelegationType delegationType) {
199            if (delegationType == null) {
200                throw new IllegalArgumentException("delegationType was null");
201            }
202            this.delegationType = delegationType;
203        }
204
205        public void setResponsibilityId(String responsibilityId) {
206            this.responsibilityId = responsibilityId;
207        }
208        
209    }
210
211    /**
212     * Defines some internal constants used on this class.
213     */
214    static class Constants {
215        final static String ROOT_ELEMENT_NAME = "peopleFlowDelegate";
216        final static String TYPE_NAME = "PeopleFlowDelegateType";
217    }
218
219    /**
220     * A private class which exposes constants which define the XML element names to use when this object is marshalled to XML.
221     */
222    static class Elements {
223        final static String MEMBER_ID = "memberId";
224        final static String MEMBER_TYPE = "memberType";
225        final static String ACTION_REQUEST_POLICY = "actionRequestPolicy";
226        final static String DELEGATION_TYPE = "delegationType";
227        final static String RESPONSIBILITY_ID = "responsibilityId";
228    }
229
230}