# only-doc-spring-boot-starter

**Repository Path**: ymts/only-doc-spring-boot-starter

## Basic Information

- **Project Name**: only-doc-spring-boot-starter
- **Description**: 自动spring boot 接口文档
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 9
- **Created**: 2020-05-20
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# only-doc-spring-boot-starter

#### 介绍
自动spring boot 接口文档

这是通过源码扫描生成接口文档的工具

### 使用方式
1、maven 引入依赖
```
		<dependency>
			<groupId>com.onlyxiahui.general</groupId>
			<artifactId>only-doc-spring-boot-starter</artifactId>
			<version>1.0.0</version>
		</dependency>
```

2、需要生成文档的接口需要源码，所以可以2种方式选其一


```
1)源码打包进jar，需要插件配置
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-resources-plugin</artifactId>
				<executions>
					<execution>
						<id>copy-resources</id>
						<phase>process-resources</phase>
						<goals>
							<goal>copy-resources</goal>
						</goals>
						<configuration>
							<outputDirectory>${project.build.outputDirectory}
							</outputDirectory>
							<resources>
								<resource>
									<directory>src/main/java</directory>
									<includes>
										<include>**/*.java</include>
									</includes>
								</resource>
							</resources>
						</configuration>
					</execution>
				</executions>
			</plugin>
		</plugins>
		
2)引入的jar导入源码
<!--依赖库源码-->
<dependency>
	<groupId>org.springframework</groupId>
	<artifactId>spring-core</artifactId>
    <version>5.0.0.RELEASE</version>
    <classifier>sources</classifier>
    <!--设置为test,项目发布时source不会放入最终的产品包-->
    <scope>test</scope>
</dependency>

```

3、打开接口文档
目前默认为http://xxx.xxx.xxx.xxx:xx/doc/index.html