:warning: **This commercetools JVM SDK is in its Maintenance Support mode currently, and is planned to be deprecated, please note the following dates.
Active Support | Maintenance Support | End of Life |
---|---|---|
28th February, 2022 |
31st December 2023. |
1st January 2024. |
We recommend to use our Java SDK V2, and you can migrate to the new version using our migration guideline.
The JVM SDK enables developers to use Java 8 methods and objects to communicate with the Composable Commerce API rather than using plain HTTP calls. Users gain type-safety, encapsulation, IDE auto completion and an internal domain specific language to discover and formulate valid requests.
Tested with JDKs: Oracle 1.8.0_221, OpenJDK 1.8.0_221 and Amazon Corretto 8.222.10.1.
<dependency>
<groupId>com.commercetools.sdk.jvm.core</groupId>
<artifactId>commercetools-models</artifactId>
<version>1.61.0</version>
</dependency>
<dependency>
<groupId>com.commercetools.sdk.jvm.core</groupId>
<artifactId>commercetools-java-client</artifactId>
<version>1.61.0</version>
</dependency>
<!-- experimental -->
<dependency>
<groupId>com.commercetools.sdk.jvm.core</groupId>
<artifactId>commercetools-convenience</artifactId>
<version>1.61.0</version>
</dependency>
commercetools-java-client
: alias for commercetools-java-client-ahc-2_0commercetools-java-client-apache-async
: uses Apache HTTP clientcommercetools-java-client-ahc-1_9
: uses async HTTP client 1.9 (AHC 1.9 is incompatible to AHC 1.8)commercetools-java-client-ahc-2_0
: uses async HTTP client 2.0 (do not mix it with the other AHC modules)commercetools-java-client-ahc-2_5
: uses async HTTP client 2.5 (AHC 2.5 is incompatible to AHC 2.0)commercetools-java-client-ahc-2_12
: uses async HTTP client 2.12commercetools-models
: models which do not depend to a client implementationrepositories {
mavenCentral()
}
dependencies {
def jvmSdkVersion = "1.61.0"
compile "com.commercetools.sdk.jvm.core:commercetools-models:$jvmSdkVersion"
compile "com.commercetools.sdk.jvm.core:commercetools-java-client:$jvmSdkVersion"
compile "com.commercetools.sdk.jvm.core:commercetools-convenience:$jvmSdkVersion"
}
see https://github.com/commercetools/commercetools-jvm-sdk-scala-add-ons
Useful code from external developers
ProductProjectionSearch.ofCurrent().withQueryFilters(m -> m.categories().id().containsAll(categoryIds1))
https://mc.commercetools.com/YOUR_PROJECT_KEY/settings/developer/api-clients
) with all available permissions (at the time of writing it is manage_payments manage_my_profile manage_orders view_products view_customers view_payments view_types manage_my_orders manage_types manage_customers manage_products view_orders manage_project), the by default created client has just manage_project
projectKey=YOUR project key without quotes
clientId=YOUR client id without quotes
clientSecret=YOUR client secret without quotes
apiUrl=https://api.europe-west1.gcp.commercetools.com
authUrl=https://auth.europe-west1.gcp.commercetools.com
./mvnw verify
to execute all integration tests./mvnw -Dit.test=*Product* -DfailIfNoTests=false verify
to execute all integration test classes which have "Product" in the class name./mvnw test
[](definitions for the top badges)