# basic-archetype

**Repository Path**: cloudscope-cn/basic-archetype

## Basic Information

- **Project Name**: basic-archetype
- **Description**: 基于SpringCloud的微服务Maven骨架
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2022-03-02
- **Last Updated**: 2023-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 使用方式
> 本项目是公司基于SpringCloud生态搭建的基础框架的脚手架工程，适用于项目初始化代码
### 使用公司Maven仓库直接生成
1. 在本地Maven配置文件settings/xml中加入公司maven镜像
```xml
<mirror>
   <id>nexus</id>
   <mirrorOf>*</mirrorOf>
   <name>nexus</name>
   <url>http://192.168.0.107:8081/nexus/content/repositories/central/</url>
</mirror>

......

<profile>
   <id>profileArchetype</id>
   <repositories>
      <repository>
         <id>archetype</id>
         <name>cloudscope archetype</name>
         <url>http://192.168.0.107:8081/nexus/content/repositories/central/</url>
         <releases>
            <enabled>true</enabled>
         </releases>
      </repository>
   </repositories>
</profile>

......

<activeProfiles>
    <activeProfile>profileArchetype</activeProfile>
</activeProfiles>

```
2. 配置完后，在IDEA中，File-> New -> Project - Maven，勾选**Create from archetype**，点击**Add Archetype**，输入GAV坐标
```properties
groupId=cn.cloudscope
artifactId=basic-archetype
version=1.0-SNAPSHOT
```
3. 确定后，在`archetype`列表中找到添加的`archetype`:
<div align="center">
   <img src="doc/archetypes.jpg" width="80%"/>
</div>

4. 点击Next，输入本项目GAV，继续点击Next，输入一些额外参数，本骨架提供以下参数（及其默认值）供自定义(参照[metadata](src/main/resources/META-INF/maven/archetype-metadata.xml))：
```properties
# 以下键值均为默认值
# 项目前缀，应客户要求，修改框架的呈现形式，例如yk-common，若输入cnooc，则生成cnooc-common
prefix=yk
# 自定义版权信息，出现在Class头部注释
copyright=www.cloudscope.cn
# SpringBoot及SpringCloud的版本，非必要不更改，且应在更改后验证核心功能可用性
boot=2.5.9
cloud=2020.0.3
```
<div align="center">
   <img src="doc/preperties.jpg" width="80%"/>
</div>

5. 自动生成的工程结构如下，可直接使用：
<div align="center">
   <img src="doc/finish.jpg" width="80%"/>
</div>

### 使用骨架工程源码创建
> 与上述方式仅在获取骨架的方式上有所差异
1. 将骨架工程下载到本地：`git clone http://code.cloudscope.cn:8080/basic-framework/basic-archetype.git`
2. 执行maven install: `mvn install`
3. 继续上述第二步直至结束。