Provides APIs to refactor XWiki entities

Description

This module provides APIs to perform various refactoring operations, such as move, copy, rename, delete, that target XWiki Entities. Since most of these operations can take a long time (e.g. renaming a space with lots of documents in it) they have been implemented as jobs that run in background threads for which we can monitor the process.

You can trigger the refactoring jobs from a Java component using the Job Executor or from Velocity/Groovy using the script service. Note that some jobs (like move) are interactive and thus can ask questions (e.g. whether you want to overwrite an existing document or not).

Script Service

For the sake of brevity in the following examples the HTTP request is blocked until the job is done by calling join(). In real life you should monitor the progress of the operation using the job status.

• Copy a Space
  #set ($source = $services.model.resolveSpace('Path.To.Source'))
  #set ($destination = $services.model.resolveSpace('Path.To.New.Parent'))
  $services.refactoring.copy($source, $destination).join()
• Copy a Space As
  #set ($source = $services.model.resolveSpace('Path.To.Source'))
  #set ($destination = $services.model.resolveSpace('Path.To.New.Name'))
  $services.refactoring.copyAs($source, $destination).join()
• Move a Space
  #set ($source = $services.model.resolveSpace('Path.To.Source'))
  #set ($destination = $services.model.resolveSpace('Path.To.New.Parent'))
  $services.refactoring.move($source, $destination).join()
• Move a Document
  #set ($source = $services.model.resolveDocument('Path.To.Source.WebHome'))
  #set ($destination = $services.model.resolveSpace('Path.To.New.Parent'))
  $services.refactoring.move($source, $destination).join()
• Rename a Space
  #set ($source = $services.model.resolveSpace('Path.To.Source'))
  $services.refactoring.rename($source, 'NewName').join()
• Rename a Document
  #set ($source = $services.model.resolveDocument('Path.To.Source.WebHome'))
  $services.refactoring.rename($source, 'NewName').join()
• Delete a Document
  #set ($source = $services.model.resolveDocument('Path.To.Source.WebHome'))
  $services.refactoring.delete($source).join()
• Delete a Space
  #set ($source = $services.model.resolveSpace('Path.To.Source'))
  $services.refactoring.delete($source).join()
• Convert a Terminal Document to a Nested Document
  #set ($source = $services.model.resolveDocument('Path.To.Page'))
  $services.refactoring.convertToNestedDocument($source).join()
• Convert a Nested Document to a Terminal Document
  #set ($source = $services.model.resolveDocument('Path.To.Source.WebHome'))
  $services.refactoring.convertToTerminalDocument($source).join()