gCube eXtensions to REST
Go to file
Manuele Simi 8948534883 Add CHANGELOG, README and LICENSE files to each module (as requested by the maven-parent). 2020-06-21 16:34:22 -04:00
.idea Add CHANGELOG, README and LICENSE files to each module (as requested by the maven-parent). 2020-06-21 16:34:22 -04:00
.settings Aligning pom artifactId to svn location 2019-03-22 11:21:36 +00:00
gxHTTP Add CHANGELOG, README and LICENSE files to each module (as requested by the maven-parent). 2020-06-21 16:34:22 -04:00
gxJRS Add CHANGELOG, README and LICENSE files to each module (as requested by the maven-parent). 2020-06-21 16:34:22 -04:00
idea/.idea Add REAME.md 2019-04-06 15:56:02 -04:00
.classpath Aligning pom artifactId to svn location 2019-03-22 11:21:36 +00:00
.gitignore Add target to gitignore. 2019-04-07 23:36:53 -04:00
.project Aligning pom artifactId to eclipse project name 2019-03-22 11:32:37 +00:00
CHANGELOG.md Add CHANGELOG, README and LICENSE files to each module (as requested by the maven-parent). 2020-06-21 16:34:22 -04:00
LICENSE.md Add CHANGELOG, README and LICENSE files to each module (as requested by the maven-parent). 2020-06-21 16:34:22 -04:00
README.md Update 'README.md' 2019-05-09 22:16:18 +02:00
pom.xml Removed snapshot for release 2020-02-06 12:02:52 +01:00

README.md

gxRest

The gCube eXtensions to the Rest Protocol (gxRest) is a set of Java libraries designed to provide convenient round-trip interaction between a Restful web application (also known as "service") and its clients.

gxRest has the flexibility for different degrees of exploitation:

  • it can be entirely adopted both at client and service side with full benefit of its conventions;
  • it can be used to send REST requests based only on plain HTTP;
  • it can be used only to return HTTP code/messagess from the service;
  • it can be used only to throw Exceptions from the service to the client.

Examples of use

Sending a request:

GXHTTPRequest request = GXHTTPRequest.newRequest("http://host:port/service/").from("GXRequestTest");
 
//prepare some parameters
String context ="...";
Map<String,String> queryParams = new WeakHashMap<>();
queryParams.put("param name", "param value");
GXInboundResponse response = request.path("context")
	  .queryParams(queryParams).withBody(context).post();

Returning a success response:

 @POST
  public Response create(...) {
 
    //Resource successfully created 
    
    URI location = ... //URI of the new resource
    return GXOutboundSuccessResponse.newCREATEResponse(location)
              .withMessage("Resource successfully created.")
	      .ofType(MediaType.APPLICATION_JSON)
              .build();
  }

Throwing an exception:

@POST
  public Response create(...) {
 
    //Oh no, something failed here
    GXOutboundErrorResponse.throwException(new MyCustomException("Resource already exists."));
    
  }   

Parsing a response

// invoke the remote method and get a response.
GXInboundResponse response = ...;
if (response.hasException()) 
    throw response.getException();
//assuming a created (200) code was expected 
if (response.hasCREATEDCode()) {
		System.out.println("Resource successfully created!");
}
//access content as string
String value = response.getStreamedContentAsString();
//unmasharll content as json
Context returnedContext = response.tryConvertStreamedContentFromJson(Context.class);

Modules

Deployment

Notes about how to deploy this component on an infrastructure or link to wiki doc (if any).

Documentation

See gxRest on Wiki.

Built With

  • JAX-RS - Java™ API for RESTful Web Services
  • Jersey - JAX-RS runtime
  • Maven - Dependency Management

License

TBP