APIリソースのSDKの生成

この例で使用されているツールとバージョン:

• Gradle 6.5
• Maven 3.6.3
• アンドロイドスタジオ4.1.2

APIゲートウェイがAPIリソースのAPI記述ファイルから生成したAndroid SDKを使用するには:

1. API Gatewayで生成されたAndroid SDKを含むzipファイルをダウンロードし、その内容を抽出します。
2. zipファイルから抽出されたルート・ディレクトリに、次を実行して、生成されたSDKをローカルMavenリポジトリにインストールします:

   mvn clean install

3. 生成されたAndroid SDKを使用するAndroidプロジェクトを決定します。Gradleがパッケージ・マネージャである既存のAndroidプロジェクトを開くか、次のように新しいAndroidプロジェクトを作成します。

   1. Android Studioを開きます。「ファイル」で、「新規」に移動して「新規プロジェクト」を選択します。
   2. 「アクティビティなし」を選択し、「次へ」を選択します。
   3. 「言語」で、「Java」を選択し、「終了」を選択します。
4. モジュールのbuild.gradleファイルを更新して、生成されたSDKを依存性として追加します。例:

   plugins {
       id 'com.android.application'
   }
   
   android {
       compileSdkVersion 29
       buildToolsVersion "30.0.3"
   
       defaultConfig {
           applicationId "com.example.myapplication"
           minSdkVersion 21
           targetSdkVersion 29
           versionCode 1
           versionName "1.0"
   
           testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
           // 2) Connect JUnit 5 to the runner
           testInstrumentationRunnerArgument "runnerBuilder", "de.mannodermaus.junit5.AndroidJUnit5Builder"
       }
   
       buildTypes {
           release {
               minifyEnabled false
               proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
           }
       }
       compileOptions {
           sourceCompatibility JavaVersion.VERSION_1_8
           targetCompatibility JavaVersion.VERSION_1_8
       }
   }
   
   apply plugin: "de.mannodermaus.android-junit5"
   
   dependencies {
       implementation 'com.android.support:multidex:1.0.3'
   
       implementation 'androidx.appcompat:appcompat:1.1.0'
       implementation 'com.google.android.material:material:1.1.0'
       implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
   
       androidTestImplementation 'androidx.test.ext:junit:1.1.1'
       androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
       implementation("com.mock:test-project:1.0.1")
   
   }
   

   test-projectがdependenciesに追加されていることに注意してください。

5. Android Studioでプロジェクト・ビルドを実行します。
6. ビルドが完了したら、生成されたSDKクラスをインポートし、Androidプロジェクトの1つ以上のJavaクラスで使用します。例:

   package com.example.myapplication;
   
   import android.annotation.SuppressLint;
   import android.content.Context;
   import android.os.AsyncTask;
   import android.widget.Toast;
   
   import com.mock.testproject.api.UserV1;
   import com.mock.testproject.api.UsersApi;
   
   public class NetworkTask extends AsyncTask<String,String,String> {
   
       @SuppressLint("StaticFieldLeak")
       private final Context context;
   
       public NetworkTask(Context context) {
           this.context = context;
       }
   
       @Override
       protected String doInBackground(String... strings) {
           try{
               UsersApi usersApi = new UsersApi();
               usersApi.setBasePath("https://0eff7c6c85cc.ngrok.io");
               UserV1 a = usersApi.getUsersUsername("a");
               return a.toString();
           }catch (Exception e){
               e.printStackTrace();
               return e.getMessage();
           }
       }
   
       @Override
       protected void onPostExecute(String s) {
           super.onPostExecute(s);
           Toast.makeText(context, s, Toast.LENGTH_LONG).show();
       }
   }
   

前述の例をガイドとして使用して、独自の要件に合せて拡張および適応できます。

この例で使用されているツールとバージョン:

• Maven 3.6.3
• Java 1.8.0

APIゲートウェイがAPIリソースのAPI記述ファイルから生成したJava SDKを使用するには:

1. API Gatewayによって生成されたJava SDKを含むzipファイルをダウンロードし、その内容を抽出します。
2. zipファイルから抽出されたルート・ディレクトリに、次を実行して、生成されたSDKをローカルMavenリポジトリにインストールします:

   mvn clean install

3. 生成されたJava SDKを使用するMavenプロジェクトを決定します。既存のMavenプロジェクトを更新するか、次を実行して新しいMavenプロジェクトを作成します。

   mvn -B archetype:generate -DarchetypeGroupdId=org.apache.maven.archetypes -DgroupId=examples.com.testApp -DartifactId=test-maven-project

4. Mavenプロジェクトのpom.xmlファイルを更新して、生成されたSDKを依存性として追加します。例:

   <dependency>
     <groupId>com.mock.test</groupId>
     <artifactId>integration-java</artifactId>
     <version>1.0.0</version>
     <scope>compile</scope>
   </dependency>
   
   

5. Mavenプロジェクトのルート・ディレクトリで、次を実行します:

   mvn clean install

6. Mavenのインストールが完了したら、生成されたSDKクラスをインポートし、Mavenプロジェクトで使用します。例:

   import com.mock.test.integration.ApiClient;
   import com.mock.test.integration.ApiException;
   import com.mock.test.integration.api.UsersApi;
   import com.mock.test.integration.model.UserV1;
   
   public class SdkTest {
   
       private String basePath;
       private UsersApi usersApi;
       private UsersApi loggedInUsersApi;
   
       public void setUpAndListUsers(){
           ApiClient loggedInClient = new ApiClient();
           loggedInClient.setPassword("password");
           loggedInClient.setUsername("username");
           loggedInUsersApi = new UsersApi(loggedInClient);
                   List<UserV1> users = loggedInUsersApi.getUsers();
   	}
         }
   

前述の例をガイドとして使用して、独自の要件に合せて拡張および適応できます。

この例で使用されているツールとバージョン:

• Npm 6.14.0

APIゲートウェイがAPIリソースのAPI記述ファイルから生成したJavaScript SDKを使用するには:

1. APIゲートウェイによって生成されたJavaScript SDKを含むzipファイルをダウンロードし、その内容を抽出します。
2. zipファイルから抽出されたルート・ディレクトリで、次を実行します。

   npm install

   npm link

3. 既存のnpmプロジェクトのルート・ディレクトリで、次のように実行します:

   npm link <path_to_javascript_client_dir>

   例:

   npm link "/Users/ajay.d.dubey/Downloads/Simple API overview_JAVASCRIPT_v26544725374050339058" 

4. サービスのコール元の.jsファイルで、生成されたSDKをインポートして使用します。例:

   const Blog = require("blog");
   const apiClient = new Blog.ApiClient();
   apiClient.defaultHeaders = { authorization: "audio/basic" };
   apiInstance = new Blog.UsersApi(apiClient);
   
   //get user
   apiInstance.getUsersUsername(
       "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
       (error, data, response) => {
           if (error) throw error;
   	      console.log(response.statusCode);
           console.log(response)
      }
   );
   
   //put user
   let opts = {
       userV1: new Blog.UserV1(
           "Test",
           "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
           "password",
           "a@b.com"
       ),
   };
   apiInstance.putUsersUsername(
       "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
       opts,
       (error, data, response) => {
           if (error) throw error;
   	      console.log(response.statusCode);
           console.log(response)
       }
   );
   

   この例では、生成されたSDKの名前はblogです。抽出されたpackage.jsonファイルを調べて、生成されたSDKの名前を見つけます。

前述の例をガイドとして使用して、独自の要件に合せて拡張および適応できます。

この例で使用されているツールとバージョン:

• XCode 12.4
• Swift 5.3.1
• CocoaPods 1.10.1

APIゲートウェイがAPIリソースのAPI記述ファイルから生成したSwift SDKを使用するには:

1. API Gatewayによって生成されたSwift SDKを含むzipファイルをダウンロードし、その内容を抽出します。
2. 生成されたSwift SDKを使用するXCodeプロジェクトを決定します。既存のXCodeプロジェクトを更新するか、次のように新しいXCodeプロジェクトを作成します。
   1. XCodeを開きます。「ファイル」で、「新規」に移動して「プロジェクト」を選択します。
   2. 「アプリケーション」を選択し、「次へ」を選択します。
   3. 「言語」で、「Swift」を選択し、「次」を選択します。
   4. プロジェクトの場所を指定し、「作成」を選択してXCodeプロジェクトを作成します。
3. XCodeプロジェクトのルート・ディレクトリにPodfileがまだ含まれていない場合は、次を実行してPodfileを作成します。

   pod init

4. Podfileを更新して、生成されたSDKへの参照を追加します。例:

   target 'test-project-3' do
     		# Comment the next line if you don't want to use dynamic frameworks
     		use_frameworks!
     		# Pods for test-project-3
   			pod 'mysdk', :path => '/Users/ajay.d.dubey/workspace-2/swift/Blog_SWIFT_1.0.01209182890182739216'
   		end
   

5. XCodeプロジェクトのルート・ディレクトリで、次を実行します:

   pod install

   出力例:

   ~/workspace-2/swift/test-project-3 on main ?1 ❯ pod install                    took 1m 4s at 09:50:31
   Analyzing dependencies
   Downloading dependencies
   Installing mysdk (1.0.0)
   Generating Pods project
   Integrating client project
   
   [!] Please close any current Xcode sessions and use `test-project-3.xcworkspace` for this project from now on.
   Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.
   
   [!] Automatically assigning platform `iOS` with version `14.4` on target `test-project-3` because no platform was specified. Please specify a platform for this target in your Podfile. See `https://guides.cocoapods.org/syntax/podfile.html#platform`.
   

6. XCodeのオープン・インスタンスをすべてクローズします。
7. XCodeプロジェクトのルート・ディレクトリで、.xcworkspaceファイルを開いてポッドを確認します。
8. 任意のswiftファイルを更新してポッドをインポートし、生成されたSDKの使用を開始します。たとえば、次のようにViewController.swiftファイルを更新して、mysdkポッドをインポートします。

   import UIKit
   import mysdk
   
   class ViewController: UIViewController {
   
       override func viewDidLoad() {
   
           mysdkAPI.credential = URLCredential.init(user: "username", password: "password", persistence: .permanent)
           mysdkAPI.customHeaders = ["Content-Type":"application/json","Authorization":"Basic 1234"]
           mysdk.UsersAPI.getUsers(completion: getUsers)
           
           mysdk.UsersAPI.getUsersUsername(username: "046B6C7F-0B8A-43B9-B35D-6489E6DAEE91", completion: responseUserUsername)    
           
          }
     func getUsers(users :[mysdk.UserV1]?, error:Error?) -> Void{
           print("Attempting fetching user details:")
           print(users)
          }
       
     func responseUserUsername(user :mysdk.UserV1?, error:Error?){
     print("Attempting fetching user with username:")
     print("Successful Request")
     print (user)
           
   		}
   

前述の例をガイドとして使用して、独自の要件に合せて拡張および適応できます。

この例で使用されているツールとバージョン:

• 糸1.22.10

APIゲートウェイがAPIリソースのAPI記述ファイルから生成したTypeScript SDKを使用するには:

1. APIゲートウェイによって生成されたTypeScript SDKを含むzipファイルをダウンロードし、その内容を抽出します。
2. zipファイルから抽出されたルート・ディレクトリで、次を実行します。

   yarn install

   yarn run build

   yarn link

3. 生成されたSDKを使用するプロジェクトのルート・ディレクトリ:
   1. 実行:

      yarn link <project-name>

      <project name>は、生成されたSDKの名前です。抽出されたpackage.jsonファイルを調べて、生成されたSDKの名前を見つけます。例:

      yarn link test-project

   2. 実行:

      yarn install

4. 生成されたSDKを使用するプロジェクトのtsファイルを更新します。例:

   const Blog = require("blog");
   const expect = require("chai").expect;
   let apiInstance;
   let apiInstanceWithoutHeader;
   
   before(function () {
       const apiClient = new Blog.ApiClient();
       apiClient.defaultHeaders = { authorization: "audio/basic" };
       apiInstance = new Blog.UsersApi(apiClient);
       apiInstanceWithoutHeader = new Blog.UsersApi();
   });
   
   describe("UsersApi", function () {
       it("should call add delete username successfully", function (done) {
           apiInstance.deleteUsersUsername(
               "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
               (error, data, response) => {
                   if (error) throw error;
                   console.log(response.statusCode);
                   console.log(response)
                   expect(response.statusCode).to.equal(204);
                   expect(data).to.equal(null);
                   done();
               }
           );
       });
       it("should update user details successfully", function (done) {
           let opts = {
               userV1: new Blog.UserV1(
                   "Test",
                   "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
                   "password",
                   "a@b.com"
               ),
           };
           apiInstance.putUsersUsername(
               "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
               opts,
               (error, data, response) => {
                   if (error) throw error;
                   expect(response.statusCode).to.equal(202);
                   expect(data).to.not.null;
                   done();
               }
           );
       });
   
       });
   
   

前述の例をガイドとして使用して、独自の要件に合せて拡張および適応できます。