手撸一个Spring Boot Starter并上传到Maven中央仓库

下面就是手撸一个Spring Boot Starter并上传到Maven中央仓库的完整攻略：

什么是Spring Boot Starter

Spring Boot Starter是一个针对特定的场景，预先配置好Spring Boot和第三方库的样板代码模板。这个模板通常包含了对于Spring Boot应用程序的配置、依赖管理、初始化等操作，并通过自动配置的方式，实现在Spring Boot的应用中引入这些场景所需要准备的相关依赖和Bean对象。

例如，Spring Boot提供了Spring Boot Starter for JDBC和Spring Boot Starter for JPA，使用这些Starter可以让我们更简单地使用JDBC和JPA操作数据库。

编写一个Spring Boot Starter

下面我们来编写一个简单的Spring Boot Starter，以便熟悉其工作原理。假设我们要编写一个Starter，使得在Spring Boot应用启动时，我们可以通过Spring Bean来获取一个UUID。

1. 创建Maven项目

首先，我们创建一个Maven项目，并在项目的pom.xml文件中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-autoconfigure</artifactId>
        <version>2.3.0.RELEASE</version>
    </dependency>
</dependencies>

其中，spring-boot-starter是Spring Boot的核心依赖，spring-boot-autoconfigure是Spring Boot提供的自动配置功能。通过添加这两个依赖，我们可以使用Spring Boot应用中的自动配置机制。

2. 创建自动配置类

创建一个配置类，以生成一个UUID并将其注册到Spring的Bean容器中，具体代码如下：

@Configuration
@EnableConfigurationProperties({MyProperties.class})
public class MyAutoConfiguration {

    @Autowired
    private MyProperties myProperties;

    @Bean
    @ConditionalOnMissingBean
    public UUID uuid() {
        UUID uuid = UUID.randomUUID();
        System.out.println("The UUID is: " + uuid);
        return uuid;
    }
}

这段代码中，我们创建了一个自动配置类MyAutoConfiguration，使用@ConditionalOnMissingBean注解来确保该Bean只会在不存在UUID类型Bean时才会自动配置。

另外，我们还需要在MyAutoConfiguration类中注入一个MyProperties类，MyProperties类用来表示在应用程序中可配置的属性值，如：

@ConfigurationProperties(prefix = "spring.my")
public class MyProperties {

    private boolean enabled = true;

    public boolean isEnabled() {
        return enabled;
    }

    public void setEnabled(boolean enabled) {
        this.enabled = enabled;
    }
}

3. 配置核心文件

在src/main/resource目录下，创建META-INF/spring.factories文件，并将MyAutoConfiguration类的全路径加入到该文件中：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.example.MyAutoConfiguration

4. 编写example应用程序

为了测试我们的自动配置是否生效，我们创建一个简单的Spring Boot应用程序，如下：

@SpringBootApplication
public class ExampleApplication {

    public static void main(String[] args) {
        ApplicationContext context = SpringApplication.run(ExampleApplication.class, args);

        UUID uuid = context.getBean(UUID.class);

        System.out.println("My UUID is: " + uuid);
    }
}

示例场景一：配置文件中禁用自动配置

默认情况下，我们的自动配置MyAutoConfiguration会自动激活。为了测试我们的自动配置是否真正支持配置功能，我们可以在application.properties(或application.yml)中设置属性：spring.my.enabled=false，这样我们的自动配置就会被禁用。

示例场景二：手动指定Bean

如果你想手动指定一个UUID Bean而不是使用我们的自动配置，你可以在ExampleApplication类中添加以下代码：

@SpringBootApplication
public class ExampleApplication {

    public static void main(String[] args) {
        ApplicationContext context = SpringApplication.run(ExampleApplication.class, args);

        UUID uuid = new UUID(0, 0);

        context.getBeanFactory().registerSingleton("myUuid", uuid);

        UUID myUuid = context.getBean("myUuid", UUID.class);

        System.out.println("My UUID is: " + myUuid);
    }
}

通过使用上述代码，我们实际上重新定义了UUID Bean，将其命名为myUuid，而不使用我们的自动配置。

将Starter上传到Maven中央仓库

完成了我们的自动配置之后，我们需要将它上传到Maven中央仓库，以便其他人可以使用该Starter。

首先，我们需要创建一个Maven Central Repository账号。然后，我们需要将Maven项目pom.xml文件中的版本号改为我们将要上传的版本号，并添加以下依赖：

<dependencies>
    ...
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-configuration-processor</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

这是一个可选的依赖，但是它能够在构建Starter时生成与之对应的metadata文件，从而使其他人更容易地知道如何使用你的Starter。

接下来，我们需要在Maven项目中执行以下命令：

$ mvn clean deploy

这个命令会将你的应用程序上传到Maven中央仓库中。

最后，Maven中央仓库需要审核通过我们上传的Maven包才会对其他人进行公开发布。审核通常需要一到两天的时间，如果审核成功，我们就可以使用maven文档中的方式进行引用。