Getting Started

Jump to bottom

David Chau edited this page May 30, 2017 · 9 revisions

Short version

Install Yeoman and generator-appdirect-connector using npm (we assume you have pre-installed node.js).

npm install -g yo
npm install -g generator-appdirect-connector

Generate your new project:

yo appdirect-connector:java

Long version

Include a dependency on the latest version of the sdk in your pom.xml

<dependency>
    <groupId>com.appdirect</groupId>
    <artifactId>service-integration-sdk</artifactId>
    <version>1.15</version>
</dependency>

Import ConnectorSdkConfiguration class in your application context; Use the import annotation @Import(ConnectorSdkConfiguration.class). i.e.

@SpringBootApplication
@Import(ConnectorSdkConfiguration.class)
public class MinimalConnector {
    // your code...
}

Include a DeveloperSpecificAppmarketCredentialsSupplier bean in your application context that returns valid appmarket credentials given a consumer key.
Include a AppmarketEventHandler<T> bean in your application context for every type of mandatory market events.

Not providing handler for a mandatory event types will lead to an application context failure.
The events you need to expose AppmarketEventHandlers for are
- SubscriptionOrder
- SubscriptionCancel

Optional events can be handled if need be.

Add AppmarketEventHandler<T> beans for every desired events and annotate it with @Primary.

@Primary
@Bean
public AppmarketEventHandler<SubscriptionUpcomingInvoice> mySubscriptionUpcomingNoticeHandler() {
	return event -> ApiResult.success("My handler for a SUBSCRIPTION_UPCOMING_INVOICE event");
}

Available optional events: