MobileFirst Foundation 8.0 마이그레이션 쿡북

Maven 어댑터를 사용하려면 개발자 워크스테이션에 Apache Maven이 설치되어 있어야 합니다.

1. Apache Maven을 설치하십시오.
   • Apache Maven .zip을 다운로드하십시오.
   • MVN_PATH 변수를 추가하고 Maven 폴더를 지정하십시오.
   • Mac 및 Linux:
     ~/.bash_profile을 편집하십시오.

     #### Apache Maven example location
     
     export MVN_PATH="/usr/local/bin"

   • Windows: 다음 안내에 따르십시오.
   • mvn -v를 실행하여 설치를 확인하십시오.
2. 쿡북은 MobileFirst CLI를 사용하여 어댑터를 작성하고 빌드하는 Maven 명령을 호출합니다.
   • 이 도구가 작동하기 위한 필수 소프트웨어이므로 NodeJS를 설치하십시오.
   • 명령행 창에서 npm install -g mfpdev-cli 명령을 실행하십시오. (또는 MobileFirst Operations Console을 사용하여 다운로드 센터에서 다운로드하여 설치하십시오.)
   • mfpdev -v를 실행하여 설치를 확인하십시오.

자신의 어댑터 유형, 어댑터 이름 및 패키지 이름과 일치하는 새 어댑터 템플리트를 작성하십시오.
그러면 어댑터의 메타데이터가 비슷해져서 추가 편집이 필요하지 않으므로 마이그레이션이 쉬워집니다.

• 명령행 창에서 mfpdev adapter create 명령을 실행하십시오.
• 어댑터 유형(HTTP 또는 SQL JavaScript 어댑터, 또는 Java 어댑터)을 선택하십시오.
• GroupID를 제공하십시오.
• Java 어댑터를 작성하는 경우, 이전에 사용한 것과 동일한 패키지 이름을 지정해야 합니다(예: "com.sample").

실제 마이그레이션을 위한 마이그레이션 도구를 실행하기 전에, 마이그레이션 모드를 설정하십시오. 지원되는 모드는 2개입니다.

• 마이그레이션
  마이그레이션 모드에서는 클라이언트 앱 마이그레이션을 서버 마이그레이션과 함께 사용하여 앱과 어댑터를 Mobile Foundation v8.0으로 마이그레이션할 수 있습니다. 
• 호환성
  호환성 모드가 설정된 경우, 서버 마이그레이션만 허용됩니다. 클라이언트 마이그레이션은 Mobile Foundation Migration Studio를 사용하여 수행됩니다.

마이그레이션 모드를 설정하려면 다음 명령을 실행하십시오.

참고: scan 및 client 명령은 호환성 모드로 설정된 경우 실행할 수 없습니다. 서버 옵션으로 마이그레이션 지원 도구를 실행하여 이전 worklight 프로젝트의 루트 디렉토리를 지정하십시오.

1. 7.1 Worklight 프로젝트를 Mobile Foundation v8.0에 마이그레이션하려면 다음과 같이 마이그레이션 지원 도구를 실행하십시오.
   mfpmigrate server --In /Users/WorklightProject**/ --Out /Users/Migrate80Project
   
   

   구문

   mfpmigrate server [--in|-i <sourceDirectory>] [--out|-o <destinationDirectory>] [--projectName|-p <newProjectDirectory>]

   
   

   설명

   기존 MobileFirst 프로젝트에서 보안 영역 및 어댑터의 마이그레이션을 수행합니다.

   
   

   옵션

   <sourceDirectory>: <sourceDirectory>는 마이그레이션하려는 MobileFirst 프로젝트의 루트 폴더여야 합니다. 이 매개변수는 필수입니다.

   <destinationDirectory>: <destinationDirectory>는 어댑터가 마이그레이션되는 디렉토리입니다.

   마이그레이션 도구는 어댑터 및 영역을 통해 스캔하고 다음을 수행합니다.

   1. 어댑터 및 지원되는 보안 검사에 대한 템플리트를 작성합니다.
   2. 어댑터 소스를 새로 작성된 Maven 아티팩트로 이동합니다.
   3. 종속 항목과 함께 프로젝트 pom을 업데이트합니다.
   4. 이 도구를 사용하여 수행되는 작업과 마이그레이션을 완료하기 위해 수동으로 수행해야 하는 기타 변경 사항에 대한 요약 보고서를 작성합니다.

2. 기존 어댑터와 worklight.properties 파일의 경우, 도구에서 더 이상 사용되지 않는 미지원 API를 7.1 어댑터에서 식별하고 다음을 수행합니다.

   1. 사용되지 않는/미지원 API를 적절한 v8.0 API로 대체합니다.
   2. 지정된 출력 위치에서 해당 v7.1 어댑터를 위한 v8.0 어댑터를 생성합니다.
   3. 개발자는 마이그레이션된 어댑터 디렉토리로 이동하여 단일 Maven 명령(mvn clean install  adapter:deploy)을 실행해서 어댑터를 빌드하고 Mobile Foundation v8.0 서버에 배치할 수 있습니다.

      참고: 마이그레이션된 어댑터 pom.xml은 어댑터를 로컬로 실행 중인 Mobile Foundation 서버에 배치합니다. 이를 다른 Mobile Foundation 서버 인스턴스에 배치하려면 pom.xml에서 서버 세부사항과 인증 정보를 업데이트하고 maven 명령을 실행하십시오.

   4. worklight.properties 파일을 스캔하여 Mobile Foundation v8.0 서버에 명시적 JNDI 값을 포함해서 이러한 항목을 보고서에 출력해야 하는 특성을 알 수 있습니다.

3. 영역의 경우, 이 도구는 AuthenticationConfig.xml의 더 이상 사용되지 않는 모든 지원 영역을 식별해서 다음 작업을 수행합니다.

   1. 요약 보고서에는, 사용자의 인증 구성에 사용된 영역 목록이 요약되며 이러한 영역은 사전 정의된 보안 검사가 포함된 v8.0에 사전 구성되어 제공됩니다. (사용자 추가 조치가 필요하지 않음).
   2. 지원되지 않는 영역이 요약됩니다(Mobile Foundation v8.0에서는 지원하지 않음).
   3. 마이그레이션이 필요한 지원 영역에서 다음 단계가 수행됩니다.
      1. 최적 SecurityCheck를 식별하여 특정 영역에 마이그레이션합니다.
      2. 식별된 SecurityCheck 기본 클래스로 SecurityCheck 템플리트를 생성합니다(접미부 SecurityCheck를 사용하는 영역과 동일한 이름 사용).
      3. 영역의 인증 확인 및 유효성 검증 방법을 식별하여 해당 SecurityCheck 메소드의 인라인 주석으로 복사해서 사용자가 이를 참조하여 새로 생성된 SecurityCheck 템플리트에 동일한 유효성 검증을 구현하도록 합니다.

         이 맵핑을 참조하여 영역 메소드에 구현된 인증 로직이 생성된 SecurityCheck 템플리트에 적합한지 확인합니다.

         어댑터 인증 영역

         어댑터 인증자 영역은 AuthenticationConfig.xml에 정의되어 있습니다. 다음은 샘플 정의입니다.

         
         <realm loginModule="SampleLoginModule" name="SampleRealm">
           <className>com.worklight.integration.auth.AdapterAuthenticator</className>
           <parameter name="login-function" value="SampleAdapter.onAuthTrigger"/>
           <parameter name="logout-function" value="SampleAdapter.onLogout"/>
         </realm>
         

         v7.1의 위 구성에서는 다음과 같이 ValidationCredentialsSecurityCheck에 맵핑할 수 있습니다.

         ValidationCredentialsSecurityCheck.createChallenge	SampleAdapter.onAuthTrigger에 사용한 것과 비슷한 접근법을 사용하여 인증 확인을 구현할 수 있습니다. 하지만 마이그레이션 중 고려해야 하는 인터페이스 변경이 있습니다.
         ValidationCredentialsSecurityCheck.validateCredentials	위 영역 정의에는 이와 비슷한 맵핑이 없습니다. 따라서 이 메소드에서는 맵핑이 불가능합니다. 그 예로, 고객이 리소스 어댑터 메소드 중 하나에서 v7.1로 이를 구현하고 인증 확인 메소드 성공 시 애플리케이션의 ChallengeHandler에서 이를 호출하는 경우가 있습니다.

         유사한 맵핑이 해당 v7.1 정의를 기반으로 양식 기반 인증자 영역, 기본 인증자 영역, 사용자 정의 인증자와 같이 v7.1의 모든 지원 영역에 대해 수행됩니다.

         v7.1의 영역 유형	영역의 메소드 정의	Mobile Foundation v8.0의 SecurityCheck 메소드
         CustomAuthentication	createIdentity	<UserAuthenticationSecurityCheck> createUser
         	processRequest	createChallenge
         	CustomAuhenticator. processAuthenticationFailure CustomAuhenticator.changeResponse on success CustomLoginModule.login	validateCredentials
         	CustomLoginmodule.logout	Logout
         Form Based authenticator	CustomLoginModule.login	<UserAuthenticationSecurityCheck> validateCredentials
         	CustomLoginmodule.logout	Logout

4. 요약 보고서를 사용하여 다음 작업을 수행합니다.

   1. 마이그레이션 지원 도구를 통해 수행된 작업을 이해합니다.
   2. 지원되지 않는 API를 간단히 마이그레이션할 수 있는 지원되는 API에 맵핑합니다.
   3. 레거시 worklight 프로젝트에 사용되는 지원되지 않는 어댑터/영역을 식별합니다.
   4. 기존 디자인의 기타 기술적인 과제 또는 병목 현상을 이해하고 아래의 새로운 개발 개념을 참조하여 해결 방법을 확인합니다.

1. 파일 시스템에서 JavaScript 어댑터 폴더로 이동하십시오(예: ../Desktop/JavaScriptAdapters/adapters/RSSReader).
2. 다른 창을 열고 새 Maven 프로젝트(예: ../Desktop/MigratedAdapter)로 이동한 후 src/main/adapter-resources 폴더로 이동하십시오.
3. 기존 어댑터 파일을 이 폴더로 복사하여 붙여넣으십시오.
4. adapter.xml을 편집하십시오. 해당 컨텐츠를 기존 어댑터의 XML 컨텐츠(이 예제에서는 RSSReader.xml)로 대체하십시오.
5. js/{adapter-name}-impl.js를 편집하십시오. 해당 컨텐츠를 기존 어댑터의 컨텐츠(이 예제에서는 RSSReader-impl.js)로 대체하십시오.

1. 파일 시스템에서 JavaScript 어댑터 폴더로 이동하십시오(예: ../Desktop/JavaScriptAdapters/adapters/SQLAdapter).
2. 다른 창을 열고 새 Maven 프로젝트(예: ../Desktop/MigratedAdapter)로 이동한 후 src/main/adapter-resources 폴더로 이동하십시오.
3. adapter.xml을 편집하십시오. 해당 컨텐츠를 기존 어댑터의 XML 컨텐츠(이 예제에서는 SQLAdapter.xml)로 대체하십시오.
4. js/{adapter-name}-impl.js를 편집하십시오. 해당 컨텐츠를 기존 어댑터의 컨텐츠(이 예제에서는 SQLAdapter-impl.js)로 대체하십시오.

여기에서 Maven 종속 항목이 작동하기 시작합니다. Worklight/MobileFirst Studio는 데이터베이스 커넥터가 이전에 server/lib 폴더에 배치된 위치에서 사용되지 않으므로 이를 Maven 종속 항목으로 대체하십시오.

1. 새로 작성한 Maven 프로젝트로 돌아가서 디렉토리의 루트에 있는 pom.xml 파일을 여십시오.
2. 해당 데이터베이스 유형을 위한 종속 항목을 추가하십시오. Maven Central 웹 사이트에서 사용할 적절한 종속 항목을 검색할 수 있습니다.
3. 이 예제에서는 MySQL 데이터베이스를 사용하십시오. 다음 코드 블록을 dependencies 섹션에 추가하십시오.

   <dependency>
       <groupId>mysql</groupId>
       <artifactId>mysql-connector-java</artifactId>
       <version>5.1.6</version>
   </dependency>

추가 종속 항목이 있는 경우, pom.xml 파일에서 지정하십시오(로컬 파일 또는 원격 종속 항목).

Maven 종속 항목에 대해 자세히 학습:

• Introduction to the Dependency Mechanism (Maven.org)
• 종속 항목 처리(튜토리얼)

다음 "다이어그램"은 지금까지 수행한 내용을 다른 방법으로 나타냅니다.

MyProject
├── adapters
│   ├── RSSAdapter
│   │   ├── RSSAdapter-impl.js
│   │   ├── RSSAdapter.xml
│   │   └── filtered.xsl

RSSAdapter
├── pom.xml
├── src
│   └── main
│       ├── adapter-resources
│       │   ├── adapter.xml
│       │   └── js
│       │        ├── RSSAdapter-impl.js
│       │        └── filtered.xml

1. 파일 시스템에서 Java 어댑터 폴더로 이동하십시오(예: ../Desktop/JavaAdapters/RSSAdapter).
2. 별도의 창을 열고 새 Maven 프로젝트(예: ../Desktop/MigratedAdapter)로 이동한 후 src/main/adapter-resources 폴더로 이동하십시오.
3. {adapter-name}.xml을 편집하십시오. 해당 컨텐츠를 기존 어댑터의 XML 컨텐츠(이 예제에서는 RSSAdapter.xml)로 대체하십시오.
4. 새 어댑터에서 src/main/java/com/sample/(이 예제에서)로 이동하십시오.
5. 기존.java 파일을 기존 어댑터의.java 파일로 대체하십시오.

기존 어댑터에서 추가 라이브러리를 사용 중인 경우 Maven 종속 항목은 지금 작동하기 시작합니다. Worklight/MobileFirst Studio는 라이브러리가 이전에 server/lib 또는 Java 어댑터의 lib 폴더에 배치된 위치에서 사용되지 않으므로 이를 Maven 종속 항목으로 대체하십시오.

1. 새로 작성한 Maven 프로젝트로 돌아가서 디렉토리의 루트에 있는 pom.xml 파일을 여십시오.
2. 해당 데이터베이스 유형을 위한 종속 항목을 추가하십시오. Maven Central 웹 사이트에서 사용할 적절한 종속 항목을 검색할 수 있습니다.
3. 이 예제는 Cloudant 종속 항목을 사용합니다. 다음 코드 블록을 dependencies 섹션에 추가하십시오.

   <dependency>
   	<groupId>com.cloudant</groupId>
   	<artifactId>cloudant-client</artifactId>
   	<version>1.2.3</version>
   </dependency>

Maven 종속 항목에 대해 자세히 학습:

• Introduction to the Dependency Mechanism (Maven.org)
• 종속 항목 처리(튜토리얼)

다음 "다이어그램"은 지금까지 수행한 내용을 다른 방법으로 나타냅니다.

├── adapters
│   └── RSSAdapter
│       ├── RSSAdapter.xml
│       ├── lib
│       └── src
│           └── com
│               └── sample
│                   ├── RSSAdapterApplication.java
│                   └── RSSAdapterResource.java

├── pom.xml
├── src
│   └── main
│       ├── adapter-resources
│       │   └── adapter.xml
│       └── java
│           └── com
│               └── sample
│                   ├── RSSAdapterApplication.java
│                   └── RSSAdapterResource.java
└

마이그레이션된 어댑터 빌드

명령행 창에서 어댑터의 폴더로 이동하여 mfpdev adapter build 명령을 실행하십시오.

이러한 오류를 해결하려면 Maven 프로젝트를 IntelliJ와 같은 Maven 프로젝트로 가져온 다음 여기에서 프로젝트를 빌드할 것을 권장합니다. IDE를 이용하면 더 쉽게 빌드 오류를 통해 반복하고 하나씩 해결할 수 있습니다. IntelliJ 및 어댑터 사용에 대해 자세히 학습하십시오.

빌드된 어댑터 테스트

마이그레이션된 어댑터를 테스트하려면 MobileFirst CLI를 사용하여 엔드포인트를 호출하거나 MobileFirst Operations Console에서 Swagger를 사용할 수 있습니다.

어댑터 테스트 및 디버그 튜토리얼에서 어댑터 테스트에 대해 자세히 학습하십시오.