tag	ffe237ae02ecd05650b1e207398d1a79586af8d9
tagger	asifdxtreme <mohammad.asif.siddiqui1@huawei.com>	Mon Apr 08 13:37:23 2019 +0530
object	04c882beb1c8a75f15dfe7a0e68e44de158bbc2c

commit	04c882beb1c8a75f15dfe7a0e68e44de158bbc2c	[log] [tgz]
author	wujimin <wujimin@huawei.com>	Thu Apr 04 17:00:39 2019 +0800
committer	Willem Jiang <jiangning9@huawei.com>	Sat Apr 06 16:55:36 2019 +0800
tree	e45afe9efa94e54555618a13825bf20991ea39f7
parent	8b1723e2fcd2beb86ba05be8d32d3f1b64024eb1 [diff]

tree: e45afe9efa94e54555618a13825bf20991ea39f7

README.md

Java Chassis

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

Quick Start

Provider service:

import org.apache.servicecomb.*;
@RpcSchema(schemaId = "helloworld")
public class HelloWorldProvider implements HelloWorld {
    public String sayHello(String name) {
        return "Hello " + name;
    }
}

Consumer service:

import org.apache.servicecomb.*;
@Component
public class HelloWorldConsumer  {
	@RpcReference(microserviceName = "pojo", schemaId = "helloworld")
	private static HelloWorld helloWorld;

	public static void main(String[] args) {
		helloWorld.sayHello("Tank");
	}
}

Documentation

Project documentation is available on the ServiceComb website.

Building

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 1.8.

  mvn clean install

If you want to build the release kits from the source

  mvn clean install  -Prelease,distribution

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

Automated Testing

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

Get The Latest Release

Download Java-Chassis

Get The Latest SNAPSHOT

We publish the snapshot version to Apache nexus repo, please add below repositories into your pom.xml.

   <repositories>
      <repository>
        <releases />
        <snapshots>
          <enabled>true</enabled>
        </snapshots>
        <id>repo.apache.snapshot</id>
        <url>https://repository.apache.org/content/repositories/snapshots/</url>
      </repository>
    </repositories>
    <pluginRepositories>
      <pluginRepository>
        <releases />
        <snapshots>
          <enabled>true</enabled>
        </snapshots>
        <id>repo.apache.snapshot</id>
        <url>https://repository.apache.org/content/repositories/snapshots/</url>
      </pluginRepository>
    </pluginRepositories>

Contact

Bugs: issues

mailing list: subscribe dev

Contributing

See CONTRIBUTING for details on submitting patches and the contribution workflow.