微服务开发指导

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文档。