tripal_ws_brapi.module

<?php
/**
 * @file
 * The main functionality of this module.
 */

$dir_class = 'class/';
$module = 'tripal_ws_brapi';

// Include helper functions.
module_load_include('inc', 'tripal_ws_brapi', 'includes/api');

// Include helper classes.
// Class to identify resource from a url.
module_load_include('inc', $module, $dir_class . 'helper class/TripalWebServiceResourceIdentifier');
// Class handle response result.
module_load_include('inc', $module, $dir_class . 'helper class/TripalWebServiceResponse');

// Include base classes.
// Base call/request class.
module_load_include('inc', $module, $dir_class . 'TripalWebServiceCall');
// Class for custom calls (non database).
module_load_include('inc', $module, $dir_class . 'TripalWebServiceCustomCall');
// Class for db calls (database).
module_load_include('inc', $module, $dir_class . 'TripalWebServiceDatabaseCall');
// Class for search calls (database).
module_load_include('inc', $module, $dir_class . 'TripalWebServiceSearchCall');

/**
 * Implements hook_menu().
 */
function tripal_ws_brapi_menu() {
  $items = [];
  $module = tripal_ws_get_module_info();

  // To add level to menu location, ie. host/[web-services/another-level]/brapi or
  // set value to blank to set menu level directly to host/brapi/.
  // @see configuration page.
  $menu_level = variable_get($module['module'] . '_menu_level');
  $base_menu_location = ($menu_level == '') ? 'brapi' : trim($menu_level) . '/brapi';

  $items[ $base_menu_location ] = [
    'title' => 'Tripal Web Services API',
    'page callback' => 'tripal_ws_vocabulary_handle_request',
    'access arguments' => ['access content'],
    'type' => MENU_CALLBACK,
  ];

  //////////////////////////////////////////////////////////////////////////

  // Configuration pages:
  $path_tripal_extension = 'admin/tripal/extension/tripalwsbrapi';

  // Configuration page. List all calls.
  $items[ $path_tripal_extension . '/configure' ] = [
    'title' => 'Tripal Web Service - BrAPI',
    'description' => t('Interface to configure calls'),
    'page callback' => 'drupal_get_form',
    'page arguments' => ['tripal_ws_configure'],
    'access arguments' => ['access administration pages'],
    'file' => 'includes/forms/configuration.form.inc',
    'type' => MENU_NORMAL_ITEM,
  ];

    // General module configuration.
    $items[ $path_tripal_extension . '/configure/module' ] = [
      'title' => 'Configure Tripal Web Service - BrAPI',
      'description' => t('Interface to configure calls'),
      'page callback' => 'drupal_get_form',
      'page arguments' => ['tripal_ws_configure_module', 3],
      'access arguments' => ['access administration pages'],
      'file' => 'includes/forms/configuration.form.inc',
      'type' => MENU_LOCAL_TASK,
      'weight' => 1,
    ];

    // Configure version.
    $items[ $path_tripal_extension . '/configure/version' ] = [
      'title' => 'BrAPI Version',
      'description' => t('Interface to configure version'),
      'page callback' => 'drupal_get_form',
      'page arguments' => ['tripal_ws_configure_version'],
      'access arguments' => ['access administration pages'],
      'file' => 'includes/forms/configuration.form.inc',
      'type' => MENU_LOCAL_TASK,
      'weight' => 2,
    ];

    // Configure a call.
    $items[ $path_tripal_extension . '/configure/call' ] = [
      'title' => 'BrAPI Calls',
      'description' => t('Interface to configure calls'),
      'page callback' => 'drupal_get_form',
      'page arguments' => ['tripal_ws_configure_call'],
      'access arguments' => ['access administration pages'],
      'file' => 'includes/forms/configuration.form.inc',
      'type' => MENU_LOCAL_TASK,
      'weight' => 3,
    ];

    // Manage search request
    $items[ $path_tripal_extension . '/configure/search' ] = [
      'title' => 'Search Request Log',
      'description' => t('Interface to manage search request'),
      'page callback' => 'drupal_get_form',
      'page arguments' => ['tripal_ws_manage_search'],
      'access arguments' => ['access administration pages'],
      'file' => 'includes/forms/configuration.form.inc',
      'type' => MENU_LOCAL_TASK,
      'weight' => 4,
    ];

  return $items;
}


/**
 * Function callback (page callback), begin processing call request.
 */
if (!function_exists('tripal_ws_vocabulary_handle_request')) {
  function tripal_ws_vocabulary_handle_request() {
    // Identify all resources required.
    $resource = new TripalWebserviceResourceIdentifier();
    $call_asset = get_object_vars($resource);
    // Call asset data stucture.
    // @see class/helper class/TripalWebServiceResourceIdentifier.

    /*
    // DEBUG.
    print '<pre>';
    print_r($call_asset);
    print '</pre>';
    */

    // Load call class file.
    $call = tripal_ws_load_call($call_asset);

    // Response.
    if (class_exists($call)) {
      $response = new $call($call_asset);
      $response->prepareResponse();
    }
  }
}