/tags/release-0.1-rc2/hive/external/service/lib/php/transport/TFramedTransport.php
PHP | 179 lines | 70 code | 24 blank | 85 comment | 9 complexity | 33eb9d9257e018bc321a941070a7bb42 MD5 | raw file
Possible License(s): Apache-2.0, BSD-3-Clause, JSON, CPL-1.0
- <?php
- /*
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements. See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership. The ASF licenses this file
- * to you 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.
- *
- * @package thrift.transport
- */
- /**
- * Framed transport. Writes and reads data in chunks that are stamped with
- * their length.
- *
- * @package thrift.transport
- */
- class TFramedTransport extends TTransport {
- /**
- * Underlying transport object.
- *
- * @var TTransport
- */
- private $transport_;
- /**
- * Buffer for read data.
- *
- * @var string
- */
- private $rBuf_;
- /**
- * Buffer for queued output data
- *
- * @var string
- */
- private $wBuf_;
- /**
- * Whether to frame reads
- *
- * @var bool
- */
- private $read_;
- /**
- * Whether to frame writes
- *
- * @var bool
- */
- private $write_;
- /**
- * Constructor.
- *
- * @param TTransport $transport Underlying transport
- */
- public function __construct($transport=null, $read=true, $write=true) {
- $this->transport_ = $transport;
- $this->read_ = $read;
- $this->write_ = $write;
- }
- public function isOpen() {
- return $this->transport_->isOpen();
- }
- public function open() {
- $this->transport_->open();
- }
- public function close() {
- $this->transport_->close();
- }
- /**
- * Reads from the buffer. When more data is required reads another entire
- * chunk and serves future reads out of that.
- *
- * @param int $len How much data
- */
- public function read($len) {
- if (!$this->read_) {
- return $this->transport_->read($len);
- }
- if (strlen($this->rBuf_) === 0) {
- $this->readFrame();
- }
- // Just return full buff
- if ($len >= strlen($this->rBuf_)) {
- $out = $this->rBuf_;
- $this->rBuf_ = null;
- return $out;
- }
- // Return substr
- $out = substr($this->rBuf_, 0, $len);
- $this->rBuf_ = substr($this->rBuf_, $len);
- return $out;
- }
- /**
- * Put previously read data back into the buffer
- *
- * @param string $data data to return
- */
- public function putBack($data) {
- if (strlen($this->rBuf_) === 0) {
- $this->rBuf_ = $data;
- } else {
- $this->rBuf_ = ($data . $this->rBuf_);
- }
- }
- /**
- * Reads a chunk of data into the internal read buffer.
- */
- private function readFrame() {
- $buf = $this->transport_->readAll(4);
- $val = unpack('N', $buf);
- $sz = $val[1];
- $this->rBuf_ = $this->transport_->readAll($sz);
- }
- /**
- * Writes some data to the pending output buffer.
- *
- * @param string $buf The data
- * @param int $len Limit of bytes to write
- */
- public function write($buf, $len=null) {
- if (!$this->write_) {
- return $this->transport_->write($buf, $len);
- }
- if ($len !== null && $len < strlen($buf)) {
- $buf = substr($buf, 0, $len);
- }
- $this->wBuf_ .= $buf;
- }
- /**
- * Writes the output buffer to the stream in the format of a 4-byte length
- * followed by the actual data.
- */
- public function flush() {
- if (!$this->write_) {
- return $this->transport_->flush();
- }
- $out = pack('N', strlen($this->wBuf_));
- $out .= $this->wBuf_;
- // Note that we clear the internal wBuf_ prior to the underlying write
- // to ensure we're in a sane state (i.e. internal buffer cleaned)
- // if the underlying write throws up an exception
- $this->wBuf_ = '';
- $this->transport_->write($out);
- $this->transport_->flush();
- }
- }