xmlrpc_example.test in Examples for Developers 7

Test case for the XML-RPC example module.

File

xmlrpc_example/xmlrpc_example.test

<?php

/**
 * @file
 * Test case for the XML-RPC example module.
 */

/**
 * Functional tests for the XMLRPC Example module.
 *
 * @ingroup xmlrpc_example
 */
class XmlrpcExampleTestCase extends DrupalWebTestCase {
  protected $xmlRpcUrl;

  /**
   * {@inheritdoc}
   */
  public static function getInfo() {
    return array(
      'name' => 'XMLRPC example functionality',
      'description' => 'Test xmlrpc service implementation.',
      'group' => 'Examples',
    );
  }

  /**
   * Enable module.
   */
  public function setUp() {
    parent::setUp('xmlrpc_example');

    // Init common variables.
    global $base_url;
    $this->xmlRpcUrl = url($GLOBALS['base_url'] . '/xmlrpc.php', array(
      'external' => TRUE,
    ));
  }

  /**
   * Perform several calls to the XML-RPC interface to test the services.
   */
  public function testXmlrpcExampleBasic() {

    // Unit test functionality.
    $result = xmlrpc($this->xmlRpcUrl, array(
      'xmlrpc_example.add' => array(
        3,
        4,
      ),
    ));
    $this
      ->assertEqual($result, 7, 'Successfully added 3+4 = 7');
    $result = xmlrpc($this->xmlRpcUrl, array(
      'xmlrpc_example.subtract' => array(
        4,
        3,
      ),
    ));
    $this
      ->assertEqual($result, 1, 'Successfully subtracted 4-3 = 1');

    // Make a multicall request.
    $options = array(
      'xmlrpc_example.add' => array(
        5,
        2,
      ),
      'xmlrpc_example.subtract' => array(
        5,
        2,
      ),
    );
    $expected = array(
      7,
      3,
    );
    $result = xmlrpc($this->xmlRpcUrl, $options);
    $this
      ->assertEqual($result, $expected, 'Successfully called multicall request');

    // Verify default limits.
    $result = xmlrpc($this->xmlRpcUrl, array(
      'xmlrpc_example.subtract' => array(
        3,
        4,
      ),
    ));
    $this
      ->assertEqual(xmlrpc_errno(), 10002, 'Results below minimum return custom error: 10002');
    $result = xmlrpc($this->xmlRpcUrl, array(
      'xmlrpc_example.add' => array(
        7,
        4,
      ),
    ));
    $this
      ->assertEqual(xmlrpc_errno(), 10001, 'Results beyond maximum return custom error: 10001');
  }

  /**
   * Perform several calls using XML-RPC web client.
   */
  public function testXmlrpcExampleClient() {

    // Now test the UI.
    // Add the integers.
    $edit = array(
      'num1' => 3,
      'num2' => 5,
    );
    $this
      ->drupalPost('examples/xmlrpc/client', $edit, t('Add the integers'));
    $this
      ->assertText(t('The XML-RPC server returned this response: @num', array(
      '@num' => 8,
    )));

    // Subtract the integers.
    $edit = array(
      'num1' => 8,
      'num2' => 3,
    );
    $result = $this
      ->drupalPost('examples/xmlrpc/client', $edit, t('Subtract the integers'));
    $this
      ->assertText(t('The XML-RPC server returned this response: @num', array(
      '@num' => 5,
    )));

    // Request available methods.
    $this
      ->drupalPost('examples/xmlrpc/client', $edit, t('Request methods'));
    $this
      ->assertText('xmlrpc_example.add', 'The XML-RPC Add method was found.');
    $this
      ->assertText('xmlrpc_example.subtract', 'The XML-RPC Subtract method was found.');

    // Before testing multicall, verify that method exists.
    $this
      ->assertText('system.multicall', 'The XML-RPC Multicall method was found.');

    // Verify multicall request.
    $edit = array(
      'num1' => 5,
      'num2' => 2,
    );
    $this
      ->drupalPost('examples/xmlrpc/client', $edit, t('Add and Subtract'));
    $this
      ->assertText('[0] =&gt; 7', 'The XML-RPC server returned the addition result.');
    $this
      ->assertText('[1] =&gt; 3', 'The XML-RPC server returned the subtraction result.');
  }

  /**
   * Perform several XML-RPC requests with different server settings.
   */
  public function testXmlrpcExampleServer() {

    // Set different minimum and maxmimum valuesI.
    $options = array(
      'xmlrpc_example_server_min' => 3,
      'xmlrpc_example_server_max' => 7,
    );
    $this
      ->drupalPost('examples/xmlrpc/server', $options, t('Save configuration'));
    $this
      ->assertText(t('The configuration options have been saved'), 'Results limited to >= 3 and <= 7');
    $edit = array(
      'num1' => 8,
      'num2' => 3,
    );
    $this
      ->drupalPost('examples/xmlrpc/client', $edit, t('Subtract the integers'));
    $this
      ->assertText(t('The XML-RPC server returned this response: @num', array(
      '@num' => 5,
    )));
    $result = xmlrpc($this->xmlRpcUrl, array(
      'xmlrpc_example.add' => array(
        3,
        4,
      ),
    ));
    $this
      ->assertEqual($result, 7, 'Successfully added 3+4 = 7');
    $result = xmlrpc($this->xmlRpcUrl, array(
      'xmlrpc_example.subtract' => array(
        4,
        3,
      ),
    ));
    $this
      ->assertEqual(xmlrpc_errno(), 10002, 'subtracting 4-3 = 1 returns custom error: 10002');
    $result = xmlrpc($this->xmlRpcUrl, array(
      'xmlrpc_example.add' => array(
        7,
        4,
      ),
    ));
    $this
      ->assertEqual(xmlrpc_errno(), 10001, 'Adding 7 + 4 = 11 returns custom error: 10001');
  }

  /**
   * Test XML-RPC requests with hook_xmlrpc_alter() functionality.
   *
   * Perform several XML-RPC requests altering the server behaviour with
   * hook_xmlrpc_alter API.
   */
  public function testXmlrpcExampleAlter() {

    // Enable XML-RPC service altering functionality.
    $options = array(
      'xmlrpc_example_alter_enabled' => TRUE,
    );
    $this
      ->drupalPost('examples/xmlrpc/alter', $options, t('Save configuration'));
    $this
      ->assertText(t('The configuration options have been saved'), 'Results are not limited due to methods alteration');

    // After altering the functionality, the add and subtract methods have no
    // limits and should not return any error.
    $edit = array(
      'num1' => 80,
      'num2' => 3,
    );
    $this
      ->drupalPost('examples/xmlrpc/client', $edit, t('Subtract the integers'));
    $this
      ->assertText(t('The XML-RPC server returned this response: @num', array(
      '@num' => 77,
    )));
    $result = xmlrpc($this->xmlRpcUrl, array(
      'xmlrpc_example.add' => array(
        30,
        4,
      ),
    ));
    $this
      ->assertEqual($result, 34, 'Successfully added 30+4 = 34');
    $result = xmlrpc($this->xmlRpcUrl, array(
      'xmlrpc_example.subtract' => array(
        4,
        30,
      ),
    ));
    $this
      ->assertEqual($result, -26, 'Successfully subtracted 4-30 = -26');
  }

}

Classes

Name	Description
XmlrpcExampleTestCase	Functional tests for the XMLRPC Example module.