(快速參考)

create-plugin

說明

create-plugin 命令用於建立 Grails 外掛程式專案。Grails 外掛程式專案類似於應用程式專案,但包含外掛程式描述,而且可以打包成外掛程式,安裝到其他 Grails 應用程式中。

外掛程式不僅對外掛程式開發人員有價值,而且也可以作為將大型 Grails 應用程式模組化的方式。它們允許您封裝功能,並在不同的專案中輕鬆重複使用。若要深入了解如何為 Grails 開發外掛程式,請參閱 Grails 使用者指南中關於 外掛程式開發 的章節。

用法

若要建立 Grails 外掛程式,請使用下列命令

grails create-plugin [OPTIONS] NAME
  • NAME:Grails 外掛程式的所需名稱。

選項包括指定功能、設定 GORM 實作、選擇 servlet 實作、選擇測試架構、設定 JDK 版本等。您可以使用這些選項根據您的特定需求調整 Grails 外掛程式。

選項

以下是 create-plugin 命令的可用選項

  • -f, --features=FEATURE[,FEATURE…​]: 指定要包含在外掛程式中的功能。可用的選項包括 h2、gorm-hibernate5、spring-boot-starter-jetty、springloaded、micronaut-http-client、cache-ehcache、hibernate-validator、postgres、mysql、cache、database-migration、grails-gsp、hamcrest、gorm-mongodb、assertj、mockito、spring-boot-starter-undertow、micronaut-inject-groovy、github-workflow-java-ci、jrebel、testcontainers、sqlserver、grails-console、views-markup、views-json、gorm-neo4j、asciidoctor、embedded-mongodb、grails-web-console、logbackGroovy、mongo-sync、shade、properties。

  • -g, --gorm=GORM 實作:指定要為外掛程式設定的 GORM 實作。可能的值為 hibernate、mongodb、neo4j。

  • -h, --help:顯示說明訊息並結束。

  • -i, --inplace:在當前目錄中建立服務。

  • --jdk=<javaVersion>:指定專案應鎖定的 JDK 版本。

  • -s, --servlet=Servlet 實作:指定要為外掛程式設定的 Servlet 實作。可能的數值為 none、tomcat、jetty、undertow。

  • -t, --test=TEST:指定要為外掛程式使用的測試架構。可能的數值為 junit、spock。

範例

建立具有特定功能的名為「example-plugin」的 Grails 外掛程式

grails create-plugin example-plugin --features h2,gorm-hibernate5,asciidoctor

此命令會產生一個名為「example-plugin」的 Grails 外掛程式專案,並具有指定的特定功能,使其準備好進行開發並整合到其他 Grails 應用程式中。

以下是 create-plugin 命令的其他範例

  1. 建立一個最小的 Grails 外掛程式

    grails create-plugin minimal-plugin

    此命令會建立一個名為「minimal-plugin」的 Grails 外掛程式專案,並套用預設設定,適合從頭開始一個新的外掛程式專案。

  2. 建立一個支援 MongoDB 的外掛程式

    grails create-plugin mongodb-plugin --gorm=mongodb

    此命令會產生一個名為「mongodb-plugin」的 Grails 外掛程式專案,並設定為使用 MongoDB 作為 GORM 實作。

  3. 建立一個具有嵌入式 H2 資料庫和檢視支援的外掛程式

    grails create-plugin h2-views-plugin --features h2,views-markup

    此命令會建立一個名為「h2-views-plugin」的 Grails 外掛程式專案,並啟用 H2 資料庫和檢視標記功能,使其適用於需要嵌入式資料庫和檢視呈現功能的專案。

這些其他範例展示了 create-plugin 命令的不同使用案例,例如建立最小的外掛程式、自訂 GORM 實作,以及啟用特定功能以符合專案需求。