i3Soft\CDA\DataType\Name\PersonName

Complexity

Total Complexity

10

Size/Duplication

Total Lines	85
Duplicated Lines	0 %

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	addPart()	0	8	2
A	setValueToElement()	0	29	6
A	__construct()	0	6	1
A	resetNameTuples()	0	3	1

<?php

/**
 * The MIT License
 *
 * Copyright 2016 Julien Fastré <julien.fastre@champs-libres.coop>.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

namespace i3Soft\CDA\DataType\Name;

use i3Soft\CDA\ClinicalDocument as CDA;
use i3Soft\CDA\Interfaces\UseAttributeInterface;

/**
 * @author Julien Fastré <julien.fastre@champs-libres.coop>
 */
class PersonName extends EntityName
{

  const HONORIFIC      = 'prefix';
  const FIRST_NAME     = 'given';
  const LAST_NAME      = 'family';
  const SUFFIX         = 'suffix';
  const possible_parts = [
    self::HONORIFIC,
    self::FIRST_NAME,
    self::LAST_NAME,
    self::SUFFIX
  ];
  protected $name_tuples = array();  // tuples is an array of addPart values.

  /**
   * PersonName constructor.
   */
  public function __construct ()
  {
    parent::__construct(NULL);
    $this->name_tuples =[];
    // use name attributes must conform to: AS 5017-2006: Health Care Client Name Usage
    $this->acceptable_use_attributes = UseAttributeInterface::NameValues;
  }

  /**
   * @param      $part
   * @param      $value
   * @param null $qualifier

Are you sure the doc-type for parameter $qualifier is correct as it would always require null to be passed?

   *
   * @return self
   */
  public function addPart ($part, $value, $qualifier = NULL): self
  {
    if (\in_array($part, self::possible_parts, TRUE) === FALSE)
    {
      return $this;
    }
    $this->name_tuples[] = ['part' => $part, 'value' => $value, 'qualifier' => $qualifier];
    return $this;
  }

  /**
   * @param \DOMElement       $el
   * @param \DOMDocument|NULL $doc
   */
  public function setValueToElement (\DOMElement $el, \DOMDocument $doc)
  {
    if (\count($this->name_tuples) > 0)
    {
      $name = $doc->createElement(CDA::NS_CDA . 'name');
      if (FALSE === empty($this->getUseAttribute()))
      {
        $name->setAttribute(CDA::NS_CDA . 'use', $this->getUseAttribute());
      }
      $el->appendChild($name);
      foreach ($this->name_tuples as $tuple)
      {
        $partElement = $doc->createElement(CDA::NS_CDA . $tuple['part'], $tuple['value']);
        if ($tuple['qualifier'])
        {
          $partElement->setAttribute('qualifier', $tuple['qualifier']);
        }
        $name->appendChild($partElement);
      }
      return;
    }

    if ($this->string !== NULL)
    {
      parent::setValueToElement($el, $doc);
    }
    else
    {
      throw new \InvalidArgumentException('the element does not contains any parts nor string');
    }
  }

  /**
   * @return PersonName
   */
  public function resetNameTuples ():self
  {
    $this->name_tuples = [];
  }


}