Units.java

/*
 * Copyright 2008 Robert Cooper, Temple of the Screaming Penguin
 *
 * Licensed under the Apache 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.apache.org/licenses/LICENSE-2.0
 *
 * 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 com.rometools.modules.yahooweather.types;

import java.io.Serializable;

import com.rometools.rome.feed.impl.EqualsBean;
import com.rometools.rome.feed.impl.ToStringBean;

/**
 * Units for various aspects of the forecast. Attributes:
 * <ul class="topspace">
 * <li>temperature: degree units, f for Fahrenheit or c for Celsius (character)</li>
 * <li>distance: units for distance, mi for miles or km for kilometers (string)</li>
 * <li>pressure: units of barometric pressure, in for pounds per square inch or mb for millibars
 * (string) [<em>I am pretty sure this is wrong.
 *           I believe this number of be inches of Mercury, not PSI.</em>]</li>
 * <li>speed: units of speed, mph for miles per hour or kph for kilometers per hour (string)</li>
 * </ul>
 * Note that the default RSS feed uses Fahrenheit degree units and English units for all other
 * attributes (miles, pounds per square inch, miles per hour). If Celsius has been specified as the
 * degree units for the feed (using the u request parameter), all the units are in metric format
 * (Celsius, kilometers, millibars, kilometers per hour).
 */
public class Units implements Serializable, Cloneable {

    private static final long serialVersionUID = 1L;
    private String temperature;
    private String distance;
    private String pressure;
    private String speed;

    /**
     * Simple constructor.
     */
    public Units() {
        super();
    }

    /**
     * @param temperature units of temp ("f" or "c");
     * @param distance units of distance ("mi" or "km")
     * @param pressure units of pressure ("in" or "mb")
     * @param speed units of speed ("mph" or "kph")
     */
    public Units(final String temperature, final String distance, final String pressure, final String speed) {
        super();
        this.temperature = temperature;
        this.distance = distance;
        this.pressure = pressure;
        this.speed = speed;
    }

    /**
     * Units of Temperature.
     *
     * @return temperature units of temp ("f" or "c");
     */
    public String getTemperature() {
        return temperature;
    }

    /**
     * Units of Temperature.
     *
     * @param temperature units of temp ("f" or "c");
     */
    public void setTemperature(final String temperature) {
        this.temperature = temperature;
    }

    /**
     * Units of distance
     *
     * @return distance units of distance ("mi" or "km")
     */
    public String getDistance() {
        return distance;
    }

    /**
     * Units of distance
     *
     * @param distance units of distance ("mi" or "km")
     */
    public void setDistance(final String distance) {
        this.distance = distance;
    }

    /**
     * Units of pressure
     *
     * @return units of pressure ("in" or "mb")
     */
    public String getPressure() {
        return pressure;
    }

    /**
     * Units of pressure
     *
     * @param pressure units of pressure ("in" or "mb")
     */
    public void setPressure(final String pressure) {
        this.pressure = pressure;
    }

    /**
     * Units of speed
     *
     * @return units of speed ("mph" or "kph")
     */
    public String getSpeed() {
        return speed;
    }

    /**
     * Units of speed
     *
     * @param speed units of speed ("mph" or "kph")
     */
    public void setSpeed(final String speed) {
        this.speed = speed;
    }

    @Override
    public boolean equals(final Object o) {
        return EqualsBean.beanEquals(Units.class, this, o);
    }

    @Override
    public int hashCode() {
        return EqualsBean.beanHashCode(this);
    }

    @Override
    public String toString() {
        return ToStringBean.toString(Units.class, this);
    }

    @Override
    public Object clone() {
        return new Units(temperature, distance, pressure, speed);
    }
}