如何定制自己的起步依賴 Spring Boot Starter

感謝您的閱讀,本文由 楊斌的博客 版權(quán)所有样屠。
如若轉(zhuǎn)載,請(qǐng)注明出處:楊斌的博客(https://y0ngb1n.github.io/a/coustomize-your-own-spring-boot-starter.html


在這里我們一起動(dòng)手實(shí)現(xiàn)一個(gè)屬于自己的起步依賴

代碼托管于 GitHub缺脉,歡迎 Star :kissing_heart:

主要內(nèi)容

主要加入兩個(gè)模塊痪欲,一個(gè)是與自動(dòng)配置相關(guān)的模塊,如果你的依賴需要做自動(dòng)配置攻礼,那么我們可以在里面寫上自動(dòng)配置业踢。另一個(gè)是 starter 模塊,它里面就是一些依賴項(xiàng)礁扮,首先就是指向我們的 autoconfigure 模塊的一個(gè)依賴知举,另外就是當(dāng)前這個(gè) Starter 所自己需要的依賴項(xiàng)瞬沦。

  • autoconfigure 模塊,包含自動(dòng)配置代碼
  • starter 模塊雇锡,包含指向自動(dòng)配置模塊的依賴及其他相關(guān)依賴

這里說明一下逛钻,autoconfigure 并不是必須的,如果當(dāng)前這個(gè)模塊并不需要什么自動(dòng)配置锰提,就可以把它去掉曙痘。而 Spring Boot 相關(guān)的那些自動(dòng)配置很多都是集中在 spring-boot-autoconfigure 里面的,所以它只要依賴了 spring-boot-starter立肘,那么就會(huì)自動(dòng)地加入這些 Autoconfigure边坤。

命名方式

一般是建議在前面加上一個(gè)前綴,主要是與 Spring Boot 官方的那些依賴做區(qū)分谅年,如下所示:

  • xxx-spring-boot-autoconfigure
  • xxx-spring-boot-starter

這樣就可以定義一個(gè)你自己的 Spring Boot Starter 了茧痒。

一些注意事項(xiàng)

  • 不要使用 spring-boot 作為依賴的前綴

    如果你這樣做了,會(huì)和 Spring Boot 官方的那些依賴混在一起踢故,從而導(dǎo)致不好辨認(rèn)文黎。

  • 不要使用 spring-boot 的配置命名空間

    另外如果你有一些配置惹苗,這里也是建議不要使用 Spring Boot 已經(jīng)在使用的配置命名空間殿较。比方說它里面有 servermanagement 相關(guān)的這些配置項(xiàng)桩蓉,那么你就不要再使用以 server淋纲、management 命名前綴的配置了。

  • starter 中僅添加必要的依賴

    在當(dāng)前這個(gè) Starter 中只加入必要的依賴就可以了院究。也許這個(gè)要求有點(diǎn)苛克洽瞬,但這里的建議是希望你的依賴不多不少、正正好好业汰,你要使用到哪些依賴就只加這些依賴就好伙窃;如果沒有必要加進(jìn)去的就可以去掉它,這樣的好處是可以減少最終打出來的包里面的依賴样漆。

  • 聲明對(duì) spring-boot-starter 的依賴

    如果有需要的可以在這個(gè) Starter 當(dāng)中加入 spring-boot-starter 這個(gè)依賴为障。這個(gè)并不是必須的,因?yàn)槲覀儸F(xiàn)在很多的工程本身就是 spring-boot 的一個(gè)項(xiàng)目放祟,所以它本身就添加了對(duì) spring-boot-starter 的依賴鳍怨。這個(gè)要看你的需要來決定一下是否要添加。


擼起袖子加油干

下面我們來看看都有哪些方式可以實(shí)現(xiàn)自動(dòng)配置

  • 傳統(tǒng)手工實(shí)現(xiàn)的自動(dòng)配置(見 custom-starter-spring-lt4-autoconfigure

    :在低版本的 Spring 中能使用這種方式快速實(shí)現(xiàn)類似自動(dòng)配置的功能跪妥。

    <dependencies>
      <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
      </dependency>
      <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
      </dependency>
      <dependency>
        <groupId>io.github.y0ngb1n.samples</groupId>
        <artifactId>custom-starter-core</artifactId>
        <scope>provided</scope>
      </dependency>
    </dependencies>
    
  • 基于 Spring Boot 的自動(dòng)配置(見 custom-starter-spring-boot-autoconfigure

    <dependencies>
      <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-autoconfigure</artifactId>
      </dependency>
      <dependency>
        <groupId>io.github.y0ngb1n.samples</groupId>
        <artifactId>custom-starter-core</artifactId>
        <scope>provided</scope>
      </dependency>
    </dependencies>
    
  • 引用自定義 Starter(見 custom-starter-spring-boot-starter

    <dependencies>
      <dependency>
        <groupId>io.github.y0ngb1n.samples</groupId>
        <artifactId>custom-starter-spring-boot-starter</artifactId>
      </dependency>
    </dependencies>
    

運(yùn)行 custom-starter-examples 效果如下:

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v2.1.0.RELEASE)

2019-05-02 23:15:56.183  INFO 17236 --- [           main] i.g.y.s.d.AutoconfigureDemoApplication   : Starting AutoconfigureDemoApplication on HP with PID 17236 ...
2019-05-02 23:15:56.208  INFO 17236 --- [           main] i.g.y.s.d.AutoconfigureDemoApplication   : No active profile set, falling back to default profiles: default
2019-05-02 23:15:57.198  INFO 17236 --- [           main] i.g.y.s.g.GreetingApplicationRunner      : Initializing GreetingApplicationRunner.
2019-05-02 23:15:57.478  INFO 17236 --- [           main] i.g.y.s.d.AutoconfigureDemoApplication   : Started AutoconfigureDemoApplication in 2.516 seconds (JVM running for 5.501)
2019-05-02 23:15:57.486  INFO 17236 --- [           main] i.g.y.s.g.GreetingApplicationRunner      : Hello everyone! We all like Spring!

以上就是一個(gè)簡(jiǎn)單的 Starter鞋喇,在里面加入自己的自動(dòng)配置和相關(guān)的依賴。那么到這里你也可以實(shí)現(xiàn)一個(gè)屬于你的 Starter眉撵,從而簡(jiǎn)化你的 Maven 依賴項(xiàng)侦香。


參考鏈接

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末落塑,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子鄙皇,更是在濱河造成了極大的恐慌芜赌,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,126評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件伴逸,死亡現(xiàn)場(chǎng)離奇詭異缠沈,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)错蝴,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,254評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門洲愤,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人顷锰,你說我怎么就攤上這事柬赐。” “怎么了官紫?”我有些...
    開封第一講書人閱讀 152,445評(píng)論 0 341
  • 文/不壞的土叔 我叫張陵肛宋,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我束世,道長(zhǎng)酝陈,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 55,185評(píng)論 1 278
  • 正文 為了忘掉前任毁涉,我火速辦了婚禮沉帮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘贫堰。我一直安慰自己穆壕,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,178評(píng)論 5 371
  • 文/花漫 我一把揭開白布其屏。 她就那樣靜靜地躺著喇勋,像睡著了一般。 火紅的嫁衣襯著肌膚如雪偎行。 梳的紋絲不亂的頭發(fā)上川背,一...
    開封第一講書人閱讀 48,970評(píng)論 1 284
  • 那天,我揣著相機(jī)與錄音睦优,去河邊找鬼渗常。 笑死,一個(gè)胖子當(dāng)著我的面吹牛汗盘,可吹牛的內(nèi)容都是我干的皱碘。 我是一名探鬼主播,決...
    沈念sama閱讀 38,276評(píng)論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼隐孽,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼癌椿!你這毒婦竟也來了健蕊?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 36,927評(píng)論 0 259
  • 序言:老撾萬榮一對(duì)情侶失蹤踢俄,失蹤者是張志新(化名)和其女友劉穎缩功,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體都办,經(jīng)...
    沈念sama閱讀 43,400評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡嫡锌,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,883評(píng)論 2 323
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了琳钉。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片势木。...
    茶點(diǎn)故事閱讀 37,997評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖歌懒,靈堂內(nèi)的尸體忽然破棺而出啦桌,到底是詐尸還是另有隱情,我是刑警寧澤及皂,帶...
    沈念sama閱讀 33,646評(píng)論 4 322
  • 正文 年R本政府宣布甫男,位于F島的核電站,受9級(jí)特大地震影響验烧,放射性物質(zhì)發(fā)生泄漏板驳。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,213評(píng)論 3 307
  • 文/蒙蒙 一噪窘、第九天 我趴在偏房一處隱蔽的房頂上張望笋庄。 院中可真熱鬧效扫,春花似錦倔监、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,204評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至济丘,卻和暖如春谱秽,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背摹迷。 一陣腳步聲響...
    開封第一講書人閱讀 31,423評(píng)論 1 260
  • 我被黑心中介騙來泰國(guó)打工疟赊, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人峡碉。 一個(gè)月前我還...
    沈念sama閱讀 45,423評(píng)論 2 352
  • 正文 我出身青樓近哟,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親鲫寄。 傳聞我的和親對(duì)象是個(gè)殘疾皇子吉执,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,722評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容