<?php

namespace StructType;

use \WsdlToPhp\PackageBase\AbstractStructBase;

/**
 * This class stands for EnergyEfficiencyType StructType
 * Meta information extracted from the WSDL
 * - documentation: Type defining the <b>ImageURL</b>, <b>ImageDescription</b>, and <b>ProductInformationsheet</b> regulatory fields that are used at the listing level to provide Energy Efficiency Label related information.<br><span
 * class="tablenote"><b>Important: </b> When providing energy efficiency information on an appliance or smartphones and tablets listing, the energy efficiency <b>rating</b> and <b>range</b> of the item must be specified through the <a href =
 * "/devzone/xml/docs/reference/ebay/additem.html#Request.Item.ItemSpecifics" target="_blank">ItemSpecifics</a> container. Use the <a href = "/api-docs/commerce/taxonomy/resources/category_tree/methods/getItemAspectsForCategory"
 * target="_blank">getItemAspectsForCategory</a> method of the Taxonomy API to retrieve applicable rating and range values for a specified category.</span>
 * @subpackage Structs
 */
class EnergyEfficiencyType extends AbstractStructBase
{
    /**
     * The ImageURL
     * Meta information extracted from the WSDL
     * - documentation: The URL to the Energy Efficiency Label image that is applicable to an item. This field is required if an Energy Efficiency Label is provided. The URL provided must be an eBay Picture Services (EPS) URL only. You can upload pictures
     * to eBay Picture Services via the <strong>UploadSiteHostedPictures</strong> call.
     * - maxOccurs: 1
     * - minOccurs: 0
     * @var string
     */
    public $ImageURL;
    /**
     * The ImageDescription
     * Meta information extracted from the WSDL
     * - documentation: A brief verbal summary of the information included on the Energy Efficiency Label for an item.<br />For example, <em>On a scale of A to G the rating is E</em>.<br />As with all strings, you need to escape reserved characters such as
     * ampersand. This field is required if an Energy Efficiency Label is provided.
     * - maxOccurs: 1
     * - minOccurs: 0
     * @var string
     */
    public $ImageDescription;
    /**
     * The ProductInformationsheet
     * Meta information extracted from the WSDL
     * - documentation: The URL to the Product Information Sheet that provides complete manufacturer-provided efficiency information about an item. This field is required if an Energy Efficiency Label is provided. The URL provided must be an eBay Picture
     * Services (EPS) URL only. You can upload pictures to eBay Picture Services via the <strong>UploadSiteHostedPictures</strong> call.
     * - maxOccurs: 1
     * - minOccurs: 0
     * @var string
     */
    public $ProductInformationsheet;
    /**
     * The any
     * @var \DOMDocument
     */
    public $any;
    /**
     * Constructor method for EnergyEfficiencyType
     * @uses EnergyEfficiencyType::setImageURL()
     * @uses EnergyEfficiencyType::setImageDescription()
     * @uses EnergyEfficiencyType::setProductInformationsheet()
     * @uses EnergyEfficiencyType::setAny()
     * @param string $imageURL
     * @param string $imageDescription
     * @param string $productInformationsheet
     * @param \DOMDocument $any
     */
    public function __construct($imageURL = null, $imageDescription = null, $productInformationsheet = null, \DOMDocument $any = null)
    {
        $this
            ->setImageURL($imageURL)
            ->setImageDescription($imageDescription)
            ->setProductInformationsheet($productInformationsheet)
            ->setAny($any);
    }
    /**
     * Get ImageURL value
     * @return string|null
     */
    public function getImageURL()
    {
        return $this->ImageURL;
    }
    /**
     * Set ImageURL value
     * @param string $imageURL
     * @return \StructType\EnergyEfficiencyType
     */
    public function setImageURL($imageURL = null)
    {
        // validation for constraint: string
        if (!is_null($imageURL) && !is_string($imageURL)) {
            throw new \InvalidArgumentException(sprintf('Invalid value %s, please provide a string, %s given', var_export($imageURL, true), gettype($imageURL)), __LINE__);
        }
        $this->ImageURL = $imageURL;
        return $this;
    }
    /**
     * Get ImageDescription value
     * @return string|null
     */
    public function getImageDescription()
    {
        return $this->ImageDescription;
    }
    /**
     * Set ImageDescription value
     * @param string $imageDescription
     * @return \StructType\EnergyEfficiencyType
     */
    public function setImageDescription($imageDescription = null)
    {
        // validation for constraint: string
        if (!is_null($imageDescription) && !is_string($imageDescription)) {
            throw new \InvalidArgumentException(sprintf('Invalid value %s, please provide a string, %s given', var_export($imageDescription, true), gettype($imageDescription)), __LINE__);
        }
        $this->ImageDescription = $imageDescription;
        return $this;
    }
    /**
     * Get ProductInformationsheet value
     * @return string|null
     */
    public function getProductInformationsheet()
    {
        return $this->ProductInformationsheet;
    }
    /**
     * Set ProductInformationsheet value
     * @param string $productInformationsheet
     * @return \StructType\EnergyEfficiencyType
     */
    public function setProductInformationsheet($productInformationsheet = null)
    {
        // validation for constraint: string
        if (!is_null($productInformationsheet) && !is_string($productInformationsheet)) {
            throw new \InvalidArgumentException(sprintf('Invalid value %s, please provide a string, %s given', var_export($productInformationsheet, true), gettype($productInformationsheet)), __LINE__);
        }
        $this->ProductInformationsheet = $productInformationsheet;
        return $this;
    }
    /**
     * Get any value
     * @uses \DOMDocument::loadXML()
     * @param bool $asString true: returns XML string, false: returns \DOMDocument
     * @return \DOMDocument|null
     */
    public function getAny($asString = true)
    {
        $domDocument = null;
        if (!empty($this->any) && !$asString) {
            $domDocument = new \DOMDocument('1.0', 'UTF-8');
            $domDocument->loadXML($this->any);
        }
        return $asString ? $this->any : $domDocument;
    }
    /**
     * Set any value
     * @uses \DOMDocument::hasChildNodes()
     * @uses \DOMDocument::saveXML()
     * @uses \DOMNode::item()
     * @param \DOMDocument $any
     * @return \StructType\EnergyEfficiencyType
     */
    public function setAny(\DOMDocument $any = null)
    {
        $this->any = ($any instanceof \DOMDocument) && $any->hasChildNodes() ? $any->saveXML($any->childNodes->item(0)) : $any;
        return $this;
    }
}
