Mobile Platform as a Service:サービス定義と開発

MPC API サービスの登録

MPC API サービスを登録するには、次のパラメーターが必要です：

• registryUrl：レジストリのアドレス。共有金融テクノロジーレジストリのアドレスは mpcpub.mpaas.cn-hangzhou.aliyuncs.com です。

• appName：ご利用のアプリケーションの名前。これは API グループ名と同じである必要があります。

• workspaceId：アプリケーションが配置されている環境のワークスペース ID。

• projectName：アプリケーションが属するテナントのプロジェクト名。これは API グループのプロジェクト名と同じである必要があります。

• privateKeyPath：RSA 秘密鍵のクラスパス。このキーは、mpaaschannel への接続を検証するために使用されます。これを /META-INF/config/rsa-mpc-pri-key-{env}.der に配置することを推奨します。ここで、{env} は dev、sit、prod などのさまざまな環境を表します。

公開鍵の設定

対応する環境のコンソールで、左側のナビゲーションウィンドウから [コード管理] > [インターフェイスキー] > [設定] を選択します。ご利用の秘密鍵に対応する RSA 公開鍵を設定します。

次のコマンドは、RSA キーペアを生成する方法を示しています。コンソールで公開鍵を設定します。ご利用のバックエンドアプリケーションの ${privateKeyPath} に秘密鍵ファイルを設定します：

* キーペアの生成方法： 
* ### 2048 ビットの RSA 秘密鍵を生成 
* 
* $ openssl genrsa -out private_key.pem 2048 
* 
* ### 秘密鍵を PKCS#8 フォーマットに変換 (Java で読み取り可能にするため) 
* 
* $ openssl pkcs8 -topk8 -inform PEM -outform DER -in private_key.pem -out private_key.der -nocrypt 
* 
* ### 公開鍵部分を DER フォーマットで出力 (Java で読み取り可能にするため) 
* 
* $ openssl rsa -in private_key.pem -pubout -outform DER -out public_key.der 
* 
* ### base64 に変換：
* 
* ## 生成された秘密鍵は、バックエンドアプリケーションで設定します
* $ openssl base64 -in private_key.der -out private_key_base64.der
* 
* ## 生成された公開鍵は、コンソールのインターフェイスキーで設定します
* $ openssl base64 -in public_key.der -out public_key_base64.der
* 
* ### 送信する前に、空白文字と改行を削除することを忘れないでください！

Spring メソッド

1. 対応するバンドルの Spring 設定ファイルで、定義されたサービスの Spring Bean を宣言します。

    <bean id="mockRpc" class="com.alipay.gateway.spi.mpc.test.MockRpcImpl"/>

2. 対応するバンドルの Spring 設定ファイルで、サービスを公開するスターター Bean を宣言します。

   MpcServiceStarter インターフェイスは、OperationType アノテーションを持つすべての Bean を、mpaaschannel プロトコルを使用して指定されたレジストリに登録します。

   <bean id="mpcServiceStarter" class="com.alipay.gateway.spi.mpc.MpcServiceStarter">
    <property name="registryUrl" value="${registy_url}"/>
    <property name="appName" value="${app_name}"/>
    <property name="workspaceId" value="${workspace_id}"/>
    <property name="projectName" value="${project_name}"/>
    <property name="privateKeyPath" value="${privatekey_path}"/>
   </bean>

Spring Boot メソッド

Spring Boot メソッドは、基本的に Spring メソッドと同じです。唯一の違いは、XML 設定ファイルの代わりにアノテーションを使用して登録することです。

1. アノテーションを使用して、定義されたサービスを Bean として登録します：

   @Service
   public class MockRpcImpl implements MockRpc{
   }

2. アノテーションを使用して、サービスを公開するスターターを定義します：

   @Configuration
   public class MpaaschannelDemo {
    @Bean(name="mpcServiceStarter")
    public MpcServiceStarter mpcServiceStarter(){
        MpcServiceStarter mpcServiceStarter = new MpcServiceStarter();
        mpcServiceStarter.setWorkspaceId("${workspace_id}");
        mpcServiceStarter.setAppName("${app_name}");
        mpcServiceStarter.setRegistryUrl("${registy_url}");
        mpcServiceStarter.setProjectName("${project_name}");
        mpcServiceStarter.setPrivateKeyPath("${privatekey_path}");
        return mpcServiceStarter;
    }
   }

MPC ログの構成

トラブルシューティングを容易にするために、MPC 関連のログを設定できます。次の例は、log4j の設定を示しています：

<!-- [MPC Logger] テナントリンク、接続確立と設定情報を記録 -->
    <appender name="MPC-TENANT-LINK-APPENDER" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="${log_root}/mpaaschannel/tenant-link.log"/>
        <param name="append" value="true"/>
        <param name="encoding" value="${file.encoding}"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d [%X{remoteAddr}][%X{uniqueId}] %-5p %c{2} - %m%n"/>
        </layout>
    </appender>

    <!-- [MPC Logger] ストリーム関連のデータ (テナントストリーム <-> コンポーネントストリームのペアを含む) を記録 -->
    <appender name="MPC-STREAM-DATA-APPENDER" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="${log_root}/mpaaschannel/stream-data.log"/>
        <param name="append" value="true"/>
        <param name="encoding" value="${file.encoding}"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d [%X{remoteAddr}][%X{uniqueId}] %-5p %c{2} - %m%n"/>
        </layout>
    </appender>


<!-- [MPC Logger] テナントログ -->
    <logger name="TENANT-LINK-DIGEST" additivity="false">
        <level value="INFO" />
        <appender-ref ref="MPC-TENANT-LINK-APPENDER" />
        <appender-ref ref="ERROR-APPENDER" />
    </logger>

    <!-- [MPC Logger] コンポーネントログ -->
    <logger name="STREAM-DATA-DIGEST" additivity="false">
        <level value="INFO" />
        <appender-ref ref="MPC-STREAM-DATA-APPENDER" />
        <appender-ref ref="ERROR-APPENDER" />
    </logger>