001 /**
002 * Copyright 2005-2014 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 */
016 package org.kuali.rice.kew.api.document;
017
018 import java.io.Serializable;
019 import java.util.Collection;
020
021 import javax.xml.bind.annotation.XmlAccessType;
022 import javax.xml.bind.annotation.XmlAccessorType;
023 import javax.xml.bind.annotation.XmlAnyElement;
024 import javax.xml.bind.annotation.XmlElement;
025 import javax.xml.bind.annotation.XmlRootElement;
026 import javax.xml.bind.annotation.XmlType;
027
028 import org.apache.commons.lang.StringUtils;
029 import org.kuali.rice.core.api.CoreConstants;
030 import org.kuali.rice.core.api.mo.AbstractDataTransferObject;
031 import org.kuali.rice.core.api.mo.ModelBuilder;
032 import org.kuali.rice.kew.api.KewApiConstants;
033 import org.w3c.dom.Element;
034
035 @XmlRootElement(name = DocumentContent.Constants.ROOT_ELEMENT_NAME)
036 @XmlAccessorType(XmlAccessType.NONE)
037 @XmlType(name = DocumentContent.Constants.TYPE_NAME, propOrder = {
038 DocumentContent.Elements.DOCUMENT_ID,
039 DocumentContent.Elements.APPLICATION_CONTENT,
040 DocumentContent.Elements.ATTRIBUTE_CONTENT,
041 DocumentContent.Elements.SEARCHABLE_CONTENT,
042 DocumentContent.Elements.FORMAT_VERSION,
043 CoreConstants.CommonElements.FUTURE_ELEMENTS
044 })
045 public final class DocumentContent extends AbstractDataTransferObject implements DocumentContentContract {
046
047 private static final long serialVersionUID = 6110079520547685342L;
048
049 @XmlElement(name = Elements.DOCUMENT_ID, required = true)
050 private final String documentId;
051
052 @XmlElement(name = Elements.APPLICATION_CONTENT, required = false)
053 private final String applicationContent;
054
055 @XmlElement(name = Elements.ATTRIBUTE_CONTENT, required = false)
056 private final String attributeContent;
057
058 @XmlElement(name = Elements.SEARCHABLE_CONTENT, required = false)
059 private final String searchableContent;
060
061 @XmlElement(name = Elements.FORMAT_VERSION, required = true)
062 private final int formatVersion;
063
064 @SuppressWarnings("unused")
065 @XmlAnyElement
066 private final Collection<Element> _futureElements = null;
067
068 /**
069 * Private constructor used only by JAXB.
070 *
071 */
072 private DocumentContent() {
073 this.documentId = null;
074 this.applicationContent = null;
075 this.attributeContent = null;
076 this.searchableContent = null;
077 this.formatVersion = 0;
078 }
079
080 private DocumentContent(Builder builder) {
081 this.documentId = builder.getDocumentId();
082 this.applicationContent = builder.getApplicationContent();
083 this.attributeContent = builder.getAttributeContent();
084 this.searchableContent = builder.getSearchableContent();
085 this.formatVersion = builder.getFormatVersion();
086 }
087
088 @Override
089 public String getDocumentId() {
090 return this.documentId;
091 }
092
093 @Override
094 public String getApplicationContent() {
095 return this.applicationContent;
096 }
097
098 @Override
099 public String getAttributeContent() {
100 return this.attributeContent;
101 }
102
103 @Override
104 public String getSearchableContent() {
105 return this.searchableContent;
106 }
107
108 @Override
109 public int getFormatVersion() {
110 return this.formatVersion;
111 }
112
113 public String getFullContent() {
114 StringBuilder fullContent = new StringBuilder();
115 fullContent.append("<").append(KewApiConstants.DOCUMENT_CONTENT_ELEMENT).append(">");
116 if (!StringUtils.isBlank(getApplicationContent())) {
117 fullContent.append("<").append(KewApiConstants.APPLICATION_CONTENT_ELEMENT).append(">");
118 fullContent.append(getApplicationContent());
119 fullContent.append("</").append(KewApiConstants.APPLICATION_CONTENT_ELEMENT).append(">");
120 }
121 if (!StringUtils.isBlank(getAttributeContent())) {
122 fullContent.append(getAttributeContent());
123 }
124 if (!StringUtils.isBlank(getSearchableContent())) {
125 fullContent.append(getSearchableContent());
126 }
127 fullContent.append("</").append(KewApiConstants.DOCUMENT_CONTENT_ELEMENT).append(">");
128 return fullContent.toString();
129 }
130
131 /**
132 * A builder which can be used to construct {@link DocumentContent} instances. Enforces the constraints of the {@link DocumentContentContract}.
133 */
134 public final static class Builder implements Serializable, ModelBuilder, DocumentContentContract {
135
136 private static final long serialVersionUID = 7549637048594326790L;
137
138 private String documentId;
139 private String applicationContent;
140 private String attributeContent;
141 private String searchableContent;
142 private int formatVersion;
143
144 private Builder(String documentId) {
145 setDocumentId(documentId);
146 setFormatVersion(KewApiConstants.DocumentContentVersions.CURRENT);
147 }
148
149 public static Builder create(String documentId) {
150 return new Builder(documentId);
151 }
152
153 public static Builder create(DocumentContentContract contract) {
154 if (contract == null) {
155 throw new IllegalArgumentException("contract was null");
156 }
157 Builder builder = create(contract.getDocumentId());
158 builder.setApplicationContent(contract.getApplicationContent());
159 builder.setAttributeContent(contract.getAttributeContent());
160 builder.setSearchableContent(contract.getSearchableContent());
161 builder.setFormatVersion(contract.getFormatVersion());
162 return builder;
163 }
164
165 public DocumentContent build() {
166 return new DocumentContent(this);
167 }
168
169 @Override
170 public String getDocumentId() {
171 return this.documentId;
172 }
173
174 @Override
175 public String getApplicationContent() {
176 return this.applicationContent;
177 }
178
179 @Override
180 public String getAttributeContent() {
181 return this.attributeContent;
182 }
183
184 @Override
185 public String getSearchableContent() {
186 return this.searchableContent;
187 }
188
189 @Override
190 public int getFormatVersion() {
191 return this.formatVersion;
192 }
193
194 public void setDocumentId(String documentId) {
195 if (StringUtils.isBlank(documentId)) {
196 throw new IllegalArgumentException("documentId was null or blank");
197 }
198 this.documentId = documentId;
199 }
200
201 public void setApplicationContent(String applicationContent) {
202 this.applicationContent = applicationContent;
203 }
204
205 public void setAttributeContent(String attributeContent) {
206 this.attributeContent = attributeContent;
207 }
208
209 public void setSearchableContent(String searchableContent) {
210 this.searchableContent = searchableContent;
211 }
212
213 public void setFormatVersion(int formatVersion) {
214 if (formatVersion < 0) {
215 throw new IllegalArgumentException("formatVersion must be a valid version, was " + formatVersion);
216 }
217 this.formatVersion = formatVersion;
218 }
219
220 }
221
222 /**
223 * Defines some internal constants used on this class.
224 */
225 static class Constants {
226
227 final static String ROOT_ELEMENT_NAME = "documentContent";
228 final static String TYPE_NAME = "DocumentContentType";
229 }
230
231 /**
232 * A private class which exposes constants which define the XML element names to use when this object is marshalled to XML.
233 */
234 static class Elements {
235
236 final static String DOCUMENT_ID = "documentId";
237 final static String APPLICATION_CONTENT = "applicationContent";
238 final static String ATTRIBUTE_CONTENT = "attributeContent";
239 final static String SEARCHABLE_CONTENT = "searchableContent";
240 final static String FORMAT_VERSION = "formatVersion";
241
242 }
243
244 }
245