io.sphere.sdk.carts.CartLike Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of commercetools-models Show documentation
There is a newer version: 2.16.0
package io.sphere.sdk.carts;

import com.fasterxml.jackson.annotation.JsonIgnore;
import com.neovisionaries.i18n.CountryCode;
import io.sphere.sdk.customergroups.CustomerGroup;
import io.sphere.sdk.customers.Customer;
import io.sphere.sdk.discountcodes.DiscountCodeInfo;
import io.sphere.sdk.models.Address;
import io.sphere.sdk.models.Resource;
import io.sphere.sdk.models.Reference;
import io.sphere.sdk.types.Custom;
import io.sphere.sdk.types.CustomFields;

import javax.annotation.Nullable;
import javax.money.CurrencyUnit;
import javax.money.MonetaryAmount;
import java.util.List;
import java.util.Optional;

/**
 * Interface to collect the common stuff between carts and orders.
 *
 * If you want to use this class as abstraction for {@link Cart} and {@link io.sphere.sdk.orders.Order} then use it as {@code CartLike}.
 *
 * @param  the type of this {@link CartLike}, order or cart
 */
public interface CartLike extends Resource, Custom {

    /**
     * The ID of the customer to which this cart/order belongs to.
     *
     * @see io.sphere.sdk.customers.commands.CustomerSignInCommand
     * @see io.sphere.sdk.carts.commands.updateactions.SetCustomerId
     *
     * @return id of the customer or null
     */
    @Nullable
    String getCustomerId();

    /**
     * The email of the customer which should be used for this cart/order. It can differ from {@link Customer#getEmail()}.
     *
     * @see io.sphere.sdk.carts.commands.updateactions.SetCustomerEmail
     *
     * @return email
     */
    @Nullable
    String getCustomerEmail();

    /**
     * Snapshots of the products added to the cart.
     *
     * @see io.sphere.sdk.carts.commands.updateactions.AddLineItem
     * @see io.sphere.sdk.carts.commands.updateactions.ChangeLineItemQuantity
     * @see io.sphere.sdk.carts.commands.updateactions.RemoveLineItem
     *
     * @return line items
     */
    List getLineItems();

    /**
     * Custom goods, fees or discounts added to the cart.
     *
     * @see io.sphere.sdk.carts.commands.updateactions.AddCustomLineItem
     * @see io.sphere.sdk.carts.commands.updateactions.RemoveCustomLineItem
     *
     * @return custom line items
     */
    List getCustomLineItems();

    /**
     * Searches for custom line items by ID of a custom line item.
     *
     * @param customLineItemId the ID of the custom line item to search for.
     * @return optional custom line item
     */
    default Optional findCustomLineItem(final String customLineItemId) {
        return getCustomLineItems().stream().filter(item -> item.getId().equals(customLineItemId)).findAny();
    }

    /**
     * Searches for line items by ID of a line item.
     *
     * @param lineItemId the ID of the line item to search for.
     * @return optional line item
     */
    default Optional findLineItem(final String lineItemId) {
        return getLineItems().stream().filter(item -> item.getId().equals(lineItemId)).findAny();
    }

    MonetaryAmount getTotalPrice();

    /**
     * The taxed price.
     *
     * The shipping address ({@link #getShippingAddress()}) is used to determine tax rate of the line items.
     *
     *
     * @return taxed price or null
     */
    @Nullable
    TaxedPrice getTaxedPrice();

    /**
     * Address to ship the goods.
     *
     * @see io.sphere.sdk.carts.commands.updateactions.SetShippingAddress
     * @see #getTaxedPrice()
     *
     * @return address or null
     */
    @Nullable
    Address getShippingAddress();

    /**
     * Address for the bill.
     *
     * @see io.sphere.sdk.carts.commands.updateactions.SetBillingAddress
     *
     * @return address or null
     */
    @Nullable
    Address getBillingAddress();

    /**
     * In the order context the customer group can only be expanded if the customer was in a group before creating the order.
     *
     * @return reference of a customer group or null
     */
    @Nullable
    Reference getCustomerGroup();

    @Nullable
    CountryCode getCountry();

    /**
     * Discount codes belonging to this cart.
     *
     * @see io.sphere.sdk.carts.commands.updateactions.AddDiscountCode
     *
     * @return discount codes
     */
    List getDiscountCodes();

    @Nullable
    CustomFields getCustom();

    /**
     * Information about shipping set by the backend once the shipping method is set.
     *
     * @see io.sphere.sdk.carts.commands.updateactions.SetShippingMethod
     * @see io.sphere.sdk.carts.commands.updateactions.SetCustomShippingMethod
     * @see io.sphere.sdk.orders.commands.updateactions.AddDelivery
     *
     * @return shipping info
     */
    @Nullable
    CartShippingInfo getShippingInfo();

    /**
     * Get associated payments.
     *
     * @return payments
     * @see io.sphere.sdk.carts.commands.updateactions.AddPayment
     * @see io.sphere.sdk.carts.commands.updateactions.RemovePayment
     * @see io.sphere.sdk.orders.commands.updateactions.AddPayment
     * @see io.sphere.sdk.orders.commands.updateactions.RemovePayment
     */
    @Nullable
    PaymentInfo getPaymentInfo();

    /**
     * The currency of this cart/order.
     * @return currency
     */
    @JsonIgnore
    default CurrencyUnit getCurrency() {
        return getTotalPrice().getCurrency();
    }
}