Jaxrs Server

Jaxrs Server provides a server based on Netty framework to expose your RESTful API.

Contents

• Features
• Get it
• Use it
  • Default case example
  • Swagger management example
  • Security
• Configuration
  • General
  • CORS
  • Swagger

Features

• Expose resources annotated with Path
• Expose providers annotated with Provider
• Enable Cross-Origin Resource sharing
• Provide Swagger resource to the following url http://host**/swagger-api**
• Enable security to use embedded jaxrs-security library

Get it

Add the following to your Maven configuration:

<dependency>
	<groupId>com.bekioui.jaxrs</groupId>
	<artifactId>jaxrs-server</artifactId>
	<version>1.1.0</version>
</dependency>

Use it

Default case example

Add the following to your Spring configuration file:

@Configuration
@Import({ JaxrsServerConfig.class })
public class SpringConfig {

  @Bean
  public DeploymentResourceDescriptor getDeploymentResourceDescriptor() {
    return () -> MyResource.class.getPackage();
  }
  
}

• This bean is required.
• You can define many descriptors.
• If you want to deploy all of your resources, return the highest package level.

Swagger management example

You need to enable CORS and Swagger first (look Configuration).

Add the following to your Spring configuration file:

@Bean
public SwaggerResourceDescriptor getSwaggerResourceDescriptor() {
  return () -> MyOtherResource.class.getPackage();
}

• This bean is not required.
• You can define many descriptors.
• DeploymentResourceDescriptor is used by default if this bean is not defined with swagger enabled.
• If you want to expose a part of your API, return the selected package.

Security

You need to enable security first (look Configuration).

Look jaxrs-security library for more informations.

Configuration

General

CORS

Swagger

Credits

Romain Sertelon

License

Copyright (C) 2016 Mehdi Bekioui (consulting@bekioui.com)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.