org.oxerr.youzan.service

Class ItemService

java.lang.Object

org.oxerr.youzan.service.ItemService

public class ItemService
extends Object

商品接口.

Field Summary

Fields

Modifier and Type	Field and Description
protected KdtApiClient	client
protected static com.fasterxml.jackson.core.type.TypeReference<Response<CouponConsume>>	COUPON_CONSUME_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Coupon>>	COUPON_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Coupons>>	COUPONS_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Item>>	ITEM_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Items>>	ITEMS_RESPONSE_TYPE_REF
protected com.fasterxml.jackson.databind.ObjectMapper	mapper
protected static com.fasterxml.jackson.core.type.TypeReference<Response<SelfFetchTrade>>	SELF_FETCH_TRADE_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Shop>>	SHOP_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Sku>>	SKU_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Skus>>	SKUS_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Success>>	SUCCESS_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<TimelimitedDiscounts>>	TIMELIMITED_DISCOUNTS_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Trade>>	TRADE_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Trades>>	TRADES_RESPONSE_TYPE_REF
protected static com.fasterxml.jackson.core.type.TypeReference<Response<Verifylogs>>	VERIFYLOGS_RESPONSE_TYPE_REF

Constructor Summary

Constructors

Constructor and Description
ItemService(KdtApiClient client)

Method Summary

Modifier and Type	Method and Description
GoodsDetail	addItem(GoodsDetail item, String fields) 新增一个商品.
boolean	deleteItem(Long numIid) 删除一个商品.
GoodsDetail	delistingItem(Long numIid, String fields) 商品下架.
boolean	delistingItems(Long[] numIids) 批量下架商品.
GoodsDetail[]	getInventoryItems(Long tagId, String q, Integer pageSize, Long pageNo, String orderBy, String fields, String banner) 获取仓库中的商品列表.
GoodsDetail	getItem(Long numIid, String fields, String alias) 获取单个商品信息.
GoodsDetail[]	getItems(String outerId, String fields) 根据商品货号获取商品.
GoodsDetail[]	getOnsaleItems(Long tagId, String q, Integer pageSize, Long pageNo, String orderBy, String fields) 获取出售中的商品列表.
GoodsSku[]	getSkus(String outerId, Long numIid, String fields) 根据外部编号取商品Sku.
GoodsDetail	listingItem(Long numIid, String fields) 商品上架.
boolean	listingItems(Long[] numIids) 批量上架商品.
protected <T> T	readValue(String method, Map<String,String> params, com.fasterxml.jackson.core.type.TypeReference valueTypeRef)
GoodsDetail	updateItem(GoodsDetail item, String fields) 更新单个商品信息.
GoodsSku	updateSku(Long skuId, Long quantity, BigDecimal price, String outerId, Long numIid) 更新SKU信息.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SUCCESS_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Success>> SUCCESS_RESPONSE_TYPE_REF

ITEM_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Item>> ITEM_RESPONSE_TYPE_REF

ITEMS_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Items>> ITEMS_RESPONSE_TYPE_REF

SKU_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Sku>> SKU_RESPONSE_TYPE_REF

SKUS_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Skus>> SKUS_RESPONSE_TYPE_REF

SHOP_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Shop>> SHOP_RESPONSE_TYPE_REF

TRADE_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Trade>> TRADE_RESPONSE_TYPE_REF

TRADES_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Trades>> TRADES_RESPONSE_TYPE_REF

SELF_FETCH_TRADE_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<SelfFetchTrade>> SELF_FETCH_TRADE_RESPONSE_TYPE_REF

COUPONS_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Coupons>> COUPONS_RESPONSE_TYPE_REF

COUPON_CONSUME_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<CouponConsume>> COUPON_CONSUME_RESPONSE_TYPE_REF

VERIFYLOGS_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Verifylogs>> VERIFYLOGS_RESPONSE_TYPE_REF

COUPON_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<Coupon>> COUPON_RESPONSE_TYPE_REF

TIMELIMITED_DISCOUNTS_RESPONSE_TYPE_REF

protected static final com.fasterxml.jackson.core.type.TypeReference<Response<TimelimitedDiscounts>> TIMELIMITED_DISCOUNTS_RESPONSE_TYPE_REF

client

protected final KdtApiClient client

mapper

protected final com.fasterxml.jackson.databind.ObjectMapper mapper

Constructor Detail

ItemService

public ItemService(KdtApiClient client)

Method Detail

deleteItem

public boolean deleteItem(@Nonnull
                          Long numIid)
                   throws IOException,
                          YouzanException

删除一个商品.

Parameters:

numIid - 商品数字编号

Returns:

true if delete successfully.

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

updateItem

public GoodsDetail updateItem(GoodsDetail item,
                              String fields)
                       throws IOException,
                              YouzanException

更新单个商品信息.

Parameters:

item - the item to be updated.

fields - 需要返回的商品对象字段

Returns:

the updated item.

Throws:

IOException - indicates i/O exception.

YouzanException - indicates Youzan business exception.

getItem

public GoodsDetail getItem(@Nullable
                           Long numIid,
                           @Nullable
                           String fields,
                           @Nullable
                           String alias)
                    throws IOException,
                           YouzanException

获取单个商品信息.

Parameters:

numIid - 商品数字编号

fields - 需要返回的商品对象字段，如title,price,desc等

alias - 商品别名 调用时，参数 num_iid 和 alias 必须选其一

Returns:

单个商品信息

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

listingItem

public GoodsDetail listingItem(@Nonnull
                               Long numIid,
                               @Nullable
                               String fields)
                        throws IOException,
                               YouzanException

商品上架.

Parameters:

numIid - 商品数字编号

fields - 需要返回的商品对象字段

Returns:

商品

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

delistingItem

public GoodsDetail delistingItem(@Nonnull
                                 Long numIid,
                                 @Nullable
                                 String fields)
                          throws IOException,
                                 YouzanException

商品下架.

Parameters:

numIid - 商品数字编号

fields - 需要返回的商品对象字段

Returns:

商品

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

listingItems

public boolean listingItems(@Nonnull
                            Long[] numIids)
                     throws IOException,
                            YouzanException

批量上架商品.

Parameters:

numIids - 商品数字编号

Returns:

商品

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

delistingItems

public boolean delistingItems(@Nonnull
                              Long[] numIids)
                       throws IOException,
                              YouzanException

批量下架商品.

Parameters:

numIids - 商品数字编号

Returns:

商品

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

getSkus

public GoodsSku[] getSkus(@Nonnull
                          String outerId,
                          @Nonnull
                          Long numIid,
                          @Nullable
                          String fields)
                   throws IOException,
                          YouzanException

根据外部编号取商品Sku.

跟据商家编码（商家为Sku设置的外部编号）获取商品Sku，如果一个outer_id对应多个Sku会返回所有符合条件的Sku。

Parameters:

outerId - 商家编码（商家为Sku设置的外部编号）

numIid - 商品数字编号

fields - 需要返回的Sku对象字段，如sku_id,num_iid,quantity等。可选值：Sku结构体中所有字段均可返回；多个字段用“,”分隔。如果为空则返回所有

Returns:

商品Sku

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

getOnsaleItems

public GoodsDetail[] getOnsaleItems(@Nullable
                                    Long tagId,
                                    @Nullable
                                    String q,
                                    @Nullable
                                    Integer pageSize,
                                    @Nullable
                                    Long pageNo,
                                    @Nullable
                                    String orderBy,
                                    @Nullable
                                    String fields)
                             throws IOException,
                                    YouzanException

获取出售中的商品列表.

Parameters:

tagId - 商品标签的ID

q - 搜索字段。搜索商品的title

pageSize - 每页条数

pageNo - 页码

orderBy - 排序方式。格式为column:asc/desc，column可选值：created 创建时间

fields - 需要返回的商品对象字段，如title,price,desc等。可选值：Item商品结构体中所有字段均可返回；多个字段用“,”分隔。如果为空则返回所有

Returns:

出售中的商品列表

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

getInventoryItems

public GoodsDetail[] getInventoryItems(@Nullable
                                       Long tagId,
                                       @Nullable
                                       String q,
                                       @Nullable
                                       Integer pageSize,
                                       @Nullable
                                       Long pageNo,
                                       @Nullable
                                       String orderBy,
                                       @Nullable
                                       String fields,
                                       @Nullable
                                       String banner)
                                throws IOException,
                                       YouzanException

获取仓库中的商品列表.

Parameters:

tagId - 商品标签的ID

q - 搜索字段。搜索商品的title

pageSize - 每页条数

pageNo - 页码

orderBy - 排序方式。格式为column:asc/desc，column可选值：created 创建时间 / modified 修改时间

fields - 需要返回的商品对象字段，如title,price,desc等。可选值：Item商品结构体中所有字段均可返回；多个字段用“,”分隔。如果为空则返回所有

banner - 分类字段。可选值：for_shelved（已下架的）/ sold_out（已售罄的）

Returns:

仓库中的商品列表

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

getItems

public GoodsDetail[] getItems(@Nonnull
                              String outerId,
                              @Nullable
                              String fields)
                       throws IOException,
                              YouzanException

根据商品货号获取商品.

Parameters:

outerId - 商品货号（商家为商品设置的外部编号）

fields - 需要返回的商品对象字段，如title,price,desc等。可选值：Item商品结构体中所有字段均可返回；多个字段用“,”分隔。如果为空则返回所有

Returns:

商品

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

updateSku

public GoodsSku updateSku(@Nonnull
                          Long skuId,
                          @Nullable
                          Long quantity,
                          @Nullable
                          BigDecimal price,
                          @Nullable
                          String outerId,
                          @Nonnull
                          Long numIid)
                   throws IOException,
                          YouzanException

更新SKU信息.

Parameters:

skuId - Sku数字ID

quantity - Sku的库存数量

price - Sku的销售价格。精确到2位小数；单位：元

outerId - 商家编码（商家为Sku设置的外部编号）

numIid - 商品数字编号

Returns:

SKU信息

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

addItem

public GoodsDetail addItem(GoodsDetail item,
                           String fields)
                    throws IOException,
                           YouzanException

新增一个商品.

Parameters:

item - 商品信息。

fields - 需要返回的商品对象字段，如title,price,desc等。可选值：Item商品结构体中所有字段均可返回；多个字段用“,”分隔。如果为空则返回所有'

Returns:

新增的商品

Throws:

IOException - indicates I/O exception.

YouzanException - indicates Youzan business exception.

readValue

protected <T> T readValue(@Nonnull
                          String method,
                          @Nullable
                          Map<String,String> params,
                          @Nonnull
                          com.fasterxml.jackson.core.type.TypeReference valueTypeRef)
                   throws IOException,
                          YouzanException

Throws:

IOException

YouzanException