Проект Apache Dubbo Spring Boot

<properties>
    <spring-boot.version>2.3.0.RELEASE</spring-boot.version>
    <dubbo.version>2.7.8</dubbo.version>
</properties>

<dependencyManagement>
    <dependencies>
        <!-- Spring Boot -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>${spring-boot.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
```        <!-- Apache Dubbo -->
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo-dependencies-bom</artifactId>
            <version>${dubbo.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
      
    </dependencies>
</dependencyManagement>
``````markdown
<dependencies>
    <!-- Dubbo Spring Boot Starter -->
    <dependency>
        <groupId>org.apache.dubbo</groupId>
        <artifactId>dubbo-spring-boot-starter</artifactId>
        <version>2.7.8</version>
    </dependency>    
</dependencies>

<repositories>
    <repository>
        <id>apache.snapshots.https</id>
        <name>Apache Development Snapshot Repository</name>
        <url>https://repository.apache.org/content/repositories/snapshots</url>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

public interface DemoService {

    String sayHello(String name);

}

@DubboService(version = "1.0.0")
public class DefaultDemoService implements DemoService {

    /**
     * Значение по умолчанию для ${dubbo.application.name} равно ${spring.application.name}
     */
    @Value("${dubbo.application.name}")
    private String serviceName;

    public String sayHello(String name) {
        return String.format("[%s] : Привет, %s", serviceName, name);
    }
}
```2. Предоставляет класс для автоматической настройки

    ```java
    @EnableAutoConfiguration
    public class DubboProviderDemo {

        public static void main(String[] args) {
            SpringApplication.run(DubboProviderDemo.class, args);
        }
    }
    ```

3. Конфигурирует файл `application.properties`:

    ```properties
    # Приложение Spring Boot
    spring.application.name=dubbo-auto-configuration-provider-demo
    # Базовые пакеты для сканирования компонентов Dubbo: @org.apache.dubbo.config.annotation.Service
    dubbo.scan.base-packages=org.apache.dubbo.spring.boot.sample.provider.service
    ```    # Приложение Dubbo
    ## Значение по умолчанию для dubbo.application.name равно ${spring.application.name}
    ## dubbo.application.name=${spring.application.name}

    # Протокол Dubbo
    dubbo.protocol.name=dubbo
    dubbo.protocol.port=12345

    ## Регистрация Dubbo
    dubbo.registry.address=N/A
    ```



### Клиент потребителя сервиса Dubbo

1. Клиент потребителя также предоставляет класс для автоматической настройки для ссылки на `DemoService`

    ```java
    @EnableAutoConfiguration
    public class DubboAutoConfigurationConsumerBootstrap {

        private final Logger logger = LoggerFactory.getLogger(getClass());

        @DubboReference(version = "1.0.0", url = "dubbo://127.0.0.1:12345")
        private DemoService demoService;

        public static void main(String[] args) {
            SpringApplication.run(DubboAutoConfigurationConsumerBootstrap.class).close();
        }

        @Bean
        public ApplicationRunner runner() {
            return args -> {
                logger.info(demoService.sayHello("mercyblitz"));
            };
        }
    }
    ```

2. Конфигурирует файл `application.yml`

    ```yaml
    spring:
      application:
        name: dubbo-auto-configure-consumer-sample
    ```

Если `DubboProviderDemo` работает корректно, убедитесь, что `DubboProviderDemo` запущен.

Дополнительные сведения см. в разделе [Примеры](dubbo-spring-boot-samples).




## Получение помощи

Имеете проблемы с приложением Dubbo Spring Boot? Мы готовы помочь!- Если вы обновляете версию, прочтите [заметки выпуска](https://github.com/apache/dubbo-spring-boot-project/releases) для получения инструкций по обновлению и новых возможностей.
- Обратитесь за помощью — Вы можете подписаться на [почтовый список пользователей Dubbo](mailto:dubbo+subscribe@googlegroups.com).
- Отправьте сообщение об ошибке на [github.com/apache/dubbo-spring-boot-project/issues](https://github.com/apache/dubbo-spring-boot-project/issues).

## Сборка с источниковЕсли вы хотите попробовать последние возможности Dubbo Spring Boot, её можно легко собрать с помощью [maven wrapper](https://github.com/takari/maven-wrapper). Ваш JDK версии 1.8 или выше.

```
$ ./mvnw clean install
```



## Модули

В проекте Apache Dubbo Spring Boot есть несколько модулей, давайте рассмотрим следующий обзор:

### [dubbo-spring-boot-parent](dubbo-spring-boot-parent)

Основное использование `dubbo-spring-boot-parent` — предоставление управления зависимостями для других модулей.


### [dubbo-spring-boot-autoconfigure](dubbo-spring-boot-autoconfigure)

`dubbo-spring-boot-autoconfigure` использует `@EnableAutoConfiguration` в Spring Boot, что позволяет автоматически конфигурировать компоненты основного Dubbo через `DubboAutoConfiguration`. Это снижает объём кода и устраняет необходимость использования XML-конфигураций.


### [dubbo-spring-boot-actuator](dubbo-spring-boot-actuator)

`dubbo-spring-boot-actuator` обеспечивает готовые к использованию в продакшне возможности (например, [проверки состояния](https://github.com/apache/dubbo-spring-boot-project/tree/master/dubbo-spring-boot-actuator#health-checks), [конечные точки](https://github.com/apache/dubbo-spring-boot-project/tree/master/dubbo-spring-boot-actuator#endpoints) и [внешние конфигурации](https://github.com/apache/dubbo-spring-boot-project/tree/master/dubbo-spring-boot-actuator#externalized-configuration)).


### [dubbo-spring-boot-starter](dubbo-spring-boot-starter)

`dubbo-spring-boot-starter` является стандартным начальным пакетом Spring Boot, который включает в себя [dubbo-spring-boot-autoconfigure](dubbo-spring-boot-autoconfigure) и [dubbo-spring-boot-actuator](dubbo-spring-boot-actuator). Он будет импортироваться непосредственно в ваше приложение.### [dubbo-spring-boot-samples](dubbo-spring-boot-samples)

Проект образцов Dubbo Spring Boot, который включает:

- [Образцы автозагрузки](dubbo-spring-boot-samples/auto-configure-samples)
- [Образцы внешних конфигураций](dubbo-spring-boot-samples/externalized-configuration-samples)
- [Образцы регистрации Zookeeper](https://github.com/apache/dubbo-spring-boot-project/tree/master/dubbo-spring-boot-samples/registry-samples/zookeeper-samples)
- [Образцы регистрации Nacos](https://github.com/apache/dubbo-spring-boot-project/tree/master/dubbo-spring-boot-samples/registry-samples/nacos-samples)

## Лицензия

Проект Apache Dubbo для Spring Boot находится под лицензией Apache 2.0. Подробнее см. файл [LICENSE](https://github.com/apache/dubbo-spring-boot-project/blob/master/LICENSE).