Repository files navigation

Apache ServiceComb Java Chassis is a Software Development Kit (SDK) for rapid development of microservices in Java, providing service registration, service discovery, dynamic routing, and service management features.

If you find this project helpful, please don't forget tostar it.

Java Chassis core dependencies

NOTICE: Since Open API 3.0.x is not compatible with 2.0.x, Java Chassis 2 and Java Chassis 1 can notwork together with Java Chassis 3. All related consumers, providers and edge service need use Java Chassis 3 when upgrading.

NOTICE: Java Chassis 1 reached its end of support now after it's first release from 2018.

• Define API

@RequestMapping(path ="/provider")publicinterfaceProviderService {@GetMapping("/sayHello")StringsayHello(@RequestParam("name")Stringname);}

• Provider service

@RestSchema(schemaId ="ProviderController",schemaInterface =ProviderService.class)publicclassProviderControllerimplementsProviderService {@OverridepublicStringsayHello(Stringname) {return"Hello " +name;  }}

• Consumer service

@ConfigurationpublicclassProviderServiceConfiguration {@BeanpublicProviderServiceproviderService() {returnInvoker.createProxy("provider","ProviderController",ProviderService.class);  }}

Invoke Provider service with RPC

@RestSchema(schemaId ="ConsumerController",schemaInterface =ConsumerService.class)publicclassConsumerControllerimplementsConsumerService {privateProviderServiceproviderService;@AutowiredpublicvoidsetProviderService(ProviderServiceproviderService) {this.providerService =providerService;  }@OverridepublicStringsayHello(Stringname) {returnproviderService.sayHello(name);  }}

Try out this examplehere .

Project documentation is available on theServiceComb Java Chassis Developer Guide.

You don’t need to build from source to use Java Chassis (binaries in apache nexus ), but if you want to try out the latest and greatest, Java Chassis can be easily built with the maven. You also need JDK 17.

  mvn clean install

The first build may take a longer than expected as Maven downloads all the dependencies.

To build the docker image and run the integration tests with docker, you can use maven docker profile

  mvn clean install -Pdocker -Pit

If you are using docker machine, please use the following command

  mvn clean install -Pdocker -Pit -Pdocker-machine

Bugs:issues

mailing list:subscribedev

SeeCONTRIBUTING for details on submitting patches and the contribution workflow.

Licensed under anApache 2.0 license.