新美大酒店开放平台SDK(JAVA版)使用说明.pages

Size: px

Start display at page:

Download "新美大酒店开放平台SDK(JAVA版)使用说明.pages"

讨姗狄
5 years ago
Views:

1 新美大酒店开放平台 SDK(JAVA 版 ) 使用说明说明 : 本 SDK 是 JAVA 版, 基于 JDK1. 版本 1 SDK 包说明 1.1 获取 SDK 得 SDK 包可以在新美大酒店开放平台数据平台 (SDK 下载 ) 下载, 也可直接通过下载地址获下载地址 : 下载成功后, 解压后可获得包含所有依赖 jar 包的文件夹 1.2 SDK 包内容 SDK 包中包含两部分 :SDK 的 jar sources,sdk 依赖的第三方 jar 包 SDK 的 jar sources mthotel-openplatform-sdk-1.0-jdk1.-sources.jar( 开发使用, 生产环境不不需要 ) mthotel-openplatform-sdk-1.0-jdk1..jar SDK 依赖的第三方 jar 包 commons-httpclient jar commons-lang-2..jar commons-lang3-3.5.jar commons-logging jar fastjson jar guava-18.0.jar httpclient jar httpcore jar 页码 : 1/

2 以上第三方 jar 包对应的 maven 依赖如下所示  <groupid>org.apache.httpcomponents</groupid> <artifactid>httpclient</artifactid> <version>4.5.1</version> <scope>compile</scope> <groupid>commons-httpclient</groupid> <artifactid>commons-httpclient</artifactid> <version>3.0.1</version>  <groupid>com.alibaba</groupid> <artifactid>fastjson</artifactid> <version>1.2.28</version>  <groupid>com.google.guava</groupid> <artifactid>guava</artifactid> <version>18.0</version>  <groupid>commons-lang</groupid> <artifactid>commons-lang</artifactid> <version>2.</version> <groupid>org.apache.commons</groupid> <artifactid>commons-lang3</artifactid> <version>3.5</version> 页码 : 2/

3 2 SDK 使用说明 2.1 代码示例例如下代码以房态上下线接口为例例, 其他接口不不同在于对应的请求参数 (MtHotelXXXRequest) // get RoomStatusOnOffParams RoomStatusOnOffParams params = new RoomStatusOnOffParams(); params.setbreakfastnum(x); params.setpoiid("xxx"); params.setroomtype("xxx"); params.setstatus(1); // 1 or 0 // put RoomStatusOnOffParams into MtHotelRoomStatusOnOffPushRequest MtHotelRoomStatusOnOffPushRequest request = new MtHotelRoomStatusOnOffPushRequest(); request.setroomstatusonoffparams(params); // initialization configure MtHotelConfiguration conf; conf = new MtHotelConfiguration("partnerId", "encryptkey"); conf.setenv(environment.dev); // Environment.DEV for developing or testing // go to configure. e.g. conf.setxxx // create client for send request DefaultMtHotelClient client = new DefaultMtHotelClient(conf); MtHotelResponse response = null; try { response = client.execute(request); } catch (MtHotelApiException e) { // there will throw MtHotelApiException when request parameter error System.out.println(e.getErrCode() + " -- " + e.geterrmsg()); } // get request body from respnose System.out.println("RequestBody: " + response.getreqbody()); // get configuration from response System.out.println("Configuration: " + response.getconfiguration()); 2.2 配置说明 SDK 配置均包含在 MtHotelConfiguration 类中, 其中供应商 ID 供应商秘钥是必须传入的参数, 其余可根据需求配置或采用默认值页码 : 3/

4 属性 field 类型默认值说明 SDK 使用环境 env Environment Environment.ONLINE 包含三种 : DEV( 开发自测时使用该环境 ) STAGING( 联调时使用该环境 ) ONLINE( 线上默认使用该环境 ) 供应商 ID partnerid String 无由新美大提供构造 MtHotelConfi guration 的必填参数供应商秘钥 encryptkey String 无由新美大提供构造 MtHotelConfi guration 的必填参数 SDK 日志开关 needenablel ogger boolean FALSE true 表示将允许 SDK 内部日志输出建议调试阶段打开, 以便便于排查问题以下是 http 请求的配置创建连接的最长时间 connecttimeo ut int 3000(ms) httpclient 配置页码 : 4/

5 属性 field 类型默认值说明从连接池中获取到连接的最长时间 connectionre questtimeout int 500(ms) httpclient 配置数据传输的最长时间 http 请求重试次数 readtimeout int 20000(ms) httpclient 配置 retrytimes int 3 http 请求异常重试次数, 0 表示不不重试整个连接池最大连接数每路路由最大连接数 maxtotal4htt pclientpool defaultmaxpe rroute4httpc lientpool int 50 httpclient 配置 int 5 httpclient 配置以下是接口访问频率配置 ( 建议调用方根据客户端部署及业务需求, 调整该参数值, 一个接口调用频率总和不不超过每分钟 0 次 ) POI 同步接口访问频率 POI 查询接口访问频率房态全量量同步接口访问频率房态价格同步接口访问频率房态库存同步接口访问频率房态上下线同步接口访问频率 poipushlimit poiquerylimit roomstatusall PushLimitPer Min roomstatuspr icepushlimit roomstatusst ockpushlimit roomstatuso noffpushlimit 页码 : 5/

6 属性 field 类型默认值说明房态规则同步接口访问频率房态新产品同步接口访问频率房态查询接口访问频率 roomstatusr ppushlimitpe rmin roomstatusn ewprodpushl imit roomstatusq uerylimitper Min 2.3 SDK 提供接口接口 request 类 response 类 POI 同步 MtHotelPoiPushRequest MtHotelResponse POI 查询房态全量量同步房态更更新价格房态更更新库存房态产品上下线房态更更新规则房态创建新产品房态同步查询 MtHotelPoiQueryRequest MtHotelRoomStatusAllPu shrequest MtHotelRoomStatusPrice PushRequest MtHotelRoomStatusStock PushRequest MtHotelRoomStatusOnOff PushRequest MtHotelRoomStatusRpPu shrequest MtHotelRoomStatusNew ProdPushRequest MtHotelRoomStatusQuer yrequest 页码 : /

38 47995529 威福髮藝店桃園市蘆竹區中山里福祿一街 48 號地下一樓 50,000 獨資李依純 105/04/06 府經登字第 1059003070 號 39 47995534 宏品餐飲桃園市桃園區信光里民

38 47995529 威福髮藝店桃園市蘆竹區中山里福祿一街 48 號地下一樓 50,000 獨資李依純 105/04/06 府經登字第 1059003070 號 39 47995534 宏品餐飲桃園市桃園區信光里民 1 08414159 惠鴻眼鏡行桃園市中壢區福德里中華路一段 186 號 1 樓 30,000 獨資宋耀鴻 105/04/27 府經登字第 1059003866 號 2 17891110 承元冷氣空調工程行桃園市桃園區中德里國際路 1 段 98 巷 50 號 2 樓之 4 200,000 獨資詹安平