SpringBoot+Dubbo简单测试例子

# Dubbo Spring Boot Production-Ready `dubbo-spring-boot-actuator` provides production-ready features (e.g. [health checks](#health-checks), [endpoints](#endpoints), and [externalized configuration](#externalized-configuration)). ## Content 1. [Main Content](https://github.com/dubbo/dubbo-spring-boot-project) 2. [Integrate with Maven](#integrate-with-maven) 3. [Health Checks](#health-checks) 4. [Endpoints](#endpoints) 5. [Externalized Configuration](#externalized-configuration) ## Integrate with Maven You can introduce the latest `dubbo-spring-boot-actuator` to your project by adding the following dependency to your pom.xml ```xml <dependency> <groupId>com.alibaba.boot</groupId> <artifactId>dubbo-spring-boot-actuator</artifactId> <version>0.1.0</version> </dependency> ``` If your project failed to resolve the dependency, try to add the following repository: ```xml <repositories> <repository> <id>sonatype-nexus-snapshots</id> <url>https://oss.sonatype.org/content/repositories/snapshots</url> <releases> <enabled>false</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> ``` ## Health Checks `dubbo-spring-boot-actuator` supports the standard Spring Boot `HealthIndicator` as a production-ready feature , which will be aggregated into Spring Boot's `Health` and exported on `HealthEndpoint` that works MVC (Spring Web MVC) and JMX (Java Management Extensions) both if they are available. ### MVC Endpoint : `/health` Suppose a Spring Boot Web application did not specify `management.port`, you can access http://localhost:8080/health via Web Client and will get a response with JSON format is like below : ```json { "status": "UP", "dubbo": { "status": "UP", "memory": { "source": "management.health.dubbo.status.defaults", "status": { "level": "OK", "message": "max:3641M,total:383M,used:92M,free:291M", "description": null } }, "load": { "source": "management.health.dubbo.status.extras", "status": { "level": "OK", "message": "load:1.73583984375,cpu:8", "description": null } }, "threadpool": { "source": "management.health.dubbo.status.extras", "status": { "level": "OK", "message": "Pool status:OK, max:200, core:200, largest:0, active:0, task:0, service port: 12345", "description": null } }, "server": { "source": "dubbo@ProtocolConfig.getStatus()", "status": { "level": "OK", "message": "/192.168.1.103:12345(clients:0)", "description": null } } } // ignore others } ``` In [samples](../dubbo-spring-boot-samples/) , `/health` MVC Endpoints are exposed on http://localhost:9091/health ([provider](../dubbo-spring-boot-samples/dubbo-spring-boot-sample-provider)) and http://localhost:8081/health ([consumer](../dubbo-spring-boot-samples/dubbo-spring-boot-sample-consumer)) `memory`, `load`, `threadpool` and `server` are Dubbo's build-in `StatusChecker`s in above example. Dubbo allows the application to extend `StatusChecker`'s SPI. Default , `memory` and `load` will be added into Dubbo's `HealthIndicator` , it could be overridden by externalized configuration [`StatusChecker`'s defaults](#statuschecker-defaults). ### JMX Endpoint : `healthEndpoint` `healthEndpoint` is a JMX (Java Management Extensions) Endpoint with ObjectName `org.springframework.boot:type=Endpoint,name=healthEndpoint` , it can be managed by JMX agent ,e.g. JDK tools : `jconsole` and so on.  ### Build-in `StatusChecker`s `META-INF/dubbo/internal/com.alibaba.dubbo.common.status.StatusChecker` declares Build-in `StatusChecker`s as follow : ```properties registry=com.alibaba.dubbo.registry.status.RegistryStatusChecker spring=com.alibaba.dubbo.config.spring.status.SpringStatusChecker datasource=com.alibaba.dubbo.config.spring.status.DataSourceStatusChecker memory=com.alibaba.dubbo.common.status.support.MemoryStatusChecker load=com.alibaba.dubbo.common.status.support.LoadStatusChecker server=com.alibaba.dubbo.rpc.protocol.dubbo.status.ServerStatusChecker threadpool=com.alibaba.dubbo.rpc.protocol.dubbo.status.ThreadPoolStatusChecker ``` The property key that is name of `StatusChecker` can be a valid value of `management.health.dubbo.status.*` in externalized configuration. ## Endpoints Actuator endpoint `dubbo` supports Spring Web MVC Endpoints : | URI | HTTP Method | Description | Content Type | | ------------------- | ----------- | ----------------------------------- | ------------------ | | `/dubbo` | `GET` | Exposes Dubbo's meta data | `application/json` | | `/dubbo/properties` | `GET` | Exposes all Dubbo's Properties | `application/json` | | `/dubbo/services` | `GET` | Exposes all Dubbo's `ServiceBean` | `application/json` | | `/dubbo/references` | `GET` | Exposes all Dubbo's `ReferenceBean` | `application/json` | | `/dubbo/configs` | `GET` | Exposes all Dubbo's `*Config` | `application/json` | | `/dubbo/shutdown` | `POST` | Shutdown Dubbo services | `application/json` | ### Endpoint : `/dubbo` `/dubbo` exposes Dubbo's meta data : ```json { "timestamp": 1516623290166, "versions": { "dubbo-spring-boot": "1.0.0" "dubbo": "2.5.9" }, "urls": { "dubbo": "https://github.com/alibaba/dubbo", "google-group": "http://groups.google.com/group/dubbo", "github": "https://github.com/dubbo/dubbo-spring-boot-project", "issues": "https://github.com/dubbo/dubbo-spring-boot-project/issues", "git": "https://github.com/dubbo/dubbo-spring-boot-project.git" }, "endpoints": { "shutdown": "/shutdown", "configs": "/configs", "services": "/services", "references": "/references", "properties": "/properties" } } ``` ### Endpoint : `/dubbo/properties` `/dubbo/properties` exposes all Dubbo's Properties from Spring Boot Externalized Configuration (a.k.a `PropertySources`) : ```json { "dubbo.application.id": "dubbo-provider-demo", "dubbo.application.name": "dubbo-provider-demo", "dubbo.application.qos-enable": "false", "dubbo.application.qos-port": "33333", "dubbo.protocol.id": "dubbo", "dubbo.protocol.name": "dubbo", "dubbo.protocol.port": "12345", "dubbo.registry.address": "N/A", "dubbo.registry.id": "my-registry", "dubbo.scan.basePackages": "com.alibaba.boot.dubbo.demo.provider.service" } ``` The structure of JSON is simple Key-Value format , the key is property name as and the value is property value. ### Endpoint : `/dubbo/services` `/dubbo/services` exposes all Dubbo's `ServiceBean` that are declared via `<dubbo:service/>` or `@Service` present in Spring `ApplicationContext` : ```json { "ServiceBean@com.alibaba.boot.dubbo.demo.api.DemoService#defaultDemoService": { "accesslog": null, "actives": null, "cache": null, "callbacks": null, "class": "com.alibaba.dubbo.config.spring.ServiceBean", "cluster": null, "connections": null, "delay": null, "document": null, "executes": null, "export": null, "exported": true, "filter": "", "generic": "false", "group": null, "id": "com.alibaba.boot.dubbo.demo.api.DemoService", "interface": "com.alibaba.boot.dubbo.demo.api.DemoService", "interfaceClass": "com.alibaba.boot.dubbo.demo.api.DemoService", "layer": null, "listener": "", "loadbalance": null, "local": null, "merger": null, "mock": null, "onconnect": null, "ondisconnect": null, "owner": null, "path": "com.alibaba.boot.dubbo.demo.api.DemoService", "proxy": null, "retries": null, "scope": null, "sent": null, "stub": null, "timeout": null, "token"