1 开发说明
1.1 project说明
1.1.1 下载地址
工程下载地址:ssh://xxx@apaciccc5086:29418/emarket.git (用git)
demo工程下载地址:ssh://xxx@apaciccc5086:29418/microservice.git(用git)
xxx 表示自己的git用户名
1.1.2 一个parent工程,其他都是子工程
下载后,如下图所示:
有五个工程
l emarket : 父工程。最重要的是包含pom.xml文件。子工程的pom文件都继承它。开发不涉及。
l emarket-config-server : 子工程。配置项集中存放在这里,例如数据库url,数据库用户名和密码等公用的配置项。
l emarket-eureka-server : 子工程。服务注册与发现。开发不涉及。
l emarket-geteway : 子工程。服务网关。
l emarket-trade-service : 子工程。交易服务。需要开发。
每个子工程包含 application.properties和bootstrap.properties 配置文件。
1.1.3 工程启动顺序
先启动emarket-eureka-server, emarket-config-server。再启动具体的微服务工程,例如emarket-trade-service。
1.1.4 emarket-eureka-server 的配置说明
#端口号
server.port=8761
#地址
eureka.instance.hostname=localhost
eureka.client.registerWithEureka=false
eureka.client.fetchRegistry=false
# 客户端访问的 eureka地址 (重要)
eureka.client.serviceUrl.defaultZone=http://${eureka.instance.hostname}:${server.port}/eureka
eureka.server.enableSelfPreservation=false
1.1.5 emarket-config-server 的配置说明
#eureka地址和端口 (重要)
eureka.client.serviceUrl.defaultZone=http://${eureka.host:APACICCC5088}:${eureka.port:8762}/eureka/
1.1.6 emarket-trade -service 的配置说明
#指明mybatis的总的sqlmap配置文件
mybatis.config=sql-map-config.xml
#eureka地址和端口 (重要)
eureka.client.serviceUrl.defaultZone=http://${eureka.host:APACICCC5088}:${eureka.port:8762}/eureka/
#serviceID (重要,一个微服务只能有一个名字)
spring.application.name=cloudservice
1.2 direct调用服务说明
map.put("pageFrom", (dataset.getPageNo() - 1)* dataset.getPageSize());
map.put("pageSize", dataset.getPageSize());
RestTemplate rt = (RestTemplate) ContainerManager.getComponent(RestTemplate.class);
Object obj[] = rt.postForObject("http://172.30.105.81:8181/test/", map, Object[].class);
long count = (Integer) obj[1];
List list = (List) obj[0];
RestTemplate 提供postForObject (url(请求url), request(请求参数), responseType(返回值类型))
1.3 服务调用服务说明
1 首先写一个调用接口,如下:
@FeignClient("cloudservice")
public interface IRemoteService {
//value是请求地址,method是请求方法(总共有get,post,put,delete)
@RequestMapping(value = "/test", method = RequestMethod.GET)
public String query(@RequestBody Map<String, Object> map);
}
2 使用这个接口,例子如下:
@Service
public class AlopService implements IAlopService {
@Autowired
IRemoteService service = null;
//实际调用服务的地方
public String test3(){
return service.query();
}
}
1.4 开发一个微服务
1 首先写一个服务接口
public interface INameListService {
public Object[] queryNameList(Map<String, Object> map);
}
2 写接口的实现类
@Service
public class NameListSericeImpl implements INameListService {
@Resource(name = "defaultService")
private IDefaultService service = null;
@Override
public Object[] queryNameList(Map<String, Object> map) {
int pageFrom =0; //起始页
if(map.get("pageFrom")!=null){
pageFrom = Integer.parseInt((String)map.get("pageFrom"));}
int pageSize =10; //每页显示条数
if(map.get("pageSize")!=null){
pageSize = Integer.parseInt((String)map.get("pageSize"));}
//分页查询
return service.getCommonPaged(
"com.spdbccc.common.db.select.selectMyFollow", "com.spdbccc.common.db.select.countMyFollow", map ,
pageFrom , pageSize );
}
}
3 写一个controller对外暴露这个服务。
@Controller
public class NameListController {
@Autowired
INameListService service ;
@RequestMapping("/test")
@ResponseBody
public Object[] queryNameList(@RequestBody Map<String, Object> map){
return service.queryNameList(map);
}
}
1.5 REST URL对外接口定义规则
Http Methods
GET
获取,查找
POST
新增创建
PUT
更新
DELETE
删除
URL组成
网络协议(HTTP)
服务器地址(我们用服务名 spring.application.name)
版本
接口名称
?参数列表
1.5.1 Get方法示例:
@RequestMapping(value="/v1/alopApply/{applyId}",method=RequestMethod.GET)
public AlopApplyVO findByAlopApply(@PathVariable("applyId ") int applyId);
说明: applyId参数出现在url中,写@PathVariable ,才能获得{applyId}参数
/v1/alopApply/{applyId} v1表示版本号(v小写字母)
1.5.2 Post方法示例:
@RequestMapping(value="/v1/alopApply/add",method=RequestMethod.POST)
public int addAlopApply(@RequestBody Map<String, Object> map);
说明: post用作创建。请求过来的参数是集合或者自定义bean , 需要写 @RequestBody
1.5.3 Put方法示例:
@RequestMapping(value = "/v1/alopApply/edit", method = RequestMethod.PUT)
public String editUser(String user);
说明: put方法用作修改。
1.5.4 Delete方法示例:
@RequestMapping(value = "/v1/alopApply/delete/{applyId}", method = RequestMethod.DELETE)
public String removeUser(@PathVariable("applyId") int applyId);
说明: delete 删除操作(包括逻辑删除)。
1.5.5 总结
RequestMapping 只能添加在方法上,不能添加在接口上。
RequestMapping的value以版本号为前缀(“/version/path”),method必须提供并且只能限定为一种,比如:
@RequestMapping(value = "/v1/apply", method = RequestMethod.GET)
接口方法的名称必须以版本号为后缀,比如:searchV1(),findByIdV2();
接口方法必须提供完善且符合要求的注释,以便自动生成API文档。
微服务开发指导
猜你喜欢
转载自hujinpeng2005.iteye.com/blog/2301248
今日推荐
周排行