/* * 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. * * Contains some contributions under the Thrift Software License. * Please see doc/old-thrift-license.txt in the Thrift distribution for * details. */ #include #include #include #include #include #include #include #include #include #include "thrift/platform.h" #include "thrift/version.h" #include "thrift/generate/t_oop_generator.h" using std::map; using std::ofstream; using std::ostringstream; using std::string; using std::stringstream; using std::vector; /** * A subclass of std::ofstream that includes indenting functionality. */ class t_rb_ofstream : public std::ofstream { private: int indent_; public: t_rb_ofstream() : std::ofstream(), indent_(0) {} explicit t_rb_ofstream(const char* filename, ios_base::openmode mode = ios_base::out, int indent = 0) : std::ofstream(filename, mode), indent_(indent) {} t_rb_ofstream& indent() { for (int i = 0; i < indent_; ++i) { *this << " "; } return *this; } void indent_up() { indent_++; } void indent_down() { indent_--; } }; /** * Ruby code generator. * */ class t_rb_generator : public t_oop_generator { public: t_rb_generator(t_program* program, const std::map& parsed_options, const std::string& option_string) : t_oop_generator(program) { (void)option_string; std::map::const_iterator iter; require_rubygems_ = false; namespaced_ = false; for( iter = parsed_options.begin(); iter != parsed_options.end(); ++iter) { if( iter->first.compare("rubygems") == 0) { require_rubygems_ = true; } else if( iter->first.compare("namespaced") == 0) { namespaced_ = true; } else { throw "unknown option ruby:" + iter->first; } } out_dir_base_ = "gen-rb"; } /** * Init and close methods */ void init_generator() override; void close_generator() override; std::string display_name() const override; /** * Program-level generation functions */ void generate_typedef(t_typedef* ttypedef) override; void generate_enum(t_enum* tenum) override; void generate_const(t_const* tconst) override; void generate_struct(t_struct* tstruct) override; void generate_forward_declaration(t_struct* tstruct) override; void generate_union(t_struct* tunion); void generate_xception(t_struct* txception) override; void generate_service(t_service* tservice) override; t_rb_ofstream& render_const_value(t_rb_ofstream& out, t_type* type, t_const_value* value); /** * Struct generation code */ void generate_rb_struct_declaration(t_rb_ofstream& out, t_struct* tstruct, bool is_exception); void generate_rb_struct(t_rb_ofstream& out, t_struct* tstruct, bool is_exception); void generate_rb_struct_required_validator(t_rb_ofstream& out, t_struct* tstruct); void generate_rb_union(t_rb_ofstream& out, t_struct* tstruct, bool is_exception); void generate_rb_union_validator(t_rb_ofstream& out, t_struct* tstruct); void generate_rb_function_helpers(t_function* tfunction); void generate_rb_simple_constructor(t_rb_ofstream& out, t_struct* tstruct); void generate_rb_simple_exception_constructor(t_rb_ofstream& out, t_struct* tstruct); void generate_field_constants(t_rb_ofstream& out, t_struct* tstruct); void generate_field_constructors(t_rb_ofstream& out, t_struct* tstruct); void generate_field_defns(t_rb_ofstream& out, t_struct* tstruct); void generate_field_data(t_rb_ofstream& out, t_type* field_type, const std::string& field_name, t_const_value* field_value, bool optional); /** * Service-level generation functions */ void generate_service_helpers(t_service* tservice); void generate_service_interface(t_service* tservice); void generate_service_client(t_service* tservice); void generate_service_server(t_service* tservice); void generate_process_function(t_service* tservice, t_function* tfunction); /** * Serialization constructs */ void generate_deserialize_field(t_rb_ofstream& out, t_field* tfield, std::string prefix = "", bool inclass = false); void generate_deserialize_struct(t_rb_ofstream& out, t_struct* tstruct, std::string prefix = ""); void generate_deserialize_container(t_rb_ofstream& out, t_type* ttype, std::string prefix = ""); void generate_deserialize_set_element(t_rb_ofstream& out, t_set* tset, std::string prefix = ""); void generate_deserialize_map_element(t_rb_ofstream& out, t_map* tmap, std::string prefix = ""); void generate_deserialize_list_element(t_rb_ofstream& out, t_list* tlist, std::string prefix = ""); void generate_serialize_field(t_rb_ofstream& out, t_field* tfield, std::string prefix = ""); void generate_serialize_struct(t_rb_ofstream& out, t_struct* tstruct, std::string prefix = ""); void generate_serialize_container(t_rb_ofstream& out, t_type* ttype, std::string prefix = ""); void generate_serialize_map_element(t_rb_ofstream& out, t_map* tmap, std::string kiter, std::string viter); void generate_serialize_set_element(t_rb_ofstream& out, t_set* tmap, std::string iter); void generate_serialize_list_element(t_rb_ofstream& out, t_list* tlist, std::string iter); void generate_rdoc(t_rb_ofstream& out, t_doc* tdoc); /** * Helper rendering functions */ std::string rb_autogen_comment(); std::string render_require_thrift(); std::string render_includes(); std::string declare_field(t_field* tfield); std::string type_name(const t_type* ttype); std::string full_type_name(const t_type* ttype); std::string function_signature(t_function* tfunction, std::string prefix = ""); std::string argument_list(t_struct* tstruct); std::string type_to_enum(t_type* ttype); std::string rb_namespace_to_path_prefix(std::string rb_namespace); std::vector ruby_modules(const t_program* p) { std::string ns = p->get_namespace("rb"); std::vector modules; if (ns.empty()) { return modules; } std::string::iterator pos = ns.begin(); while (true) { std::string::iterator delim = std::find(pos, ns.end(), '.'); modules.push_back(capitalize(std::string(pos, delim))); pos = delim; if (pos == ns.end()) { break; } ++pos; } return modules; } void begin_namespace(t_rb_ofstream&, std::vector); void end_namespace(t_rb_ofstream&, std::vector); private: /** * File streams */ t_rb_ofstream f_types_; t_rb_ofstream f_consts_; t_rb_ofstream f_service_; std::string namespace_dir_; std::string require_prefix_; /** If true, add a "require 'rubygems'" line to the top of each gen-rb file. */ bool require_rubygems_; /** If true, generate files in idiomatic namespaced directories. */ bool namespaced_; }; /** * Prepares for file generation by opening up the necessary file output * streams. * * @param tprogram The program to generate */ void t_rb_generator::init_generator() { string subdir = get_out_dir(); // Make output directory MKDIR(subdir.c_str()); if (namespaced_) { require_prefix_ = rb_namespace_to_path_prefix(program_->get_namespace("rb")); string dir = require_prefix_; string::size_type loc; while ((loc = dir.find("/")) != string::npos) { subdir = subdir + dir.substr(0, loc) + "/"; MKDIR(subdir.c_str()); dir = dir.substr(loc + 1); } } namespace_dir_ = subdir; // Make output file string f_types_name = namespace_dir_ + underscore(program_name_) + "_types.rb"; f_types_.open(f_types_name.c_str()); string f_consts_name = namespace_dir_ + underscore(program_name_) + "_constants.rb"; f_consts_.open(f_consts_name.c_str()); // Print header f_types_ << rb_autogen_comment() << '\n' << render_require_thrift() << render_includes() << '\n'; begin_namespace(f_types_, ruby_modules(program_)); f_consts_ << rb_autogen_comment() << '\n' << render_require_thrift() << "require '" << require_prefix_ << underscore(program_name_) << "_types'" << '\n' << '\n'; begin_namespace(f_consts_, ruby_modules(program_)); } /** * Renders the require of thrift itself, and possibly of the rubygems dependency. */ string t_rb_generator::render_require_thrift() { if (require_rubygems_) { return "require 'rubygems'\nrequire 'thrift'\n"; } else { return "require 'thrift'\n"; } } /** * Renders all the imports necessary for including another Thrift program */ string t_rb_generator::render_includes() { const vector& includes = program_->get_includes(); string result = ""; for (auto include : includes) { if (namespaced_) { t_program* included = include; std::string included_require_prefix = rb_namespace_to_path_prefix(included->get_namespace("rb")); std::string included_name = included->get_name(); result += "require '" + included_require_prefix + underscore(included_name) + "_types'\n"; } else { result += "require '" + underscore(include->get_name()) + "_types'\n"; } } if (includes.size() > 0) { result += "\n"; } return result; } /** * Autogen'd comment */ string t_rb_generator::rb_autogen_comment() { return std::string("#\n") + "# Autogenerated by Thrift Compiler (" + THRIFT_VERSION + ")\n" + "#\n" + "# DO NOT EDIT UNLESS YOU ARE SURE THAT YOU KNOW WHAT YOU ARE DOING\n" + "#\n"; } /** * Closes the type files */ void t_rb_generator::close_generator() { // Close types file end_namespace(f_types_, ruby_modules(program_)); end_namespace(f_consts_, ruby_modules(program_)); f_types_.close(); f_consts_.close(); } /** * Generates a typedef. This is not done in Ruby, types are all implicit. * * @param ttypedef The type definition */ void t_rb_generator::generate_typedef(t_typedef* ttypedef) { (void)ttypedef; } /** * Generates code for an enumerated type. Done using a class to scope * the values. * * @param tenum The enumeration */ void t_rb_generator::generate_enum(t_enum* tenum) { f_types_.indent() << "module " << capitalize(tenum->get_name()) << '\n'; f_types_.indent_up(); vector constants = tenum->get_constants(); vector::iterator c_iter; for (c_iter = constants.begin(); c_iter != constants.end(); ++c_iter) { int value = (*c_iter)->get_value(); // Ruby class constants have to be capitalized... omg i am so on the fence // about languages strictly enforcing capitalization why can't we just all // agree and play nice. string name = capitalize((*c_iter)->get_name()); generate_rdoc(f_types_, *c_iter); f_types_.indent() << name << " = " << value << '\n'; } // Create a hash mapping values back to their names (as strings) since ruby has no native enum // type f_types_.indent() << "VALUE_MAP = {"; for (c_iter = constants.begin(); c_iter != constants.end(); ++c_iter) { // Populate the hash int value = (*c_iter)->get_value(); if (c_iter != constants.begin()) f_types_ << ", "; f_types_ << value << " => \"" << capitalize((*c_iter)->get_name()) << "\""; } f_types_ << "}" << '\n'; // Create a set with valid values for this enum f_types_.indent() << "VALID_VALUES = Set.new(["; for (c_iter = constants.begin(); c_iter != constants.end(); ++c_iter) { // Populate the set if (c_iter != constants.begin()) f_types_ << ", "; f_types_ << capitalize((*c_iter)->get_name()); } f_types_ << "]).freeze" << '\n'; f_types_.indent_down(); f_types_.indent() << "end" << '\n' << '\n'; } /** * Generate a constant value */ void t_rb_generator::generate_const(t_const* tconst) { t_type* type = tconst->get_type(); string name = tconst->get_name(); t_const_value* value = tconst->get_value(); name[0] = toupper(name[0]); f_consts_.indent() << name << " = "; render_const_value(f_consts_, type, value) << '\n' << '\n'; } /** * Prints the value of a constant with the given type. Note that type checking * is NOT performed in this function as it is always run beforehand using the * validate_types method in main.cc */ t_rb_ofstream& t_rb_generator::render_const_value(t_rb_ofstream& out, t_type* type, t_const_value* value) { type = get_true_type(type); if (type->is_base_type()) { t_base_type::t_base tbase = ((t_base_type*)type)->get_base(); switch (tbase) { case t_base_type::TYPE_STRING: out << "%q\"" << get_escaped_string(value) << '"'; break; case t_base_type::TYPE_BOOL: out << (value->get_integer() > 0 ? "true" : "false"); break; case t_base_type::TYPE_I8: case t_base_type::TYPE_I16: case t_base_type::TYPE_I32: case t_base_type::TYPE_I64: out << value->get_integer(); break; case t_base_type::TYPE_DOUBLE: if (value->get_type() == t_const_value::CV_INTEGER) { out << value->get_integer(); } else { out << value->get_double(); } break; default: throw "compiler error: no const of base type " + t_base_type::t_base_name(tbase); } } else if (type->is_enum()) { out.indent() << value->get_integer(); } else if (type->is_struct() || type->is_xception()) { out << full_type_name(type) << ".new({" << '\n'; out.indent_up(); const vector& fields = ((t_struct*)type)->get_members(); vector::const_iterator f_iter; const map& val = value->get_map(); map::const_iterator v_iter; for (v_iter = val.begin(); v_iter != val.end(); ++v_iter) { t_type* field_type = nullptr; for (f_iter = fields.begin(); f_iter != fields.end(); ++f_iter) { if ((*f_iter)->get_name() == v_iter->first->get_string()) { field_type = (*f_iter)->get_type(); } } if (field_type == nullptr) { throw "type error: " + type->get_name() + " has no field " + v_iter->first->get_string(); } out.indent(); render_const_value(out, g_type_string, v_iter->first) << " => "; render_const_value(out, field_type, v_iter->second) << "," << '\n'; } out.indent_down(); out.indent() << "})"; } else if (type->is_map()) { t_type* ktype = ((t_map*)type)->get_key_type(); t_type* vtype = ((t_map*)type)->get_val_type(); out << "{" << '\n'; out.indent_up(); const map& val = value->get_map(); map::const_iterator v_iter; for (v_iter = val.begin(); v_iter != val.end(); ++v_iter) { out.indent(); render_const_value(out, ktype, v_iter->first) << " => "; render_const_value(out, vtype, v_iter->second) << "," << '\n'; } out.indent_down(); out.indent() << "}"; } else if (type->is_list() || type->is_set()) { t_type* etype; if (type->is_list()) { etype = ((t_list*)type)->get_elem_type(); } else { etype = ((t_set*)type)->get_elem_type(); } if (type->is_set()) { out << "Set.new([" << '\n'; } else { out << "[" << '\n'; } out.indent_up(); const vector& val = value->get_list(); vector::const_iterator v_iter; for (v_iter = val.begin(); v_iter != val.end(); ++v_iter) { out.indent(); render_const_value(out, etype, *v_iter) << "," << '\n'; } out.indent_down(); if (type->is_set()) { out.indent() << "])"; } else { out.indent() << "]"; } } else { throw "CANNOT GENERATE CONSTANT FOR TYPE: " + type->get_name(); } return out; } /** * Generates a ruby struct */ void t_rb_generator::generate_struct(t_struct* tstruct) { if (tstruct->is_union()) { generate_rb_union(f_types_, tstruct, false); } else { generate_rb_struct(f_types_, tstruct, false); } } /** * Generates the "forward declarations" for ruby structs. * These are simply a declaration of each class with proper inheritance. * The rest of the struct is still generated in generate_struct as has * always been the case. These declarations allow thrift to generate valid * ruby in cases where thrift structs rely on recursive definitions. */ void t_rb_generator::generate_forward_declaration(t_struct* tstruct) { generate_rb_struct_declaration(f_types_, tstruct, tstruct->is_xception()); } void t_rb_generator::generate_rb_struct_declaration(t_rb_ofstream& out, t_struct* tstruct, bool is_exception) { out.indent() << "class " << type_name(tstruct); if (tstruct->is_union()) { out << " < ::Thrift::Union"; } if (is_exception) { out << " < ::Thrift::Exception"; } out << "; end" << '\n' << '\n'; } /** * Generates a struct definition for a thrift exception. Basically the same * as a struct but extends the Exception class. * * @param txception The struct definition */ void t_rb_generator::generate_xception(t_struct* txception) { generate_rb_struct(f_types_, txception, true); } /** * Generates a ruby struct */ void t_rb_generator::generate_rb_struct(t_rb_ofstream& out, t_struct* tstruct, bool is_exception = false) { generate_rdoc(out, tstruct); out.indent() << "class " << type_name(tstruct); if (is_exception) { out << " < ::Thrift::Exception"; } out << '\n'; out.indent_up(); out.indent() << "include ::Thrift::Struct, ::Thrift::Struct_Union" << '\n'; if (is_exception) { generate_rb_simple_exception_constructor(out, tstruct); } generate_field_constants(out, tstruct); generate_field_defns(out, tstruct); generate_rb_struct_required_validator(out, tstruct); out.indent() << "::Thrift::Struct.generate_accessors self" << '\n'; out.indent_down(); out.indent() << "end" << '\n' << '\n'; } /** * Generates a ruby union */ void t_rb_generator::generate_rb_union(t_rb_ofstream& out, t_struct* tstruct, bool is_exception = false) { (void)is_exception; generate_rdoc(out, tstruct); out.indent() << "class " << type_name(tstruct) << " < ::Thrift::Union" << '\n'; out.indent_up(); out.indent() << "include ::Thrift::Struct_Union" << '\n'; generate_field_constructors(out, tstruct); generate_field_constants(out, tstruct); generate_field_defns(out, tstruct); generate_rb_union_validator(out, tstruct); out.indent() << "::Thrift::Union.generate_accessors self" << '\n'; out.indent_down(); out.indent() << "end" << '\n' << '\n'; } void t_rb_generator::generate_field_constructors(t_rb_ofstream& out, t_struct* tstruct) { out.indent() << "class << self" << '\n'; out.indent_up(); const vector& fields = tstruct->get_members(); vector::const_iterator f_iter; for (f_iter = fields.begin(); f_iter != fields.end(); ++f_iter) { if (f_iter != fields.begin()) { out << '\n'; } std::string field_name = (*f_iter)->get_name(); out.indent() << "def " << field_name << "(val)" << '\n'; out.indent() << " " << tstruct->get_name() << ".new(:" << field_name << ", val)" << '\n'; out.indent() << "end" << '\n'; } out.indent_down(); out.indent() << "end" << '\n'; out << '\n'; } void t_rb_generator::generate_rb_simple_exception_constructor(t_rb_ofstream& out, t_struct* tstruct) { const vector& members = tstruct->get_members(); if (members.size() == 1) { vector::const_iterator m_iter = members.begin(); if ((*m_iter)->get_type()->is_string()) { string name = (*m_iter)->get_name(); out.indent() << "def initialize(message=nil)" << '\n'; out.indent_up(); out.indent() << "super()" << '\n'; out.indent() << "self." << name << " = message" << '\n'; out.indent_down(); out.indent() << "end" << '\n' << '\n'; if (name != "message") { out.indent() << "def message; " << name << " end" << '\n' << '\n'; } } } } void t_rb_generator::generate_field_constants(t_rb_ofstream& out, t_struct* tstruct) { const vector& fields = tstruct->get_members(); vector::const_iterator f_iter; for (f_iter = fields.begin(); f_iter != fields.end(); ++f_iter) { std::string field_name = (*f_iter)->get_name(); std::string cap_field_name = upcase_string(field_name); out.indent() << cap_field_name << " = " << (*f_iter)->get_key() << '\n'; } out << '\n'; } void t_rb_generator::generate_field_defns(t_rb_ofstream& out, t_struct* tstruct) { const vector& fields = tstruct->get_members(); vector::const_iterator f_iter; out.indent() << "FIELDS = {" << '\n'; out.indent_up(); for (f_iter = fields.begin(); f_iter != fields.end(); ++f_iter) { if (f_iter != fields.begin()) { out << "," << '\n'; } // generate the field docstrings within the FIELDS constant. no real better place... generate_rdoc(out, *f_iter); out.indent() << upcase_string((*f_iter)->get_name()) << " => "; generate_field_data(out, (*f_iter)->get_type(), (*f_iter)->get_name(), (*f_iter)->get_value(), (*f_iter)->get_req() == t_field::T_OPTIONAL); } out.indent_down(); out << '\n'; out.indent() << "}" << '\n' << '\n'; out.indent() << "def struct_fields; FIELDS; end" << '\n' << '\n'; } void t_rb_generator::generate_field_data(t_rb_ofstream& out, t_type* field_type, const std::string& field_name = "", t_const_value* field_value = nullptr, bool optional = false) { field_type = get_true_type(field_type); // Begin this field's defn out << "{:type => " << type_to_enum(field_type); if (!field_name.empty()) { out << ", :name => '" << field_name << "'"; } if (field_value != nullptr) { out << ", :default => "; render_const_value(out, field_type, field_value); } if (!field_type->is_base_type()) { if (field_type->is_struct() || field_type->is_xception()) { out << ", :class => " << full_type_name((t_struct*)field_type); } else if (field_type->is_list()) { out << ", :element => "; generate_field_data(out, ((t_list*)field_type)->get_elem_type()); } else if (field_type->is_map()) { out << ", :key => "; generate_field_data(out, ((t_map*)field_type)->get_key_type()); out << ", :value => "; generate_field_data(out, ((t_map*)field_type)->get_val_type()); } else if (field_type->is_set()) { out << ", :element => "; generate_field_data(out, ((t_set*)field_type)->get_elem_type()); } } else { if (((t_base_type*)field_type)->is_binary()) { out << ", :binary => true"; } } if (optional) { out << ", :optional => true"; } if (field_type->is_enum()) { out << ", :enum_class => " << full_type_name(field_type); } // End of this field's defn out << "}"; } void t_rb_generator::begin_namespace(t_rb_ofstream& out, vector modules) { for (auto & module : modules) { out.indent() << "module " << module << '\n'; out.indent_up(); } } void t_rb_generator::end_namespace(t_rb_ofstream& out, vector modules) { for (vector::reverse_iterator m_iter = modules.rbegin(); m_iter != modules.rend(); ++m_iter) { out.indent_down(); out.indent() << "end" << '\n'; } } /** * Generates a thrift service. * * @param tservice The service definition */ void t_rb_generator::generate_service(t_service* tservice) { string f_service_name = namespace_dir_ + underscore(service_name_) + ".rb"; f_service_.open(f_service_name.c_str()); f_service_ << rb_autogen_comment() << '\n' << render_require_thrift(); if (tservice->get_extends() != nullptr) { if (namespaced_) { f_service_ << "require '" << rb_namespace_to_path_prefix( tservice->get_extends()->get_program()->get_namespace("rb")) << underscore(tservice->get_extends()->get_name()) << "'" << '\n'; } else { f_service_ << "require '" << require_prefix_ << underscore(tservice->get_extends()->get_name()) << "'" << '\n'; } } f_service_ << "require '" << require_prefix_ << underscore(program_name_) << "_types'" << '\n' << '\n'; begin_namespace(f_service_, ruby_modules(tservice->get_program())); f_service_.indent() << "module " << capitalize(tservice->get_name()) << '\n'; f_service_.indent_up(); // Generate the three main parts of the service (well, two for now in PHP) generate_service_client(tservice); generate_service_server(tservice); generate_service_helpers(tservice); f_service_.indent_down(); f_service_.indent() << "end" << '\n' << '\n'; end_namespace(f_service_, ruby_modules(tservice->get_program())); // Close service file f_service_.close(); } /** * Generates helper functions for a service. * * @param tservice The service to generate a header definition for */ void t_rb_generator::generate_service_helpers(t_service* tservice) { vector functions = tservice->get_functions(); vector::iterator f_iter; f_service_.indent() << "# HELPER FUNCTIONS AND STRUCTURES" << '\n' << '\n'; for (f_iter = functions.begin(); f_iter != functions.end(); ++f_iter) { t_struct* ts = (*f_iter)->get_arglist(); generate_rb_struct(f_service_, ts); generate_rb_function_helpers(*f_iter); } } /** * Generates a struct and helpers for a function. * * @param tfunction The function */ void t_rb_generator::generate_rb_function_helpers(t_function* tfunction) { t_struct result(program_, tfunction->get_name() + "_result"); t_field success(tfunction->get_returntype(), "success", 0); if (!tfunction->get_returntype()->is_void()) { result.append(&success); } t_struct* xs = tfunction->get_xceptions(); const vector& fields = xs->get_members(); vector::const_iterator f_iter; for (f_iter = fields.begin(); f_iter != fields.end(); ++f_iter) { result.append(*f_iter); } generate_rb_struct(f_service_, &result); } /** * Generates a service client definition. * * @param tservice The service to generate a server for. */ void t_rb_generator::generate_service_client(t_service* tservice) { string extends = ""; string extends_client = ""; if (tservice->get_extends() != nullptr) { extends = full_type_name(tservice->get_extends()); extends_client = " < " + extends + "::Client "; } f_service_.indent() << "class Client" << extends_client << '\n'; f_service_.indent_up(); f_service_.indent() << "include ::Thrift::Client" << '\n' << '\n'; // Generate client method implementations vector functions = tservice->get_functions(); vector::const_iterator f_iter; for (f_iter = functions.begin(); f_iter != functions.end(); ++f_iter) { t_struct* arg_struct = (*f_iter)->get_arglist(); const vector& fields = arg_struct->get_members(); vector::const_iterator fld_iter; string funname = (*f_iter)->get_name(); // Open function f_service_.indent() << "def " << function_signature(*f_iter) << '\n'; f_service_.indent_up(); f_service_.indent() << "send_" << funname << "("; bool first = true; for (fld_iter = fields.begin(); fld_iter != fields.end(); ++fld_iter) { if (first) { first = false; } else { f_service_ << ", "; } f_service_ << (*fld_iter)->get_name(); } f_service_ << ")" << '\n'; if (!(*f_iter)->is_oneway()) { f_service_.indent(); if (!(*f_iter)->get_returntype()->is_void()) { f_service_ << "return "; } f_service_ << "recv_" << funname << "()" << '\n'; } f_service_.indent_down(); f_service_.indent() << "end" << '\n'; f_service_ << '\n'; f_service_.indent() << "def send_" << function_signature(*f_iter) << '\n'; f_service_.indent_up(); std::string argsname = capitalize((*f_iter)->get_name() + "_args"); std::string messageSendProc = (*f_iter)->is_oneway() ? "send_oneway_message" : "send_message"; f_service_.indent() << messageSendProc << "('" << funname << "', " << argsname; for (fld_iter = fields.begin(); fld_iter != fields.end(); ++fld_iter) { f_service_ << ", :" << (*fld_iter)->get_name() << " => " << (*fld_iter)->get_name(); } f_service_ << ")" << '\n'; f_service_.indent_down(); f_service_.indent() << "end" << '\n'; if (!(*f_iter)->is_oneway()) { std::string resultname = capitalize((*f_iter)->get_name() + "_result"); t_struct noargs(program_); t_function recv_function((*f_iter)->get_returntype(), string("recv_") + (*f_iter)->get_name(), &noargs); // Open function f_service_ << '\n'; f_service_.indent() << "def " << function_signature(&recv_function) << '\n'; f_service_.indent_up(); f_service_.indent() << "fname, mtype, rseqid = receive_message_begin()" << '\n'; f_service_.indent() << "handle_exception(mtype)" << '\n'; f_service_.indent() << "if reply_seqid(rseqid)==false" << '\n'; f_service_.indent() << " raise \"seqid reply faild\"" << '\n'; f_service_.indent() << "end" << '\n'; f_service_.indent() << "result = receive_message(" << resultname << ")" << '\n'; // Careful, only return _result if not a void function if (!(*f_iter)->get_returntype()->is_void()) { f_service_.indent() << "return result.success unless result.success.nil?" << '\n'; } t_struct* xs = (*f_iter)->get_xceptions(); const std::vector& xceptions = xs->get_members(); vector::const_iterator x_iter; for (x_iter = xceptions.begin(); x_iter != xceptions.end(); ++x_iter) { f_service_.indent() << "raise result." << (*x_iter)->get_name() << " unless result." << (*x_iter)->get_name() << ".nil?" << '\n'; } // Careful, only return _result if not a void function if ((*f_iter)->get_returntype()->is_void()) { f_service_.indent() << "return" << '\n'; } else { f_service_.indent() << "raise " "::Thrift::ApplicationException.new(::Thrift::ApplicationException::" "MISSING_RESULT, '" << (*f_iter)->get_name() << " failed: unknown result')" << '\n'; } // Close function f_service_.indent_down(); f_service_.indent() << "end" << '\n' << '\n'; } } f_service_.indent_down(); f_service_.indent() << "end" << '\n' << '\n'; } /** * Generates a service server definition. * * @param tservice The service to generate a server for. */ void t_rb_generator::generate_service_server(t_service* tservice) { // Generate the dispatch methods vector functions = tservice->get_functions(); vector::iterator f_iter; string extends = ""; string extends_processor = ""; if (tservice->get_extends() != nullptr) { extends = full_type_name(tservice->get_extends()); extends_processor = " < " + extends + "::Processor "; } // Generate the header portion f_service_.indent() << "class Processor" << extends_processor << '\n'; f_service_.indent_up(); f_service_.indent() << "include ::Thrift::Processor" << '\n' << '\n'; // Generate the process subfunctions for (f_iter = functions.begin(); f_iter != functions.end(); ++f_iter) { generate_process_function(tservice, *f_iter); } f_service_.indent_down(); f_service_.indent() << "end" << '\n' << '\n'; } /** * Generates a process function definition. * * @param tfunction The function to write a dispatcher for */ void t_rb_generator::generate_process_function(t_service* tservice, t_function* tfunction) { (void)tservice; // Open function f_service_.indent() << "def process_" << tfunction->get_name() << "(seqid, iprot, oprot)" << '\n'; f_service_.indent_up(); string argsname = capitalize(tfunction->get_name()) + "_args"; string resultname = capitalize(tfunction->get_name()) + "_result"; f_service_.indent() << "args = read_args(iprot, " << argsname << ")" << '\n'; t_struct* xs = tfunction->get_xceptions(); const std::vector& xceptions = xs->get_members(); vector::const_iterator x_iter; // Declare result for non oneway function if (!tfunction->is_oneway()) { f_service_.indent() << "result = " << resultname << ".new()" << '\n'; } // Try block for a function with exceptions if (xceptions.size() > 0) { f_service_.indent() << "begin" << '\n'; f_service_.indent_up(); } // Generate the function call t_struct* arg_struct = tfunction->get_arglist(); const std::vector& fields = arg_struct->get_members(); vector::const_iterator f_iter; f_service_.indent(); if (!tfunction->is_oneway() && !tfunction->get_returntype()->is_void()) { f_service_ << "result.success = "; } f_service_ << "@handler." << tfunction->get_name() << "("; bool first = true; for (f_iter = fields.begin(); f_iter != fields.end(); ++f_iter) { if (first) { first = false; } else { f_service_ << ", "; } f_service_ << "args." << (*f_iter)->get_name(); } f_service_ << ")" << '\n'; if (!tfunction->is_oneway() && xceptions.size() > 0) { f_service_.indent_down(); for (x_iter = xceptions.begin(); x_iter != xceptions.end(); ++x_iter) { f_service_.indent() << "rescue " << full_type_name((*x_iter)->get_type()) << " => " << (*x_iter)->get_name() << '\n'; if (!tfunction->is_oneway()) { f_service_.indent_up(); f_service_.indent() << "result." << (*x_iter)->get_name() << " = " << (*x_iter)->get_name() << '\n'; f_service_.indent_down(); } } f_service_.indent() << "end" << '\n'; } // Shortcut out here for oneway functions if (tfunction->is_oneway()) { f_service_.indent() << "return" << '\n'; f_service_.indent_down(); f_service_.indent() << "end" << '\n' << '\n'; return; } f_service_.indent() << "write_result(result, oprot, '" << tfunction->get_name() << "', seqid)" << '\n'; // Close function f_service_.indent_down(); f_service_.indent() << "end" << '\n' << '\n'; } /** * Renders a function signature of the form 'type name(args)' * * @param tfunction Function definition * @return String of rendered function definition */ string t_rb_generator::function_signature(t_function* tfunction, string prefix) { // TODO(mcslee): Nitpicky, no ',' if argument_list is empty return prefix + tfunction->get_name() + "(" + argument_list(tfunction->get_arglist()) + ")"; } /** * Renders a field list */ string t_rb_generator::argument_list(t_struct* tstruct) { string result = ""; const vector& fields = tstruct->get_members(); vector::const_iterator f_iter; bool first = true; for (f_iter = fields.begin(); f_iter != fields.end(); ++f_iter) { if (first) { first = false; } else { result += ", "; } result += (*f_iter)->get_name(); } return result; } string t_rb_generator::type_name(const t_type* ttype) { string prefix = ""; string name = ttype->get_name(); if (ttype->is_struct() || ttype->is_xception() || ttype->is_enum()) { name = capitalize(ttype->get_name()); } return prefix + name; } string t_rb_generator::full_type_name(const t_type* ttype) { string prefix = "::"; vector modules = ruby_modules(ttype->get_program()); for (auto & module : modules) { prefix += module + "::"; } return prefix + type_name(ttype); } /** * Converts the parse type to a Ruby tyoe */ string t_rb_generator::type_to_enum(t_type* type) { type = get_true_type(type); if (type->is_base_type()) { t_base_type::t_base tbase = ((t_base_type*)type)->get_base(); switch (tbase) { case t_base_type::TYPE_VOID: throw "NO T_VOID CONSTRUCT"; case t_base_type::TYPE_STRING: return "::Thrift::Types::STRING"; case t_base_type::TYPE_BOOL: return "::Thrift::Types::BOOL"; case t_base_type::TYPE_I8: return "::Thrift::Types::BYTE"; case t_base_type::TYPE_I16: return "::Thrift::Types::I16"; case t_base_type::TYPE_I32: return "::Thrift::Types::I32"; case t_base_type::TYPE_I64: return "::Thrift::Types::I64"; case t_base_type::TYPE_DOUBLE: return "::Thrift::Types::DOUBLE"; default: throw "compiler error: unhandled type"; } } else if (type->is_enum()) { return "::Thrift::Types::I32"; } else if (type->is_struct() || type->is_xception()) { return "::Thrift::Types::STRUCT"; } else if (type->is_map()) { return "::Thrift::Types::MAP"; } else if (type->is_set()) { return "::Thrift::Types::SET"; } else if (type->is_list()) { return "::Thrift::Types::LIST"; } throw "INVALID TYPE IN type_to_enum: " + type->get_name(); } string t_rb_generator::rb_namespace_to_path_prefix(string rb_namespace) { string namespaces_left = rb_namespace; string::size_type loc; string path_prefix = ""; while ((loc = namespaces_left.find(".")) != string::npos) { path_prefix = path_prefix + underscore(namespaces_left.substr(0, loc)) + "/"; namespaces_left = namespaces_left.substr(loc + 1); } if (namespaces_left.size() > 0) { path_prefix = path_prefix + underscore(namespaces_left) + "/"; } return path_prefix; } void t_rb_generator::generate_rdoc(t_rb_ofstream& out, t_doc* tdoc) { if (tdoc->has_doc()) { out.indent(); generate_docstring_comment(out, "", "# ", tdoc->get_doc(), ""); } } void t_rb_generator::generate_rb_struct_required_validator(t_rb_ofstream& out, t_struct* tstruct) { out.indent() << "def validate" << '\n'; out.indent_up(); const vector& fields = tstruct->get_members(); vector::const_iterator f_iter; for (f_iter = fields.begin(); f_iter != fields.end(); ++f_iter) { t_field* field = (*f_iter); if (field->get_req() == t_field::T_REQUIRED) { out.indent() << "raise ::Thrift::ProtocolException.new(::Thrift::ProtocolException::UNKNOWN, " "'Required field " << field->get_name() << " is unset!')"; if (field->get_type()->is_bool()) { out << " if @" << field->get_name() << ".nil?"; } else { out << " unless @" << field->get_name(); } out << '\n'; } } // if field is an enum, check that its value is valid for (f_iter = fields.begin(); f_iter != fields.end(); ++f_iter) { t_field* field = (*f_iter); if (field->get_type()->is_enum()) { out.indent() << "unless @" << field->get_name() << ".nil? || " << full_type_name(field->get_type()) << "::VALID_VALUES.include?(@" << field->get_name() << ")" << '\n'; out.indent_up(); out.indent() << "raise ::Thrift::ProtocolException.new(::Thrift::ProtocolException::UNKNOWN, " "'Invalid value of field " << field->get_name() << "!')" << '\n'; out.indent_down(); out.indent() << "end" << '\n'; } } out.indent_down(); out.indent() << "end" << '\n' << '\n'; } void t_rb_generator::generate_rb_union_validator(t_rb_ofstream& out, t_struct* tstruct) { out.indent() << "def validate" << '\n'; out.indent_up(); const vector& fields = tstruct->get_members(); vector::const_iterator f_iter; out.indent() << "raise(StandardError, 'Union fields are not set.') if get_set_field.nil? || get_value.nil?" << '\n'; // if field is an enum, check that its value is valid for (f_iter = fields.begin(); f_iter != fields.end(); ++f_iter) { const t_field* field = (*f_iter); if (field->get_type()->is_enum()) { out.indent() << "if get_set_field == :" << field->get_name() << '\n'; out.indent() << " raise " "::Thrift::ProtocolException.new(::Thrift::ProtocolException::UNKNOWN, " "'Invalid value of field " << field->get_name() << "!') unless " << full_type_name(field->get_type()) << "::VALID_VALUES.include?(get_value)" << '\n'; out.indent() << "end" << '\n'; } } out.indent_down(); out.indent() << "end" << '\n' << '\n'; } std::string t_rb_generator::display_name() const { return "Ruby"; } THRIFT_REGISTER_GENERATOR( rb, "Ruby", " rubygems: Add a \"require 'rubygems'\" line to the top of each generated file.\n" " namespaced: Generate files in idiomatic namespaced directories.\n")