THRIFT-952. TBinarySerializer utility class for converting between byte strings and PHP objects
Adds a nice TBinarySerializer class to make it simple to convert between PHP objects and serialized strings using the Binary protocol.
Patch: Radu Marin
git-svn-id: https://svn.apache.org/repos/asf/incubator/thrift/trunk@1021521 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/lib/php/Makefile.am b/lib/php/Makefile.am
index 8067e65..07242f9 100644
--- a/lib/php/Makefile.am
+++ b/lib/php/Makefile.am
@@ -37,6 +37,7 @@
phpprotocoldir = $(phpdir)/protocol
phpprotocol_DATA = \
src/protocol/TBinaryProtocol.php \
+ src/protocol/TBinarySerializer.php \
src/protocol/TProtocol.php
phptransportdir = $(phpdir)/transport
diff --git a/lib/php/src/protocol/TBinarySerializer.php b/lib/php/src/protocol/TBinarySerializer.php
new file mode 100644
index 0000000..2913d32
--- /dev/null
+++ b/lib/php/src/protocol/TBinarySerializer.php
@@ -0,0 +1,69 @@
+<?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.protocol
+ * @author: rmarin (marin.radu@facebook.com)
+ */
+
+require_once $GLOBALS['THRIFT_ROOT'].'/transport/TMemoryBuffer.php';
+require_once $GLOBALS['THRIFT_ROOT'].'/protocol/TBinaryProtocol.php';
+
+/**
+ * Utility class for serializing and deserializing
+ * a thrift object using TBinaryProtocolAccelerated.
+ */
+class TBinarySerializer {
+
+ // NOTE(rmarin): Because thrift_protocol_write_binary
+ // adds a begin message prefix, you cannot specify
+ // a transport in which to serialize an object. It has to
+ // be a string. Otherwise we will break the compatibility with
+ // normal deserialization.
+ public static function serialize($object) {
+ $transport = new TMemoryBuffer();
+ $protocol = new TBinaryProtocolAccelerated($transport);
+ if (function_exists('thrift_protocol_write_binary')) {
+ thrift_protocol_write_binary($protocol, $object->getName(),
+ TMessageType::REPLY, $object,
+ 0, $protocol->isStrictWrite());
+
+ $protocol->readMessageBegin($unused_name, $unused_type,
+ $unused_seqid);
+ } else {
+ $object->write($protocol);
+ }
+ return $transport->getBuffer();
+ }
+
+ public static function deserialize($string_object, $class_name) {
+ $transport = new TMemoryBuffer();
+ $protocol = new TBinaryProtocolAccelerated($transport);
+ if (function_exists('thrift_protocol_read_binary')) {
+ $protocol->writeMessageBegin('', TMessageType::REPLY, 0);
+ $transport->write($string_object);
+ return thrift_protocol_read_binary($protocol, $class_name,
+ $protocol->isStrictRead());
+ } else {
+ $transport->write($string_object);
+ $object = new $class_name();
+ $object->read($protocol);
+ return $object;
+ }
+ }
+}