Mobile Platform as a Service：Definisi dan pengembangan layanan

Daftarkan layanan API MPC

Pendaftaran layanan API MPC memerlukan parameter-parameter berikut:

• registryUrl: Alamat registri. Alamat untuk registri financial technology bersama adalah mpcpub.mpaas.cn-hangzhou.aliyuncs.com.

• appName: Nama aplikasi Anda. Nilai ini harus sama dengan nama grup API.

• workspaceId: ID ruang kerja dari lingkungan tempat aplikasi berada.

• projectName: Nama proyek dari penyewa tempat aplikasi berada. Nilai ini harus sama dengan Project Name dalam grup API.

• privateKeyPath: Classpath untuk kunci privat RSA. Kunci ini digunakan untuk memverifikasi koneksi ke mpaaschannel. Kami menyarankan Anda menempatkannya di /META-INF/config/rsa-mpc-pri-key-{env}.der, di mana {env} merepresentasikan lingkungan berbeda, seperti dev, sit, atau prod.

Konfigurasikan kunci publik

Pada Konsol untuk lingkungan yang sesuai, pilih Code Management > Interface Keys > Configure di panel navigasi sebelah kiri. Konfigurasikan kunci publik RSA yang sesuai dengan kunci privat Anda.

Perintah berikut menunjukkan cara menghasilkan pasangan kunci RSA. Konfigurasikan kunci publik di Konsol. Konfigurasikan file kunci privat di ${privateKeyPath} pada aplikasi Backend Anda:

* the way to generate key pair: 
* ### Generate a 2048-bit RSA private key 
* 
* $ openssl genrsa -out private_key.pem 2048 
* 
* ### Convert private Key to PKCS#8 format (so Java can read it) 
* 
* $ openssl pkcs8 -topk8 -inform PEM -outform DER -in private_key.pem -out private_key.der -nocrypt 
* 
* ### Output public key portion in DER format (so Java can read it) 
* 
* $ openssl rsa -in private_key.pem -pubout -outform DER -out public_key.der 
* 
* ### change to base64:
* 
* ## The generated private key, to be configured in the backend application
* $ openssl base64 -in private_key.der -out private_key_base64.der
* 
* ## The generated public key, to be configured in Interface Keys in the console
* $ openssl base64 -in public_key.der -out public_key_base64.der
* 
* ### remember to clear the whitespace chars and line breaks before submit!!!

Spring method

1. Pada file konfigurasi spring dari bundle yang sesuai, deklarasikan bean Spring untuk layanan yang telah didefinisikan.

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

2. Pada file konfigurasi spring dari bundle yang sesuai, deklarasikan bean starter yang mengekspos layanan tersebut.

   Antarmuka MpcServiceStarter mendaftarkan semua bean yang memiliki anotasi OperationType ke registri yang ditentukan menggunakan protokol 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>

Metode Spring Boot

Metode Spring Boot pada dasarnya sama dengan metode Spring. Satu-satunya perbedaan adalah Anda menggunakan anotasi untuk pendaftaran, bukan file konfigurasi XML.

1. Gunakan anotasi untuk mendaftarkan layanan yang telah didefinisikan sebagai bean:

   @Service
   public class MockRpcImpl implements MockRpc{
   }

2. Gunakan anotasi untuk mendefinisikan starter yang mengekspos layanan tersebut:

   @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;
    }
   }

Konfigurasikan Log MPC

Untuk memudahkan troubleshooting, Anda dapat mengonfigurasi log terkait MPC. Contoh berikut menunjukkan konfigurasi log4j:

<!-- [MPC Logger] tenant link, records connection establishment and settings information -->
    <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] records data related to a stream (including a pair of tenant stream <-> component stream) -->
    <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] tenant log -->
    <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] component log -->
    <logger name="STREAM-DATA-DIGEST" additivity="false">
        <level value="INFO" />
        <appender-ref ref="MPC-STREAM-DATA-APPENDER" />
        <appender-ref ref="ERROR-APPENDER" />
    </logger>