[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6ACGMW980S58X7861TC896N":3,"skill-same:01M6ACGMW980S58X7861TC896N":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":28,"publishedAt":42,"linkOnly":43,"markdownContent":44,"markdownBody":45,"frontMatter":46,"refName":47,"commitSha":48,"skillDirectory":49,"forksCount":50,"repositoryHtmlUrl":51,"repositoryHomepageUrl":52,"ownerHtmlUrl":53,"ownerBlogUrl":54,"ownerDescription":6,"updatedAt":55,"install":56,"resources":69},"01M6ACGMW980S58X7861TC896N","grails-developer",null,"Comprehensive guide for Grails development, covering web applications, REST APIs, GORM, controllers, services, views, plugins, and testing with Spock and Geb","apache\u002Fgrails-core","apache","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F47359?v=4","01M6AC83E6K4FDKK7HZ8WNMQKE","The Apache Software Foundation","01M6ACFVWFRRTGBQBMWZHV6TS9",2942,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgrails-core\u002Fblob\u002F8.0.x\u002Fgrails-skills\u002Fdeveloper\u002Fskills\u002Fgrails-developer\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[29,30,31,32,33,34,35,36,37,38,39,40,41],"grails","grails developer","developer","testing","web","development","plugins","services","REST","applications","guide","with","for","2026-11-10 10:12:30",false,"---\nname: grails-developer\ndescription: Comprehensive guide for Grails development, covering web applications, REST APIs, GORM, controllers, services, views, plugins, and testing with Spock and Geb\nlicense: Apache-2.0\n---\n\u003C!--\nSPDX-License-Identifier: Apache-2.0\n\nLicensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0. \n-->\n\n## What I Do\n\n- Provide detailed guidance for building Grails web applications and REST APIs.\n- Assist with GORM for data modeling, controllers for request handling, services for business logic, and views (GSP, JSON, Markup).\n- Support testing with Spock (unit\u002Fintegration tests) and Geb for browser automation.\n- Guide plugin usage and development, security implementation, and deployment strategies.\n- Help with configuration, internationalization, async programming, and performance optimization.\n\n## When to Use Me\n\nActivate this skill when developing with Grails, including:\n\n- Building CRUD applications, RESTful APIs, or full-stack web applications.\n- Working with GORM domain classes, constraints, and relationships.\n- Creating controllers, services, interceptors, or tag libraries.\n- Writing Spock specifications or Geb functional tests.\n- Configuring plugins, security, caching, or database migrations.\n- Deploying Grails applications to containers or cloud platforms.\n\n## Technology Stack\n\nGrails is built on:\n- **Spring Boot**: 4.1.x\n- **Spring Framework**: 7.0.x\n- **Groovy**: 5.1.x\n- **Gradle**: 9.7 or later\n- **Spock**: 2.4-groovy-5.0\n- **Jakarta EE**: 10 (migrated from javax.*)\n- **Micronaut**: Optional via `grails-micronaut` plugin\n\n## Project Structure\n\n```\nmyapp\u002F\n├── grails-app\u002F\n│   ├── conf\u002F                 # Configuration\n│   │   ├── application.yml   # Main config\n│   │   ├── logback-spring.xml # Logging config\n│   │   └── spring\u002Fresources.groovy # Spring bean definitions\n│   ├── controllers\u002F          # Request handlers\n│   ├── domain\u002F               # GORM domain classes\n│   ├── i18n\u002F                 # Message bundles\n│   ├── init\u002F                 # Bootstrap classes\n│   ├── services\u002F             # Business logic\n│   ├── taglib\u002F               # Custom GSP tags\n│   ├── utils\u002F                # Utility classes\n│   └── views\u002F                # GSP templates\n├── src\u002F\n│   ├── main\u002Fgroovy\u002F          # Additional Groovy classes\n│   ├── main\u002Fjava\u002F            # Java classes\n│   ├── test\u002Fgroovy\u002F          # Test specifications\n│   └── integration-test\u002Fgroovy\u002F # Integration test specifications\n├── build.gradle              # Build configuration\n└── gradle.properties         # Project properties\n```\n\n## Domain Classes (GORM)\n\n### Basic Domain Class\n```groovy\nclass Book {\n    String title\n    String author\n    Date datePublished\n    Integer pages\n\n    static constraints = {\n        title blank: false, maxSize: 255\n        author blank: false\n        datePublished nullable: true\n        pages min: 1, nullable: true\n    }\n\n    static mapping = {\n        table 'books'\n        title column: 'book_title'\n        datePublished type: 'date'\n    }\n}\n```\n\n### Relationships\n```groovy\nclass Author {\n    String name\n\n    static hasMany = [books: Book]\n\n    static mapping = {\n        books cascade: 'all-delete-orphan'\n    }\n}\n\nclass Book {\n    String title\n\n    static belongsTo = [author: Author]\n}\n\n\u002F\u002F Many-to-Many\nclass Book {\n    static hasMany = [categories: Category]\n    static belongsTo = Category\n}\n\nclass Category {\n    String name\n    static hasMany = [books: Book]\n}\n```\n\n### GORM Queries\n```groovy\n\u002F\u002F Dynamic finders\nBook.findByTitle(\"Grails Guide\")\nBook.findAllByAuthorLike(\"%Smith%\")\nBook.findByTitleAndAuthor(\"Guide\", \"Smith\")\nBook.countByPagesGreaterThan(100)\n\n\u002F\u002F Where queries\nBook.where {\n    title =~ \"%Grails%\" && pages > 100\n}.list()\n\n\u002F\u002F Criteria queries\nBook.withCriteria {\n    like('title', '%Grails%')\n    gt('pages', 100)\n    order('datePublished', 'desc')\n    maxResults(10)\n}\n\n\u002F\u002F HQL queries\nBook.executeQuery(\n    \"from Book b where b.author.name = :name\",\n    [name: 'Smith']\n)\n\n\u002F\u002F Detached criteria (reusable)\ndef criteria = Book.where {\n    pages > 100\n}\ncriteria.list()\ncriteria.count()\n```\n\n### Transactions\n```groovy\n\u002F\u002F In services (default transactional)\n@Transactional\nclass BookService {\n    def saveBook(Book book) {\n        book.save(failOnError: true)\n    }\n}\n\n\u002F\u002F Manual transaction control\nBook.withTransaction { status ->\n    def book = new Book(title: \"Test\")\n    book.save()\n    if (someCondition) {\n        status.setRollbackOnly()\n    }\n}\n```\n\n## Controllers\n\n### Basic Controller\n```groovy\nclass BookController {\n\n    BookService bookService\n\n    static allowedMethods = [save: 'POST', update: 'PUT', delete: 'DELETE']\n\n    def index() {\n        respond Book.list(), model: [bookCount: Book.count()]\n    }\n\n    def show(Long id) {\n        respond Book.get(id)\n    }\n\n    def create() {\n        respond new Book(params)\n    }\n\n    def save(Book book) {\n        if (book.hasErrors()) {\n            respond book.errors, view: 'create'\n            return\n        }\n        bookService.save(book)\n        redirect action: 'show', id: book.id\n    }\n\n    def edit(Long id) {\n        respond Book.get(id)\n    }\n\n    def update(Book book) {\n        if (book.hasErrors()) {\n            respond book.errors, view: 'edit'\n            return\n        }\n        bookService.save(book)\n        redirect action: 'show', id: book.id\n    }\n\n    def delete(Long id) {\n        bookService.delete(id)\n        redirect action: 'index'\n    }\n}\n```\n\n### REST Controller\n```groovy\nimport grails.rest.RestfulController\n\nclass BookController extends RestfulController\u003CBook> {\n\n    static responseFormats = ['json', 'xml']\n\n    BookController() {\n        super(Book)\n    }\n\n    \u002F\u002F Override to customize\n    @Override\n    protected Book queryForResource(Serializable id) {\n        Book.where { id == id && active == true }.find()\n    }\n}\n```\n\n### Command Objects\n```groovy\nclass BookCommand implements Validateable {\n    String title\n    String author\n    Integer pages\n\n    static constraints = {\n        title blank: false\n        author blank: false\n        pages min: 1, nullable: true\n    }\n}\n\nclass BookController {\n    def save(BookCommand cmd) {\n        if (cmd.hasErrors()) {\n            respond cmd.errors\n            return\n        }\n        \u002F\u002F Process valid command\n    }\n}\n```\n\n### Content Negotiation\n```groovy\nclass BookController {\n    def show(Long id) {\n        def book = Book.get(id)\n        respond book  \u002F\u002F Auto-negotiates based on Accept header\n    }\n}\n\n\u002F\u002F Or explicit\ndef show(Long id) {\n    def book = Book.get(id)\n    withFormat {\n        html { render view: 'show', model: [book: book] }\n        json { render book as JSON }\n        xml { render book as XML }\n    }\n}\n```\n\n## Services\n\n### Basic Service\n```groovy\nimport grails.gorm.transactions.Transactional\n\n@Transactional\nclass BookService {\n\n    def findByTitle(String title) {\n        Book.findByTitle(title)\n    }\n\n    def save(Book book) {\n        book.save(failOnError: true)\n    }\n\n    @Transactional(readOnly = true)\n    def list(Map params) {\n        Book.list(params)\n    }\n\n    def delete(Long id) {\n        Book.get(id)?.delete()\n    }\n}\n```\n\n### Service with Events\n```groovy\nimport grails.events.annotation.Publisher\nimport grails.events.annotation.Subscriber\n\nclass BookService {\n\n    @Publisher\n    def save(Book book) {\n        book.save()\n        \u002F\u002F Automatically publishes 'book.saved' event\n    }\n}\n\nclass NotificationService {\n\n    @Subscriber('book.saved')\n    def onBookSaved(Book book) {\n        \u002F\u002F Handle event\n        log.info \"Book saved: ${book.title}\"\n    }\n}\n```\n\n### Async Service\n```groovy\nimport grails.async.Promise\nimport static grails.async.Promises.*\n\nclass BookService {\n\n    Promise\u003CBook> findAsync(Long id) {\n        task {\n            Book.get(id)\n        }\n    }\n\n    def processBooks() {\n        def p1 = task { Book.findAllByActive(true) }\n        def p2 = task { Author.list() }\n\n        waitAll(p1, p2)\n        \u002F\u002F Both complete\n    }\n}\n```\n\n## Views\n\n### GSP (Groovy Server Pages)\n```html\n\u003C!-- grails-app\u002Fviews\u002Fbook\u002Flist.gsp -->\n\u003C!DOCTYPE html>\n\u003Chtml>\n\u003Chead>\n    \u003Ctitle>Books\u003C\u002Ftitle>\n    \u003Casset:stylesheet src=\"application.css\"\u002F>\n\u003C\u002Fhead>\n\u003Cbody>\n    \u003Ch1>Books (${bookCount})\u003C\u002Fh1>\n\n    \u003Cg:each in=\"${bookList}\" var=\"book\">\n        \u003Cdiv class=\"book\">\n            \u003Ch2>${book.title}\u003C\u002Fh2>\n            \u003Cp>By ${book.author}\u003C\u002Fp>\n            \u003Cg:link action=\"show\" id=\"${book.id}\">View\u003C\u002Fg:link>\n        \u003C\u002Fdiv>\n    \u003C\u002Fg:each>\n\n    \u003Cg:if test=\"${bookList.empty}\">\n        \u003Cp>No books found.\u003C\u002Fp>\n    \u003C\u002Fg:if>\n\n    \u003Cg:paginate total=\"${bookCount}\"\u002F>\n\n    \u003Casset:javascript src=\"application.js\"\u002F>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n### Common GSP Tags\n```html\n\u003C!-- Links -->\n\u003Cg:link controller=\"book\" action=\"show\" id=\"${book.id}\">View\u003C\u002Fg:link>\n\u003Cg:createLink action=\"list\"\u002F>\n\n\u003C!-- Forms -->\n\u003Cg:form action=\"save\">\n    \u003Cg:textField name=\"title\" value=\"${book?.title}\"\u002F>\n    \u003Cg:textArea name=\"description\" value=\"${book?.description}\"\u002F>\n    \u003Cg:select name=\"category\" from=\"${categories}\" optionKey=\"id\" optionValue=\"name\"\u002F>\n    \u003Cg:checkBox name=\"active\" value=\"${book?.active}\"\u002F>\n    \u003Cg:submitButton name=\"submit\" value=\"Save\"\u002F>\n\u003C\u002Fg:form>\n\n\u003C!-- Conditionals -->\n\u003Cg:if test=\"${condition}\">...\u003C\u002Fg:if>\n\u003Cg:elseif test=\"${other}\">...\u003C\u002Fg:elseif>\n\u003Cg:else>...\u003C\u002Fg:else>\n\n\u003C!-- Iteration -->\n\u003Cg:each in=\"${items}\" var=\"item\" status=\"i\">\n    ${i}: ${item.name}\n\u003C\u002Fg:each>\n\n\u003C!-- Rendering -->\n\u003Cg:render template=\"bookRow\" model=\"[book: book]\"\u002F>\n\u003Cg:render template=\"bookRow\" collection=\"${books}\" var=\"book\"\u002F>\n\n\u003C!-- Security (with Spring Security plugin) -->\n\u003Csec:ifLoggedIn>Welcome, ${sec.username()}\u003C\u002Fsec:ifLoggedIn>\n\u003Csec:ifNotLoggedIn>\u003Cg:link controller=\"login\">Login\u003C\u002Fg:link>\u003C\u002Fsec:ifNotLoggedIn>\n```\n\n### JSON Views\n```groovy\n\u002F\u002F grails-app\u002Fviews\u002Fbook\u002Fshow.gson\nimport myapp.Book\n\nmodel {\n    Book book\n}\n\njson {\n    id book.id\n    title book.title\n    author book.author\n    datePublished book.datePublished?.format('yyyy-MM-dd')\n    _links {\n        self {\n            href \"\u002Fbooks\u002F${book.id}\"\n        }\n    }\n}\n```\n\n### Layouts\n```html\n\u003C!-- grails-app\u002Fviews\u002Flayouts\u002Fmain.gsp -->\n\u003C!DOCTYPE html>\n\u003Chtml>\n\u003Chead>\n    \u003Ctitle>\u003Cg:layoutTitle default=\"My App\"\u002F>\u003C\u002Ftitle>\n    \u003Casset:stylesheet src=\"application.css\"\u002F>\n    \u003Cg:layoutHead\u002F>\n\u003C\u002Fhead>\n\u003Cbody>\n    \u003Cnav>\u003C!-- Navigation -->\u003C\u002Fnav>\n    \u003Cmain>\n        \u003Cg:layoutBody\u002F>\n    \u003C\u002Fmain>\n    \u003Cfooter>\u003C!-- Footer -->\u003C\u002Ffooter>\n    \u003Casset:javascript src=\"application.js\"\u002F>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n\n\u003C!-- Use in views -->\n\u003Chtml>\n\u003Chead>\n    \u003Cmeta name=\"layout\" content=\"main\"\u002F>\n    \u003Ctitle>Books\u003C\u002Ftitle>\n\u003C\u002Fhead>\n\u003Cbody>\n    \u003C!-- Page content -->\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n## Interceptors\n\n```groovy\nclass AuthInterceptor {\n\n    AuthInterceptor() {\n        matchAll()\n            .excludes(controller: 'login')\n            .excludes(controller: 'error')\n    }\n\n    boolean before() {\n        if (!session.user) {\n            redirect(controller: 'login')\n            return false\n        }\n        true\n    }\n\n    boolean after() {\n        \u002F\u002F After action executes\n        true\n    }\n\n    void afterView() {\n        \u002F\u002F After view renders\n    }\n}\n```\n\n## Tag Libraries\n\n```groovy\nclass BookTagLib {\n\n    static namespace = 'book'\n    static defaultEncodeAs = [taglib: 'html']\n\n    def formatTitle = { attrs, body ->\n        def title = attrs.title ?: body()\n        out \u003C\u003C \"\u003Cspan class='book-title'>${title}\u003C\u002Fspan>\"\n    }\n\n    def ifHasBooks = { attrs, body ->\n        if (Book.count() > 0) {\n            out \u003C\u003C body()\n        }\n    }\n}\n\n\u002F\u002F Usage in GSP\n\u003Cbook:formatTitle title=\"${book.title}\"\u002F>\n\u003Cbook:ifHasBooks>\n    \u003Cp>We have books!\u003C\u002Fp>\n\u003C\u002Fbook:ifHasBooks>\n```\n\n## Configuration\n\n### application.yml\n```yaml\ngrails:\n    profile: web\n    codegen:\n        defaultPackage: myapp\n    gorm:\n        reactor:\n            events: false\n    mime:\n        types:\n            json: ['application\u002Fjson', 'text\u002Fjson']\n            xml: ['text\u002Fxml', 'application\u002Fxml']\n\nenvironments:\n    development:\n        dataSource:\n            dbCreate: create-drop\n            url: jdbc:h2:mem:devDb\n    test:\n        dataSource:\n            dbCreate: update\n            url: jdbc:h2:mem:testDb\n    production:\n        dataSource:\n            dbCreate: none\n            url: jdbc:postgresql:\u002F\u002Flocalhost\u002Fmyapp\n            driverClassName: org.postgresql.Driver\n            dialect: org.hibernate.dialect.PostgreSQLDialect\n            properties:\n                jmxEnabled: true\n                initialSize: 5\n                maxActive: 50\n\nserver:\n    port: 8080\n    servlet:\n        context-path: \u002Fmyapp\n```\n\n### URL Mappings\n```groovy\n\u002F\u002F grails-app\u002Fcontrollers\u002Fmyapp\u002FUrlMappings.groovy\nclass UrlMappings {\n\n    static mappings = {\n        \u002F\u002F Default\n        \"\u002F$controller\u002F$action?\u002F$id?(.$format)?\" {\n            constraints {\n                \u002F\u002F apply constraints here\n            }\n        }\n\n        \u002F\u002F REST resources\n        \"\u002Fapi\u002Fbooks\"(resources: 'book')\n\n        \u002F\u002F Custom mappings\n        \"\u002Fbooks\u002F$id\"(controller: 'book', action: 'show')\n        \"\u002Fsearch\"(controller: 'book', action: 'search')\n\n        \u002F\u002F Named URL mappings\n        name bookShow: \"\u002Fbooks\u002F$id\" {\n            controller = 'book'\n            action = 'show'\n        }\n\n        \u002F\u002F Error pages\n        \"500\"(view: '\u002Ferror')\n        \"404\"(view: '\u002FnotFound')\n    }\n}\n```\n\n## Testing with Spock\n\n### Unit Test - Controller\n```groovy\nimport grails.testing.web.controllers.ControllerUnitTest\nimport spock.lang.Specification\n\nclass BookControllerSpec extends Specification\n        implements ControllerUnitTest\u003CBookController> {\n\n    def setup() {\n        controller.bookService = Mock(BookService)\n    }\n\n    void \"index returns list of books\"() {\n        given:\n        def books = [new Book(title: \"Test\")]\n        controller.bookService.list(_) >> books\n\n        when:\n        controller.index()\n\n        then:\n        model.bookList == books\n        view == '\u002Fbook\u002Findex'\n    }\n\n    void \"show returns 404 for missing book\"() {\n        when:\n        controller.show(999)\n\n        then:\n        response.status == 404\n    }\n}\n```\n\n### Unit Test - Service\n```groovy\nimport grails.testing.services.ServiceUnitTest\nimport spock.lang.Specification\n\nclass BookServiceSpec extends Specification\n        implements ServiceUnitTest\u003CBookService> {\n\n    void \"save persists book\"() {\n        given:\n        def book = new Book(title: \"Test\", author: \"Author\")\n\n        when:\n        def result = service.save(book)\n\n        then:\n        result.id != null\n        Book.count() == 1\n    }\n}\n```\n\n### Unit Test - Domain\n```groovy\nimport grails.testing.gorm.DomainUnitTest\nimport spock.lang.Specification\n\nclass BookSpec extends Specification\n        implements DomainUnitTest\u003CBook> {\n\n    void \"title cannot be blank\"() {\n        when:\n        domain.title = \"\"\n        domain.author = \"Test\"\n\n        then:\n        !domain.validate(['title'])\n        domain.errors['title'].code == 'blank'\n    }\n\n    void \"valid book passes validation\"() {\n        when:\n        domain.title = \"Valid Title\"\n        domain.author = \"Author\"\n\n        then:\n        domain.validate()\n    }\n}\n```\n\n### Integration Test\n```groovy\nimport grails.testing.mixin.integration.Integration\nimport grails.gorm.transactions.Rollback\nimport spock.lang.Specification\n\n@Integration\n@Rollback\nclass BookServiceIntegrationSpec extends Specification {\n\n    BookService bookService\n\n    void \"save and retrieve book\"() {\n        given:\n        def book = new Book(title: \"Integration Test\", author: \"Tester\")\n\n        when:\n        bookService.save(book)\n        def found = Book.findByTitle(\"Integration Test\")\n\n        then:\n        found != null\n        found.author == \"Tester\"\n    }\n}\n```\n\n### Functional Test with Geb\n```groovy\nimport geb.spock.ContainerGebSpec\nimport grails.testing.mixin.integration.Integration\n\n@Integration\nclass BookFunctionalSpec extends ContainerGebSpec {\n\n    void \"can view book list\"() {\n        when:\n        go '\u002Fbook\u002Findex'\n\n        then:\n        title == 'Book List'\n        $('h1').text() == 'Books'\n    }\n\n    void \"can create new book\"() {\n        when:\n        go '\u002Fbook\u002Fcreate'\n        $('form').title = 'New Book'\n        $('form').author = 'Test Author'\n        $('input[type=submit]').click()\n\n        then:\n        $('h1').text().contains('New Book')\n    }\n}\n```\n\n## Plugins\n\n### Common Plugins\n```groovy\n\u002F\u002F build.gradle\n\n\u002F\u002F Spring Security\nimplementation 'org.apache.grails.plugins:grails-spring-security-core:7.0.1'\n\n\u002F\u002F Database Migration (Liquibase)\nimplementation 'org.apache.grails.plugins:grails-database-migration:5.0.1'\n\n\u002F\u002F Caching\nimplementation 'org.apache.grails.plugins:grails-cache:7.0.0'\n\n\u002F\u002F Async support\nimplementation 'org.apache.grails.plugins:grails-async:7.0.0'\n\n\u002F\u002F Fields plugin for form rendering\nimplementation 'org.apache.grails.plugins:grails-fields:7.0.0'\n\n\u002F\u002F Asset Pipeline\nruntimeOnly 'cloud.wondrify:asset-pipeline-grails'\n```\n\n### Spring Security Configuration\n```groovy\n\u002F\u002F grails-app\u002Fconf\u002Fapplication.groovy\ngrails.plugin.springsecurity.userLookup.userDomainClassName = 'myapp.User'\ngrails.plugin.springsecurity.userLookup.authorityJoinClassName = 'myapp.UserRole'\ngrails.plugin.springsecurity.authority.className = 'myapp.Role'\n\ngrails.plugin.springsecurity.controllerAnnotations.staticRules = [\n    [pattern: '\u002F',               access: ['permitAll']],\n    [pattern: '\u002Ferror',          access: ['permitAll']],\n    [pattern: '\u002Findex',          access: ['permitAll']],\n    [pattern: '\u002Fadmin\u002F**',       access: ['ROLE_ADMIN']],\n    [pattern: '\u002Fapi\u002F**',         access: ['isAuthenticated()']],\n]\n```\n\n## Build Commands\n\n```bash\n# Run application\n.\u002Fgradlew bootRun\n\n# Run tests\n.\u002Fgradlew test                                    # All tests\n.\u002Fgradlew test --tests \"BookServiceSpec\"          # Single spec\n.\u002Fgradlew test --tests \"*Spec.save*\"              # Pattern match\n.\u002Fgradlew integrationTest                         # Integration tests\n\n# Build\n.\u002Fgradlew build                                   # Build with tests\n.\u002Fgradlew bootJar                                 # Executable JAR\n.\u002Fgradlew bootWar                                 # WAR file\n\n# Code quality\n.\u002Fgradlew check                                   # Run all verification tasks\n\n# Clean\n.\u002Fgradlew clean\n```\n\n## Best Practices\n\n### Convention Over Configuration\n- Follow Grails naming conventions for automatic wiring.\n- Use standard directory structure.\n- Let Grails infer configurations where possible.\n\n### Performance\n- Use `@GrailsCompileStatic` on controllers, services, and domain classes.\n- Enable query caching for read-heavy operations.\n- Use pagination for large result sets.\n- Avoid N+1 queries with eager fetching or batch size.\n\n### Security\n- Use CSRF tokens in forms: `\u003Cg:form useToken=\"true\">`.\n- Apply Spring Security for authentication\u002Fauthorization.\n- Use parameterized queries (GORM handles this automatically).\n- Encode output to prevent XSS.\n\n### Testing\n- Write unit tests for domain constraints.\n- Test controllers with `ControllerUnitTest`.\n- Use integration tests for service\u002Fdatabase interactions.\n- Use Geb for critical user workflows.\n\n### Code Style\n- Use `@GrailsCompileStatic` or `@CompileStatic` for type safety and performance.\n- Prefer services for business logic over controllers.\n- Use command objects for complex form handling.\n- Keep controllers thin, services fat.\n\n## Resources\n\n- **Grails User Guide**: https:\u002F\u002Fgrails.apache.org\u002Fdocs\u002Flatest\u002Fguide\u002Fsingle.html\n- **GORM Documentation**: https:\u002F\u002Fgrails.apache.org\u002Fdocs\u002Flatest\u002Fgrails-data\u002F\n- **Grails Plugins**: https:\u002F\u002Fgrails.apache.org\u002Fplugins.html\n- **Groovy 5 Documentation**: https:\u002F\u002Fgroovy-lang.org\u002Fdocumentation.html#all-versions (select latest 5.1.x)\n- **Spock Framework**: https:\u002F\u002Fspockframework.org\u002Fspock\u002Fdocs\u002F2.4\u002Fall_in_one.html\n- **Geb Manual**: https:\u002F\u002Fgroovy.apache.org\u002Fgeb\u002Fmanual\u002Fcurrent\u002F\n","\u003C!--\nSPDX-License-Identifier: Apache-2.0\n\nLicensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0. \n-->\n\n## What I Do\n\n- Provide detailed guidance for building Grails web applications and REST APIs.\n- Assist with GORM for data modeling, controllers for request handling, services for business logic, and views (GSP, JSON, Markup).\n- Support testing with Spock (unit\u002Fintegration tests) and Geb for browser automation.\n- Guide plugin usage and development, security implementation, and deployment strategies.\n- Help with configuration, internationalization, async programming, and performance optimization.\n\n## When to Use Me\n\nActivate this skill when developing with Grails, including:\n\n- Building CRUD applications, RESTful APIs, or full-stack web applications.\n- Working with GORM domain classes, constraints, and relationships.\n- Creating controllers, services, interceptors, or tag libraries.\n- Writing Spock specifications or Geb functional tests.\n- Configuring plugins, security, caching, or database migrations.\n- Deploying Grails applications to containers or cloud platforms.\n\n## Technology Stack\n\nGrails is built on:\n- **Spring Boot**: 4.1.x\n- **Spring Framework**: 7.0.x\n- **Groovy**: 5.1.x\n- **Gradle**: 9.7 or later\n- **Spock**: 2.4-groovy-5.0\n- **Jakarta EE**: 10 (migrated from javax.*)\n- **Micronaut**: Optional via `grails-micronaut` plugin\n\n## Project Structure\n\n```\nmyapp\u002F\n├── grails-app\u002F\n│   ├── conf\u002F                 # Configuration\n│   │   ├── application.yml   # Main config\n│   │   ├── logback-spring.xml # Logging config\n│   │   └── spring\u002Fresources.groovy # Spring bean definitions\n│   ├── controllers\u002F          # Request handlers\n│   ├── domain\u002F               # GORM domain classes\n│   ├── i18n\u002F                 # Message bundles\n│   ├── init\u002F                 # Bootstrap classes\n│   ├── services\u002F             # Business logic\n│   ├── taglib\u002F               # Custom GSP tags\n│   ├── utils\u002F                # Utility classes\n│   └── views\u002F                # GSP templates\n├── src\u002F\n│   ├── main\u002Fgroovy\u002F          # Additional Groovy classes\n│   ├── main\u002Fjava\u002F            # Java classes\n│   ├── test\u002Fgroovy\u002F          # Test specifications\n│   └── integration-test\u002Fgroovy\u002F # Integration test specifications\n├── build.gradle              # Build configuration\n└── gradle.properties         # Project properties\n```\n\n## Domain Classes (GORM)\n\n### Basic Domain Class\n```groovy\nclass Book {\n    String title\n    String author\n    Date datePublished\n    Integer pages\n\n    static constraints = {\n        title blank: false, maxSize: 255\n        author blank: false\n        datePublished nullable: true\n        pages min: 1, nullable: true\n    }\n\n    static mapping = {\n        table 'books'\n        title column: 'book_title'\n        datePublished type: 'date'\n    }\n}\n```\n\n### Relationships\n```groovy\nclass Author {\n    String name\n\n    static hasMany = [books: Book]\n\n    static mapping = {\n        books cascade: 'all-delete-orphan'\n    }\n}\n\nclass Book {\n    String title\n\n    static belongsTo = [author: Author]\n}\n\n\u002F\u002F Many-to-Many\nclass Book {\n    static hasMany = [categories: Category]\n    static belongsTo = Category\n}\n\nclass Category {\n    String name\n    static hasMany = [books: Book]\n}\n```\n\n### GORM Queries\n```groovy\n\u002F\u002F Dynamic finders\nBook.findByTitle(\"Grails Guide\")\nBook.findAllByAuthorLike(\"%Smith%\")\nBook.findByTitleAndAuthor(\"Guide\", \"Smith\")\nBook.countByPagesGreaterThan(100)\n\n\u002F\u002F Where queries\nBook.where {\n    title =~ \"%Grails%\" && pages > 100\n}.list()\n\n\u002F\u002F Criteria queries\nBook.withCriteria {\n    like('title', '%Grails%')\n    gt('pages', 100)\n    order('datePublished', 'desc')\n    maxResults(10)\n}\n\n\u002F\u002F HQL queries\nBook.executeQuery(\n    \"from Book b where b.author.name = :name\",\n    [name: 'Smith']\n)\n\n\u002F\u002F Detached criteria (reusable)\ndef criteria = Book.where {\n    pages > 100\n}\ncriteria.list()\ncriteria.count()\n```\n\n### Transactions\n```groovy\n\u002F\u002F In services (default transactional)\n@Transactional\nclass BookService {\n    def saveBook(Book book) {\n        book.save(failOnError: true)\n    }\n}\n\n\u002F\u002F Manual transaction control\nBook.withTransaction { status ->\n    def book = new Book(title: \"Test\")\n    book.save()\n    if (someCondition) {\n        status.setRollbackOnly()\n    }\n}\n```\n\n## Controllers\n\n### Basic Controller\n```groovy\nclass BookController {\n\n    BookService bookService\n\n    static allowedMethods = [save: 'POST', update: 'PUT', delete: 'DELETE']\n\n    def index() {\n        respond Book.list(), model: [bookCount: Book.count()]\n    }\n\n    def show(Long id) {\n        respond Book.get(id)\n    }\n\n    def create() {\n        respond new Book(params)\n    }\n\n    def save(Book book) {\n        if (book.hasErrors()) {\n            respond book.errors, view: 'create'\n            return\n        }\n        bookService.save(book)\n        redirect action: 'show', id: book.id\n    }\n\n    def edit(Long id) {\n        respond Book.get(id)\n    }\n\n    def update(Book book) {\n        if (book.hasErrors()) {\n            respond book.errors, view: 'edit'\n            return\n        }\n        bookService.save(book)\n        redirect action: 'show', id: book.id\n    }\n\n    def delete(Long id) {\n        bookService.delete(id)\n        redirect action: 'index'\n    }\n}\n```\n\n### REST Controller\n```groovy\nimport grails.rest.RestfulController\n\nclass BookController extends RestfulController\u003CBook> {\n\n    static responseFormats = ['json', 'xml']\n\n    BookController() {\n        super(Book)\n    }\n\n    \u002F\u002F Override to customize\n    @Override\n    protected Book queryForResource(Serializable id) {\n        Book.where { id == id && active == true }.find()\n    }\n}\n```\n\n### Command Objects\n```groovy\nclass BookCommand implements Validateable {\n    String title\n    String author\n    Integer pages\n\n    static constraints = {\n        title blank: false\n        author blank: false\n        pages min: 1, nullable: true\n    }\n}\n\nclass BookController {\n    def save(BookCommand cmd) {\n        if (cmd.hasErrors()) {\n            respond cmd.errors\n            return\n        }\n        \u002F\u002F Process valid command\n    }\n}\n```\n\n### Content Negotiation\n```groovy\nclass BookController {\n    def show(Long id) {\n        def book = Book.get(id)\n        respond book  \u002F\u002F Auto-negotiates based on Accept header\n    }\n}\n\n\u002F\u002F Or explicit\ndef show(Long id) {\n    def book = Book.get(id)\n    withFormat {\n        html { render view: 'show', model: [book: book] }\n        json { render book as JSON }\n        xml { render book as XML }\n    }\n}\n```\n\n## Services\n\n### Basic Service\n```groovy\nimport grails.gorm.transactions.Transactional\n\n@Transactional\nclass BookService {\n\n    def findByTitle(String title) {\n        Book.findByTitle(title)\n    }\n\n    def save(Book book) {\n        book.save(failOnError: true)\n    }\n\n    @Transactional(readOnly = true)\n    def list(Map params) {\n        Book.list(params)\n    }\n\n    def delete(Long id) {\n        Book.get(id)?.delete()\n    }\n}\n```\n\n### Service with Events\n```groovy\nimport grails.events.annotation.Publisher\nimport grails.events.annotation.Subscriber\n\nclass BookService {\n\n    @Publisher\n    def save(Book book) {\n        book.save()\n        \u002F\u002F Automatically publishes 'book.saved' event\n    }\n}\n\nclass NotificationService {\n\n    @Subscriber('book.saved')\n    def onBookSaved(Book book) {\n        \u002F\u002F Handle event\n        log.info \"Book saved: ${book.title}\"\n    }\n}\n```\n\n### Async Service\n```groovy\nimport grails.async.Promise\nimport static grails.async.Promises.*\n\nclass BookService {\n\n    Promise\u003CBook> findAsync(Long id) {\n        task {\n            Book.get(id)\n        }\n    }\n\n    def processBooks() {\n        def p1 = task { Book.findAllByActive(true) }\n        def p2 = task { Author.list() }\n\n        waitAll(p1, p2)\n        \u002F\u002F Both complete\n    }\n}\n```\n\n## Views\n\n### GSP (Groovy Server Pages)\n```html\n\u003C!-- grails-app\u002Fviews\u002Fbook\u002Flist.gsp -->\n\u003C!DOCTYPE html>\n\u003Chtml>\n\u003Chead>\n    \u003Ctitle>Books\u003C\u002Ftitle>\n    \u003Casset:stylesheet src=\"application.css\"\u002F>\n\u003C\u002Fhead>\n\u003Cbody>\n    \u003Ch1>Books (${bookCount})\u003C\u002Fh1>\n\n    \u003Cg:each in=\"${bookList}\" var=\"book\">\n        \u003Cdiv class=\"book\">\n            \u003Ch2>${book.title}\u003C\u002Fh2>\n            \u003Cp>By ${book.author}\u003C\u002Fp>\n            \u003Cg:link action=\"show\" id=\"${book.id}\">View\u003C\u002Fg:link>\n        \u003C\u002Fdiv>\n    \u003C\u002Fg:each>\n\n    \u003Cg:if test=\"${bookList.empty}\">\n        \u003Cp>No books found.\u003C\u002Fp>\n    \u003C\u002Fg:if>\n\n    \u003Cg:paginate total=\"${bookCount}\"\u002F>\n\n    \u003Casset:javascript src=\"application.js\"\u002F>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n### Common GSP Tags\n```html\n\u003C!-- Links -->\n\u003Cg:link controller=\"book\" action=\"show\" id=\"${book.id}\">View\u003C\u002Fg:link>\n\u003Cg:createLink action=\"list\"\u002F>\n\n\u003C!-- Forms -->\n\u003Cg:form action=\"save\">\n    \u003Cg:textField name=\"title\" value=\"${book?.title}\"\u002F>\n    \u003Cg:textArea name=\"description\" value=\"${book?.description}\"\u002F>\n    \u003Cg:select name=\"category\" from=\"${categories}\" optionKey=\"id\" optionValue=\"name\"\u002F>\n    \u003Cg:checkBox name=\"active\" value=\"${book?.active}\"\u002F>\n    \u003Cg:submitButton name=\"submit\" value=\"Save\"\u002F>\n\u003C\u002Fg:form>\n\n\u003C!-- Conditionals -->\n\u003Cg:if test=\"${condition}\">...\u003C\u002Fg:if>\n\u003Cg:elseif test=\"${other}\">...\u003C\u002Fg:elseif>\n\u003Cg:else>...\u003C\u002Fg:else>\n\n\u003C!-- Iteration -->\n\u003Cg:each in=\"${items}\" var=\"item\" status=\"i\">\n    ${i}: ${item.name}\n\u003C\u002Fg:each>\n\n\u003C!-- Rendering -->\n\u003Cg:render template=\"bookRow\" model=\"[book: book]\"\u002F>\n\u003Cg:render template=\"bookRow\" collection=\"${books}\" var=\"book\"\u002F>\n\n\u003C!-- Security (with Spring Security plugin) -->\n\u003Csec:ifLoggedIn>Welcome, ${sec.username()}\u003C\u002Fsec:ifLoggedIn>\n\u003Csec:ifNotLoggedIn>\u003Cg:link controller=\"login\">Login\u003C\u002Fg:link>\u003C\u002Fsec:ifNotLoggedIn>\n```\n\n### JSON Views\n```groovy\n\u002F\u002F grails-app\u002Fviews\u002Fbook\u002Fshow.gson\nimport myapp.Book\n\nmodel {\n    Book book\n}\n\njson {\n    id book.id\n    title book.title\n    author book.author\n    datePublished book.datePublished?.format('yyyy-MM-dd')\n    _links {\n        self {\n            href \"\u002Fbooks\u002F${book.id}\"\n        }\n    }\n}\n```\n\n### Layouts\n```html\n\u003C!-- grails-app\u002Fviews\u002Flayouts\u002Fmain.gsp -->\n\u003C!DOCTYPE html>\n\u003Chtml>\n\u003Chead>\n    \u003Ctitle>\u003Cg:layoutTitle default=\"My App\"\u002F>\u003C\u002Ftitle>\n    \u003Casset:stylesheet src=\"application.css\"\u002F>\n    \u003Cg:layoutHead\u002F>\n\u003C\u002Fhead>\n\u003Cbody>\n    \u003Cnav>\u003C!-- Navigation -->\u003C\u002Fnav>\n    \u003Cmain>\n        \u003Cg:layoutBody\u002F>\n    \u003C\u002Fmain>\n    \u003Cfooter>\u003C!-- Footer -->\u003C\u002Ffooter>\n    \u003Casset:javascript src=\"application.js\"\u002F>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n\n\u003C!-- Use in views -->\n\u003Chtml>\n\u003Chead>\n    \u003Cmeta name=\"layout\" content=\"main\"\u002F>\n    \u003Ctitle>Books\u003C\u002Ftitle>\n\u003C\u002Fhead>\n\u003Cbody>\n    \u003C!-- Page content -->\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n## Interceptors\n\n```groovy\nclass AuthInterceptor {\n\n    AuthInterceptor() {\n        matchAll()\n            .excludes(controller: 'login')\n            .excludes(controller: 'error')\n    }\n\n    boolean before() {\n        if (!session.user) {\n            redirect(controller: 'login')\n            return false\n        }\n        true\n    }\n\n    boolean after() {\n        \u002F\u002F After action executes\n        true\n    }\n\n    void afterView() {\n        \u002F\u002F After view renders\n    }\n}\n```\n\n## Tag Libraries\n\n```groovy\nclass BookTagLib {\n\n    static namespace = 'book'\n    static defaultEncodeAs = [taglib: 'html']\n\n    def formatTitle = { attrs, body ->\n        def title = attrs.title ?: body()\n        out \u003C\u003C \"\u003Cspan class='book-title'>${title}\u003C\u002Fspan>\"\n    }\n\n    def ifHasBooks = { attrs, body ->\n        if (Book.count() > 0) {\n            out \u003C\u003C body()\n        }\n    }\n}\n\n\u002F\u002F Usage in GSP\n\u003Cbook:formatTitle title=\"${book.title}\"\u002F>\n\u003Cbook:ifHasBooks>\n    \u003Cp>We have books!\u003C\u002Fp>\n\u003C\u002Fbook:ifHasBooks>\n```\n\n## Configuration\n\n### application.yml\n```yaml\ngrails:\n    profile: web\n    codegen:\n        defaultPackage: myapp\n    gorm:\n        reactor:\n            events: false\n    mime:\n        types:\n            json: ['application\u002Fjson', 'text\u002Fjson']\n            xml: ['text\u002Fxml', 'application\u002Fxml']\n\nenvironments:\n    development:\n        dataSource:\n            dbCreate: create-drop\n            url: jdbc:h2:mem:devDb\n    test:\n        dataSource:\n            dbCreate: update\n            url: jdbc:h2:mem:testDb\n    production:\n        dataSource:\n            dbCreate: none\n            url: jdbc:postgresql:\u002F\u002Flocalhost\u002Fmyapp\n            driverClassName: org.postgresql.Driver\n            dialect: org.hibernate.dialect.PostgreSQLDialect\n            properties:\n                jmxEnabled: true\n                initialSize: 5\n                maxActive: 50\n\nserver:\n    port: 8080\n    servlet:\n        context-path: \u002Fmyapp\n```\n\n### URL Mappings\n```groovy\n\u002F\u002F grails-app\u002Fcontrollers\u002Fmyapp\u002FUrlMappings.groovy\nclass UrlMappings {\n\n    static mappings = {\n        \u002F\u002F Default\n        \"\u002F$controller\u002F$action?\u002F$id?(.$format)?\" {\n            constraints {\n                \u002F\u002F apply constraints here\n            }\n        }\n\n        \u002F\u002F REST resources\n        \"\u002Fapi\u002Fbooks\"(resources: 'book')\n\n        \u002F\u002F Custom mappings\n        \"\u002Fbooks\u002F$id\"(controller: 'book', action: 'show')\n        \"\u002Fsearch\"(controller: 'book', action: 'search')\n\n        \u002F\u002F Named URL mappings\n        name bookShow: \"\u002Fbooks\u002F$id\" {\n            controller = 'book'\n            action = 'show'\n        }\n\n        \u002F\u002F Error pages\n        \"500\"(view: '\u002Ferror')\n        \"404\"(view: '\u002FnotFound')\n    }\n}\n```\n\n## Testing with Spock\n\n### Unit Test - Controller\n```groovy\nimport grails.testing.web.controllers.ControllerUnitTest\nimport spock.lang.Specification\n\nclass BookControllerSpec extends Specification\n        implements ControllerUnitTest\u003CBookController> {\n\n    def setup() {\n        controller.bookService = Mock(BookService)\n    }\n\n    void \"index returns list of books\"() {\n        given:\n        def books = [new Book(title: \"Test\")]\n        controller.bookService.list(_) >> books\n\n        when:\n        controller.index()\n\n        then:\n        model.bookList == books\n        view == '\u002Fbook\u002Findex'\n    }\n\n    void \"show returns 404 for missing book\"() {\n        when:\n        controller.show(999)\n\n        then:\n        response.status == 404\n    }\n}\n```\n\n### Unit Test - Service\n```groovy\nimport grails.testing.services.ServiceUnitTest\nimport spock.lang.Specification\n\nclass BookServiceSpec extends Specification\n        implements ServiceUnitTest\u003CBookService> {\n\n    void \"save persists book\"() {\n        given:\n        def book = new Book(title: \"Test\", author: \"Author\")\n\n        when:\n        def result = service.save(book)\n\n        then:\n        result.id != null\n        Book.count() == 1\n    }\n}\n```\n\n### Unit Test - Domain\n```groovy\nimport grails.testing.gorm.DomainUnitTest\nimport spock.lang.Specification\n\nclass BookSpec extends Specification\n        implements DomainUnitTest\u003CBook> {\n\n    void \"title cannot be blank\"() {\n        when:\n        domain.title = \"\"\n        domain.author = \"Test\"\n\n        then:\n        !domain.validate(['title'])\n        domain.errors['title'].code == 'blank'\n    }\n\n    void \"valid book passes validation\"() {\n        when:\n        domain.title = \"Valid Title\"\n        domain.author = \"Author\"\n\n        then:\n        domain.validate()\n    }\n}\n```\n\n### Integration Test\n```groovy\nimport grails.testing.mixin.integration.Integration\nimport grails.gorm.transactions.Rollback\nimport spock.lang.Specification\n\n@Integration\n@Rollback\nclass BookServiceIntegrationSpec extends Specification {\n\n    BookService bookService\n\n    void \"save and retrieve book\"() {\n        given:\n        def book = new Book(title: \"Integration Test\", author: \"Tester\")\n\n        when:\n        bookService.save(book)\n        def found = Book.findByTitle(\"Integration Test\")\n\n        then:\n        found != null\n        found.author == \"Tester\"\n    }\n}\n```\n\n### Functional Test with Geb\n```groovy\nimport geb.spock.ContainerGebSpec\nimport grails.testing.mixin.integration.Integration\n\n@Integration\nclass BookFunctionalSpec extends ContainerGebSpec {\n\n    void \"can view book list\"() {\n        when:\n        go '\u002Fbook\u002Findex'\n\n        then:\n        title == 'Book List'\n        $('h1').text() == 'Books'\n    }\n\n    void \"can create new book\"() {\n        when:\n        go '\u002Fbook\u002Fcreate'\n        $('form').title = 'New Book'\n        $('form').author = 'Test Author'\n        $('input[type=submit]').click()\n\n        then:\n        $('h1').text().contains('New Book')\n    }\n}\n```\n\n## Plugins\n\n### Common Plugins\n```groovy\n\u002F\u002F build.gradle\n\n\u002F\u002F Spring Security\nimplementation 'org.apache.grails.plugins:grails-spring-security-core:7.0.1'\n\n\u002F\u002F Database Migration (Liquibase)\nimplementation 'org.apache.grails.plugins:grails-database-migration:5.0.1'\n\n\u002F\u002F Caching\nimplementation 'org.apache.grails.plugins:grails-cache:7.0.0'\n\n\u002F\u002F Async support\nimplementation 'org.apache.grails.plugins:grails-async:7.0.0'\n\n\u002F\u002F Fields plugin for form rendering\nimplementation 'org.apache.grails.plugins:grails-fields:7.0.0'\n\n\u002F\u002F Asset Pipeline\nruntimeOnly 'cloud.wondrify:asset-pipeline-grails'\n```\n\n### Spring Security Configuration\n```groovy\n\u002F\u002F grails-app\u002Fconf\u002Fapplication.groovy\ngrails.plugin.springsecurity.userLookup.userDomainClassName = 'myapp.User'\ngrails.plugin.springsecurity.userLookup.authorityJoinClassName = 'myapp.UserRole'\ngrails.plugin.springsecurity.authority.className = 'myapp.Role'\n\ngrails.plugin.springsecurity.controllerAnnotations.staticRules = [\n    [pattern: '\u002F',               access: ['permitAll']],\n    [pattern: '\u002Ferror',          access: ['permitAll']],\n    [pattern: '\u002Findex',          access: ['permitAll']],\n    [pattern: '\u002Fadmin\u002F**',       access: ['ROLE_ADMIN']],\n    [pattern: '\u002Fapi\u002F**',         access: ['isAuthenticated()']],\n]\n```\n\n## Build Commands\n\n```bash\n# Run application\n.\u002Fgradlew bootRun\n\n# Run tests\n.\u002Fgradlew test                                    # All tests\n.\u002Fgradlew test --tests \"BookServiceSpec\"          # Single spec\n.\u002Fgradlew test --tests \"*Spec.save*\"              # Pattern match\n.\u002Fgradlew integrationTest                         # Integration tests\n\n# Build\n.\u002Fgradlew build                                   # Build with tests\n.\u002Fgradlew bootJar                                 # Executable JAR\n.\u002Fgradlew bootWar                                 # WAR file\n\n# Code quality\n.\u002Fgradlew check                                   # Run all verification tasks\n\n# Clean\n.\u002Fgradlew clean\n```\n\n## Best Practices\n\n### Convention Over Configuration\n- Follow Grails naming conventions for automatic wiring.\n- Use standard directory structure.\n- Let Grails infer configurations where possible.\n\n### Performance\n- Use `@GrailsCompileStatic` on controllers, services, and domain classes.\n- Enable query caching for read-heavy operations.\n- Use pagination for large result sets.\n- Avoid N+1 queries with eager fetching or batch size.\n\n### Security\n- Use CSRF tokens in forms: `\u003Cg:form useToken=\"true\">`.\n- Apply Spring Security for authentication\u002Fauthorization.\n- Use parameterized queries (GORM handles this automatically).\n- Encode output to prevent XSS.\n\n### Testing\n- Write unit tests for domain constraints.\n- Test controllers with `ControllerUnitTest`.\n- Use integration tests for service\u002Fdatabase interactions.\n- Use Geb for critical user workflows.\n\n### Code Style\n- Use `@GrailsCompileStatic` or `@CompileStatic` for type safety and performance.\n- Prefer services for business logic over controllers.\n- Use command objects for complex form handling.\n- Keep controllers thin, services fat.\n\n## Resources\n\n- **Grails User Guide**: https:\u002F\u002Fgrails.apache.org\u002Fdocs\u002Flatest\u002Fguide\u002Fsingle.html\n- **GORM Documentation**: https:\u002F\u002Fgrails.apache.org\u002Fdocs\u002Flatest\u002Fgrails-data\u002F\n- **Grails Plugins**: https:\u002F\u002Fgrails.apache.org\u002Fplugins.html\n- **Groovy 5 Documentation**: https:\u002F\u002Fgroovy-lang.org\u002Fdocumentation.html#all-versions (select latest 5.1.x)\n- **Spock Framework**: https:\u002F\u002Fspockframework.org\u002Fspock\u002Fdocs\u002F2.4\u002Fall_in_one.html\n- **Geb Manual**: https:\u002F\u002Fgroovy.apache.org\u002Fgeb\u002Fmanual\u002Fcurrent\u002F\n",{"name":5,"license":15,"description":7},"8.0.x","8803d54c23f742d11efb3e01eeee86489bb4ba95","grails-skills\u002Fdeveloper\u002Fskills\u002Fgrails-developer",979,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fgrails-core","https:\u002F\u002Fgrails.apache.org\u002F","https:\u002F\u002Fgithub.com\u002Fapache","https:\u002F\u002Fwww.apache.org\u002F","2026-11-15 03:12:29",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add apache\u002Fgrails-core --skill grails-developer",{"tool":62,"command":63},"bunx","bunx skills add apache\u002Fgrails-core --skill grails-developer",{"tool":65,"command":66},"pnpm","pnpm dlx skills add apache\u002Fgrails-core --skill grails-developer","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fapache\u002Fgrails-core\u002Fblob\u002F8.0.x\u002Fgrails-skills\u002Fdeveloper\u002Fskills\u002Fgrails-developer\u002FSKILL.md",true,[],[71,78,84,90,96,102],{"skillNo":72,"name":73,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":77},"01M7B5APRW1EKGNHWGDMK15JE5","violation-fixer","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgrails-core\u002Fblob\u002F8.0.x\u002F.claude\u002Fskills\u002Fviolation-fixer\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":77},"01M7B5AMFA8A8560CGDCFHW3SK","test-fixer","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgrails-core\u002Fblob\u002F8.0.x\u002F.claude\u002Fskills\u002Ftest-fixer\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":77},"01M7B5AKHFJW84NSXM8BZBAA9C","mono-repo-integration","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgrails-core\u002Fblob\u002F8.0.x\u002F.claude\u002Fskills\u002Fmono-repo-integration\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":77},"01M7B5AJHPW5ADFJNKM5KVFKSE","hibernate-developer","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgrails-core\u002Fblob\u002F8.0.x\u002F.claude\u002Fskills\u002Fhibernate-developer\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":77},"01M7B5AHGRTVSKFD4M3KMHWZRZ","grails-8-upgrade","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgrails-core\u002Fblob\u002F8.0.x\u002F.claude\u002Fskills\u002Fgrails-8-upgrade\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":77},"01M7B5AG2FWXSXCK1ESCBWB2X9","gradle-developer","https:\u002F\u002Fgithub.com\u002Fapache\u002Fgrails-core\u002Fblob\u002F8.0.x\u002F.claude\u002Fskills\u002Fgradle-developer\u002FSKILL.md",[],[]]