AEM Groovy Extension

OSGi bundle containing Groovy builders and metaclasses for Adobe Experience Manager.

License	The Apache Software License, Version 2.0
Categories	Groovy Languages
GroupId	com.icfolson.aem.groovy.extension
ArtifactId	aem-groovy-extension
Last Version	7.0.0
Release Date	Mar 7, 2019
Type	pom
Description	AEM Groovy Extension OSGi bundle containing Groovy builders and metaclasses for Adobe Experience Manager.
Project URL	https://github.com/icfnext/aem-groovy-extension
Project Organization	ICF Next
Source Code Management	https://github.com/icfnext/aem-groovy-extension

Download aem-groovy-extension

Filename	Size
aem-groovy-extension-7.0.0.pom	12 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.icfolson.aem.groovy.extension/aem-groovy-extension/ -->
<dependency>
    <groupId>com.icfolson.aem.groovy.extension</groupId>
    <artifactId>aem-groovy-extension</artifactId>
    <version>7.0.0</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.icfolson.aem.groovy.extension/aem-groovy-extension/
implementation 'com.icfolson.aem.groovy.extension:aem-groovy-extension:7.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.icfolson.aem.groovy.extension/aem-groovy-extension/
implementation ("com.icfolson.aem.groovy.extension:aem-groovy-extension:7.0.0")

Apache Buildr

'com.icfolson.aem.groovy.extension:aem-groovy-extension:pom:7.0.0'

Apache Ivy

<dependency org="com.icfolson.aem.groovy.extension" name="aem-groovy-extension" rev="7.0.0">
  <artifact name="aem-groovy-extension" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.icfolson.aem.groovy.extension', module='aem-groovy-extension', version='7.0.0')
)

Scala SBT

libraryDependencies += "com.icfolson.aem.groovy.extension" % "aem-groovy-extension" % "7.0.0"

Leiningen

[com.icfolson.aem.groovy.extension/aem-groovy-extension "7.0.0"]

Dependencies

provided (6)

Group / Artifact	Type	Version
javax.jcr : jcr	jar	2.0
javax.servlet : javax.servlet-api	jar	3.1.0
org.osgi : osgi.cmpn	jar	6.0.0
org.osgi : osgi.core	jar	6.0.0
org.codehaus.groovy : groovy-all	jar	2.4.15
com.adobe.aem : uber-jar	jar	6.3.2

Project Modules

• aem-groovy-extension-bundle
• aem-groovy-extension-tests
• aem-groovy-extension-package

AEM Groovy Extension

ICF Next

Overview

OSGi bundle containing Groovy builders and metaclasses for Adobe Experience Manager. The bundle exposes an API to implement extension "provider" services to register additional Groovy metaclasses in the container.

new NodeBuilder(session).content {
    satirists("sling:Folder") {
        bierce(firstName: "Ambrose", lastName: "Bierce", birthDate: Calendar.instance.updated(year: 1842, month: 5, date: 24))
        mencken(firstName: "H.L.", lastName: "Mencken", birthDate: Calendar.instance.updated(year: 1880, month: 8, date: 12))
        other("sling:Folder", "jcr:title": "Other")
    }
}

See Groovydocs for complete API documentation.

Requirements

• AEM 6.x running on localhost:4502
• Maven 3.x

Compatibility

Groovy Extension Version(s)	AEM Version(s)
7.x.x	6.3, 6.4, 6.5
6.x.x, 5.x.x	6.4
4.x.x	6.3
3.x.x, 2.x.x	6.2
1.x.x	6.1
0.9.x, 0.8.x	6.0
<= 0.7.x	5.6 (CQ5)

Usage and Installation

1. Add dependency to your project's Maven pom.xml.

    <dependency>
        <groupId>com.icfolson.aem.groovy.extension</groupId>
        <artifactId>aem-groovy-extension-bundle</artifactId>
        <version>7.0.0</version>
        <scope>provided</scope>
    </dependency>
   

2. Install the AEM Groovy Extension package.

    mvn install -P local
   

   or

    mvn install -P local,replicate
   

   The optional replicate profile activates the deployed package to the local publish instance.

   To install to a non-localhost AEM environment, connection parameters can be passed as Maven properties on the command line (see the parent POM file for additional environment property names).

    mvn install -P local -Daem.host=hostname -Daem.port.author=7402
   

Context Path Support

If you are running AEM with a context path, set the Maven property aem.context.path during installation.

mvn install -P local -Daem.context.path=/context

Registering Additional Metaclasses

Services implementing the com.icfolson.aem.groovy.extension.api.MetaClassExtensionProvider will be automatically discovered and bound by the OSGi container. These services can be implemented in any deployed bundle. The AEM Groovy Extension bundle will handle the registration and removal of supplied metaclasses as these services are activated/deactivated in the container. See the DefaultMetaClassExtensionProvider service for the proper closure syntax for registering metaclasses.

Versioning

Follows Semantic Versioning guidelines.

ICF Next

Your global engagement and transformation partner.

Versions

Version
7.0.0 Mar 7, 2019
6.0.0 Sep 25, 2018
5.0.0 Jul 12, 2018
4.0.0 May 1, 2017
3.0.0 Nov 30, 2016
2.0.0 Jun 30, 2016