/**

  * Copyright 2005-2011 The Kuali Foundation

  *

  * Licensed under the Educational Community License, Version 2.0 (the "License");

  * you may not use this file except in compliance with the License.

  * You may obtain a copy of the License at

  *

  * http://www.opensource.org/licenses/ecl2.php

  *

  * Unless required by applicable law or agreed to in writing, software

  * distributed under the License is distributed on an "AS IS" BASIS,

  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  * See the License for the specific language governing permissions and

  * limitations under the License.

  */

 package org.kuali.rice.krms.api.repository.term;

 import java.io.Serializable;

 import java.util.Collection;

 import java.util.List;

 import javax.xml.bind.annotation.XmlAccessType;

 import javax.xml.bind.annotation.XmlAccessorType;

 import javax.xml.bind.annotation.XmlAnyElement;

 import javax.xml.bind.annotation.XmlElement;

 import javax.xml.bind.annotation.XmlElementWrapper;

 import javax.xml.bind.annotation.XmlRootElement;

 import javax.xml.bind.annotation.XmlType;

 import org.apache.commons.lang.StringUtils;

 import org.jdom.IllegalAddException;

 import org.kuali.rice.core.api.CoreConstants;

 import org.kuali.rice.core.api.mo.AbstractDataTransferObject;

 import org.kuali.rice.core.api.mo.ModelBuilder;

 import org.kuali.rice.krms.api.repository.BuilderUtils;

 /**

  * Immutable DTO for Terms.  Construction must be done via the {@link Builder} inner class.

  * 

  * @author Kuali Rice Team (rice.collab@kuali.org)

  *

  */

 @XmlRootElement(name = TermDefinition.Constants.ROOT_ELEMENT_NAME)

 @XmlAccessorType(XmlAccessType.NONE)

 @XmlType(name = TermDefinition.Constants.TYPE_NAME, propOrder = {

                 TermDefinition.Elements.ID,

         TermDefinition.Elements.SPECIFICATION,

         TermDefinition.Elements.DESCRIPTION,

                 TermDefinition.Elements.PARAMETERS,

         CoreConstants.CommonElements.VERSION_NUMBER,

                 CoreConstants.CommonElements.FUTURE_ELEMENTS

 })

 public final class TermDefinition extends AbstractDataTransferObject implements TermDefinitionContract {

         private static final long serialVersionUID = 1L;

         @XmlElement(name = Elements.ID, required=false)

         private final String id;

         @XmlElement(name = Elements.SPECIFICATION, required=true)

         private final TermSpecificationDefinition specification;

     @XmlElement(name = Elements.DESCRIPTION, required=false)

     private final String description;

         @XmlElementWrapper(name = Elements.PARAMETERS, required=false)

         @XmlElement(name = "parameter", required=false)

         private final List<TermParameterDefinition> parameters;

     @XmlElement(name = CoreConstants.CommonElements.VERSION_NUMBER, required = false)

     private final Long versionNumber;

         @SuppressWarnings("unused")

     @XmlAnyElement

     private final Collection<org.w3c.dom.Element> _futureElements = null;

         /**

          * This constructor is for JAXB only.  Do not invoke directly.

          */

         private TermDefinition() {

                 id = null;

                 specification = null;

         description = null;

                 parameters = null;

         versionNumber = null;

         }

         private TermDefinition(Builder builder) {

                 id = builder.getId();

                 specification = builder.getSpecification().build();

         description = builder.getDescription();

                 parameters = BuilderUtils.convertFromBuilderList(builder.getParameters());

                 versionNumber = builder.getVersionNumber();

         }

         /**

          * {@link ModelBuilder} for {@link TermDefinition}s.

          * 

          * @author Kuali Rice Team (rice.collab@kuali.org)

          *

          */

         public static class Builder implements TermDefinitionContract, ModelBuilder, Serializable {

                 private static final long serialVersionUID = 1L;

                 private String id;

         private String description;

                 private TermSpecificationDefinition.Builder specification;

                 private List<TermParameterDefinition.Builder> parameters;

         private Long versionNumber;

                 private Builder(String id, TermSpecificationDefinition.Builder termSpecificationDefinition, 

                                 List<TermParameterDefinition.Builder> termParameters) {

                         setId(id);

                         setSpecification(termSpecificationDefinition);

                         setParameters(termParameters);

                 }

                 /**

                  * static factory for creating a {@link Builder}.

                  * 

                  * @param id may be null.

                  * @param termSpecification must not be null.

                  * @param termParameters may be null.

                  */

                 public static Builder create(String id, TermSpecificationDefinition.Builder termSpecification, 

                                 List<TermParameterDefinition.Builder> termParameters) {

                         return new Builder(id, termSpecification, termParameters);

                 }

                 /**

                  * static factory for creating a {@link Builder} from a {@link TermDefinitionContract}.

                  * 

                  * @param term must be non-null.

                  */

                 public static Builder create(TermDefinitionContract term) {

                         if (term == null) throw new IllegalAddException("term may not be null");

                         // Convert TermParameterDefinitionContract to TermParameterDefinition:

                         List<TermParameterDefinition.Builder> outParams =

                                 BuilderUtils.transform(term.getParameters(), TermParameterDefinition.Builder.toBuilder);

                         Builder builder = create(term.getId(), 

                                         // doing my TermSpecificationDefinitionContract conversion inline:

                                         TermSpecificationDefinition.Builder.create(term.getSpecification()),

                                         // this is made immutable in the setter

                                         outParams 

                                         );

             builder.setDescription(term.getDescription());

                         builder.setVersionNumber(term.getVersionNumber());

                         return builder;

                 }

         public void setDescription(String description) {

             this.description = description;

         }

         // Builder setters:

                 /**

                  * @param id the id to set.  Should be null to build {@link TermDefinition}s for creation operations.

                  * @throws IllegalArgumentException if the id is non-null and only contains whitespace

                  */

                 public void setId(String id) {

                         if (id != null && StringUtils.isBlank(id)) {

                                 throw new IllegalArgumentException("id must contain non-whitespace chars");

                         }

                         this.id = id;

                 }

                 /**

                  * @param termSpecification the termSpecification to set

                  * @throws IllegalArgumentException if termSpecification is null

                  */

                 public void setSpecification(TermSpecificationDefinition.Builder termSpecification) {

                         if (termSpecification == null) {

                                 throw new IllegalArgumentException("termSpecification must not be null");

                         }

                         this.specification = termSpecification;

                 }

                 /**

                  * @param parameters the termParameters to set.  May be null, or empty.

                  */

                 public void setParameters(List<TermParameterDefinition.Builder> parameters) {

                         this.parameters = parameters;

                 }

                 /**

                  * @param versionNumber the versionNumber to set.  May be null.

                  */

         public void setVersionNumber(Long versionNumber){

             this.versionNumber = versionNumber;

         }

                 // Builder getters:

                 /**

                  * @return the id

                  */

                 @Override

                 public String getId() {

                         return id;

                 }

                 /**

                  * @return the termSpecification

                  */

                 @Override

                 public TermSpecificationDefinition.Builder getSpecification() {

                         return specification;

                 }

         @Override

         public String getDescription() {

             return description;

         }

         /**

                  * @return the termParameters

                  */

                 @Override

                 public List<TermParameterDefinition.Builder> getParameters() {

                         return parameters;

                 }

                 /**

                  * @return the version number

                  */

         @Override

         public Long getVersionNumber() {

             return this.versionNumber;

         }

                 /**

                  * Builds the {@link TermDefinition}, or dies trying.

                  * 

                  * @see org.kuali.rice.core.api.mo.ModelBuilder#build()

                  * @throws IllegalStateException if builder validation fails

                  */

                 @Override

                 public TermDefinition build() {

                         return new TermDefinition(this);

                 }

         }

         /**

          * @return the termId.  May be null if this {@link TermDefinition} hasn't been persisted.

          */

         @Override

         public String getId() {

                 return this.id;

         }

         /**

          * @return the specification.  Will never be null.

          */

         @Override

         public TermSpecificationDefinition getSpecification() {

                 return this.specification;

         }

     @Override

     public String getDescription() {

         return description;

     }

     /**

          * @return the parameters.  May be empty, but will never be null.

          */

         @Override

         public List<TermParameterDefinition> getParameters() {

                 return this.parameters;

         }

         /**

          * @see org.kuali.rice.core.api.mo.common.Versioned#getVersionNumber()

          */

     @Override

     public Long getVersionNumber() {

         return versionNumber;

     }

         static class Constants {

                 public static final String ROOT_ELEMENT_NAME = "termDefinition";

                 public static final String TYPE_NAME = "termDefinitionType";

         }

         static class Elements {

                 public static final String ID = "id";

                 public static final String SPECIFICATION = "specification";

                 public static final String PARAMETERS = "parameters";

         public static final String DESCRIPTION = "description";

     }

 }