ascendtech / simplerest

GWT 2.9.X/3.X Rest Client Using Fetch API

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

GWT REST Client using Fetch API

Usage

Add AST Repo

  allprojects {
    repositories {
      ...
      maven { url 'https://maven.ascend-tech.us/repo' }
    }
  }

Add Dependency:

  compile 'us.ascendtech:simplerest-core:0.5.3'
  compile 'us.ascendtech:simplerest-core:0.5.3:sources'
  annotationProcessor 'us.ascendtech:simplerest-processor:0.5.3'
  annotationProcessor 'javax.annotation:javax.annotation-api:1.3.2'  

Define a Client Service Definition Sync Syntax

@SimpleRestGwtSync
@Path("/service/todo")
public interface ToDoServiceClientSync {
	@GET
	@Path("/list")
	List<ToDoDTO> getCurrentToDos();

	@PUT
	@Path("/add")
	ToDoDTO addToDo(ToDoDTO toDo);

	@DELETE
	@Path("/delete/{id}")
	void deleteToDo(@PathParam("id") Integer id);

	@POST
	@Path("/search/{query}")
	Collection<ToDoDTO> searchToDos(@PathParam("query") String query);

}

Define a Client Service Definition Async Syntax (Legacy Syntax) (Usage will be same as above Sync version)

@SimpleRestGwt
@Path("/service/todo")
public interface ToDoServiceClient {

	@GET
	@Path("/list")
	void getCurrentToDos(MultipleCallback<ToDoDTO> callback, ErrorCallback errorCallback);

	@PUT
	@Path("/add")
	void addToDo(ToDoDTO toDo, SingleCallback<ToDoDTO> callback, ErrorCallback errorCallback);

	@DELETE
	@Path("/delete/{id}")
	void deleteToDo(@PathParam("id") Integer id, CompletableCallback callback, ErrorCallback errorCallback);

	@POST
	@Path("/search/{query}")
	void searchToDos(@PathParam("query") String query, MultipleCallback<ToDoDTO> callback, ErrorCallback errorCallback);

}

Define DTO objects

DTOs should be defined as JS native objects on the client and POJO on the backend

@JsType(namespace = GLOBAL, name = "Object", isNative = true)
public class ToDoDTO {
	
}

Sample backend definition in micronaut

@Controller("/service/todo")
public class ToDoController {

	private ToDoService todoService;

	public ToDoController(ToDoService todoService) {
		this.todoService = todoService;
	}

	@Get("/list")
	public HttpResponse<Collection<ToDo>> list() {
		return HttpResponse.created(todoService.getCurrentTODOs());
	}

	@Put("/add")
	public HttpResponse<ToDo> add(@Body ToDo todo) {
		todoService.addTodo(todo);
		return HttpResponse.created(todo);
	}

	@Delete("/delete/{id}")
	public HttpResponse delete(@Parameter Integer id) {
		todoService.removeTodo(id);
		return HttpResponse.ok();
	}

	@Post("/search/{query}")
	public HttpResponse<Collection<ToDo>> searchToDos(@QueryValue String query) {

		Collection<ToDo> todos = new ArrayList<>();
		for (ToDo todo : todoService.getCurrentTODOs()) {
			if (todo.getTodo().toLowerCase().contains(query.toLowerCase())) {
				todos.add(todo);
			}
		}

		return HttpResponse.created(todos);

	}

}

Build code to generate client implementions using annotation processing

From ToDoServiceClient a class ToDoServiceClientSimpleRest will be generated.

Create service

Service can be made static in a singleton class and shared

String baseUrl = DomGlobal.window.location.protocol + "//" + DomGlobal.window.location.host;
ToDoServiceClient todoServiceClient = new ToDoServiceClientSimpleRest(baseUrl);

Use service

todoServiceClient.addToDo(newToDoDTO, new SingleCallback<ToDoDTO>() {
	@Override
	public void onData(ToDoDTO data) {

	}}, new ErrorCallback() {

	@Override
	public void onError(int statusCode, String status, String errorBody) {

	}
});


todoServiceClient.deleteToDo(currentValue.getId(), new CompletableCallback() {
	@Override
	public void onDone() {
	
	}}, new ErrorCallback() {

	@Override
	public void onError(int statusCode, String status, String errorBody) {

	}
});

todoServiceClient.getCurrentToDos(new MultipleCallback<ToDoDTO>() {
	@Override
	public void onData(ToDoDTO[] data) {

	}}, new ErrorCallback() {

	@Override
	public void onError(int statusCode, String status, String errorBody) {

	}
});

About

GWT 2.9.X/3.X Rest Client Using Fetch API

License:Apache License 2.0


Languages

Language:Java 94.3%Language:Kotlin 5.7%