Inheritance diagram for Drupal\tripal_chado\Task\ChadoCloner:

[legend]

Collaboration diagram for Drupal\tripal_chado\Task\ChadoCloner:

[legend]

Public Member Functions
	validateParameters ()

	performTask ()

	getProgress ()

	getStatus ()

Public Member Functions inherited from Drupal\tripal_chado\Task\ChadoTaskBase
	getTripalDbxClass ($class)

Public Member Functions inherited from Drupal\tripal_biodb\Task\BioTaskBase
	__construct (?\Drupal\Core\Database\Connection $database=NULL, ?\Psr\Log\LoggerInterface $logger=NULL, ?\Drupal\tripal_biodb\Lock\SharedLockBackendInterface $locker=NULL, ?\Drupal\Core\State\StateInterface $state=NULL)

	setParameters (array $parameters=[])

	getId ()

	getLogger ()

Public Attributes
const	TASK_NAME = 'cloner'

Public Attributes inherited from Drupal\tripal_chado\Task\ChadoTaskBase
const	TASK_NAME = 'chado'

Public Attributes inherited from Drupal\tripal_biodb\Task\BioTaskBase
const	TASK_NAME = 'task'

const	STATE_KEY_DATA_PREFIX = 'tripal_biodb_'

Additional Inherited Members
Protected Member Functions inherited from Drupal\tripal_biodb\Task\BioTaskBase
	prepareSchemas (array $schema_list)

	getSchemaLockName (\Drupal\tripal\TripalDBX\TripalDbxConnection $db)

	initId ()

	acquireTaskLocks ()

	releaseTaskLocks ()

Protected Attributes inherited from Drupal\tripal_biodb\Task\BioTaskBase
	$id

	$connection

	$logger

	$locker

	$state

	$parameters = ['input_schemas' => [], 'output_schemas' => [], ]

	$inputSchemas = []

	$outputSchemas = []

Detailed Description

Chado cloner.

Usage:

// Where 'chado' is the name of an existing Chado schema and 'new_chado_copy'
// is the name of an unexisting schema that will be created and receive the
// full copy of the 'chado' schema content.
$cloner = \Drupal::service('tripal_chado.cloner');
$cloner->setParameters([
  'input_schemas'  => ['chado'],
  'output_schemas' => ['new_chado_copy'],
]);
if (!$cloner->performTask()) {
  // Display a message telling the user the task failed and details are in
  // the site logs.
}

Member Function Documentation

◆ getProgress()

Drupal\tripal_chado\Task\ChadoCloner::getProgress ( )

{Returns the percent of progress of current task.This method can also be used to check if a task is currently running if it has a > 0 value. A negative value means an error occured while running.

Returns: float A value between -1 and 1, 0 meaning the task has not been started yet, 1 meaning the task is completed with success and a negative value meaning that the task failed. The negative value may be used as a code to identify the error.

}

Implements Drupal\tripal_biodb\Task\BioTaskInterface.

◆ getStatus()

Drupal\tripal_chado\Task\ChadoCloner::getStatus ( )

{{Returns a string describing current status of the performed task.This function returns the last known status, even if the task ended. In case of failure, this function may return the reason of the failure.

Returns: string A localized description.

}}

Reimplemented from Drupal\tripal_biodb\Task\BioTaskBase.

◆ performTask()

Drupal\tripal_chado\Task\ChadoCloner::performTask ( )

Clone a given chado schema into the specified schema.

The cloning procedure uses a custom PostgreSQL function (tripal_clone_schema() installed with Tripal Chado) to clone schema rather than using a schema dump, modifying it to change schema name (with possible side effects) and reloading that dump. It is faster and avoids using temporary files (risks of content disclosure).

Task parameter array provided to the class constructor includes:

'input_schemas' array: one input schema that must exist (required)
'output_schemas' array: one output schema that must not exist (required)

Example:

['input_schemas' => ['original_name'], 'output_schemas' => ['copy_name'], ]

Returns: bool TRUE if the task was performed with success and FALSE if the task was completed but without the expected success.

Exceptions

Drupal

Reimplemented from Drupal\tripal_biodb\Task\BioTaskBase.

◆ validateParameters()

Drupal\tripal_chado\Task\ChadoCloner::validateParameters ( )

Validate task parameters.

Parameter array provided to the class constructor must include one input schema and one output schema as shown:

['input_schemas' => ['original_name'], 'output_schemas' => ['copy_name'], ]

Exceptions

Implements Drupal\tripal_biodb\Task\BioTaskInterface.

Member Data Documentation

◆ TASK_NAME

const Drupal\tripal_chado\Task\ChadoCloner::TASK_NAME = 'cloner'

Name of the task.

The documentation for this class was generated from the following file:

tripal_chado/src/Task/ChadoCloner.php

Public Member Functions

Public Attributes

Additional Inherited Members