You are here

Home » API reference » Search API Multilingual Solr Search 8 » SolrFieldTypeListBuilder.php

class SolrFieldTypeListBuilder in Search API Multilingual Solr Search 8

Provides a listing of SolrFieldType.

Hierarchy

Expanded class hierarchy of SolrFieldTypeListBuilder

File

src/Controller/SolrFieldTypeListBuilder.php, line 14

Namespace

Drupal\search_api_solr_multilingual\Controller
View source 
class SolrFieldTypeListBuilder extends ConfigEntityListBuilder {

  /**
   * @var \Drupal\search_api_solr_multilingual\SolrMultilingualBackendInterface
   */
  protected $backend;

  /**
   * @var string
   *   A Solr version string.
   */
  protected $assumed_minimum_version = '';

  /**
   * {@inheritdoc}
   */
  public function buildHeader() {
    $header = [
      'label' => $this
        ->t('Solr Field Type'),
      'minimum_solr_version' => $this
        ->t('Minimum Solr Version'),
      'managed_schema' => $this
        ->t('Managed Schema Required'),
      'langcode' => $this
        ->t('Language'),
      'domains' => $this
        ->t('Domains'),
      'id' => $this
        ->t('Machine name'),
    ];
    return $header + parent::buildHeader();
  }

  /**
   * {@inheritdoc}
   */
  public function buildRow(EntityInterface $solr_field_type) {

    /** @var \Drupal\search_api_solr_multilingual\SolrFieldTypeInterface $solr_field_type */
    $domains = $solr_field_type
      ->getDomains();
    if (empty($domains)) {
      $domains = [
        'generic',
      ];
    }
    $row = [
      'label' => $solr_field_type
        ->label(),
      'minimum_solr_version' => $solr_field_type
        ->getMinimumSolrVersion(),
      // @todo format
      'managed_schema' => $solr_field_type
        ->isManagedSchema(),
      // @todo format
      'langcode' => $solr_field_type
        ->getFieldTypeLanguageCode(),
      // @todo format
      'domains' => implode(', ', $domains),
      'id' => $solr_field_type
        ->id(),
    ];
    return $row + parent::buildRow($solr_field_type);
  }

  /**
   * {@inheritdoc}
   */
  public function load() {
    static $entities;
    if (!$entities) {
      $solr_version = '9999.0.0';
      $operator = '>=';
      $domain = 'generic';
      $warning = FALSE;
      try {

        /** @var \Drupal\search_api_solr\SolrBackendInterface $backend */
        $backend = $this
          ->getBackend();
        $domain = $backend
          ->getDomain();
        $solr_version = $backend
          ->getSolrConnector()
          ->getSolrVersion();
        if (version_compare($solr_version, '0.0.0', '==')) {
          $solr_version = '9999.0.0';
          throw new SearchApiSolrException();
        }
      } catch (SearchApiSolrException $e) {
        $operator = '<=';
        $warning = TRUE;
      }
      $entity_ids = $this
        ->getEntityIds();

      /** @var \Drupal\Core\Config\Entity\ConfigEntityStorageInterface $storage */
      $storage = $this
        ->getStorage();
      $entities = $storage
        ->loadMultipleOverrideFree($entity_ids);

      // We filter to those field types that are relevant for the current server.
      // There are multiple entities having the same field_type.name but different
      // values for managed_schema, minimum_solr_version and domains.
      $selection = [];
      foreach ($entities as $key => $solr_field_type) {

        /** @var \Drupal\search_api_solr_multilingual\SolrFieldTypeInterface $solr_field_type */
        $version = $solr_field_type
          ->getMinimumSolrVersion();
        $domains = $solr_field_type
          ->getDomains();
        if ($solr_field_type
          ->isManagedSchema() != $this
          ->getBackend()
          ->isManagedSchema() || version_compare($version, $solr_version, '>') || !in_array($domain, $domains) && !in_array('generic', $domains)) {
          unset($entities[$key]);
        }
        else {
          $name = $solr_field_type
            ->getFieldTypeName();
          if (isset($selection[$name])) {

            // The more specific domain has precedence over a newer version.
            if ('generic' != $domain && 'generic' == $selection[$name]['domain'] && in_array($domain, $domains) || version_compare($version, $selection[$name]['version'], $operator) && in_array($selection[$name]['domain'], $domains)) {
              unset($entities[$selection[$name]['key']]);
              $selection[$name] = [
                'version' => $version,
                'key' => $key,
                'domain' => in_array($domain, $domains) ? $domain : 'generic',
              ];
            }
            else {
              unset($entities[$key]);
            }
          }
          else {
            $selection[$name] = [
              'version' => $version,
              'key' => $key,
              'domain' => in_array($domain, $domains) ? $domain : 'generic',
            ];
          }
        }
      }
      if ($warning) {
        $this->assumed_minimum_version = array_reduce($selection, function ($version, $item) {
          if (version_compare($item['version'], $version, '<')) {
            return $item['version'];
          }
          return $version;
        }, $solr_version);
        $this
          ->messenger()
          ->addWarning($this
          ->t('Unable to reach the Solr server (yet). Therefor the lowest supported Solr version %version is assumed.' . ' Once the connection works and the real Solr version could be detected it might be necessary to deploy an adjusted config to the server to get the best search results.' . ' If the server does not start using the downloadable config, you should edit the server add manually set the Solr version override temporarily that fits your server best and download the config again. But it is recommended to remove this override once the server is running.', [
          '%version' => $this->assumed_minimum_version,
        ]));
      }

      // Sort the entities using the entity class's sort() method.
      // See \Drupal\Core\Config\Entity\ConfigEntityBase::sort().
      uasort($entities, array(
        $this->entityType
          ->getClass(),
        'sort',
      ));
    }
    return $entities;
  }

  /**
   * @inheritdoc
   */
  public function getDefaultOperations(EntityInterface $solr_field_type) {

    /** @var \Drupal\search_api_solr_multilingual\SolrFieldTypeInterface $solr_field_type */
    $operations = parent::getDefaultOperations($solr_field_type);
    if ($solr_field_type
      ->access('view') && $solr_field_type
      ->hasLinkTemplate('export-form')) {
      $operations['export'] = array(
        'title' => $this
          ->t('Export'),
        'weight' => 10,
        'url' => $solr_field_type
          ->toUrl('export-form'),
      );
    }
    return $operations;
  }

  /**
   *
   */
  public function getSchemaExtraTypesXml() {
    return $this
      ->getPlainTextRenderArray($this
      ->generateSchemaExtraTypesXml());
  }

  /**
   *
   */
  protected function generateSchemaExtraTypesXml() {
    $target_solr_version = $this
      ->getBackend()
      ->getSolrConnector()
      ->getSolrVersion();
    $indentation = '  ';
    if (version_compare($target_solr_version, '6.0.0', '>=')) {
      $indentation .= '  ';
    }
    $xml = $this
      ->getExtraFileHead($target_solr_version, 'types');

    /** @var \Drupal\search_api_solr_multilingual\SolrFieldTypeInterface $solr_field_type */
    foreach ($this
      ->load() as $solr_field_type) {
      if (!$solr_field_type
        ->isManagedSchema()) {
        $xml .= "\n{$indentation}" . str_replace("\n", "\n{$indentation}", $solr_field_type
          ->getFieldTypeAsXml());
      }
    }
    $xml .= "\n" . $this
      ->getExtraFileFoot($target_solr_version, 'types');
    return $xml;
  }

  /**
   *
   */
  public function getSchemaExtraFieldsXml() {
    return $this
      ->getPlainTextRenderArray($this
      ->generateSchemaExtraFieldsXml());
  }

  /**
   *
   */
  protected function generateSchemaExtraFieldsXml() {
    $target_solr_version = $this
      ->getBackend()
      ->getSolrConnector()
      ->getSolrVersion();
    $xml = $this
      ->getExtraFileHead($target_solr_version, 'fields');
    $indentation = '  ';
    if (version_compare($target_solr_version, '6.0.0', '>=')) {
      $indentation .= '  ';
    }

    /** @var \Drupal\search_api_solr_multilingual\SolrFieldTypeInterface $solr_field_type */
    foreach ($this
      ->load() as $solr_field_type) {
      if (!$solr_field_type
        ->isManagedSchema()) {
        foreach ($solr_field_type
          ->getDynamicFields() as $dynamic_field) {
          $xml .= $indentation . '<dynamicField ';
          foreach ($dynamic_field as $attribute => $value) {
            $xml .= $attribute . '="' . (is_bool($value) ? $value ? 'true' : 'false' : $value) . '" ';
          }
          $xml .= "/>\n";
        }
        if (version_compare($target_solr_version, '6.0.0', '>=')) {

          // On Solr 6 we're not in that "legacy mode" and inside an fields tag.
          foreach ($solr_field_type
            ->getCopyFields() as $copy_field) {
            $xml .= $indentation . '<copyField ';
            foreach ($copy_field as $attribute => $value) {
              $xml .= $attribute . '="' . (is_bool($value) ? $value ? 'true' : 'false' : $value) . '" ';
            }
            $xml .= "/>\n";
          }
        }
      }
    }
    $xml .= $this
      ->getExtraFileFoot($target_solr_version, 'fields');
    return $xml;
  }

  /**
   *
   */
  protected function getPlainTextRenderArray($plain_text) {
    return [
      'file' => [
        '#plain_text' => $plain_text,
        '#cache' => [
          'contexts' => $this->entityType
            ->getListCacheContexts(),
          'tags' => $this->entityType
            ->getListCacheTags(),
        ],
      ],
    ];
  }

  /**
   * Creates the head part of an extra file XML (not wellformed on its own).
   *
   * @param $target_solr_version
   *   string The version string of the Solr version to
   *   create the file for.
   * @param $legacy_element
   *   string The XML element to use as a wrapper for versions of
   *   Solr below 6.0.0.
   *
   * @return string The created fragment.
   */
  protected function getExtraFileHead($target_solr_version, $legacy_element) {
    $head = '';
    if (version_compare($target_solr_version, '6.0.0', '<')) {
      $head = <<<'EOD'
<?xml version="1.0" encoding="UTF-8" ?>
EOD;
      $head .= "\n\n";
      $head .= "<{$legacy_element}>\n";
    }
    return $head;
  }

  /**
   * Creates the foot part of an extra file XML (not wellformed on its own).
   *
   * @param $target_solr_version
   *   string The version string of the Solr version to
   *   create the file for.
   * @param $legacy_element
   *   string The XML element to use as a wrapper for versions of
   *   Solr below 6.0.0.
   *
   * @return string The created fragment.
   */
  protected function getExtraFileFoot($target_solr_version, $legacy_element) {
    $foot = '';
    if (version_compare($target_solr_version, '6.0.0', '<')) {
      $foot .= "</{$legacy_element}>";
    }
    return $foot;
  }

  /**
   * @return \ZipStream\ZipStream
   */
  public function getConfigZip() {
    $solr_field_types = $this
      ->load();

    /** @var \Drupal\search_api_solr\SolrBackendInterface $backend */
    $backend = $this
      ->getBackend();
    $connector = $backend
      ->getSolrConnector();
    $solr_branch = $connector
      ->getSolrBranch($this->assumed_minimum_version);
    $search_api_solr_conf_path = drupal_get_path('module', 'search_api_solr') . '/solr-conf/' . $solr_branch;
    $solrcore_properties = parse_ini_file($search_api_solr_conf_path . '/solrcore.properties', FALSE, INI_SCANNER_RAW);
    $schema = file_get_contents($search_api_solr_conf_path . '/schema.xml');
    $schema = preg_replace('@<fieldType name="text_und".*?</fieldType>@ms', '<!-- fieldType text_und is moved to schema_extra_types.xml by Search API Multilingual Solr -->', $schema);
    $schema = preg_replace('@<dynamicField name="([^"]*)".*?type="text_und".*?/>@', "<!-- dynamicField \$1 is moved to schema_extra_fields.xml by Search API Multilingual Solr -->", $schema);
    $zip = new ZipStream('solr_' . $solr_branch . '_config.zip');
    $zip
      ->addFile('schema.xml', $schema);
    $zip
      ->addFile('schema_extra_types.xml', $this
      ->generateSchemaExtraTypesXml());
    $zip
      ->addFile('schema_extra_fields.xml', $this
      ->generateSchemaExtraFieldsXml());

    // Add language specific text files.

    /** @var \Drupal\search_api_solr_multilingual\SolrFieldTypeInterface $solr_field_type */
    foreach ($solr_field_types as $solr_field_type) {
      $text_files = $solr_field_type
        ->getTextFiles();
      foreach ($text_files as $text_file_name => $text_file) {
        $language_specific_text_file_name = $text_file_name . '_' . $solr_field_type
          ->getFieldTypeLanguageCode() . '.txt';
        $zip
          ->addFile($language_specific_text_file_name, $text_file);
        $solrcore_properties['solr.replication.confFiles'] .= ',' . $language_specific_text_file_name;
      }
    }
    $solrcore_properties['solr.luceneMatchVersion'] = $connector
      ->getLuceneMatchVersion($this->assumed_minimum_version ?: '');

    // @todo
    // $solrcore_properties['solr.replication.masterUrl']
    $solrcore_properties_string = '';
    foreach ($solrcore_properties as $property => $value) {
      $solrcore_properties_string .= $property . '=' . $value . "\n";
    }
    $zip
      ->addFile('solrcore.properties', $solrcore_properties_string);

    // @todo provide a hook to add more things.
    // Now add all remaining static files from the conf dir that have not been
    // generated dynamically above.
    foreach (scandir($search_api_solr_conf_path) as $file) {
      if (strpos($file, '.') !== 0) {
        foreach ($zip->files as $zipped_file) {

          /* @see \ZipStream\ZipStream::addToCdr() */
          if ($file == $zipped_file[0]) {
            continue 2;
          }
        }
        $zip
          ->addFileFromPath($file, $search_api_solr_conf_path . '/' . $file);
      }
    }
    return $zip;
  }

  /**
   *
   */
  public function setServer(ServerInterface $server) {
    $this->backend = $server
      ->getBackend();
  }

  /**
   * @return \Drupal\search_api_solr_multilingual\SolrMultilingualBackendInterface
   */
  protected function getBackend() {
    return $this->backend;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
DependencySerializationTrait::$_entityStorages protected property An array of entity type IDs keyed by the property name of their storages.
DependencySerializationTrait::$_serviceIds protected property An array of service IDs keyed by property name used for serialization.
DependencySerializationTrait::__sleep public function 1
DependencySerializationTrait::__wakeup public function 2
EntityHandlerBase::$moduleHandler protected property The module handler to invoke hooks on. 2
EntityHandlerBase::moduleHandler protected function Gets the module handler. 2
EntityHandlerBase::setModuleHandler public function Sets the module handler for this handler.
EntityListBuilder::$entityType protected property Information about the entity type.
EntityListBuilder::$entityTypeId protected property The entity type ID.
EntityListBuilder::$limit protected property The number of entities to list per page, or FALSE to list all entities. 3
EntityListBuilder::$storage protected property The entity storage class. 1
EntityListBuilder::buildOperations public function Builds a renderable list of operation links for the entity. 2
EntityListBuilder::createInstance public static function Instantiates a new instance of this entity handler. Overrides EntityHandlerInterface::createInstance 20
EntityListBuilder::ensureDestination protected function Ensures that a destination is present on the given URL.
EntityListBuilder::getEntityIds protected function Loads entity IDs using a pager sorted by the entity id. 4
EntityListBuilder::getLabel Deprecated protected function Gets the label of an entity.
EntityListBuilder::getOperations public function Provides an array of information to build a list of operation links. Overrides EntityListBuilderInterface::getOperations 2
EntityListBuilder::getStorage public function Gets the entity storage. Overrides EntityListBuilderInterface::getStorage
EntityListBuilder::getTitle protected function Gets the title of the page. 1
EntityListBuilder::render public function Builds the entity listing as renderable array for table.html.twig. Overrides EntityListBuilderInterface::render 16
EntityListBuilder::__construct public function Constructs a new EntityListBuilder object. 16
MessengerTrait::$messenger protected property The messenger. 29
MessengerTrait::messenger public function Gets the messenger. 29
MessengerTrait::setMessenger public function Sets the messenger.
RedirectDestinationTrait::$redirectDestination protected property The redirect destination service. 1
RedirectDestinationTrait::getDestinationArray protected function Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url.
RedirectDestinationTrait::getRedirectDestination protected function Returns the redirect destination service.
RedirectDestinationTrait::setRedirectDestination public function Sets the redirect destination service.
SolrFieldTypeListBuilder::$assumed_minimum_version protected property A Solr version string.
SolrFieldTypeListBuilder::$backend protected property
SolrFieldTypeListBuilder::buildHeader public function Builds the header row for the entity listing. Overrides EntityListBuilder::buildHeader
SolrFieldTypeListBuilder::buildRow public function Builds a row for an entity in the entity listing. Overrides EntityListBuilder::buildRow
SolrFieldTypeListBuilder::generateSchemaExtraFieldsXml protected function
SolrFieldTypeListBuilder::generateSchemaExtraTypesXml protected function
SolrFieldTypeListBuilder::getBackend protected function
SolrFieldTypeListBuilder::getConfigZip public function
SolrFieldTypeListBuilder::getDefaultOperations public function @inheritdoc Overrides ConfigEntityListBuilder::getDefaultOperations
SolrFieldTypeListBuilder::getExtraFileFoot protected function Creates the foot part of an extra file XML (not wellformed on its own).
SolrFieldTypeListBuilder::getExtraFileHead protected function Creates the head part of an extra file XML (not wellformed on its own).
SolrFieldTypeListBuilder::getPlainTextRenderArray protected function
SolrFieldTypeListBuilder::getSchemaExtraFieldsXml public function
SolrFieldTypeListBuilder::getSchemaExtraTypesXml public function
SolrFieldTypeListBuilder::load public function Loads entities of this type from storage for listing. Overrides ConfigEntityListBuilder::load
SolrFieldTypeListBuilder::setServer public function
StringTranslationTrait::$stringTranslation protected property The string translation service. 1
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.