使用PanacheEntityResource的Quarkus自定义restendpoint

Question

我试图通过quarkus的一些教程，在创建一个简单的RESTendpoint时遇到了一个问题。下面是本教程：https://quarkus.io/guides/rest-data-panache。

Im使用指南中的方法创建扩展PanacheEntityResource 的接口

public interface ActorResource extends PanacheEntityResource<Actor, Long>{
    
        
}

相应的实体是：

@Entity
public class Actor extends PanacheEntity{
    
    
    public String first_name;
    public String last_name;
    public Timestamp last_update;
    
    public static List<Actor> findByFirstName(String name) {
        return list("first_name", name);
    }
    

}

@ResourceProperties(path = "actors")
public interface ActorResource extends PanacheEntityResource<Actor, Long>{
    
    
    @GET
    @Produces("application/json")
    @Path("/first_name={name}")
    public static List<Actor> getByFirstName(@PathParam("name") String name) {
        return Actor.findByFirstName(name);
    }
    
        
}

@Path("/countries")
@ApplicationScoped
@Produces("application/json")
public class CountryResource  {
    
    @GET
    @Path("/name={name}")
    public List<Country> getByName(@PathParam("name") String name) {
        return Country.findByName(name);
    }
    
    @ResourceProperties(path = "/countries")
    public interface CountryResourceTest extends PanacheEntityResource<Country, Long>{
        
    }

}

Answer 1

我认为直接向生成的资源类添加自定义endpoint还不受支持，因为这仍然是一个仅用于评估的试验性特性。在Quarkus的GitHub问题跟踪器中，可以随时给出问题反馈。

我认为添加自定义endpoint的最佳方法是创建具有相同路径的第二个资源类。然后您可以在那里定义您的自定义endpoint。如果您没有名称冲突，那么它将起作用。我使用hibernate-orm-panache-quickstart对其进行了测试，并修改了以下代码：

具有自定义查询得我得实体：

@Entity
@Cacheable
public class Fruit extends PanacheEntity {

    @Column(length = 40, unique = true)
    public String name;

    public Fruit() {
    }

    public Fruit(String name) {
        this.name = name;
    }

    public static Fruit findByName(String name) {
        return find("name=?1", name).firstResult();
    }
}

生成的rest-api的资源（在本教程中删除给定的资源）：

public interface FruitResource extends PanacheEntityResource<Fruit, Long> {
}

我的特定资源：

@Path("fruit")
@ApplicationScoped
@Produces("application/json")
@Consumes("application/json")
public class FruitSpecificResource {

    @GET
    @Path("/first_name={name}")
    public Fruit getByName(@PathParam("name") String name) {
        return Fruit.findByName(name);
    }

}

出于测试的目的，我还添加了openapi并用h2替换了postgres。以下是我的依赖项：

        <dependency>
            <groupId>io.quarkus</groupId>
            <artifactId>quarkus-hibernate-orm-panache</artifactId>
        </dependency>
        <dependency>
            <groupId>io.quarkus</groupId>
            <artifactId>quarkus-resteasy-jsonb</artifactId>
        </dependency>
        <dependency>
            <groupId>io.quarkus</groupId>
            <artifactId>quarkus-jdbc-h2</artifactId>
        </dependency>
        <dependency>
            <groupId>io.quarkus</groupId>
            <artifactId>quarkus-smallrye-openapi</artifactId>
        </dependency>
        <dependency>
            <groupId>io.quarkus</groupId>
            <artifactId>quarkus-hibernate-orm-rest-data-panache</artifactId>
        </dependency>

quarkus.datasource.db-kind=h2
quarkus.datasource.jdbc.url=jdbc:h2:mem:test
quarkus.datasource.jdbc.max-size=8
quarkus.datasource.jdbc.min-size=2

quarkus.hibernate-orm.database.generation=drop-and-create
quarkus.hibernate-orm.log.sql=true
quarkus.hibernate-orm.sql-load-script=import.sql

好了，现在我可以启动quarkus：dev了，在localhost:8080/swagger-ui下面会有一个swagger-ui

新的endpoint就在那里。我手动测试过。它起作用了。