Step1 ). Javascript 코드와 통신할 별도의 클래스를 따로 생성한다.

• Spring Mapper와 비슷하다. (Spring Mapper 는 DataBase와 통신)
• Plugin 클래스를 상속한다 (extends Plugin)
  • com.getcapacitor.Plugin
• Javascript 단에서 사용할 클래스 별칭 이름을 지정한다. (@CapacitorPlugin 어노테이션 사용)

Step2 ). Javascript 코드 단에서 호출할 메소드를 정의한다.

• @PluginMethod() 어노테이션을 해당 메소드위에 기재한다.
• 해당 메소드는 자바스크립트 단에서 Plugin별칭.메소드() 로 호출할 수 있다.
  • 자료형은 Promise로 반환된다.
  • Native Code에서 전달한 Json Object 를 넘겨 받을려면 then() 메소드를 사용해야 된다.
• 자바스크립트 단에서 해당 메소드에 파라미터를 넘겨주고 싶을때에는 Native Code 단에서 해당 메소드의 매개변수로 PluginCall call 을 사용한다.
  • call.getString(”key”) 로 매개변수를 Javascirpt → nativeCode 단에서 전달받을수 있다

전체코드

package io.ionic.starter;

import com.getcapacitor.JSObject;
import com.getcapacitor.Plugin;
import com.getcapacitor.PluginCall;
import com.getcapacitor.PluginMethod;
import com.getcapacitor.annotation.CapacitorPlugin;

@CapacitorPlugin(name = "Echo")
public class EchoPlugin extends Plugin {

  @PluginMethod
  public void echo(PluginCall call){
    String value = call.getString("value");
		// string 문자열 가져올때

		JSObject address = call.getObject("address", new JSObject());
		// JSON 객체 가져올때

    JSObject jsObject = new JSObject();
    jsObject.put("value",value);
    call.resolve(jsObject);
  }
}

• 클라이언트(Javascript 단)은 JSON 직렬화된 데이터를 Native Code로 보낼수 있다.

  • number / text / boolean / objects / arrays 자료형 가능

• 클라이언트로 부터 보내져온 data는 PluginCall.getData() 로 얻어올 수 있다.

• 플러그인 메소드는 호출될때 성공할수도 있고 실패할 수도 있다. Promise 패턴사용

  • resolve( ) : 성공할때 호출되는 이벤트
  • reject( ) : 실패할때 호출되는 이벤트

• 무언가의 오류로 실패해서 데이터를 클라이언트에게 반환하기 싫다면 call.reject 메소드를 사용한다.

  • error 문자열과, 옵션사항으로 error code , Exception 인스턴스를 클라이언트에게 돌려줄수 있다.
  • call.reject(exception.getLocalizedMessage(), null, exception);