저는 최근에 쥐팩. 
최신 HTTP 애플리케이션을 빌드하기 위한 Java 라이브러리 세트입니다.
이러한 단순한 정의를 뛰어넘기 위해 Ratpack은 비차단, 비동기, 네티 기반입니다. 우리의 Java SDK. 따라서 경량 애플리케이션 프레임워크의 자연스러운 후보가 될 수 있습니다.
새로운 웹 프레임워크를 테스트할 때 가장 먼저 할 수 있는 일 중 하나는 기본 API를 만드는 것입니다. 그리고 간단한 CRUD를 구축하는 것은 Couchbase와 같은 문서 데이터베이스로 작업할 때 자연스럽게 이루어집니다. 따라서 이 포스팅은 Ratpack에 대한 기본적인 소개로, Java SDK로 제공되는 Couchbase 엔티티 리포지토리 추상화를 보여줍니다. 여기서는 API 자체에 초점을 맞추지 않고 Ratpack과 Couchbase 리포지토리에서 사용되는 메커니즘에 대해 더 자세히 설명하겠습니다.
Ratpack Java 프로젝트 만들기
제가 아는 대부분의 Ratpack 사용자는 Groovy로 코딩하는 경향이 있습니다. 저는 보통 Java로 코딩을 하므로 오늘은 이 방법을 사용하려고 합니다. The 빠른 시작 쥐팩에서 찾을 수 있는 가이드에는 Groovy가 포함되어 있습니다. 예를 들어 lazybones 템플릿은 Groovy 템플릿입니다. 그래서 제가 즐겨 사용하는 IDE에서 간단한 Java Gradle 프로젝트를 생성하는 것으로 시작했습니다. 그런 다음 build.gradle 파일을 만들고 올바른 종속성으로 완성했습니다. 저는 jcenter 저장소, 쥐팩-그레이들 1.3.3에 대한 종속성을 사용하고 있는지 확인했습니다. io.ratpack.ratpack-java 플러그인. 그리고 카우치베이스 종속성도 잊지 마세요.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
buildscript { repositories { jcenter() } dependencies { classpath "io.ratpack:ratpack-gradle:1.3.3" } } apply plugin: "io.ratpack.ratpack-java" apply plugin: 'eclipse' sourceCompatibility = 1.8 version = '1.0' jar { manifest { attributes 'Implementation-Title': 'Ratpack Couchbase Repository Sample', 'Implementation-Version': version } } repositories { mavenCentral() jcenter() } dependencies { compile "com.couchbase.client:java-client:2.2.5" } mainClassName = "org.couchbase.devex.Application" test { systemProperties 'property': 'value' } |
다음 단계는 간단한 Hello World로 앱을 시작하는 것입니다. 위의 빌드 파일에서 볼 수 있듯이 Application 클래스가 있습니다. 메인 클래스 이름 옵션이 필요합니다. 여기서는 우선 Ratpack 서버를 가동하고 헬로 월드 메시지를 반환할 '/hello' URL 경로를 등록하기만 하면 됩니다.
쥐팩에는 다음과 같은 기능이 있습니다. 핸들러 객체입니다. 핸들러는 컨텍스트를 매개변수로 사용하는 함수입니다. 핸들러를 경로에 연결할 수 있습니다. 여기서는 핸들러 함수를 '/hello' 경로에 연결하겠습니다. Ratpack을 이해하려면 모든 애플리케이션에서 핸들러를 사용하므로 핸들러를 이해해야 합니다.
Ratpack 애플리케이션의 진입점은 RatpackServer 클래스입니다. 이 클래스에서 정적 메서드인 시작. 이 함수는 RatpackServerSpec 객체를 매개변수로 하는 함수를 받습니다. 이 객체는 서버를 구성할 수 있는 유창한 API를 제공합니다. 여기서 제가 해야 할 일은 핸들러를 추가하는 것뿐입니다. 핸들러를 추가하기만 하면 됩니다. 핸들러 메서드는 핸들러 체인을 매개변수로 하는 함수를 받습니다. 그 체인에서 핸들러를 만들 수 있습니다:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
package org.couchbase.devex; import ratpack.server.RatpackServer; public class Application { public static void main(String... args) throws Exception { RatpackServer .start(server -> server.handlers(chain -> chain.path("hello", ctx -> ctx.render("Hello World!")))); } } |
애플리케이션을 시작하고 localhost:5050/hello로 이동하면 안녕하세요 메시지가 표시됩니다. Couchbase 부분으로 이동합니다.
카우치베이스 엔티티 모델
엔티티 모델은 버전 2.2.x에서 등장했습니다. Couchbase 어노테이션 @Id를 사용하여 엔티티를 쉽게 선언할 수 있습니다. 또한 엔티티 클래스에 인수가 없는 공용 생성자가 있는지, 결과 JSON 문서에서 원하는 필드에 대해 설정자와 게터를 사용할 수 있는지 확인해야 합니다. 사용자 이름, 나이, 이름, 성을 가진 사용자를 모델링하기 위해 다음 User 클래스를 사용합니다:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 |
package org.couchbase.devex; import com.couchbase.client.java.repository.annotation.Field; import com.couchbase.client.java.repository.annotation.Id; public class User { @Id private String username; private Integer age; @Field("fName") private String firstName; @Field("lName") private String lastName; public User() {} public User(String username, Integer age, String firstName, String lastName) { this.username = username; this.age = age; this.firstName = firstName; this.lastName = lastName; } public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } public String getFirstName() { return firstName; } public void setFirstName(String firstName) { this.firstName = firstName; } public String getLastName() { return lastName; } public void setLastName(String lastName) { this.lastName = lastName; } @Override public String toString() { return "User [username=" + username + ", age=" + age + ", firstName=" + firstName + ", lastName=" + lastName + "]"; } } |
Id 어노테이션은 필수이며 문서의 키로 사용될 필드를 정의합니다. 필드 어노테이션을 사용하여 결과 JSON 문서에서 속성 이름을 변경할 수 있습니다. 또한 @Id 필드는 JSON에 포함되지 않는다는 점에 유의하세요.
이 엔티티 클래스는 다음과 같이 사용해야 합니다. 엔티티도큐먼트. 사용법이 매우 유사합니다. 기타 문서 구현 를 사용할 수 있습니다. 다음 코드는 Couchbase에서 JSON 문서를 생성합니다:
|
1 2 3 4 5 |
User user = new User("ldoguin", 31, "Laurent", "Doguin"); EntityDocument<User> document = EntityDocument.create(user); Repository repo = CouchbaseCluster.create().openBucket().repository(); repo.upsert(document); |
다음 문서를 생성합니다:
키: ldoguin
값입니다: { "lName": "도구인", "나이": 31, "fName": "Laurent" }
이 코드는 현재 차단 및 동기화 중입니다. 이것이 나쁜가요? 상황에 따라 다릅니다.) 위의 헬로 월드 대신에 실행되는 경우처럼 블로킹이 아닌 스레드에서 블로킹 코드를 실행하고 있다면 다른 모든 것을 차단하는 것과 마찬가지입니다. 그리고 그것은 나쁜 일이 될 수 있습니다. 이 스레드는 모든 요청을 처리하는 이벤트 루프를 관리하기 때문입니다. 제가 찾은 이 블로그 게시물 이를 이해하는 데 매우 유용합니다.
Ratpack의 목표 중 하나는 차단 코드 사용을 돕는 것입니다. 비동기, 비차단 핸들러. Ratpack 사용 약속 를 비동기 코드를 관리하는 방법으로 사용할 수 있습니다. 또한 함수를 인수로 받아 프로미스를 반환하는 블로킹 프리미티브도 제공합니다. 이 함수는 블로킹 코드를 실행합니다. 여기에서는 localhost:5050/create URL을 누르면 사용자를 생성하고 localhost:5050/get URL을 누르면 사용자를 반환하는 예제가 있습니다:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
public static void main(String... args) throws Exception { RatpackServer.start(server -> server.handlers(chain -> chain.path("create", ctx -> { Blocking.get(() -> { EntityDocument<User> document = EntityDocument.create(new User("ldoguin", 31, "Laurent", "Doguin")); Repository repo = CouchbaseCluster.create().openBucket().repository(); return repo.upsert(document); }).then(entityDoc -> ctx.render("OK")); }).path("get", ctx -> { Blocking.get(() -> { Repository repo = CouchbaseCluster.create().openBucket().repository(); EntityDocument<User> ldoguin = repo.get("ldoguin", User.class); return ldoguin; }).then(user -> ctx.render(user.content().toString())); }) )); } |
이 API가 역대 최악으로 설계되었다는 사실은 제쳐두고, Ratpack으로 비동기 핸들러에서 차단, 동기 코드를 실행하는 방법에 대한 아이디어를 얻을 수 있을 것입니다. 기존 애플리케이션을 Ratpack으로 마이그레이션하기 위한 첫 번째 단계입니다.
하지만 이 예제는 RxJava 기반 SDK의 모든 장점을 보여주지는 못합니다. 그래서 다음 포스트에서는 RxJava와 Ratpack을 비동기 버전의 리포지토리와 함께 사용하는 방법을 보여드리겠습니다.
