Merge branch 'FearlessKiwis-MAGETWO-32896-Quote-Immutability' into develop

Conflicts:
	app/code/Magento/Quote/Model/Cart/ShippingMethodConverter.php

Author: Yu Tang

app/code/Magento/Quote/Api/Data/AddressInterface.php

@@ -16,11 +16,11 @@ interface AddressInterface extends \Magento\Framework\Api\ExtensibleDataInterfac
 
     const KEY_ID = 'id';
 
-    const REGION_ID = 'region_id';
+    const KEY_REGION_ID = 'region_id';
 
-    const REGION_CODE = 'region_code';
+    const KEY_REGION_CODE = 'region_code';
 
-    const REGION = 'region';
+    const KEY_REGION = 'region';
 
     const KEY_CUSTOMER_ID = 'customer_id';
 
@@ -57,129 +57,281 @@ interface AddressInterface extends \Magento\Framework\Api\ExtensibleDataInterfac
      */
     public function getId();
 
+    /**
+     * Set id
+     *
+     * @param int $id
+     * @return $this
+     */
+    public function setId($id);
+
     /**
      * Get region name
      *
      * @return string
      */
     public function getRegion();
 
+    /**
+     * Set region name
+     *
+     * @param string $region
+     * @return $this
+     */
+    public function setRegion($region);
+
     /**
      * Get region id
      *
-     * @return string
+     * @return int
      */
     public function getRegionId();
 
+    /**
+     * Set region id
+     *
+     * @param int $regionId
+     * @return $this
+     */
+    public function setRegionId($regionId);
+
     /**
      * Get region code
      *
      * @return string
      */
     public function getRegionCode();
 
+    /**
+     * Set region code
+     *
+     * @param string $regionCode
+     * @return $this
+     */
+    public function setRegionCode($regionCode);
+
     /**
      * Get country id
      *
      * @return string
      */
     public function getCountryId();
 
+    /**
+     * Set country id
+     *
+     * @param string $countryId
+     * @return $this
+     */
+    public function setCountryId($countryId);
+
     /**
      * Get street
      *
      * @return string[]
      */
     public function getStreet();
 
+    /**
+     * Set street
+     *
+     * @param string|string[] $street
+     * @return $this
+     */
+    public function setStreet($street);
+
     /**
      * Get company
      *
      * @return string|null
      */
     public function getCompany();
 
+    /**
+     * Set company
+     *
+     * @param string $company
+     * @return $this
+     */
+    public function setCompany($company);
+
     /**
      * Get telephone number
      *
      * @return string
      */
     public function getTelephone();
 
+    /**
+     * Set telephone number
+     *
+     * @param string $telephone
+     * @return $this
+     */
+    public function setTelephone($telephone);
+
     /**
      * Get fax number
      *
      * @return string|null
      */
     public function getFax();
 
+    /**
+     * Set fax number
+     *
+     * @param string $fax
+     * @return $this
+     */
+    public function setFax($fax);
+
     /**
      * Get postcode
      *
      * @return string
      */
     public function getPostcode();
 
+    /**
+     * Set postcode
+     *
+     * @param string $postcode
+     * @return $this
+     */
+    public function setPostcode($postcode);
+
     /**
      * Get city name
      *
      * @return string
      */
     public function getCity();
 
+    /**
+     * Set city name
+     *
+     * @param string $city
+     * @return $this
+     */
+    public function setCity($city);
+
     /**
      * Get first name
      *
      * @return string
      */
     public function getFirstname();
 
+    /**
+     * Set first name
+     *
+     * @param string $firstname
+     * @return $this
+     */
+    public function setFirstname($firstname);
+
     /**
      * Get last name
      *
      * @return string
      */
     public function getLastname();
 
+    /**
+     * Set last name
+     *
+     * @param string $lastname
+     * @return $this
+     */
+    public function setLastname($lastname);
+
     /**
      * Get middle name
      *
      * @return string|null
      */
     public function getMiddlename();
 
+    /**
+     * Set middle name
+     *
+     * @param string $middlename
+     * @return $this
+     */
+    public function setMiddlename($middlename);
+
     /**
      * Get prefix
      *
      * @return string|null
      */
     public function getPrefix();
 
+    /**
+     * Set prefix
+     *
+     * @param string $prefix
+     * @return $this
+     */
+    public function setPrefix($prefix);
+
     /**
      * Get suffix
      *
      * @return string|null
      */
     public function getSuffix();
 
+    /**
+     * Set suffix
+     *
+     * @param string $suffix
+     * @return $this|null
+     */
+    public function setSuffix($suffix);
+
     /**
      * Get Vat id
      *
      * @return string|null
      */
     public function getVatId();
 
+    /**
+     * Set Vat id
+     *
+     * @param string $vatId
+     * @return $this
+     */
+    public function setVatId($vatId);
+
     /**
      * Get customer id
      *
-     * @return string|null
+     * @return int|null
      */
     public function getCustomerId();
 
+    /**
+     * Set customer id
+     *
+     * @param int $customerId
+     * @return $this
+     */
+    public function setCustomerId($customerId);
+
     /**
      * Get billing/shipping email
      *
      * @return string
      */
     public function getEmail();
+
+    /**
+     * Set billing/shipping email
+     *
+     * @param string $email
+     * @return $this
+     */
+    public function setEmail($email);
 }