readme4-resteasy.md · 既安之/spring cloud 相关技术整合说明

# spring-cloud 集成resteasy

resteasy是jboss开源的`java api for restful service(JSR 311, JAX-RS 2.0, JAX-RS 1.1)`实现参考。
是类似SpringMVC的mvc实现。

### API包定义

#### 依赖引入
```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <packaging>pom</packaging>

<groupId>com.jeanerk</groupId>
    <version>1.0-SNAPSHOT</version>
    <artifactId>spring-cloud-api</artifactId>

<modules>
        <module>spring-cloud-user-api</module>
    </modules>

<dependencies>
        
        <dependency>
            <groupId>javax.ws.rs</groupId>
            <artifactId>javax.ws.rs-api</artifactId>
            <version>2.1</version>
        </dependency>
        <dependency>
            <groupId>javax.validation</groupId>
            <artifactId>validation-api</artifactId>
            <version>2.0.1.Final</version>
        </dependency>
    </dependencies>

</project>
```

#### API定义

API定义在专门的接口包里，也就是`pom.xml`中的`spring-cloud-user-api`这个包里。
同时通过`javax.ws.rs-api`这个包的注解定义接口，实现通过API模块的实现模块去实现。

```java
package com.jeanerk.user.api.feign;

import com.jeanerk.user.api.dto.User;

import javax.ws.rs.*;
import javax.ws.rs.core.MediaType;
import java.util.List;

@Path("/api/user")
@Produces(MediaType.APPLICATION_JSON)
public interface IUserService {

@GET
    @Path("/{userId}")
    User findUserById(@PathParam("userId") String userId);

@POST
    @Path("/page")
    List<User> page(User user);
}

```

### API实现
#### 依赖引入
```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

<parent>
        <artifactId>spring-boot-starter-parent</artifactId>
        <groupId>org.springframework.boot</groupId>
        <version>2.3.6.RELEASE</version>
        <relativePath />
    </parent>

<artifactId>spring-cloud-service-user-resteasy</artifactId>

<dependencies>
        <dependency>
            <groupId>com.jeanerk</groupId>
            <artifactId>spring-cloud-user-api</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>org.jboss.resteasy</groupId>
            <artifactId>resteasy-spring-boot-starter</artifactId>
            <version>4.9.0.Final</version>
        </dependency>
        
        <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-validator</artifactId>
            <version>6.0.13.Final</version>
        </dependency>

<dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.20</version>
        </dependency>

<dependency>
            <groupId>org.postgresql</groupId>
            <artifactId>postgresql</artifactId>
            <version>42.2.23</version>
        </dependency>

<dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-consul-discovery</artifactId>
            <version>2.1.3.RELEASE</version>
            <exclusions>
                <exclusion>
                    <groupId>com.fasterxml.jackson.core</groupId>
                    <artifactId>jackson-databind</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>tk.mybatis</groupId>
            <artifactId>mapper-spring-boot-starter</artifactId>
            <version>2.1.5</version>
            <exclusions>
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-web</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

</project>
```

#### RESTEASY APPLICATION定义

RESTEASY通过Application识别什么接口走RESTEASY的servlet，类似于SpringMVC的DispatcherServlet的ServletMapping.

```java
package com.jeanerk.user.provider;

import org.springframework.stereotype.Component;

import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;

@Component
@ApplicationPath("/user-resteasy")
public class UserServiceApplication extends Application {
    public UserServiceApplication() {}
}

```

#### RESTEASY API实现

API的实现就是一个java bean, 实现上一节定义的api接口。

```java
package com.jeanerk.user.provider.service.impl;

import com.jeanerk.user.api.dto.User;
import com.jeanerk.user.api.feign.IUserService;
import com.jeanerk.user.provider.mapper.UserMapper;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserServiceProvider implements IUserService {

@Autowired
    private UserMapper userMapper;

@Override
    public User findUserById(String userId) {
        User result = new User();
        com.jeanerk.user.provider.entity.User source = userMapper.selectByPrimaryKey(userId);
        BeanUtils.copyProperties(source, result);
        return result;
    }

@Override
    public List<User> page(User user) {
        return null;
    }
}

```

### 启动服务

```yaml
server:
  port: 17005
  servlet:
    context-path: /resteasy
spring:
  application:
    name: user-service-resteasy

cloud:
    consul:
      host: 127.0.0.1
      port: 8500
      discovery:
        heartbeat:
          enabled: true
        prefer-ip-address: true

# 数据源配置信息
  datasource:
    url: jdbc:postgresql://127.0.0.1:5432/postgres
    username: postgres
    password: 123456
    driver-class-name: org.postgresql.Driver
```

```java
package com.jeanerk.user.provider;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import tk.mybatis.spring.annotation.MapperScan;

@SpringBootApplication
@EnableDiscoveryClient
@MapperScan(basePackages = {"com.jeanerk.user.provider.mapper"})
public class UserResteasyApplication {
    public static void main(String[] args) {
        SpringApplication.run(UserResteasyApplication.class, args);
    }
}

```

### 调用RESTEASY API

> curl http://10.193.239.65:17005/resteasy/user-resteasy/api/user/48aca1d09aae4809936564b9faeafd08

既安之/spring cloud 相关技术整合说明

简介

发行版

贡献者

近期动态

既安之/spring cloud 相关技术整合说明 .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

既安之/spring cloud 相关技术整合说明