地址组件README

Standard-Address

标准化地址组件

使用方法

• git clone 地址组件工程
• mvn clean install 将地址组件jar包打入本地仓库
• 在工程数据库中执行省市区sql
• 在工程中引入地址jar包

    com.standard
    address
    1.0-SNAPSHOT

• 在项目启动类上将地址组件的bean通过注解（@EnableAddressComponet）注入到spring容器中

@EnableAddressComponet
public class ManagementApplication {

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

}

• 也可在地址组件工程中resources下面新建META-INF文件夹，在下面新建spring.factories文件，在其中指明自动注解抓取的类，让springboot注解自动抓取，不用再通过注解@EnableAddressComponet指定

org.springframework.boot.autoconfigure.EnableAutoConfiguration=类全名

• 在application.properties中表明mapper文件的位置（省市区）

# mybatis
# 多环境不同配置（mapper文件放在不同工程下）
mybatis.mapper-locations=classpath:/mapper/address/*.xml,\
...

• 指定swagger配置文件扫描带有@ApiOperation注解的方法（将组件中的swagger扫描到当前工程下）

import io.swagger.annotations.ApiOperation;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * swagger config
 *
 * @author 伍磊
 */
@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                //扫描的是自定义Controller的包名
                //.apis(RequestHandlerSelectors.basePackage("com.standard"))
                .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                .paths(PathSelectors.any())
                .build();
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .build();
    }
}