PHP Classes

File: example/GoogleClient/service/Google_ServiceResource.php

Recommend this page to a friend!
  Classes of Vivek Muthal   Viv OAuth IMAP   example/GoogleClient/service/Google_ServiceResource.php   Download  
File: example/GoogleClient/service/Google_ServiceResource.php
Role: Example script
Content type: text/plain
Description: Example script
Class: Viv OAuth IMAP
Access messages in IMAP server using OAuth token
Author: By
Last change: Update of example/GoogleClient/service/Google_ServiceResource.php
Date: 9 months ago
Size: 7,566 bytes
 

Contents

Class file image Download
<?php
/**
 * Copyright 2010 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * Implements the actual methods/resources of the discovered Google API using magic function
 * calling overloading (__call()), which on call will see if the method name (plus.activities.list)
 * is available in this service, and if so construct an apiHttpRequest representing it.
 *
 * @author Chris Chabot <chabotc@google.com>
 * @author Chirag Shah <chirags@google.com>
 *
 */
class Google_ServiceResource {
 
// Valid query parameters that work, but don't appear in discovery.
 
private $stackParameters = array(
     
'alt' => array('type' => 'string', 'location' => 'query'),
     
'boundary' => array('type' => 'string', 'location' => 'query'),
     
'fields' => array('type' => 'string', 'location' => 'query'),
     
'trace' => array('type' => 'string', 'location' => 'query'),
     
'userIp' => array('type' => 'string', 'location' => 'query'),
     
'userip' => array('type' => 'string', 'location' => 'query'),
     
'quotaUser' => array('type' => 'string', 'location' => 'query'),
     
'file' => array('type' => 'complex', 'location' => 'body'),
     
'data' => array('type' => 'string', 'location' => 'body'),
     
'mimeType' => array('type' => 'string', 'location' => 'header'),
     
'uploadType' => array('type' => 'string', 'location' => 'query'),
     
'mediaUpload' => array('type' => 'complex', 'location' => 'query'),
  );

 
/** @var Google_Service $service */
 
private $service;

 
/** @var string $serviceName */
 
private $serviceName;

 
/** @var string $resourceName */
 
private $resourceName;

 
/** @var array $methods */
 
private $methods;

  public function
__construct($service, $serviceName, $resourceName, $resource) {
   
$this->service = $service;
   
$this->serviceName = $serviceName;
   
$this->resourceName = $resourceName;
   
$this->methods = isset($resource['methods']) ? $resource['methods'] : array($resourceName => $resource);
  }

 
/**
   * @param $name
   * @param $arguments
   * @return Google_HttpRequest|array
   * @throws Google_Exception
   */
 
public function __call($name, $arguments) {
    if (! isset(
$this->methods[$name])) {
      throw new
Google_Exception("Unknown function: {$this->serviceName}->{$this->resourceName}->{$name}()");
    }
   
$method = $this->methods[$name];
   
$parameters = $arguments[0];

   
// postBody is a special case since it's not defined in the discovery document as parameter, but we abuse the param entry for storing it
   
$postBody = null;
    if (isset(
$parameters['postBody'])) {
      if (
is_object($parameters['postBody'])) {
       
$this->stripNull($parameters['postBody']);
      }

     
// Some APIs require the postBody to be set under the data key.
     
if (is_array($parameters['postBody']) && 'latitude' == $this->serviceName) {
        if (!isset(
$parameters['postBody']['data'])) {
         
$rawBody = $parameters['postBody'];
          unset(
$parameters['postBody']);
         
$parameters['postBody']['data'] = $rawBody;
        }
      }

     
$postBody = is_array($parameters['postBody']) || is_object($parameters['postBody'])
          ?
json_encode($parameters['postBody'])
          :
$parameters['postBody'];
      unset(
$parameters['postBody']);

      if (isset(
$parameters['optParams'])) {
       
$optParams = $parameters['optParams'];
        unset(
$parameters['optParams']);
       
$parameters = array_merge($parameters, $optParams);
      }
    }

    if (!isset(
$method['parameters'])) {
     
$method['parameters'] = array();
    }
   
   
$method['parameters'] = array_merge($method['parameters'], $this->stackParameters);
    foreach (
$parameters as $key => $val) {
      if (
$key != 'postBody' && ! isset($method['parameters'][$key])) {
        throw new
Google_Exception("($name) unknown parameter: '$key'");
      }
    }
    if (isset(
$method['parameters'])) {
      foreach (
$method['parameters'] as $paramName => $paramSpec) {
        if (isset(
$paramSpec['required']) && $paramSpec['required'] && ! isset($parameters[$paramName])) {
          throw new
Google_Exception("($name) missing required param: '$paramName'");
        }
        if (isset(
$parameters[$paramName])) {
         
$value = $parameters[$paramName];
         
$parameters[$paramName] = $paramSpec;
         
$parameters[$paramName]['value'] = $value;
          unset(
$parameters[$paramName]['required']);
        } else {
          unset(
$parameters[$paramName]);
        }
      }
    }

   
// Discovery v1.0 puts the canonical method id under the 'id' field.
   
if (! isset($method['id'])) {
     
$method['id'] = $method['rpcMethod'];
    }

   
// Discovery v1.0 puts the canonical path under the 'path' field.
   
if (! isset($method['path'])) {
     
$method['path'] = $method['restPath'];
    }

   
$servicePath = $this->service->servicePath;

   
// Process Media Request
   
$contentType = false;
    if (isset(
$method['mediaUpload'])) {
     
$media = Google_MediaFileUpload::process($postBody, $parameters);
      if (
$media) {
       
$contentType = isset($media['content-type']) ? $media['content-type']: null;
       
$postBody = isset($media['postBody']) ? $media['postBody'] : null;
       
$servicePath = $method['mediaUpload']['protocols']['simple']['path'];
       
$method['path'] = '';
      }
    }

   
$url = Google_REST::createRequestUri($servicePath, $method['path'], $parameters);
   
$httpRequest = new Google_HttpRequest($url, $method['httpMethod'], null, $postBody);
    if (
$postBody) {
     
$contentTypeHeader = array();
      if (isset(
$contentType) && $contentType) {
       
$contentTypeHeader['content-type'] = $contentType;
      } else {
       
$contentTypeHeader['content-type'] = 'application/json; charset=UTF-8';
       
$contentTypeHeader['content-length'] = Google_Utils::getStrLen($postBody);
      }
     
$httpRequest->setRequestHeaders($contentTypeHeader);
    }

   
$httpRequest = Google_Client::$auth->sign($httpRequest);
    if (
Google_Client::$useBatch) {
      return
$httpRequest;
    }

   
// Terminate immediately if this is a resumable request.
   
if (isset($parameters['uploadType']['value'])
        &&
Google_MediaFileUpload::UPLOAD_RESUMABLE_TYPE == $parameters['uploadType']['value']) {
     
$contentTypeHeader = array();
      if (isset(
$contentType) && $contentType) {
       
$contentTypeHeader['content-type'] = $contentType;
      }
     
$httpRequest->setRequestHeaders($contentTypeHeader);
      if (
$postBody) {
       
$httpRequest->setPostBody($postBody);
      }
      return
$httpRequest;
    }

    return
Google_REST::execute($httpRequest);
  }

  public function
useObjects() {
    global
$apiConfig;
    return (isset(
$apiConfig['use_objects']) && $apiConfig['use_objects']);
  }

  protected function
stripNull(&$o) {
   
$o = (array) $o;
    foreach (
$o as $k => $v) {
      if (
$v === null || strstr($k, "\0*\0__")) {
        unset(
$o[$k]);
      }
      elseif (
is_object($v) || is_array($v)) {
       
$this->stripNull($o[$k]);
      }
    }
  }
}