Add tizen-message-port Module 74/57074/18
authoryons.kim <yons.kim@samsung.com>
Wed, 13 Jan 2016 01:22:49 +0000 (10:22 +0900)
committeryons.kim <yons.kim@samsung.com>
Mon, 1 Feb 2016 02:13:45 +0000 (11:13 +0900)
Change-Id: Ib3eb980e65168493acffae0797879a8ada563132

modules/CMakeLists.txt
modules/tizen-message-port/CMakeLists.txt [new file with mode: 0644]
modules/tizen-message-port/message_port_extension.cc [new file with mode: 0755]
modules/tizen-message-port/message_port_extension.h [new file with mode: 0755]
modules/tizen-message-port/package.json [new file with mode: 0755]
modules/tizen-message-port/picojson.h [new file with mode: 0644]
modules/tizen-message-port/tizen-message-port_api.js [new file with mode: 0755]
packaging/jsnative.spec

index b9a7cd3..354dae9 100644 (file)
@@ -8,6 +8,6 @@ ADD_SUBDIRECTORY(tizen-app-control)
 ADD_SUBDIRECTORY(tizen-application)
 ADD_SUBDIRECTORY(tizen-application-common)
 ADD_SUBDIRECTORY(tizen-app-preference)
-
 ADD_SUBDIRECTORY(tizen-sound-manager)
 ADD_SUBDIRECTORY(tizen-notification)
+ADD_SUBDIRECTORY(tizen-message-port)
diff --git a/modules/tizen-message-port/CMakeLists.txt b/modules/tizen-message-port/CMakeLists.txt
new file mode 100644 (file)
index 0000000..88dbef5
--- /dev/null
@@ -0,0 +1,20 @@
+SET(MODULE "tizen-message-port")
+
+# Native Module
+ADD_MODULE(${MODULE} XWALK
+  JSAPI
+    tizen-message-port_api.js
+  SRCS
+    message_port_extension.cc
+  DEPENDS
+    dlog capi-message-port
+)
+
+# Copy Project
+INSTALL(FILES package.json
+  DESTINATION ${GLOBAL_NODE_MODULE_PATH}/${MODULE}
+)
+
+INSTALL(TARGETS ${MODULE}
+  DESTINATION ${GLOBAL_NODE_MODULE_PATH}/${MODULE}
+)
diff --git a/modules/tizen-message-port/message_port_extension.cc b/modules/tizen-message-port/message_port_extension.cc
new file mode 100755 (executable)
index 0000000..9b93ede
--- /dev/null
@@ -0,0 +1,258 @@
+/*
+ * Copyright (c) 2016 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ *    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.
+ */
+
+#include "message_port_extension.h"
+
+#include <dlog.h>
+#include <message_port.h>
+#include <bundle_internal.h>
+
+#include "picojson.h"
+
+#ifdef LOG_TAG
+#undef LOG_TAG
+#endif
+#define LOG_TAG "JSNative"
+
+namespace appfw {
+
+namespace {
+
+const char* STR_ERROR_NONE = "None";
+const char* STR_ERROR_INVALID_PARAMETER = "InvalidValueError";
+const char* STR_ERROR_PORT_NOT_FOUND = "NotFoundError";
+const char* STR_ERROR_MAX_EXCEEDED = "QuotaError";
+const char* STR_ERROR_RESOURCE_UNAVAILABLE = "InvalidStateError";
+const char* STR_ERROR_OUT_OF_MEMORY = "OutOfMemoryError";
+const char* STR_ERROR_IO_ERROR = "IOError";
+const char* STR_ERROR_CERTIFICATE_NOT_MATCH = "InvalidOperationError";
+
+const char* ConvertMessagePortErrorToStr(int errorCode) {
+  switch (errorCode) {
+    case MESSAGE_PORT_ERROR_NONE:
+      return STR_ERROR_NONE;
+    case MESSAGE_PORT_ERROR_INVALID_PARAMETER:
+      return STR_ERROR_INVALID_PARAMETER;
+    case MESSAGE_PORT_ERROR_PORT_NOT_FOUND:
+      return STR_ERROR_PORT_NOT_FOUND;
+    case MESSAGE_PORT_ERROR_MAX_EXCEEDED:
+      return STR_ERROR_MAX_EXCEEDED;
+    case MESSAGE_PORT_ERROR_RESOURCE_UNAVAILABLE:
+      return STR_ERROR_RESOURCE_UNAVAILABLE;
+    case MESSAGE_PORT_ERROR_OUT_OF_MEMORY:
+      return STR_ERROR_OUT_OF_MEMORY;
+    case MESSAGE_PORT_ERROR_IO_ERROR:
+      return STR_ERROR_IO_ERROR;
+    case MESSAGE_PORT_ERROR_CERTIFICATE_NOT_MATCH:
+      return STR_ERROR_CERTIFICATE_NOT_MATCH;
+    default:
+      return "Undefined";
+  }
+}
+
+picojson::value ConvertBundleToObject(bundle* message) {
+  char* json = nullptr;
+  picojson::value ret;
+
+  int err = bundle_to_json(message, &json);
+  if (err == BUNDLE_ERROR_NONE && json != nullptr) {
+    picojson::value v;
+    std::string err;
+    picojson::parse(v, json, json + strlen(json), &err);
+    if (!err.empty()) {
+      LOGE("Ignoring message. Can't parse msessage : %s", err.c_str());
+    } else {
+      ret = picojson::value(v.get<picojson::object>());
+    }
+  } else {
+    LOGE("Can't get object from bundle");
+  }
+  if (json != nullptr)
+    free(json);
+  return ret;
+}
+
+bundle* ConvertObjectToBundle(picojson::value obj) {
+  bundle* b = nullptr;
+  int ret = bundle_from_json(obj.serialize().c_str(), &b);
+  if (ret != BUNDLE_ERROR_NONE || b == nullptr) {
+    LOGE("Can't get bundle from object");
+  }
+  return b;
+}
+
+}  // namespace
+
+xwalk::XWalkExtensionInstance* MessagePortExtension::CreateInstance() {
+  return new MessagePortInstance();
+}
+
+MessagePortInstance::MessagePortInstance() {}
+
+MessagePortInstance::~MessagePortInstance() {}
+
+void MessagePortInstance::Initialize() {
+  LOGD("Created tizen-message-port instance");
+}
+
+void MessagePortInstance::HandleSyncMessage(const char* msg) {
+  picojson::value value;
+  std::string err;
+  picojson::parse(value, msg, msg + strlen(msg), &err);
+  if (!err.empty()) {
+    LOGE("Ignoring message. Can't parse msessage : %s", err.c_str());
+    return;
+  }
+  if (!value.is<picojson::object>()) {
+    LOGE("Ignoring message. It is not an object.");
+    return;
+  }
+
+  auto& request = value.get<picojson::object>();
+  auto cmd = request["cmd"].to_str();
+  auto& msgObj = request["msg"].get<picojson::object>();
+
+  if (cmd == "registerLocalPort") {
+    auto localPort = msgObj["localPort"].to_str();
+    bool trusted = msgObj["trusted"].get<bool>();
+    RegisterLocalPort(localPort, trusted);
+  } else if (cmd == "unregisterLocalPort") {
+    int localId = static_cast<int>(msgObj["localId"].get<double>());
+    bool trusted = msgObj["trusted"].get<bool>();
+    UnregisterLocalPort(localId, trusted);
+  } else if (cmd == "send") {
+    auto remoteAppId = msgObj["appId"].to_str();
+    auto remotePort = msgObj["portName"].to_str();
+    bool trusted = msgObj["trusted"].get<bool>();
+
+    bundle* b = ConvertObjectToBundle(msgObj["message"]);
+    if (b == nullptr) {
+      picojson::value::object obj;
+      obj["result"] = picojson::value("NO");
+      obj["reason"] = picojson::value("Can't get bundle from object");
+      PostMessage(picojson::value(obj).serialize().c_str());
+      return;
+    }
+
+    if (msgObj.find("localId") != msgObj.end()) {
+      int localId = static_cast<int>(msgObj["localId"].get<double>());
+      SendMessageWithLocalPort(remoteAppId, remotePort, b, localId, trusted);
+    } else {
+      SendMessage(remoteAppId, remotePort, b, trusted);
+    }
+
+    if (b)
+      bundle_free(b);
+  } else {
+    LOGE("The cmd(%s) is not proccessed", cmd.c_str());;
+  }
+}
+
+void MessagePortInstance::FireSimpleEvent(const std::string& event,
+                                          const std::string& data) {
+  picojson::value::object obj;
+  obj["event"] = picojson::value(event);
+  if (data.length() > 0) {
+    obj["data"] = picojson::value(data);
+  }
+  PostMessage(picojson::value(obj).serialize().c_str());
+}
+
+void MessagePortInstance::RegisterLocalPort(const std::string& localPort,
+                                            bool trusted) {
+  auto receiveCb = [](int localPortId, const char* remoteAppId,
+                      const char* remotePort, bool trustedRemotePort,
+                      bundle* message, void* userData) {
+    if (!userData)
+      return;
+
+    MessagePortInstance* self =
+        reinterpret_cast<MessagePortInstance*>(userData);
+
+    bundle* messageDup = bundle_dup(message);
+
+    picojson::value::object obj;
+    obj["localId"] = picojson::value(std::to_string(localPortId));
+    obj["appId"] = picojson::value(remoteAppId);
+    if (remotePort != nullptr)
+      obj["portName"] = picojson::value(remotePort);
+    obj["trusted"] = picojson::value(trustedRemotePort);
+    obj["msg"] = ConvertBundleToObject(messageDup);
+
+    if (messageDup) {
+      bundle_free(messageDup);
+    }
+
+    if (obj["msg"].is<picojson::null>()) {
+      LOGE("doesn't have any message");
+      self->FireSimpleEvent("error", picojson::value("no message").serialize());
+    } else {
+      self->FireSimpleEvent("listen", picojson::value(obj).serialize());
+    }
+  };
+
+  int ret = (trusted) ? message_port_register_trusted_local_port(
+                            localPort.c_str(), receiveCb, this)
+                      : message_port_register_local_port(localPort.c_str(),
+                                                         receiveCb, this);
+  picojson::value::object obj;
+  obj["result"] = picojson::value(std::to_string(ret));
+  if (ret < 0)
+    obj["reason"] = picojson::value(ConvertMessagePortErrorToStr(ret));
+  SendSyncReply(picojson::value(obj).serialize().c_str());
+}
+
+void MessagePortInstance::UnregisterLocalPort(int localId, bool trusted) {
+  int ret = (trusted) ? message_port_unregister_local_port(localId)
+                      : message_port_unregister_trusted_local_port(localId);
+  picojson::value::object obj;
+  obj["result"] = picojson::value(std::to_string(ret));
+  if (ret != MESSAGE_PORT_ERROR_NONE)
+    obj["reason"] = picojson::value(ConvertMessagePortErrorToStr(ret));
+  SendSyncReply(picojson::value(obj).serialize().c_str());
+}
+
+void MessagePortInstance::SendMessage(const std::string& remoteAppId,
+                                      const std::string& remotePort,
+                                      bundle* message, bool trustedRemotePort) {
+  int ret = (trustedRemotePort)
+      ? message_port_send_trusted_message(remoteAppId.c_str(),
+                                          remotePort.c_str(), message)
+      : message_port_send_message(remoteAppId.c_str(),
+                                  remotePort.c_str(), message);
+  picojson::value::object obj;
+  obj["result"] = picojson::value(std::to_string(ret));
+  obj["reason"] = picojson::value(ConvertMessagePortErrorToStr(ret));
+  SendSyncReply(picojson::value(obj).serialize().c_str());
+}
+
+void MessagePortInstance::SendMessageWithLocalPort(
+    const std::string& remoteAppId,  const std::string& remotePort,
+    bundle* message, int localId, bool trustedRemotePort) {
+  int ret = (trustedRemotePort)
+      ? message_port_send_trusted_message_with_local_port(
+            remoteAppId.c_str(), remotePort.c_str(), message, localId)
+      : message_port_send_message_with_local_port(
+            remoteAppId.c_str(), remotePort.c_str(), message, localId);
+  picojson::value::object obj;
+  obj["result"] = picojson::value(std::to_string(ret));
+  obj["reason"] = picojson::value(ConvertMessagePortErrorToStr(ret));
+  SendSyncReply(picojson::value(obj).serialize().c_str());
+}
+
+}  // namespace appfw
+
+EXPORT_XWALK_EXTENSION(tizen_message_port, appfw::MessagePortExtension);
diff --git a/modules/tizen-message-port/message_port_extension.h b/modules/tizen-message-port/message_port_extension.h
new file mode 100755 (executable)
index 0000000..f02a927
--- /dev/null
@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2016 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ *    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.
+ */
+
+#ifndef MESSAGE_PORT_EXTENSION_H_
+#define MESSAGE_PORT_EXTENSION_H_
+
+#include <xwalk/xwalk_extension.h>
+#include <functional>
+#include <string>
+#include <bundle.h>
+
+namespace appfw {
+
+class MessagePortExtension : public xwalk::XWalkExtension {
+ public:
+  // @override
+  xwalk::XWalkExtensionInstance* CreateInstance();
+};
+
+class MessagePortInstance : public xwalk::XWalkExtensionInstance {
+ public:
+  typedef std::function<void
+      (int, const char*, const char*, bool, bundle*, void*)>
+      MessagePortMessageCb;
+  MessagePortInstance();
+  virtual ~MessagePortInstance();
+  // @override
+  void Initialize();
+
+  // @override
+  void HandleSyncMessage(const char* msg);
+ private:
+  void FireSimpleEvent(const std::string& event,
+                       const std::string& data = std::string());
+  void RegisterLocalPort(const std::string& localPort, bool trusted);
+  void UnregisterLocalPort(int localId, bool trusted);
+  void SendMessage(const std::string& remoteAppId,
+                   const std::string& remotePort, bundle* message,
+                   bool trustedRemotePort);
+  void SendMessageWithLocalPort(const std::string& remoteAppId,
+                                const std::string& remotePort, bundle* message,
+                                int localId, bool trustedRemotePort);
+};
+
+}  // namespace appfw
+
+#endif  // MESSAGE_PORT_EXTENSION_H_
+
diff --git a/modules/tizen-message-port/package.json b/modules/tizen-message-port/package.json
new file mode 100755 (executable)
index 0000000..c2e8272
--- /dev/null
@@ -0,0 +1,12 @@
+{
+  "name": "tizen-message-port",
+  "version": "0.0.1",
+  "description": "Module for Message Port",
+  "main": "tizen-message-port.xwalk",
+  "dependencies": {
+  },
+  "author": {
+    "name": "Yongseop Kim",
+    "email": "yons.kim@samsung.com"
+  }
+}
diff --git a/modules/tizen-message-port/picojson.h b/modules/tizen-message-port/picojson.h
new file mode 100644 (file)
index 0000000..0ae6851
--- /dev/null
@@ -0,0 +1,1037 @@
+/*
+ * Copyright 2009-2010 Cybozu Labs, Inc.
+ * Copyright 2011 Kazuho Oku
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice,
+ *    this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ *    this list of conditions and the following disclaimer in the documentation
+ *    and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY CYBOZU LABS, INC. ``AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
+ * EVENT SHALL CYBOZU LABS, INC. OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * The views and conclusions contained in the software and documentation are
+ * those of the authors and should not be interpreted as representing official
+ * policies, either expressed or implied, of Cybozu Labs, Inc.
+ *
+ */
+#ifndef picojson_h
+#define picojson_h
+
+#include <algorithm>
+#include <cassert>
+#include <cmath>
+#include <cstdio>
+#include <cstdlib>
+#include <cstring>
+#include <iostream>
+#include <iterator>
+#include <map>
+#include <string>
+#include <vector>
+
+#ifdef _MSC_VER
+    #define SNPRINTF _snprintf_s
+    #pragma warning(push)
+    #pragma warning(disable : 4244) // conversion from int to char
+#else
+    #define SNPRINTF snprintf
+#endif
+
+namespace picojson {
+
+  enum {
+    null_type,
+    boolean_type,
+    number_type,
+    string_type,
+    array_type,
+    object_type
+  };
+
+  struct null {};
+
+  class value {
+  public:
+    typedef std::vector<value> array;
+    typedef std::map<std::string, value> object;
+    union _storage {
+      bool boolean_;
+      double number_;
+      std::string* string_;
+      array* array_;
+      object* object_;
+    };
+  protected:
+    int type_;
+    _storage u_;
+  public:
+    value();
+    value(int type, bool);
+    explicit value(bool b);
+    explicit value(double n);
+    explicit value(const std::string& s);
+    explicit value(const array& a);
+    explicit value(const object& o);
+    explicit value(const char* s);
+    value(const char* s, size_t len);
+    ~value();
+    value(const value& x);
+    value& operator=(const value& x);
+    void swap(value& x);
+    template <typename T> bool is() const;
+    template <typename T> const T& get() const;
+    template <typename T> T& get();
+    bool evaluate_as_boolean() const;
+    const value& get(size_t idx) const;
+    const value& get(const std::string& key) const;
+    bool contains(size_t idx) const;
+    bool contains(const std::string& key) const;
+    std::string to_str() const;
+    template <typename Iter> void serialize(Iter os) const;
+    std::string serialize() const;
+  private:
+    template <typename T> value(const T*); // intentionally defined to block implicit conversion of pointer to bool
+  };
+
+  typedef value::array array;
+  typedef value::object object;
+
+  inline value::value() : type_(null_type) {}
+
+  inline value::value(int type, bool) : type_(type) {
+    switch (type) {
+#define INIT(p, v) case p##type: u_.p = v; break
+      INIT(boolean_, false);
+      INIT(number_, 0.0);
+      INIT(string_, new std::string());
+      INIT(array_, new array());
+      INIT(object_, new object());
+#undef INIT
+    default: break;
+    }
+  }
+
+  inline value::value(bool b) : type_(boolean_type) {
+    u_.boolean_ = b;
+  }
+
+  inline value::value(double n) : type_(number_type) {
+    u_.number_ = n;
+  }
+
+  inline value::value(const std::string& s) : type_(string_type) {
+    u_.string_ = new std::string(s);
+  }
+
+  inline value::value(const array& a) : type_(array_type) {
+    u_.array_ = new array(a);
+  }
+
+  inline value::value(const object& o) : type_(object_type) {
+    u_.object_ = new object(o);
+  }
+
+  inline value::value(const char* s) : type_(string_type) {
+    u_.string_ = new std::string(s);
+  }
+
+  inline value::value(const char* s, size_t len) : type_(string_type) {
+    u_.string_ = new std::string(s, len);
+  }
+
+  inline value::~value() {
+    switch (type_) {
+#define DEINIT(p) case p##type: delete u_.p; break
+      DEINIT(string_);
+      DEINIT(array_);
+      DEINIT(object_);
+#undef DEINIT
+    default: break;
+    }
+  }
+
+  inline value::value(const value& x) : type_(x.type_) {
+    switch (type_) {
+#define INIT(p, v) case p##type: u_.p = v; break
+      INIT(string_, new std::string(*x.u_.string_));
+      INIT(array_, new array(*x.u_.array_));
+      INIT(object_, new object(*x.u_.object_));
+#undef INIT
+    default:
+      u_ = x.u_;
+      break;
+    }
+  }
+
+  inline value& value::operator=(const value& x) {
+    if (this != &x) {
+      this->~value();
+      new (this) value(x);
+    }
+    return *this;
+  }
+
+  inline void value::swap(value& x) {
+    std::swap(type_, x.type_);
+    std::swap(u_, x.u_);
+  }
+
+#define IS(ctype, jtype)           \
+  template <> inline bool value::is<ctype>() const { \
+    return type_ == jtype##_type;        \
+  }
+  IS(null, null)
+  IS(bool, boolean)
+  IS(int, number)
+  IS(double, number)
+  IS(std::string, string)
+  IS(array, array)
+  IS(object, object)
+#undef IS
+
+#define GET(ctype, var)           \
+  template <> inline const ctype& value::get<ctype>() const { \
+    assert("type mismatch! call vis<type>() before get<type>()" \
+     && is<ctype>());               \
+    return var;             \
+  }               \
+  template <> inline ctype& value::get<ctype>() {   \
+    assert("type mismatch! call is<type>() before get<type>()"  \
+     && is<ctype>());         \
+    return var;             \
+  }
+  GET(bool, u_.boolean_)
+  GET(double, u_.number_)
+  GET(std::string, *u_.string_)
+  GET(array, *u_.array_)
+  GET(object, *u_.object_)
+#undef GET
+
+  inline bool value::evaluate_as_boolean() const {
+    switch (type_) {
+    case null_type:
+      return false;
+    case boolean_type:
+      return u_.boolean_;
+    case number_type:
+      return u_.number_ != 0;
+    case string_type:
+      return ! u_.string_->empty();
+    default:
+      return true;
+    }
+  }
+
+  inline const value& value::get(size_t idx) const {
+    static value s_null;
+    assert(is<array>());
+    return idx < u_.array_->size() ? (*u_.array_)[idx] : s_null;
+  }
+
+  inline const value& value::get(const std::string& key) const {
+    static value s_null;
+    assert(is<object>());
+    object::const_iterator i = u_.object_->find(key);
+    return i != u_.object_->end() ? i->second : s_null;
+  }
+
+  inline bool value::contains(size_t idx) const {
+    assert(is<array>());
+    return idx < u_.array_->size();
+  }
+
+  inline bool value::contains(const std::string& key) const {
+    assert(is<object>());
+    object::const_iterator i = u_.object_->find(key);
+    return i != u_.object_->end();
+  }
+
+  inline std::string value::to_str() const {
+    switch (type_) {
+    case null_type:      return "null";
+    case boolean_type:   return u_.boolean_ ? "true" : "false";
+    case number_type:    {
+      char buf[256];
+      double tmp;
+      SNPRINTF(buf, sizeof(buf), fabs(u_.number_) < (1ULL << 53) && modf(u_.number_, &tmp) == 0 ? "%.f" : "%.17g", u_.number_);
+      return buf;
+    }
+    case string_type:    return *u_.string_;
+    case array_type:     return "array";
+    case object_type:    return "object";
+    default:             assert(0);
+#ifdef _MSC_VER
+      __assume(0);
+#endif
+    }
+    return std::string();
+  }
+
+  template <typename Iter> void copy(const std::string& s, Iter oi) {
+    std::copy(s.begin(), s.end(), oi);
+  }
+
+  template <typename Iter> void serialize_str(const std::string& s, Iter oi) {
+    *oi++ = '"';
+    for (std::string::const_iterator i = s.begin(); i != s.end(); ++i) {
+      switch (*i) {
+#define MAP(val, sym) case val: copy(sym, oi); break
+  MAP('"', "\\\"");
+  MAP('\\', "\\\\");
+  MAP('/', "\\/");
+  MAP('\b', "\\b");
+  MAP('\f', "\\f");
+  MAP('\n', "\\n");
+  MAP('\r', "\\r");
+  MAP('\t', "\\t");
+#undef MAP
+      default:
+  if ((unsigned char)*i < 0x20 || *i == 0x7f) {
+    char buf[7];
+    SNPRINTF(buf, sizeof(buf), "\\u%04x", *i & 0xff);
+    copy(buf, buf + 6, oi);
+    } else {
+    *oi++ = *i;
+  }
+  break;
+      }
+    }
+    *oi++ = '"';
+  }
+
+  template <typename Iter> void value::serialize(Iter oi) const {
+    switch (type_) {
+    case string_type:
+      serialize_str(*u_.string_, oi);
+      break;
+    case array_type: {
+      *oi++ = '[';
+      for (array::const_iterator i = u_.array_->begin();
+           i != u_.array_->end();
+           ++i) {
+  if (i != u_.array_->begin()) {
+    *oi++ = ',';
+  }
+  i->serialize(oi);
+      }
+      *oi++ = ']';
+      break;
+    }
+    case object_type: {
+      *oi++ = '{';
+      for (object::const_iterator i = u_.object_->begin();
+     i != u_.object_->end();
+     ++i) {
+  if (i != u_.object_->begin()) {
+    *oi++ = ',';
+  }
+  serialize_str(i->first, oi);
+  *oi++ = ':';
+  i->second.serialize(oi);
+      }
+      *oi++ = '}';
+      break;
+    }
+    default:
+      copy(to_str(), oi);
+      break;
+    }
+  }
+
+  inline std::string value::serialize() const {
+    std::string s;
+    serialize(std::back_inserter(s));
+    return s;
+  }
+
+  template <typename Iter> class input {
+  protected:
+    Iter cur_, end_;
+    int last_ch_;
+    bool ungot_;
+    int line_;
+  public:
+    input(const Iter& first, const Iter& last) : cur_(first), end_(last), last_ch_(-1), ungot_(false), line_(1) {}
+    int getc() {
+      if (ungot_) {
+  ungot_ = false;
+  return last_ch_;
+      }
+      if (cur_ == end_) {
+  last_ch_ = -1;
+  return -1;
+      }
+      if (last_ch_ == '\n') {
+  line_++;
+      }
+      last_ch_ = *cur_++ & 0xff;
+      return last_ch_;
+    }
+    void ungetc() {
+      if (last_ch_ != -1) {
+  assert(! ungot_);
+  ungot_ = true;
+      }
+    }
+    Iter cur() const { return cur_; }
+    int line() const { return line_; }
+    void skip_ws() {
+      while (1) {
+  int ch = getc();
+  if (! (ch == ' ' || ch == '\t' || ch == '\n' || ch == '\r')) {
+    ungetc();
+    break;
+  }
+      }
+    }
+    bool expect(int expect) {
+      skip_ws();
+      if (getc() != expect) {
+  ungetc();
+  return false;
+      }
+      return true;
+    }
+    bool match(const std::string& pattern) {
+      for (std::string::const_iterator pi(pattern.begin());
+     pi != pattern.end();
+     ++pi) {
+  if (getc() != *pi) {
+    ungetc();
+    return false;
+  }
+      }
+      return true;
+    }
+  };
+
+  template<typename Iter> inline int _parse_quadhex(input<Iter> &in) {
+    int uni_ch = 0, hex;
+    for (int i = 0; i < 4; i++) {
+      if ((hex = in.getc()) == -1) {
+  return -1;
+      }
+      if ('0' <= hex && hex <= '9') {
+  hex -= '0';
+      } else if ('A' <= hex && hex <= 'F') {
+  hex -= 'A' - 0xa;
+      } else if ('a' <= hex && hex <= 'f') {
+  hex -= 'a' - 0xa;
+      } else {
+  in.ungetc();
+  return -1;
+      }
+      uni_ch = uni_ch * 16 + hex;
+    }
+    return uni_ch;
+  }
+
+  template<typename String, typename Iter> inline bool _parse_codepoint(String& out, input<Iter>& in) {
+    int uni_ch;
+    if ((uni_ch = _parse_quadhex(in)) == -1) {
+      return false;
+    }
+    if (0xd800 <= uni_ch && uni_ch <= 0xdfff) {
+      if (0xdc00 <= uni_ch) {
+  // a second 16-bit of a surrogate pair appeared
+  return false;
+      }
+      // first 16-bit of surrogate pair, get the next one
+      if (in.getc() != '\\' || in.getc() != 'u') {
+  in.ungetc();
+  return false;
+      }
+      int second = _parse_quadhex(in);
+      if (! (0xdc00 <= second && second <= 0xdfff)) {
+  return false;
+      }
+      uni_ch = ((uni_ch - 0xd800) << 10) | ((second - 0xdc00) & 0x3ff);
+      uni_ch += 0x10000;
+    }
+    if (uni_ch < 0x80) {
+      out.push_back(uni_ch);
+    } else {
+      if (uni_ch < 0x800) {
+  out.push_back(0xc0 | (uni_ch >> 6));
+      } else {
+  if (uni_ch < 0x10000) {
+    out.push_back(0xe0 | (uni_ch >> 12));
+  } else {
+    out.push_back(0xf0 | (uni_ch >> 18));
+    out.push_back(0x80 | ((uni_ch >> 12) & 0x3f));
+  }
+  out.push_back(0x80 | ((uni_ch >> 6) & 0x3f));
+      }
+      out.push_back(0x80 | (uni_ch & 0x3f));
+    }
+    return true;
+  }
+
+  template<typename String, typename Iter> inline bool _parse_string(String& out, input<Iter>& in) {
+    while (1) {
+      int ch = in.getc();
+      if (ch < ' ') {
+  in.ungetc();
+  return false;
+      } else if (ch == '"') {
+  return true;
+      } else if (ch == '\\') {
+  if ((ch = in.getc()) == -1) {
+    return false;
+  }
+  switch (ch) {
+#define MAP(sym, val) case sym: out.push_back(val); break
+    MAP('"', '\"');
+    MAP('\\', '\\');
+    MAP('/', '/');
+    MAP('b', '\b');
+    MAP('f', '\f');
+    MAP('n', '\n');
+    MAP('r', '\r');
+    MAP('t', '\t');
+#undef MAP
+  case 'u':
+    if (! _parse_codepoint(out, in)) {
+      return false;
+    }
+    break;
+  default:
+    return false;
+  }
+      } else {
+  out.push_back(ch);
+      }
+    }
+    return false;
+  }
+
+  template <typename Context, typename Iter> inline bool _parse_array(Context& ctx, input<Iter>& in) {
+    if (! ctx.parse_array_start()) {
+      return false;
+    }
+    if (in.expect(']')) {
+      return true;
+    }
+    size_t idx = 0;
+    do {
+      if (! ctx.parse_array_item(in, idx)) {
+  return false;
+      }
+      idx++;
+    } while (in.expect(','));
+    return in.expect(']');
+  }
+
+  template <typename Context, typename Iter> inline bool _parse_object(Context& ctx, input<Iter>& in) {
+    if (! ctx.parse_object_start()) {
+      return false;
+    }
+    if (in.expect('}')) {
+      return true;
+    }
+    do {
+      std::string key;
+      if (! in.expect('"')
+    || ! _parse_string(key, in)
+    || ! in.expect(':')) {
+  return false;
+      }
+      if (! ctx.parse_object_item(in, key)) {
+  return false;
+      }
+    } while (in.expect(','));
+    return in.expect('}');
+  }
+
+  template <typename Iter> inline bool _parse_number(double& out, input<Iter>& in) {
+    std::string num_str;
+    while (1) {
+      int ch = in.getc();
+      if (('0' <= ch && ch <= '9') || ch == '+' || ch == '-' || ch == '.'
+    || ch == 'e' || ch == 'E') {
+  num_str.push_back(ch);
+      } else {
+  in.ungetc();
+  break;
+      }
+    }
+    char* endp;
+    out = strtod(num_str.c_str(), &endp);
+    return endp == num_str.c_str() + num_str.size();
+  }
+
+  template <typename Context, typename Iter> inline bool _parse(Context& ctx, input<Iter>& in) {
+    in.skip_ws();
+    int ch = in.getc();
+    switch (ch) {
+#define IS(ch, text, op) case ch: \
+      if (in.match(text) && op) { \
+  return true; \
+      } else { \
+  return false; \
+      }
+      IS('n', "ull", ctx.set_null());
+      IS('f', "alse", ctx.set_bool(false));
+      IS('t', "rue", ctx.set_bool(true));
+#undef IS
+    case '"':
+      return ctx.parse_string(in);
+    case '[':
+      return _parse_array(ctx, in);
+    case '{':
+      return _parse_object(ctx, in);
+    default:
+      if (('0' <= ch && ch <= '9') || ch == '-') {
+  in.ungetc();
+  double f;
+  if (_parse_number(f, in)) {
+    ctx.set_number(f);
+    return true;
+  } else {
+    return false;
+  }
+      }
+      break;
+    }
+    in.ungetc();
+    return false;
+  }
+
+  class deny_parse_context {
+  public:
+    bool set_null() { return false; }
+    bool set_bool(bool) { return false; }
+    bool set_number(double) { return false; }
+    template <typename Iter> bool parse_string(input<Iter>&) { return false; }
+    bool parse_array_start() { return false; }
+    template <typename Iter> bool parse_array_item(input<Iter>&, size_t) {
+      return false;
+    }
+    bool parse_object_start() { return false; }
+    template <typename Iter> bool parse_object_item(input<Iter>&, const std::string&) {
+      return false;
+    }
+  };
+
+  class default_parse_context {
+  protected:
+    value* out_;
+  public:
+    default_parse_context(value* out) : out_(out) {}
+    bool set_null() {
+      *out_ = value();
+      return true;
+    }
+    bool set_bool(bool b) {
+      *out_ = value(b);
+      return true;
+    }
+    bool set_number(double f) {
+      *out_ = value(f);
+      return true;
+    }
+    template<typename Iter> bool parse_string(input<Iter>& in) {
+      *out_ = value(string_type, false);
+      return _parse_string(out_->get<std::string>(), in);
+    }
+    bool parse_array_start() {
+      *out_ = value(array_type, false);
+      return true;
+    }
+    template <typename Iter> bool parse_array_item(input<Iter>& in, size_t) {
+      array& a = out_->get<array>();
+      a.push_back(value());
+      default_parse_context ctx(&a.back());
+      return _parse(ctx, in);
+    }
+    bool parse_object_start() {
+      *out_ = value(object_type, false);
+      return true;
+    }
+    template <typename Iter> bool parse_object_item(input<Iter>& in, const std::string& key) {
+      object& o = out_->get<object>();
+      default_parse_context ctx(&o[key]);
+      return _parse(ctx, in);
+    }
+  private:
+    default_parse_context(const default_parse_context&);
+    default_parse_context& operator=(const default_parse_context&);
+  };
+
+  class null_parse_context {
+  public:
+    struct dummy_str {
+      void push_back(int) {}
+    };
+  public:
+    null_parse_context() {}
+    bool set_null() { return true; }
+    bool set_bool(bool) { return true; }
+    bool set_number(double) { return true; }
+    template <typename Iter> bool parse_string(input<Iter>& in) {
+      dummy_str s;
+      return _parse_string(s, in);
+    }
+    bool parse_array_start() { return true; }
+    template <typename Iter> bool parse_array_item(input<Iter>& in, size_t) {
+      return _parse(*this, in);
+    }
+    bool parse_object_start() { return true; }
+    template <typename Iter> bool parse_object_item(input<Iter>& in, const std::string&) {
+      return _parse(*this, in);
+    }
+  private:
+    null_parse_context(const null_parse_context&);
+    null_parse_context& operator=(const null_parse_context&);
+  };
+
+  // obsolete, use the version below
+  template <typename Iter> inline std::string parse(value& out, Iter& pos, const Iter& last) {
+    std::string err;
+    pos = parse(out, pos, last, &err);
+    return err;
+  }
+
+  template <typename Context, typename Iter> inline Iter _parse(Context& ctx, const Iter& first, const Iter& last, std::string* err) {
+    input<Iter> in(first, last);
+    if (! _parse(ctx, in) && err != NULL) {
+      char buf[64];
+      SNPRINTF(buf, sizeof(buf), "syntax error at line %d near: ", in.line());
+      *err = buf;
+      while (1) {
+  int ch = in.getc();
+  if (ch == -1 || ch == '\n') {
+    break;
+  } else if (ch >= ' ') {
+    err->push_back(ch);
+  }
+      }
+    }
+    return in.cur();
+  }
+
+  template <typename Iter> inline Iter parse(value& out, const Iter& first, const Iter& last, std::string* err) {
+    default_parse_context ctx(&out);
+    return _parse(ctx, first, last, err);
+  }
+
+  inline std::string parse(value& out, std::istream& is) {
+    std::string err;
+    parse(out, std::istreambuf_iterator<char>(is.rdbuf()),
+    std::istreambuf_iterator<char>(), &err);
+    return err;
+  }
+
+  template <typename T> struct last_error_t {
+    static std::string s;
+  };
+  template <typename T> std::string last_error_t<T>::s;
+
+  inline void set_last_error(const std::string& s) {
+    last_error_t<bool>::s = s;
+  }
+
+  inline const std::string& get_last_error() {
+    return last_error_t<bool>::s;
+  }
+
+  inline bool operator==(const value& x, const value& y) {
+    if (x.is<null>())
+      return y.is<null>();
+#define PICOJSON_CMP(type)          \
+    if (x.is<type>())           \
+      return y.is<type>() && x.get<type>() == y.get<type>()
+    PICOJSON_CMP(bool);
+    PICOJSON_CMP(double);
+    PICOJSON_CMP(std::string);
+    PICOJSON_CMP(array);
+    PICOJSON_CMP(object);
+#undef PICOJSON_CMP
+    assert(0);
+#ifdef _MSC_VER
+    __assume(0);
+#endif
+    return false;
+  }
+
+  inline bool operator!=(const value& x, const value& y) {
+    return ! (x == y);
+  }
+}
+
+namespace std {
+  template<> inline void swap(picojson::value& x, picojson::value& y)
+    {
+      x.swap(y);
+    }
+}
+
+inline std::istream& operator>>(std::istream& is, picojson::value& x)
+{
+  picojson::set_last_error(std::string());
+  std::string err = picojson::parse(x, is);
+  if (! err.empty()) {
+    picojson::set_last_error(err);
+    is.setstate(std::ios::failbit);
+  }
+  return is;
+}
+
+inline std::ostream& operator<<(std::ostream& os, const picojson::value& x)
+{
+  x.serialize(std::ostream_iterator<char>(os));
+  return os;
+}
+#ifdef _MSC_VER
+    #pragma warning(pop)
+#endif
+
+#endif
+#ifdef TEST_PICOJSON
+#ifdef _MSC_VER
+    #pragma warning(disable : 4127) // conditional expression is constant
+#endif
+
+using namespace std;
+
+static void plan(int num)
+{
+  printf("1..%d\n", num);
+}
+
+static bool success = true;
+
+static void ok(bool b, const char* name = "")
+{
+  static int n = 1;
+  if (! b)
+    success = false;
+  printf("%s %d - %s\n", b ? "ok" : "ng", n++, name);
+}
+
+template <typename T> void is(const T& x, const T& y, const char* name = "")
+{
+  if (x == y) {
+    ok(true, name);
+  } else {
+    ok(false, name);
+  }
+}
+
+#include <algorithm>
+#include <sstream>
+#include <float.h>
+#include <limits.h>
+
+int main(void)
+{
+  plan(85);
+
+  // constructors
+#define TEST(expr, expected) \
+    is(picojson::value expr .serialize(), string(expected), "picojson::value" #expr)
+
+  TEST( (true),  "true");
+  TEST( (false), "false");
+  TEST( (42.0),   "42");
+  TEST( (string("hello")), "\"hello\"");
+  TEST( ("hello"), "\"hello\"");
+  TEST( ("hello", 4), "\"hell\"");
+
+  {
+    double a = 1;
+    for (int i = 0; i < 1024; i++) {
+      picojson::value vi(a);
+      std::stringstream ss;
+      ss << vi;
+      picojson::value vo;
+      ss >> vo;
+      double b = vo.get<double>();
+      if ((i < 53 && a != b) || fabs(a - b) / b > 1e-8) {
+        printf("ng i=%d a=%.18e b=%.18e\n", i, a, b);
+      }
+      a *= 2;
+    }
+  }
+
+#undef TEST
+
+#define TEST(in, type, cmp, serialize_test) {       \
+    picojson::value v;              \
+    const char* s = in;             \
+    string err = picojson::parse(v, s, s + strlen(s));      \
+    ok(err.empty(), in " no error");          \
+    ok(v.is<type>(), in " check type");         \
+    is<type>(v.get<type>(), cmp, in " correct output");     \
+    is(*s, '\0', in " read to eof");          \
+    if (serialize_test) {           \
+      is(v.serialize(), string(in), in " serialize");     \
+    }                 \
+  }
+  TEST("false", bool, false, true);
+  TEST("true", bool, true, true);
+  TEST("90.5", double, 90.5, false);
+  TEST("1.7976931348623157e+308", double, DBL_MAX, false);
+  TEST("\"hello\"", string, string("hello"), true);
+  TEST("\"\\\"\\\\\\/\\b\\f\\n\\r\\t\"", string, string("\"\\/\b\f\n\r\t"),
+       true);
+  TEST("\"\\u0061\\u30af\\u30ea\\u30b9\"", string,
+       string("a\xe3\x82\xaf\xe3\x83\xaa\xe3\x82\xb9"), false);
+  TEST("\"\\ud840\\udc0b\"", string, string("\xf0\xa0\x80\x8b"), false);
+#undef TEST
+
+#define TEST(type, expr) {                 \
+    picojson::value v;                   \
+    const char *s = expr;                \
+    string err = picojson::parse(v, s, s + strlen(s));           \
+    ok(err.empty(), "empty " #type " no error");           \
+    ok(v.is<picojson::type>(), "empty " #type " check type");        \
+    ok(v.get<picojson::type>().empty(), "check " #type " array size"); \
+  }
+  TEST(array, "[]");
+  TEST(object, "{}");
+#undef TEST
+
+  {
+    picojson::value v;
+    const char *s = "[1,true,\"hello\"]";
+    string err = picojson::parse(v, s, s + strlen(s));
+    ok(err.empty(), "array no error");
+    ok(v.is<picojson::array>(), "array check type");
+    is(v.get<picojson::array>().size(), size_t(3), "check array size");
+    ok(v.contains(0), "check contains array[0]");
+    ok(v.get(0).is<double>(), "check array[0] type");
+    is(v.get(0).get<double>(), 1.0, "check array[0] value");
+    ok(v.contains(1), "check contains array[1]");
+    ok(v.get(1).is<bool>(), "check array[1] type");
+    ok(v.get(1).get<bool>(), "check array[1] value");
+    ok(v.contains(2), "check contains array[2]");
+    ok(v.get(2).is<string>(), "check array[2] type");
+    is(v.get(2).get<string>(), string("hello"), "check array[2] value");
+    ok(!v.contains(3), "check not contains array[3]");
+  }
+
+  {
+    picojson::value v;
+    const char *s = "{ \"a\": true }";
+    string err = picojson::parse(v, s, s + strlen(s));
+    ok(err.empty(), "object no error");
+    ok(v.is<picojson::object>(), "object check type");
+    is(v.get<picojson::object>().size(), size_t(1), "check object size");
+    ok(v.contains("a"), "check contains property");
+    ok(v.get("a").is<bool>(), "check bool property exists");
+    is(v.get("a").get<bool>(), true, "check bool property value");
+    is(v.serialize(), string("{\"a\":true}"), "serialize object");
+    ok(!v.contains("z"), "check not contains property");
+  }
+
+#define TEST(json, msg) do {        \
+    picojson::value v;          \
+    const char *s = json;       \
+    string err = picojson::parse(v, s, s + strlen(s));  \
+    is(err, string("syntax error at line " msg), msg);  \
+  } while (0)
+  TEST("falsoa", "1 near: oa");
+  TEST("{]", "1 near: ]");
+  TEST("\n\bbell", "2 near: bell");
+  TEST("\"abc\nd\"", "1 near: ");
+#undef TEST
+
+  {
+    picojson::value v1, v2;
+    const char *s;
+    string err;
+    s = "{ \"b\": true, \"a\": [1,2,\"three\"], \"d\": 2 }";
+    err = picojson::parse(v1, s, s + strlen(s));
+    s = "{ \"d\": 2.0, \"b\": true, \"a\": [1,2,\"three\"] }";
+    err = picojson::parse(v2, s, s + strlen(s));
+    ok((v1 == v2), "check == operator in deep comparison");
+  }
+
+  {
+    picojson::value v1, v2;
+    const char *s;
+    string err;
+    s = "{ \"b\": true, \"a\": [1,2,\"three\"], \"d\": 2 }";
+    err = picojson::parse(v1, s, s + strlen(s));
+    s = "{ \"d\": 2.0, \"a\": [1,\"three\"], \"b\": true }";
+    err = picojson::parse(v2, s, s + strlen(s));
+    ok((v1 != v2), "check != operator for array in deep comparison");
+  }
+
+  {
+    picojson::value v1, v2;
+    const char *s;
+    string err;
+    s = "{ \"b\": true, \"a\": [1,2,\"three\"], \"d\": 2 }";
+    err = picojson::parse(v1, s, s + strlen(s));
+    s = "{ \"d\": 2.0, \"a\": [1,2,\"three\"], \"b\": false }";
+    err = picojson::parse(v2, s, s + strlen(s));
+    ok((v1 != v2), "check != operator for object in deep comparison");
+  }
+
+  {
+    picojson::value v1, v2;
+    const char *s;
+    string err;
+    s = "{ \"b\": true, \"a\": [1,2,\"three\"], \"d\": 2 }";
+    err = picojson::parse(v1, s, s + strlen(s));
+    picojson::object& o = v1.get<picojson::object>();
+    o.erase("b");
+    picojson::array& a = o["a"].get<picojson::array>();
+    picojson::array::iterator i;
+    i = std::remove(a.begin(), a.end(), picojson::value(std::string("three")));
+    a.erase(i, a.end());
+    s = "{ \"a\": [1,2], \"d\": 2 }";
+    err = picojson::parse(v2, s, s + strlen(s));
+    ok((v1 == v2), "check erase()");
+  }
+
+  ok(picojson::value(3.0).serialize() == "3",
+     "integral number should be serialized as a integer");
+
+  {
+    const char* s = "{ \"a\": [1,2], \"d\": 2 }";
+    picojson::null_parse_context ctx;
+    string err;
+    picojson::_parse(ctx, s, s + strlen(s), &err);
+    ok(err.empty(), "null_parse_context");
+  }
+
+  {
+    picojson::value v1, v2;
+    v1 = picojson::value(true);
+    swap(v1, v2);
+    ok(v1.is<picojson::null>(), "swap (null)");
+    ok(v2.get<bool>() == true, "swap (bool)");
+
+    v1 = picojson::value("a");
+    v2 = picojson::value(1.0);
+    swap(v1, v2);
+    ok(v1.get<double>() == 1.0, "swap (dobule)");
+    ok(v2.get<string>() == "a", "swap (string)");
+
+    v1 = picojson::value(picojson::object());
+    v2 = picojson::value(picojson::array());
+    swap(v1, v2);
+    ok(v1.is<picojson::array>(), "swap (array)");
+    ok(v2.is<picojson::object>(), "swap (object)");
+  }
+
+  return success ? 0 : 1;
+}
+
+#endif
diff --git a/modules/tizen-message-port/tizen-message-port_api.js b/modules/tizen-message-port/tizen-message-port_api.js
new file mode 100755 (executable)
index 0000000..c6f08b7
--- /dev/null
@@ -0,0 +1,416 @@
+/*
+ * Copyright (c) 2016 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ *    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.
+ */
+
+/**
+ * The Tizen Message Port Module.
+ *
+ * `require('tizen-message-port')` returns an instance of the
+ * {{#crossLink "MessagePort"}}{{/crossLink}} class.
+ *
+ * ``` javascript
+ *     var messageport = require('tizen-message-port');
+ *
+ *     messageport.listen('port1', function(message, sender) {
+ *       // sender = {appId, portName, trusted}
+ *     });
+ *     messageport.stopListening('port1');
+ *     messageport.listen('port2', true, function(message, sender) {
+ *       // sender = {appId, portName, trusted}
+ *     });
+ *     messageport.stopListening('port2', true);
+ *
+ *     var message = {
+ *       // currently processes only two type below
+ *       msg1: 'hello world!',    // str
+ *       msg2: ['hello', 'world'] // str array
+ *     };
+ *
+ *     // for one direction
+ *     messageport.send({'appId': appId, 'portName': portName, 'trusted': true},
+ *                      message);
+ *
+ *     // for bidirection
+ *     messageport.send({'appId': appId, 'portName': portName, 'trusted': true},
+ *                      message, {'portName': myPortName, 'trusted': true});
+ * ```
+ *
+ * @module tizen-message-port
+ * @since 3.0
+**/
+
+'use strict';
+
+function native_sync_call(method, parameter) {
+  let args = {};
+  args['cmd'] = method;
+  args = Object.assign(args, parameter);
+  try {
+    return JSON.parse(extension.internal.sendSyncMessage(JSON.stringify(args)));
+  } catch (e) {
+    console.error(e.message);
+    return {};
+  }
+}
+
+function registerEventHandler(messageport) {
+  let handler = (function(self) {
+    return function(json) {
+      let msg = JSON.parse(json);
+      self.__event_handle__(msg);
+    };
+  })(messageport);
+  extension.setMessageListener(handler);
+}
+
+function convertObjectToMap(obj) {
+  let map = new Map();
+  for (let key in obj) {
+    map.set(key, obj[key]);
+  }
+  return map;
+}
+
+function convertMapToObject(map) {
+  let obj = {};
+  map.forEach(function(value, key) {
+    obj[key] = value;
+  });
+  return obj;
+}
+
+function registerLocalPort(portName, trusted) {
+  let args = {'msg': {'localPort': String(portName),
+                      'trusted': Boolean(trusted)}};
+  let ret = native_sync_call('registerLocalPort', args);
+  return ret;
+}
+
+function unregisterLocalPort(localId, trusted) {
+  let args = {'msg': {'localId': Number(localId),
+                      'trusted': Boolean(trusted)}};
+  let ret = native_sync_call('unregisterLocalPort', args);
+  return ret;
+}
+
+function combinePortNameAndTrusted(portName, trusted) {
+  return `___${portName}___${trusted}___`;
+}
+
+// `portName, trusted` -> { localId, callback }
+const MESSAGE_PORT_MAP = Symbol();
+
+/**
+ * The MessagePort class provides functions to communicate between ports.
+ * require('tizen-message-port') returns an instance of this class
+ * ``` javascript
+ * var messageport = require('tizen-message-port');
+ * ```
+ * @class MessagePort
+ * @public
+ * @since 3.0
+ * @public
+ */
+class MessagePort {
+  constructor() {
+    this[MESSAGE_PORT_MAP] = new Map();
+    registerEventHandler(this);
+  }
+
+  /**
+   * Listens message from other ports.
+   *
+   * This method internally registers a port with the portName which is
+   * specified in this method.
+   *
+   * ```javascript
+   * messageport.listen('port1', function(message, sender) {
+   *   // (this callback will be invoked when this port receives any message)
+   *   // message is a Map. when reiceive the message, its type is only Map.
+   *   // sender = {appId, portName, trusted}
+   *
+   *   console.log('The message: ' + message.get(sthMapKey));
+   *   if (sender.trusted) {
+   *     console.log('Who sent this message?');
+   *     console.log('appId: ' + sender.appId);
+   *     if (sender.portName !== undefined) {
+   *       console.log('portName: ' + sender.portName);
+   *     }
+   *   }
+   * });
+   * ```
+   *
+   * Two ports can listen with the same portName if one is trusted and
+   * the other one is untrusted. For example, the following would register two
+   * different ports.
+   *
+   * ``` javascript
+   * // registers an untrusted port with name 'port1'
+   * messageport.listen('port1', function(message, sender){});
+   *
+   * // registers a trusted port with name 'port1'
+   * messageport.listen('port1', true, function(message, sender){});
+   * ```
+   *
+   * @method listen
+   *
+   * @param {String} portName The name of the port which will listen.
+   * @param {Boolean} [trusted=false] true if the port which will listen is to
+   * be registered as a trusted port. false is the default.
+   * @param {Function} callback Callback function to be invoked when
+   * this port receives any message.
+   * The callback function takes two parameters:
+   * @param {Map} callback.message Message which is received. When receive the
+   * message, it can be only Map.
+   * @param {Object} [callback.sender] Information of sender who sends
+   * this message. If sender sent without own information, sender can be
+   * undefined.
+   * @param {String} callback.sender.appId Application ID of sender application.
+   * @param {String} callback.sender.portName Name of the sender port.
+   * @param {Boolean} callback.sender.trusted true if the port which sends this
+   * message is trusted. false otherwise.
+   *
+   * @return {Boolean} true if the port is registered. false otherwise.
+   *
+   * @throws
+   * * InvalidValueError - The specified portName, trusted and callback are not valid
+   * * OutOfMemoryError - Out of memory
+   * * IOError - Internal I/O error
+   * @since 3.0
+   */
+  listen(portName, trusted, callback) {
+    if (arguments.length === 2) {
+      if (trusted instanceof Function) {
+        callback = trusted;
+        trusted = false;
+      } else {
+        console.error(
+            'Failed to listen because callback parameter is not valid');
+        throw new Error('InvalidValueError');
+      }
+    } else if (arguments.length < 2) {
+      console.error('Failed to listen because parameters are not valid');
+        throw new Error('InvalidValueError');
+    }
+
+    let ret = registerLocalPort(portName, trusted);
+    let localId = Number(ret['result']);
+    if (localId > 0) {
+      this[MESSAGE_PORT_MAP].set(combinePortNameAndTrusted(portName, trusted),
+                                 {'localId': localId, 'callback': callback});
+      return true;
+    } else {
+      if (ret['reason'] !== undefined) {
+        let reason = String(ret['reason']);
+        console.error('Failed to registered port(' + portName + ', ' + trusted +
+                      ') because ' + reason);
+        throw new Error(reason);
+      }
+      return false;
+    }
+  }
+
+  /**
+   * Stops a port from listening to messages from other ports.
+   *
+   * Two ports with the same portName can stop listening if one is trusted and
+   * the other one is untrusted. For example, the following is possible:
+   *
+   * ``` javascript
+   * // unresgisters an untrusted port with name 'port1'
+   * messageport.stopListening('port1');
+   *
+   * // unresgisters a trusted port with name 'port1'
+   * messageport.stopListening('port1', true);
+   * ```
+   *
+   * @method stopListening
+   *
+   * @param {String} portName The name of the port which will stop listening
+   * port.
+   * @param [trusted=false] {Boolean} true if the port which will stop listening
+   * was set to listen as a trusted port. false is the default.
+   *
+   * @return {Boolean} true if the port is unregistered. false otherwise.
+   *
+   * @throws
+   * * InvalidValueError - The specified portName and trusted are not valid
+   * * NotFoundError - The port which has specified portName and trusted cannot be found
+   * * OutOfMemoryError - Out of memory
+   * * IOError - Internal I/O error
+   *
+   * @since 3.0
+   */
+  stopListening(portName, trusted) {
+    let key = combinePortNameAndTrusted(String(portName), Boolean(trusted));
+    let value = this[MESSAGE_PORT_MAP].get(key);
+    if (!value) {
+      console.error('Failed to find (%s,%s) in map', portName, trusted);
+      return;
+    }
+    let ret = unregisterLocalPort(value.localId, trusted);
+    if (Number(ret['result']) === 0) {
+      this[MESSAGE_PORT_MAP].delete(key);
+      return true;
+    } else {
+      if (ret['reason'] !== undefined) {
+        let reason = String(ret['reason']);
+        console.error('Failed to registered port(' + portName + ', ' + trusted +
+                      ') because ' + reason);
+        throw new Error(reason);
+      }
+      return false;
+    }
+  }
+
+  /**
+   * Send one or more messages to a port which is listening.
+   *
+   * ```javascript
+   * // if message's type is Map,
+   * var messageMap = new Map();
+   * messageMap.set('msg1', 'hello world');
+   * messageMap.set('msg2', ['hello', 'world']);
+   *
+   * // if message's type is Object,
+   * var messageObj = {};
+   * messageObj.msg1 = 'hello world';
+   * messageObj.msg2 = ['hello', 'world'];
+   *
+   * // sends the message without sender information,
+   * send({appId: 'receiverAppId', portName: 'receiverPortName'}, messageMap);
+   *
+   * // or sends the message with sender information,
+   * send({appId: 'receiverAppId', portName: 'receiverPortName'}, messageObj,
+   *      {portName: 'senderPort', trusted: true});
+   *
+   * // caution: accepted message's values' types are only string and string array
+   * message.set('msg1', 'hello world');  // string type is accepted
+   * message.set('msg2', ['hello', 'world']);  // string array type is accepted
+   * // message.set('msg3', true);  // not accepted
+   * // message.set('msg4', {name: 'tizen'});  // not accepted
+   * // message.set('msg5', 12345);  // not accepted
+   * // message.set('msg6', function() {});  // not accepted
+   * ```
+   *
+   * @method send
+   *
+   * @param {Object} receiver Message receiver information.
+   * @param {String} receiver.appId Application ID of receiver application.
+   * @param {String} receiver.portName Name of the receiver port.
+   * This port should be set to listen by the application with appId.
+   * @param {Boolean} [receiver.trusted=false] true if the receiver port which
+   * is listening as a trusted port. false is the default.
+   * @param {Map|Object} message Message to send to receiver. When send the
+   * message, it can be a Map or an Object.
+   * * Currently, only string value and string array value are supported.
+   * @param {Object} [sender] Message sender information.
+   * @param {String} sender.portName Name of port which sends the message. The
+   * application which calls this method should have set this portName to
+   * {{#crossLink "MessagePort/listen:method"}}{{/crossLink}}.If this portName
+   * is not set to {{#crossLink "MessagePort/listen:method"}}{{/crossLink}},
+   * the message is sent without sender information.
+   * @param {Boolean} [sender.trusted=false] true if the sender port is
+   * listening as a trusted port. false is the default.
+   *
+   * @return {Boolean} True if send() is successful.
+   *
+   * @throws
+   * * InvalidValueError - The specified receiver is not valid
+   * * OutOfMemoryError - Out of memory
+   * * NotFoundError - The port which has specified appId, portName and trusted in receiver cannot be found
+   * * InvalidOperationError - The receiver is not signed with the same certificate
+   * * QuotaError - The size of the message has exceeded the maximum limit
+   * * IOError - Internal I/O error
+   *
+   * @since 3.0
+   */
+  send(receiver, message, sender) {
+    if (typeof message !== 'object' && !(message instanceof Map)) {
+      throw new Error('[MessagePort::send] Wrong Type of message');
+    }
+
+    let withSender = false;
+    let keySender;
+    if (sender && sender.portName) {
+      keySender = combinePortNameAndTrusted(String(sender.portName),
+                                            Boolean(sender.trusted));
+      if (this[MESSAGE_PORT_MAP].has(keySender))
+        withSender = true;
+    }
+
+    if (message instanceof Map)
+      message = convertMapToObject(message);
+
+    let args = {'msg': {'appId': String(receiver.appId),
+                        'portName': String(receiver.portName),
+                        'trusted': Boolean(receiver.trusted),
+                        'message': message }};
+
+    if (withSender) {
+      args['msg'] = Object.assign(args['msg'],
+                                  {'localId': Number(this[MESSAGE_PORT_MAP]
+                                                     .get(keySender)
+                                                     .localId)});
+    }
+
+    let ret = native_sync_call('send', args);
+    if (Number(ret['result']) === 0) {
+      return true;
+    } else {
+      if (ret['reason'] !== undefined) {
+        let reason = String(ret['reason']);
+        console.error('Failed to send to (' + receiver.appId + ', ' +
+                      receiver.portName + ', ' + receiver.trusted +
+                      ') because ' + reason);
+        throw new Error(reason);
+      }
+      return false;
+    }
+  }
+
+  findCallback(localId) {
+    for (let v of this[MESSAGE_PORT_MAP].values()) {
+      if (v.localId === localId)
+        return v.callback;
+    }
+    return undefined;
+  }
+
+  __event_handle__(msg) {
+    if ('listen' === msg['event']) {
+      let data = JSON.parse(msg['data']);
+
+      let appId = String(data['appId']);
+      let portName = data['portName'];
+      let trusted = Boolean(data['trusted']);
+      let map = convertObjectToMap(data['msg']);
+      let sender = {'appId': appId, 'portName': portName, 'trusted': trusted };
+
+      let localId = Number(data['localId']);
+      let listenCb = this.findCallback(localId);
+
+      if (listenCb && listenCb instanceof Function) {
+        listenCb(map, sender);
+      } else {
+        console.error('Failed to find any callback for listen id: ' + localId);
+      }
+    } else {
+      console.error('Invalid event was passed');
+    }
+  }
+};
+
+exports = new MessagePort();
index e293f9e..366dcc3 100644 (file)
@@ -22,10 +22,10 @@ BuildRequires: pkgconfig(capi-appfw-application)
 BuildRequires: pkgconfig(capi-appfw-app-manager)
 BuildRequires: pkgconfig(pkgmgr-info)
 BuildRequires: pkgconfig(bundle)
+BuildRequires: pkgconfig(capi-message-port)
 BuildRequires: pkgconfig(capi-media-sound-manager)
 BuildRequires: pkgconfig(notification)
 
-
 Requires: nodejs
 
 %description