Merge branch '2.x'

Author: rjrudin

.gitignore

@@ -1,35 +1,36 @@
-/bin
-/.classpath
-/build
-/.gradle
-/.nb-gradle
-/.settings
-/.project
-ml-gradle-all/build/
-ml-gradle-all/.gradle/
-ml-gradle-all/.classpath
-ml-gradle-all/.project
-ml-gradle-all/.settings/
-sample-project/rob/
-sample-project/data/export/
-disconnected-project/build/
-disconnected-project/.gradle/
-sample-project/local.gradle
-examples/disconnected-project/build/
-examples/disconnected-project/.gradle/
-examples/flexrep-project/.gradle/
-examples/sample-project/local.gradle
-examples/failover-project/.gradle/
-examples/mlcp-project/.gradle/
-examples/mlcp-project/build/
-examples/mlcp-project/data/export/
-examples/shell-project/.gradle/
-examples/shell-project/build/
-examples/shell-project/.gradle
-examples/shell-project/.settings
-examples/shell-project/.project
-examples/shell-project/.classpath
-examples/minimal-project/.gradle
-examples/ignore-resources-project/.gradle/
-.idea
-*.iml
+/bin
+/.classpath
+/build
+/.gradle
+/.nb-gradle
+/.settings
+/.project
+ml-gradle-all/build/
+ml-gradle-all/.gradle/
+ml-gradle-all/.classpath
+ml-gradle-all/.project
+ml-gradle-all/.settings/
+sample-project/rob/
+sample-project/data/export/
+disconnected-project/build/
+disconnected-project/.gradle/
+sample-project/local.gradle
+examples/disconnected-project/build/
+examples/disconnected-project/.gradle/
+examples/flexrep-project/.gradle/
+examples/sample-project/local.gradle
+examples/failover-project/.gradle/
+examples/mlcp-project/.gradle/
+examples/mlcp-project/build/
+examples/mlcp-project/data/export/
+examples/shell-project/.gradle/
+examples/shell-project/build/
+examples/shell-project/.gradle
+examples/shell-project/.settings
+examples/shell-project/.project
+examples/shell-project/.classpath
+examples/minimal-project/.gradle
+examples/ignore-resources-project/.gradle/
+.idea
+*.iml
+out

build.gradle

@@ -17,6 +17,8 @@ plugins {
   id "eclipse"
   id "idea"
   id "com.jfrog.bintray" version "1.6"
+  id "com.github.jk1.dependency-license-report" version "0.3.11"
+  id "com.gradle.plugin-publish" version "0.9.7"
 }
 
 apply plugin: "com.gradle.plugin-publish"
@@ -37,6 +39,7 @@ dependencies {
   compile localGroovy()
   compile mlAppDeployerDependency
   compile mlcpUtilDependency
+  compile group: 'commons-io', name: 'commons-io', version: '2.5'
 }
 
 task sourcesJar(type: Jar, dependsOn: classes) {
@@ -87,11 +90,11 @@ pluginBundle {
       displayName = 'ml-gradle for MarkLogic'
       description = 'Gradle plugin for configuring and deploying applications to MarkLogic'
       tags = ['marklogic']
-      version = "2.8.0"
+      version = "2.9.0"
     }
   }
 
   mavenCoordinates {
-    version = "2.8.0"
+    version = "2.9.0"
   }
 }

examples/local-testing-project/gradle.properties

@@ -1,6 +1,6 @@
 # Set this to the version you used when running
 # "gradle -Pversion=(something) publishToMavenLocal" on your local ml-gradle repo
-mlGradleVersion=2.8.0
+mlGradleVersion=2.9.0
 
 mlHost=localhost
 mlAppName=example

examples/roxy-project/.gitignore

@@ -0,0 +1,8 @@
+/bin
+.classpath
+.project
+/build
+.gradle
+.settings
+src
+backup-*

examples/roxy-project/build.gradle

@@ -1,14 +1,16 @@
-plugins {
-  id "com.marklogic.ml-gradle" version "2.7.1"
+buildscript {
+	repositories {
+		mavenLocal()
+		jcenter()
+	}
+	dependencies {
+		classpath "com.marklogic:ml-gradle:2.9.0"
+	}
 }
 
-/**
- * ml-gradle defaults to a modules path of src/main/ml-modules. Roxy applications almost always store
- * asset modules under ./src, so we need to modify the module paths. Note that since Roxy stores REST API
- * extensions under ./ext, "gradle mlWatch" will not load these.
- */
-ext {
-	mlAppConfig {
-		modulePaths = ["src"]
-	}
+apply plugin: "com.marklogic.ml-gradle"
+
+repositories {
+	mavenLocal()
+	jcenter()
 }

examples/roxy-project/deploy/app_specific.rb

@@ -0,0 +1,85 @@
+#
+# Put your custom functions in this class in order to keep the files under lib untainted
+#
+# This class has access to all of the private variables in deploy/lib/server_config.rb
+#
+# any public method you create here can be called from the command line. See
+# the examples below for more information.
+#
+class ServerConfig
+
+  def hello_world()
+    @logger.info "trying to run a custom query"
+    r = execute_query %Q{
+      xquery version "1.0-ml";
+      ("one", "two", "three") ! element span { . }
+    },
+    {
+      :app_name => "#{@properties['ml.app-name']}"
+    }
+    JSON.parse(r.body).each do |item|
+      output = item['result']
+      @logger.info "   " + output
+    end
+  end
+
+  def get_document_count()
+		r = execute_query %Q{
+			xdmp:estimate(fn:doc())
+		}
+		@logger.info(r.body)
+	end
+
+	def delete_view()
+		r = execute_query %Q{
+			xquery version "1.0-ml";
+
+			import module namespace view = "http://marklogic.com/xdmp/view"
+				at "/MarkLogic/views.xqy";
+
+			try {
+				view:remove(
+					"main",
+					"Compliance"
+				)
+			} catch ($e) { () }
+			(: Deletes a view, of the 'main' schema that contains columns, with a scope on the element, 'html'. :)
+		},
+		{ :db_name => @properties["ml.content-db"] }
+	end
+
+	def create_view()
+		r = execute_query %Q{
+			xquery version "1.0-ml";
+
+			import module namespace view = "http://marklogic.com/xdmp/view"
+				at "/MarkLogic/views.xqy";
+
+			try {
+				view:schema-create(
+					"main",
+					()
+				)
+			} catch ($e) {()},
+			view:create(
+					"main",
+					"Compliance",
+					view:element-view-scope(fn:QName("http://www.w3.org/1999/xhtml","html")),
+					( view:column("uri", cts:uri-reference()),
+						view:column("entityName", cts:path-reference('/xhtml:html/xhtml:head/xhtml:meta[@name eq "entityName"]/@content',("collation=http://marklogic.com/collation/"))),
+						view:column("entityStreetAddress",  cts:path-reference('/xhtml:html/xhtml:head/xhtml:meta[@name eq "entityStreetAddress"]/@content',("collation=http://marklogic.com/collation/", ("nullable")))),
+						view:column("entityCityAddress",  cts:path-reference('/xhtml:html/xhtml:head/xhtml:meta[@name eq "entityCityAddress"]/@content',("collation=http://marklogic.com/collation/", ("nullable")))),
+						view:column("entityCountryAddress",  cts:path-reference('/xhtml:html/xhtml:head/xhtml:meta[@name eq "entityCountryAddress"]/@content',("collation=http://marklogic.com/collation//S2", ("nullable")))),
+						view:column("foreignEntityStatus",  cts:path-reference('/xhtml:html/xhtml:head/xhtml:meta[@name eq "foreignEntityStatus"]/@content',("collation=http://marklogic.com/collation/", ("nullable")))),
+						view:column("intermediaryEntityStatus",  cts:path-reference('/xhtml:html/xhtml:head/xhtml:meta[@name eq "intermediaryEntityStatus"]/@content',("collation=http://marklogic.com/collation/codepoint", ("nullable")))),
+						view:column("EIN",  cts:path-reference('/xhtml:html/xhtml:head/xhtml:meta[@name eq "EIN"]/@content',("collation=http://marklogic.com/collation/", ("nullable")))),
+						view:column("docType", cts:path-reference('/xhtml:html/xhtml:head/xhtml:meta[@name eq "docType"]/@content',("collation=http://marklogic.com/collation//S1", ("nullable"))))
+					),
+					()
+			)
+
+			(: Creates a view, of the 'main' schema that contains columns, with a scope on the element, 'html'. :)
+		},
+		{ :db_name => @properties["ml.content-db"] }
+	end
+end

gradle.properties

@@ -1,5 +1,5 @@
 group=com.marklogic
-version=2.8.0
-mlAppDeployerDependency=com.marklogic:ml-app-deployer:2.8.0
+version=2.9.0
+mlAppDeployerDependency=com.marklogic:ml-app-deployer:2.9.0
 mlcpUtilDependency=com.marklogic:mlcp-util:0.3.0
 

src/main/groovy/com/marklogic/gradle/MarkLogicPlugin.groovy

@@ -33,6 +33,9 @@ import com.marklogic.gradle.task.groups.SetTraceEventsTask
 import com.marklogic.gradle.task.mimetypes.DeployMimetypesTask
 import com.marklogic.gradle.task.qconsole.ExportWorkspacesTask
 import com.marklogic.gradle.task.qconsole.ImportWorkspacesTask
+import com.marklogic.gradle.task.roxy.RoxyMigrateBuildStepsTask
+import com.marklogic.gradle.task.roxy.RoxyMigrateFilesTask
+import com.marklogic.gradle.task.roxy.RoxyMigratePropertiesTask
 import com.marklogic.gradle.task.scaffold.GenerateScaffoldTask
 import com.marklogic.gradle.task.schemas.LoadSchemasTask
 import com.marklogic.gradle.task.security.*
@@ -80,7 +83,8 @@ class MarkLogicPlugin implements Plugin<Project> {
 		String deployGroup = "ml-gradle Deploy"
 		project.task("mlPostDeploy", group: deployGroup, description: "Add dependsOn to this task to add tasks at the end of mlDeploy").mustRunAfter(["mlDeployApp"])
 		project.task("mlPostUndeploy", group: deployGroup, description: "Add dependsOn to this task to add tasks at the end of mlUndeploy").mustRunAfter(["mlUndeployApp"])
-		project.task("mlDeploy", group: deployGroup, dependsOn: ["mlDeployApp", "mlPostDeploy"], description: "Deploys all application resources in the configuration directory and allows for additional steps via mlPostDeploy.dependsOn").mustRunAfter("mlClearModulesDatabase")
+		project.task("mlDeploy", group: deployGroup, dependsOn: ["mlDeployApp", "mlPostDeploy"],
+			description: "Deploys all application resources in the configuration directory and allows for additional steps via mlPostDeploy.dependsOn. Use -Pignore to specify a comma-delimited list of short class names of ml-app-deployer command classes to ignore while deploying.").mustRunAfter("mlClearModulesDatabase")
 		project.task("mlUndeploy", group: deployGroup, dependsOn: ["mlUndeployApp", "mlPostUndeploy"], description: "Undeploys all application resources in the configuration directory and allows for additional steps via mlPostUndeploy.dependsOn")
 		project.task("mlRedeploy", group: deployGroup, dependsOn: ["mlClearModulesDatabase", "mlDeploy"], description: "Clears the modules database and then deploys the application")
 
@@ -207,6 +211,15 @@ class MarkLogicPlugin implements Plugin<Project> {
 		String shellGroup = "ml-gradle Shell"
 		project.task("mlShell", type: ShellTask, group: shellGroup, description: "Run groovysh with MarkLogic-specific support built in")
 
+		String roxyGroup = "ml-gradle Roxy";
+		project.task("mlRoxyMigrateBuildSteps", type: RoxyMigrateBuildStepsTask, group: roxyGroup, description: "Migrate build steps from deploy/app_specific.rb into custom Gradle tasks. " +
+			"Use -ProxyProjectPath to define the location of your Roxy project, and -PappSpecificPath to define a path other than deploy/app_specific.rb")
+		project.task("mlRoxyMigrateFiles", type: RoxyMigrateFilesTask, group: roxyGroup, description: "Migrate Roxy source files into this Gradle project. " +
+			"Use -ProxyProjectPath to define the location of your Roxy project.")
+		project.task("mlRoxyMigrateProperties", type: RoxyMigratePropertiesTask, group: roxyGroup, description: "Migrate Roxy properties into the gradle.properties file in this project. " +
+			"Use -ProxyProjectPath to define the location of your Roxy project.")
+		project.task("mlRoxyMigrateProject", group: roxyGroup, description: "Run all tasks for migrating a Roxy project into this Gradle project. " +
+			"Use -ProxyProjectPath to define the location of your Roxy project.", dependsOn: ["mlRoxyMigrateBuildSteps", "mlRoxyMigrateFiles", "mlRoxyMigrateProperties"])
 		logger.info("Finished initializing ml-gradle\n")
 	}
 

src/main/groovy/com/marklogic/gradle/task/DeployAppTask.groovy

@@ -1,11 +1,34 @@
 package com.marklogic.gradle.task
 
+import com.marklogic.appdeployer.impl.SimpleAppDeployer
 import org.gradle.api.tasks.TaskAction
 
 class DeployAppTask extends MarkLogicTask {
 
+	/**
+	 * Use "-Pignore" to specify the short class names of ml-app-deployer commands to ignore. The commands are then
+	 * removed from the mlAppDeployer object, as long as it is an instance of SimpleAppDeployer from ml-app-deployer.
+	 */
     @TaskAction
     void deployApp() {
-        getAppDeployer().deploy(getAppConfig())
+	    def appDeployer = getAppDeployer()
+	    if (project.hasProperty("ignore")) {
+		    if (appDeployer instanceof SimpleAppDeployer) {
+			    String[] commandNames = project.property("ignore").split(",")
+			    SimpleAppDeployer deployer = (SimpleAppDeployer)appDeployer
+			    for (String commandName : commandNames) {
+				    def command = deployer.removeCommand(commandName)
+				    if (command != null) {
+					    println "Ignoring command: " + commandName
+				    } else {
+					    println "Could not find command specified by ignore property: " + commandName
+				    }
+			    }
+		    }
+		    else {
+			    println "ignore property defined, but mlAppDeployer is not an instance of SimpleAppDeployer, so not able to ignore commands"
+		    }
+	    }
+        appDeployer.deploy(getAppConfig())
     }
 }

src/main/groovy/com/marklogic/gradle/task/MarkLogicTask.groovy

@@ -44,10 +44,10 @@ class MarkLogicTask extends DefaultTask {
 		project.hasProperty("mlAdminPassword") ? project.property("mlAdminPassword") : project.property("mlPassword")
 	}
 
-    DatabaseClient newClient() {
+	DatabaseClient newClient() {
         getAppConfig().newDatabaseClient()
     }
-    
+
     void deployWithCommandListProperty(String propertyName) {
         deployWithCommands(getProject().property(propertyName))
     }
@@ -57,7 +57,7 @@ class MarkLogicTask extends DefaultTask {
         deployer.setCommands(commands)
         deployer.deploy(getAppConfig())
     }
-    
+
     void undeployWithCommandListProperty(String propertyName) {
         undeployWithCommands(getProject().property(propertyName))
     }
@@ -67,12 +67,12 @@ class MarkLogicTask extends DefaultTask {
         deployer.setCommands(commands)
         deployer.undeploy(getAppConfig())
     }
-    
+
     void invokeDeployerCommandWithClassName(String className) {
         SimpleAppDeployer d = (SimpleAppDeployer)getAppDeployer()
         new SimpleAppDeployer(getManageClient(), getAdminManager(), d.getCommand(className)).deploy(getAppConfig())
     }
-    
+
     void undeployWithCommandWithClassName(String className) {
         SimpleAppDeployer d = (SimpleAppDeployer)getAppDeployer()
         new SimpleAppDeployer(getManageClient(), getAdminManager(), d.getCommand(className)).undeploy(getAppConfig())