Android Magento Client

Android client for communicating with a magento site

License

License

Categories

Categories

CLI User Interface
GroupId

GroupId

com.github.chen0040
ArtifactId

ArtifactId

android-magento-client
Last Version

Last Version

1.0.5
Release Date

Release Date

Type

Type

aar
Description

Description

Android Magento Client
Android client for communicating with a magento site
Project URL

Project URL

https://github.com/chen0040/android-magento-client
Source Code Management

Source Code Management

https://github.com/chen0040/android-magento-client.git

Download android-magento-client

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.chen0040/android-magento-client/ -->
<dependency>
    <groupId>com.github.chen0040</groupId>
    <artifactId>android-magento-client</artifactId>
    <version>1.0.5</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/com.github.chen0040/android-magento-client/
implementation 'com.github.chen0040:android-magento-client:1.0.5'
// https://jarcasting.com/artifacts/com.github.chen0040/android-magento-client/
implementation ("com.github.chen0040:android-magento-client:1.0.5")
'com.github.chen0040:android-magento-client:aar:1.0.5'
<dependency org="com.github.chen0040" name="android-magento-client" rev="1.0.5">
  <artifact name="android-magento-client" type="aar" />
</dependency>
@Grapes(
@Grab(group='com.github.chen0040', module='android-magento-client', version='1.0.5')
)
libraryDependencies += "com.github.chen0040" % "android-magento-client" % "1.0.5"
[com.github.chen0040/android-magento-client "1.0.5"]

Dependencies

compile (5)

Group / Artifact Type Version
com.android.support » appcompat-v7 jar 25.3.1
com.github.chen0040 : java-magento-client jar 1.0.15
com.squareup.okhttp3 : okhttp jar 3.4.2
com.alibaba : fastjson jar 1.1.68.android
org.slf4j : slf4j-android jar 1.7.7

Project Modules

There are no modules declared in this project.

Install

Gradle

Add the following line to your build.gradle of your Android project:

compile 'com.github.chen0040:android-magento-client:1.0.5'

As the project makes uses of features in Java 8 therefore you need to enable Java 8 support in your Android project by adding the following to your gradle.build file:

android {
  ...
  
    defaultConfig {
        ...
		
        jackOptions {
            enabled true
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

If failed to download from jcenter() repository, add mavenCentral() into in the repositories declaration section of your gradle.build file.

Maven

Add the following dependency to the POM file of your Android project:

<dependency>
  <groupId>com.github.chen0040</groupId>
  <artifactId>android-magento-client</artifactId>
  <version>1.0.4</version>
  <type>aar</type>
</dependency>

Features

  • Support for token based authentication (ideal for Android application)
  • Support for V1 rest api at the current version of Magento which is Magento2 version 2.16
  • Allow access to:
    • Product (CRUD)
    • Product Media (CRUD)
    • Product Inventory (RU)
    • Product Categories (CRUD)
    • Guest Shopping Cart (CRUD)
    • My Shopping Cart (CRUD)
    • Account (R)

The java client provides access to web apis as listed in link and link2 currently available for Magent 2.16.

As Magento2 by default enable a feature preventing anonymous access to most of the web APIs which could cause third-party integrations to fail. If a third-party integration calls any of these web APIs, it will receive an authentication error instead of the expected response. In this case, you might need to disable this feature. To disable this feature, log in to the Admin panel and navigate to Stores > Configuration > Services > Magento Web API > Web API Security. Then select Yes from the Allow Anonymous Guest Access menu.

Usage

Customer Login

The sample code below shows how to login to magento site and retrieve the current login account information:

String magento_site_url = "http://magento.ll";
String username = "[email protected]";
String password = "password";
AndroidMagentoClient client = new AndroidMagentoClient(magento_site_url);
String token = client.loginAsClient(username, password);
Account myAccount = client.getMyAccount();

Admin Login

The sample code below shows how to login to magento site as the administrator and retrieve the admin login account information:

String magento_site_url = "http://magento.ll";
String username = "admin";
String password = "admin-password";
AndroidMagentoClient client = new AndroidMagentoClient(magento_site_url);
String token = client.loginAsAdmin(username, password);
Account account = client.getAccountById(1);

Product

The sample code below shows how to list products, get/add/update/delete a particular product by its sku

AndroidMagentoClient client = new AndroidMagentoClient(magento_site_url);
client.loginAsAdmin(username, password);

int pageIndex = 0;
int pageSize = 10;
ProductPage page = client.products().page(pageIndex, pageSize);
List<Product> products = page.getItems();

// check if product by sku exists
boolean exists = client.products().hasProduct(sku);

// get product detail
Product product = client.products().getProductBySku(sku);

// create or update a product 
Product product = new Product();
product.setSku("B203-SKU");
product.setName("B203");
product.setPrice(30.00);
product.setStatus(1);
product.setType_id("simple");
product.setAttribute_set_id(4);
product.setWeight(1);
product.setVisibility(Product.VISIBILITY_BOTH);
product.setStatus(Product.STATUS_ENABLED);
      
Product saveProduct = client.products().saveProduct(product);

// delete a product
client.products().deleteProduct(sku);

Product Media

The sample code below shows how to list the media associated with a particular product:

String productSku = "B202-SKU";
List<ProductMedia> mediaList = client.media().getProductMediaList(productSku);

// below returns a list of absoluate/relative urls for the media (e.g. images) associated with the product
List<String> imageUrls = client.media().getProductMediaAbsoluteUrls(productSku);
List<String> imageUrls = client.media().getProductMediaRelativeUrls(productSku);

In the above code,the entry id of a product media associated with the product can be obtained by calling the ProductMedia.getId() api.

The sample code below shows how to obtain a particular media associated with a product:

String productSku = "B202-SKU";
long entryId = 1L;

ProductMedia media = client.media().getProductMedia(productSku, entryId);

// below returns a list of absoluate/relative urls for the media (e.g. images) associated with the product
String imageUrl = client.media().getProductMediaAbsoluteUrl(productSku, entryId);
String imageUrl = client.media().getProductMediaRelativeUrl(productSku, entryId);

The sample code below shows how to upload an image for a particular product given the bytes of the image file:

String productSku = "B202-SKU";
String imageFileName = "new_image.png";

InputStream inputStream = new FileInputStream(imageFileName);

ByteArrayOutputStream baos = new ByteArrayOutputStream();
int length;
byte[] bytes = new byte[1024];
while((length = inputStream.read(bytes, 0, 1024)) > 0) {
 baos.write(bytes, 0, length);
}
bytes = baos.toByteArray();

boolean overwrite = true;
long uploadedEntryId = client.media().uploadImage(productSku, bytes, ImageType.Png, overwrite);

The sample code below shows how to upload an image for a particular product given the file path of the image file to upload:

String productSku = "B202-SKU";
String imageFilePath = "new_image.png";

boolean overwrite = true;
long uploadedEntryId = client.media().uploadImage(productSku, imageFilePath, overwrite);

The uploadedEntryId returned is the entry id created for the newly uploaded image.

The sample code below shows how to update an image media for a particular product given the bytes of the new image:

String productSku = "B202-SKU";
String imageFileName = "new_image.png";

InputStream inputStream = new FileInputStream(imageFileName);

ByteArrayOutputStream baos = new ByteArrayOutputStream();
int length;
byte[] bytes = new byte[1024];
while((length = inputStream.read(bytes, 0, 1024)) > 0) {
 baos.write(bytes, 0, length);
}
bytes = baos.toByteArray();
long entryId = 1L; // entry id of the media to be updated
boolean updated = client.media().updateImage(productSku, entryId, bytes, ImageType.Png);

The sample code below shows how to update an image media for a particular product given the file path of the new image:

String productSku = "B202-SKU";
String imageFilePath = "new_image.png";
long entryId = 1L; // entry id of the media to be updated
boolean updated = client.media().updateImage(productSku, entryId, imageFilePath);

The sample code below shows how to delete an image or a video associated with a particular product:

String productSku = "B202-SKU";
long entryId = 1L; // entry id of the media to be deleted
boolean deleted = client.media().deleteProductMedia(productSku, entryId);

Product Categories

The sample code below show how to list/add/update/delete categories, get a particular category,

AndroidMagentoClient client = new AndroidMagentoClient(magento_site_url);
client.loginAsAdmin(username, password);

// list categories
Category page = client.categories().all();

// get the category that has category_id = 15 (Clean means no children of that category will be returned)
Category category15 = client.categories().getCategoryByIdClean(15);
Category category15 = client.categories().getCategoryByIdWithChildren(15);

// delete category with category id = 15
client.categories().deleteCategory(15);

Category newCategory = ...
client.categories().addCategory(newCategory);

newCategory.setName("New Category Name");
client.categories().updateCategory(newCategory);

The sample code below show how to list/add/remove products under a category:

// list products under category 15
List<CategoryProduct> products = client.categories().getProductsInCategory(15);

// add product to category
long categoryId = 15;
String productSku = "B202-SKU";
int position = 1;
boolean added = client.categories().addProductToCategory(categoryId, productSku, position);

// remove product from category
boolean removed = client.categories().removeProductFromCategory(categoryId, productSku);

Product Inventory

The sample code below shows how to obtain and update the inventory information for a particular product sku:

AndroidMagentoClient client = new AndroidMagentoClient(magento_site_url);
client.loginAsAdmin(username, password);
String productSku = "product_dynamic_571";
StockItems inventory_for_sku = client.inventory().getStockItems(productSku);

// to update the inventory for the product
inventory_for_sku.setQty(10);
String stockId = client.inventory().saveStockItems(productSku, inventory_for_sku);

Guest Shopping Cart

The sample code below shows how to create a new guest shopping cart, add/update/delete items in the shopping cart:

Note that creating guest shopping cart does not require login

AndroidMagentoClient client = new AndroidMagentoClient(magento_site_url);
String cartId = client.guestCart().newCart();

CartItem item = new CartItem();
item.setQty(1);
item.setSku("product_dynamic_758");

// add new item to shopping cart
item = client.guestCart().addItemToCart(cartId, item);
System.out.println("cartItem: " + JSON.toJSONString(item, SerializerFeature.PrettyFormat));

// update item in the shopping cart
item.setQty(3);
item = client.guestCart().updateItemInCart(cartId, item);
System.out.println("cartItem: " + JSON.toJSONString(item, SerializerFeature.PrettyFormat));

// delete item in the shopping cart
boolean deleted = client.guestCart().deleteItemInCart(cartId, item.getItem_id());

Cart cart = client.guestCart().getCart(cartId);
CartTotal cartTotal = client.getGuestCart().getCartTotal(cartId);

System.out.println("cart: " + JSON.toJSONString(cart, SerializerFeature.PrettyFormat));
System.out.println("cartTotal: " + JSON.toJSONString(cartTotal, SerializerFeature.PrettyFormat));

The sample code belows show how to transfer a guest cart to my cart after user login:

AndroidMagentoClient client = new AndroidMagentoClient(magento_site_url);

String cartId = client.guestCart().newCart();

CartItem item = new CartItem();
item.setQty(1);
item.setSku("product_dynamic_758");

item = client.guestCart().addItemToCart(cartId, item);

client.loginAsClient("username", "password");
boolean result = client.myCart().transferGuestCartToMyCart(cartId);

Cart cart = client.myCart().getCart();
CartTotal cartTotal = client.myCart().getCartTotal();

My Shopping Cart

The sample code below shows how to create my shopping cart, add/update/delete items in the shopping cart:

Note that creating my shopping cart requires login

AndroidMagentoClient client = new AndroidMagentoClient(magento_site_url);
client.loginAsClient("username", "password");
String quoteId = client.myCart().newQuote();

CartItem item = new CartItem();
item.setQty(1);
item.setSku("product_dynamic_758");

// add new item to shopping cart
item = client.myCart().addItemToCart(quoteId, item);
System.out.println("cartItem: " + JSON.toJSONString(item, SerializerFeature.PrettyFormat));

// update item in the shopping cart
item.setQty(3);
item = client.myCart().updateItemInCart(quoteId, item);
System.out.println("cartItem: " + JSON.toJSONString(item, SerializerFeature.PrettyFormat));

// delete item in the shopping cart
boolean deleted = client.myCart().deleteItemInCart(item.getItem_id());

Cart cart = client.myCart().getCart();
CartTotal cartTotal = client.myCart().getCartTotal();

System.out.println("cart: " + JSON.toJSONString(cart, SerializerFeature.PrettyFormat));
System.out.println("cartTotal: " + JSON.toJSONString(cartTotal, SerializerFeature.PrettyFormat));

Notes

Versions

Version
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1