问题描述

公司让写客户端首页接口，不明白什么意思？

大神给讲一下，只知道普通的接口的定义，服务接口还真不知道怎么下手。下面是原先一个小模块的服务接口
package cn.damai.mt.app.advert.rest.impl;

import java.util.HashMap;
import java.util.Map;

import javax.annotation.Resource;
import javax.servlet.http.HttpServletRequest;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.stereotype.Service;

import cn.damai.mt.app.advert.rest.AdvertRestService;
import cn.damai.mt.app.advert.service.MtcAppAdvertService;
import cn.damai.mt.app.model.MtcAppAdvert;
import cn.damai.mt.app.resp.ModelResp;
import cn.damai.mt.app.util.ParamUtil;
@Service("terminalAppAdvertRestService")
public class AdvertRestServiceImpl implements AdvertRestService {
private Log log = LogFactory.getLog(getClass());
@Resource(name = "mtcAppAdvertService")
MtcAppAdvertService mtcAppAdvertService;
@Override
public ModelResp> getHomeAdvert(HttpServletRequest request) {
ModelResp> resp=new ModelResp>();
Map map=ParamUtil.getParaMap(request);
Map resultMap=new HashMap();
int type=0;
if(map.get("type")!=null){
try {
type=(Integer)map.get("type");
} catch (Exception e) {
log.info("参数不符合条件！");
resp.setCode(400);
return resp;
}
}
if(type==1||type==2||type==3){
try {
MtcAppAdvert mtcAppAdvert = mtcAppAdvertService.getHomeAdvert();
MtcAppAdvert mtcAppAd = mtcAppAdvertService.getHomeAd();
if(mtcAppAdvert!=null){
String imgUrl = mtcAppAdvert.getImgUrl();
String[] array = imgUrl.split(",");
String md5 = mtcAppAdvert.getMd5();
String[] arr = md5.split(",");
if(type==1){
imgUrl = array[0];
md5 = arr[0];
}else if(type==2){
imgUrl = array[1];
md5 = arr[1];
}else if(type==3){
imgUrl = array[2];
md5 = arr[2];
}
resultMap.put("advertTitle", mtcAppAdvert.getAdvertTitle());
resultMap.put("jumpContent", mtcAppAdvert.getJumpContent());
resultMap.put("imgUrl", imgUrl);
resultMap.put("md5", md5);
resp.setCode(200);
resp.setData(resultMap);
return resp;
}else{//符合条件的为空，
if(mtcAppAd!=null){//有数据，但不符合条件
log.info("有数据，但不符合条件！");
resp.setCode(203);
//203：无数据返回
return resp;
}
log.info("没有广告！");
resp.setCode(201);
//201：无数据返回
return resp;
}
} catch (Exception e) {
log.error(e);
e.printStackTrace();
resp.setCode(500);
return resp;
}
}else{
log.info("获取首页广告图：安卓和ios的分辨类型不正确!");
resp.setCode(400);
return resp;
}

}

}

解决方案

你这样理解：
手机请求服务器某URL，并传入参数，服务器处理后返回一堆数据，这就是接口

1、你上面的代码就代表URL是http://你公司的域名/项目名/terminalAppAdvertRestService
2、手机传的参数是一个JSON字符串，通过ParamUtil转成了MAP对象
3、服务器经过一系列处理得到resultMap，并通过这个方法将其返回给WebService
4、WebService服务将resultMap转换成JSON字符串，返回给了手机

解决方案二：

同楼上，并补充，与APP或WEBAPP通讯，建议使用 RESTFUL 的方式，同时与前端的小伙伴约定好返回的数据格式，同时也需要考虑版本的更新维护，因为客户端的更新一定是不及时的，不能因为服务器端返回的数据格式不正确导致老版本的客户端无法正常使用

解决方案三：

应该是给手机端写接口吧，供手机端调用的