001    /*
002     * The MIT License
003     * Copyright (c) 2012 Microsoft Corporation
004     *
005     * Permission is hereby granted, free of charge, to any person obtaining a copy
006     * of this software and associated documentation files (the "Software"), to deal
007     * in the Software without restriction, including without limitation the rights
008     * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
009     * copies of the Software, and to permit persons to whom the Software is
010     * furnished to do so, subject to the following conditions:
011     *
012     * The above copyright notice and this permission notice shall be included in
013     * all copies or substantial portions of the Software.
014     *
015     * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
016     * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
017     * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
018     * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
019     * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
020     * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
021     * THE SOFTWARE.
022     */
023    
024    package microsoft.exchange.webservices.data.property.complex;
025    
026    import microsoft.exchange.webservices.data.core.EwsServiceXmlReader;
027    import microsoft.exchange.webservices.data.core.EwsServiceXmlWriter;
028    import microsoft.exchange.webservices.data.core.EwsUtilities;
029    import microsoft.exchange.webservices.data.core.XmlAttributeNames;
030    import microsoft.exchange.webservices.data.core.XmlElementNames;
031    import microsoft.exchange.webservices.data.core.enumeration.property.BodyType;
032    import microsoft.exchange.webservices.data.core.exception.service.local.ServiceXmlDeserializationException;
033    import microsoft.exchange.webservices.data.core.exception.service.local.ServiceXmlSerializationException;
034    
035    import javax.xml.stream.XMLStreamException;
036    
037    /**
038     * Represents the body part of an item that is unique to the conversation the
039     * item is part of.
040     */
041    public final class UniqueBody extends ComplexProperty {
042    
043      /**
044       * The body type.
045       */
046      private BodyType bodyType;
047    
048      /**
049       * The text.
050       */
051      private String text;
052    
053      /**
054       * Initializes a new instance.
055       */
056      public UniqueBody() {
057      }
058    
059      /**
060       * Defines an implicit conversion of UniqueBody into a string.
061       *
062       * @param messageBody the message body
063       * @return string containing the text of the UniqueBody
064       * @throws Exception the exception
065       */
066      public static String getStringFromUniqueBody(UniqueBody messageBody)
067          throws Exception {
068        EwsUtilities.validateParam(messageBody, "messageBody");
069        return messageBody.text;
070      }
071    
072      /**
073       * Reads attribute from XML.
074       *
075       * @param reader the reader
076       * @throws Exception the exception
077       */
078      public void readAttributesFromXml(EwsServiceXmlReader reader)
079          throws Exception {
080        this.bodyType = reader.readAttributeValue(BodyType.class,
081            XmlAttributeNames.BodyType);
082      }
083    
084      /**
085       * Reads attribute from XML.
086       *
087       * @param reader the reader
088       * @throws XMLStreamException the xml stream exception
089       * @throws ServiceXmlDeserializationException the service xml deserialization exception
090       */
091      public void readTextValueFromXml(EwsServiceXmlReader reader)
092          throws XMLStreamException, ServiceXmlDeserializationException {
093        this.text = reader.readValue();
094      }
095    
096      /**
097       * Writes attributes from XML.
098       *
099       * @param writer the writer
100       * @throws ServiceXmlSerializationException the service xml serialization exception
101       */
102      public void writeAttributesToXml(EwsServiceXmlWriter writer)
103          throws ServiceXmlSerializationException {
104        writer.writeAttributeValue(XmlAttributeNames.BodyType, this.bodyType);
105      }
106    
107      /**
108       * Writes elements to XML.
109       *
110       * @param writer the writer
111       * @throws ServiceXmlSerializationException the service xml serialization exception
112       */
113      public void writeElementsToXml(EwsServiceXmlWriter writer)
114          throws ServiceXmlSerializationException {
115        if (!(this.text == null || this.text.isEmpty())) {
116          writer.writeValue(this.text, XmlElementNames.UniqueBody);
117        }
118      }
119    
120      /**
121       * Gets the type of the unique body's text.
122       *
123       * @return bodytype
124       */
125      public BodyType getBodyType() {
126        return this.bodyType;
127      }
128    
129      /**
130       * Gets the text of the unique body.
131       *
132       * @return text
133       */
134      public String getText() {
135        return this.text;
136      }
137    
138      /*
139       * (non-Javadoc)
140       *
141       * @see java.lang.Object#toString()
142       */
143      @Override
144      public String toString() {
145        return (this.getText() == null) ? "" : this.getText();
146      }
147    
148    }