若依框架-初始化模板

環(huán)境部署

1. 準(zhǔn)備工作

JDK >= 1.8 (推薦1.8版本)
Mysql >= 5.7.0 (推薦5.7版本)
Maven >= 3.0

2. 運(yùn)行項(xiàng)目

   1. 前往Gitee下載頁(yè)面(https://gitee.com/y_project/RuoYi (opens new window))下載解壓到工作目錄
   2. 導(dǎo)入到Eclipse，菜單 File -> Import耗美，然后選擇 Maven -> Existing Maven Projects挤安，點(diǎn)擊 Next> 按鈕咳蔚，選擇工作目錄医瘫，然后點(diǎn)擊 Finish 按鈕箫攀，即可成功導(dǎo)入昔搂。
      Eclipse會(huì)自動(dòng)加載Maven依賴包竹观，初次加載會(huì)比較慢（根據(jù)自身網(wǎng)絡(luò)情況而定）
   3. 創(chuàng)建數(shù)據(jù)庫(kù)ry并導(dǎo)入數(shù)據(jù)腳本ry_2021xxxx.sql，quartz.sql
   4. 打開項(xiàng)目運(yùn)行com.ruoyi.RuoYiApplication.java遭赂，出現(xiàn)如下圖表示啟動(dòng)成功循诉。
   5. 打開瀏覽器，輸入：(http://localhost:80 (opens new window)) （默認(rèn)賬戶/密碼 admin/admin123）
      若能正確展示登錄頁(yè)面撇他，并能成功登錄茄猫，菜單及頁(yè)面展示正常，則表明環(huán)境搭建成功

   建議使用Git克隆困肩，因?yàn)榭寺〉姆绞娇梢院蚏uoYi隨時(shí)保持更新同步划纽。使用Git命令克隆

3. 運(yùn)行成功
   

   微信圖片_20210120181752.png
   
   注意：
   我們可能導(dǎo)入quartz.sql會(huì)報(bào)錯(cuò)？
   1071 - Specified key was too long; max key length is 767 bytes 1709 - Index column size too large. The maximum column size is 767 bytes.锌畸？
   解決方法
   https://gitee.com/y_project/RuoYi-Vue/issues/I1O1M8

改造框架

1. 區(qū)分接口

2. 更換項(xiàng)目包路徑
   使用 module 重命名

├── xxxxx
│       └── xxxxx-admin
│       └── xxxxx-common
│       └── xxxxx-framework
│       └── xxxxx-generator
│       └── xxxxx-quartz
│       └── xxxxx-system
│       └── pom.xml

2. 更換頂級(jí)目錄的pom.xml

<modules>
    <module>xxxx-admin</module>
    <module>xxxx-framework</module>
    <module>xxxx-system</module>
    <module>xxxx-quartz</module>
    <module>xxxx-generator</module>
    <module>xxxx-common</module>
</modules>

3. 更換項(xiàng)目所有包名稱 com.ruoyi.xxx 換成com.yyy.xxx

4. 更換application.yml指定要掃描的Mapper類的包的路徑typeAliasesPackage包路徑名稱替換com.xxxxx

# MyBatis
mybatis:
    # 搜索指定包別名
    typeAliasesPackage: com.你的包名.**.domain

5. 更換mapper文件的namespace包路徑

6. 更換pom文件內(nèi)容
   以下pom.xml文件中包含ruoyi的關(guān)鍵字替換成xxxxx

├── xxxxx
│       └── xxxxx-admin      pom.xml
│       └── xxxxx-common     pom.xml
│       └── xxxxx-framework  pom.xml
│       └── xxxxx-generator  pom.xml
│       └── xxxxx-quartz     pom.xml
│       └── xxxxx-system     pom.xml
│       └── pom.xml

以上操作完正常情況下 項(xiàng)目包路徑都已經(jīng)更改完畢 重啟項(xiàng)目就OK

進(jìn)一步改造模板

1. 控制臺(tái)日志 變顏色
   修改logback.xml文件

        <!-- 日志輸出格式 -->
   <property name="log.pattern" value="%d{HH:mm:ss.SSS} [%thread] %-5level %logger{20} - [%method,%line] - %msg%n" />
   <property name="log.color.pattern" value="%red(%d{yyyy-MM-dd HH:mm:ss}) %green([%thread]) %highlight(%-5level) %boldMagenta(%logger{10}) - %cyan(%msg%n)"></property>
   <!-- 控制臺(tái)輸出 -->
   <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
       <encoder>
           <pattern>${log.color.pattern}</pattern>
       </encoder>
   </appender>
   

2. 咋樣配置項(xiàng)目切換環(huán)境

• 在 xxx-admin 的 pom.xml文件 配置 profiles

 <profiles>

        <profile>
            <!-- 生產(chǎn)環(huán)境 -->
            <id>prod</id>
            <properties>
                <profileActive>prod</profileActive>
            </properties>
            <activation>
                <activeByDefault>false</activeByDefault>
            </activation>
        </profile>

        <profile>
            <!-- 本地開發(fā)環(huán)境 -->
            <id>dev</id>
            <properties>
                <profileActive>dev</profileActive>
            </properties>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
        </profile>
        <profile>
            <!-- 測(cè)試環(huán)境 -->
            <id>test</id>
            <properties>
                <profileActive>test</profileActive>
            </properties>
            <activation>
                <activeByDefault>false</activeByDefault>
            </activation>
        </profile>
    </profiles>

• 在 在 xxx-admin 的 application.yml 配置 profiles（動(dòng)態(tài)切換）

spring:
    profiles: 
        active: @profileActive@

如果報(bào)錯(cuò) 在 xxx-admin 的 pom.xml文件

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <!--開啟過濾勇劣，用指定的參數(shù)替換directory下的文件中的參數(shù)-->
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

[參考文獻(xiàn)](https://blog.csdn.net/mengjie0617/article/details/110122080
https://www.icode9.com/content-4-510466.html)

1611137825(1).png

3. 配置日志

部署流程

部署方式：

• SpringBoot Jar包部署方式
• 依賴jar包和靜態(tài)資源文件分離

流程：

1. cd 進(jìn)入項(xiàng)目根目錄，屬于以下mvn命令進(jìn)行打包潭枣。

   打包測(cè)試環(huán)境

    mvn clean package  -Ptest -Dmaven.test.skip=true
   

   打包生產(chǎn)環(huán)境

    mvn clean package  -Pdis -Dmaven.test.skip=true
   

   打包過后進(jìn)入xxxx-admin文件夾內(nèi)target目錄比默，可以看到目錄內(nèi)有 lib幻捏，resource兩個(gè)文件夾 以及xxxx-admin.jar。

   • lib目錄中均為依賴所需的jar包退敦，第一次上傳需要將整體上傳到服務(wù)器項(xiàng)目所在地lib目錄中粘咖，后期迭代之后只需要將增加的依賴包拷貝進(jìn)入就行，需要更新項(xiàng)目xxxx-common,xxxx-system,xxxx-framework,xxxx-quartz等目錄時(shí)侈百，只需要將相關(guān)文件夾中target目錄的jar包拷貝進(jìn)去替換即可。
   • resources目錄中均為xxxx-admin中的靜態(tài)資源文件翰铡，將此文件夾拷貝到服務(wù)器項(xiàng)目部署相同目錄中即可钝域，迭代升級(jí)替換相關(guān)文件即可。

2. 上傳到服務(wù)器之后锭魔，在xxxx-admin.jar同類文件中,按照以下命令進(jìn)行

   nohup java -jar -Dloader.path=.,resources,lib xxxx-admin.jar >temp.txt &
   

查看運(yùn)行情況：

ps -ef|grep 'java -jar'

``` 暫時(shí)不用這種服務(wù)類型的
service xxxx-admin stop
```
```
rm -rf /etc/init.d/xxxx-admin
```
```
ln -s /usr/local/api/project/xxxx-admin.jar /etc/init.d/xxxx-admin
```
```
chmod +x /usr/local/api/project/xxxx-admin.jar
```
```
service xxxx-admin start
```

參考
若依手冊(cè)