AWS SDK の各言語版がどのように生成されているのかちょっと見てみた

#AWS

Daisuke Fujimura

2017.12.22

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

「スタバで注文するのはいつも Venti」でおなじみの fujimura です。

AWS SDK が JSON で書かれた定義ファイルから生成されたものという話を以前、聞いた記憶があったので、具体的にどのように生成されているのか、いくつかの repository をさっくりのぞいてみました。

Java

aws/aws-sdk-java: The official AWS SDK for Java.

テンプレートファイルは /aws-java-sdk-code-generator/src/main/resources/templates 配下に見当たります。ファイル名の拡張子が ftl ということから FreeMarker を使用しているようです。

${fileHeader}

<#assign documentation = (metadata.documentation)!""/>

/**
 * ${documentation}
 */
package ${metadata.packageName};

pom.xml の dependencies にも freemarker があることを確認しました。

    <dependency>
        <artifactId>freemarker</artifactId>
        <groupId>org.freemarker</groupId>
        <optional>false</optional>
        <version>2.3.24-incubating</version>
    </dependency>

C++

aws/aws-sdk-cpp: AWS SDK for C++

テンプレートファイルは /code-generation/generator/src/main/resources/com/amazonaws/util/awsclientgenerator/velocity 配下に見当たります。途中のディレクトリ名のあるとおり Velocity を使用しているようです。

#set($enumSize = $enumModel.members.size())
#set($count = 1)
  enum class ${enumModel.name}
  {
    NOT_SET,
#foreach($enumMember in $enumModel.members)
    ${enumMember.memberName}#if($count < $enumSize),${nl}#end
#set($count = $count + 1)
#end

  };

namespace ${enumModel.name}Mapper
{
${typeInfo.exportValue} ${enumModel.name} Get${enumModel.name}ForName(const Aws::String& name);

${typeInfo.exportValue} Aws::String GetNameFor${enumModel.name}(${enumModel.name} value);
} // namespace ${enumModel.name}Mapper

こちらも pom.xml の dependencies に velocity があることを確認しました。

        <dependency>
            <groupId>org.apache.velocity</groupId>
            <artifactId>velocity-tools</artifactId>
            <version>2.0</version>
        </dependency>
        <dependency>
            <groupId>org.apache.velocity</groupId>
            <artifactId>velocity</artifactId>
            <version>1.7</version>
        </dependency>

Java とは異なるテンプレートエンジンなのはちょっと興味深いです。

Ruby

aws/aws-sdk-ruby: The official AWS SDK for Ruby.

テンプレートファイルは /build_tools/aws-sdk-code-generator/templates に見当たります。こちらは Mustache を使用してるようです。

{{#generated_src_warning}}
{{generated_src_warning}}
{{/generated_src_warning}}
module {{module_name}}
  module Errors

    extend Aws::Errors::DynamicErrors

  end
end

Gemfile に mustache の記述がありました。

group :build do
  # using this to fix poorly formatted HTML in API docs
  gem 'kramdown', '1.14.0' # pinned to support Ruby 1.9.3
  gem 'mustache', '0.99.8' # pinned to support Ruby 1.9.3
end