Skip to main content

Websphere Commerce SOLR REST Framework

With new feature pack FEP8, data can be directly fetched from SOLR index via REST calls without hitting commerce server. In order to do the customization, we first need to understand the REST framework in Websphere commerce.
  • Every REST call has a unique pattern like /productview/byCatentryId/{catentryId}
  • To handle such REST request, the entry points are Rest Handlers.
  • In this case, it's ProductViewHandler.
  • These REST handlers are of AbstractSearchResourceHandler type and are annotated with different Path annotations.
  • These annotation could be at two level, class level and method level.
  • In general, /productview/ represents a class level path and the next token represents different methods.

@Path ("store/{storeId}/productview")
public class ProductViewHandler extends AbstractSearchResourceHandler {

   @Path ("byCatentryId/{catentryId}")
   public Response getProductByUniqueID(@QueryParam String responseFormat...) {
   }

   @Path ("byPartNumber/{partnumber}")

   public Response getProductByPartNumber(@QueryParam String responseFormat...) {
   }
}

  • The method name and class name has no significance but just conventions associated with them. The actual mapping is determined by the Path annotation.
  • Now, how would Search server know that there exists a Handler with ability to handle specific patterns?
  • Every REST handler is supposed to be registered with Search server. OOTB handlers are defined in /Search-Rest/WebContent/WEB-INF/config/resources-search.properties
  • If you want to create your custom REST handlers, an entry needs to be defined in /Search-Rest/WebContent/WEB-INF/config/resources-search-ext.properties.
  • At server startup time, the entries in resource file are loaded and different Path annotations are registered with search server.
Labels:

Comments

Post a Comment

Popular posts from this blog

File Upload in Websphere Commerce

Websphere Commerce has a inbuilt mechanism to handle the file upload process but it has some limitations with it. Whenever a File type is present in request object, commerce ignores the rest of parameters coming after that. The inbuilt mechanism treats the file object as UploadedFile type object. This type of object provides a limited number of options to further process the File Objects. To  overcome these limitation, we need to use Apache Common Fileupload features to handle the File Upload process for Hanes. File Upload Basic Requirements In order to pass a File object in request, we need to make some changes in the Form. File Upload is not supported by REST or Ajax REST Requests. Icon Request Parsing The first step is to parse the request for Uploaded File Objects. And apart from this we need to get the other parameters back to request properties, which is not available because of the limitation of commerce. ...
Post a Comment
Read more

Websphere Commerce Creating a custom SOLR core

This page describes how we can create custom SOLR cores in commerce. Let's think of a e commerce site where we retailers can log in and can register there shops. We want to index Shops so that user can search for different shops. SOLR Core Naming Convention A custom SOLR core has to be named according to OOTB convention  MC_10001_<coreName>_en_US . The core name should be a single word without any underscores in it. An entry in solr.xml will look like as below < core   instanceDir = "MC_10001\en_US\Shops\"   name = "MC_10001_Shops_en_US"   /> Registering custom core with Search server Create a new folder along with the other SOLR cores,  "Shops " at /search/solr/home/MC_10001/en_US/ Shops  should have a " conf " folder for configuration XMLs . Define SQL in /conf/wc-data-config.xml and map the database fields with SOLR fields. Define SOLR fields in schema.xml We need to register our custom SO...
4 comments
Read more

Enabling Inventory index for storefront in Websphere Commerce

By default, Inventory Index is only meant for business users to use in CMC for Product Ranking and merchandising purpose. This document describes how to enable this OOTB SOLR Index for Store Front usage so that it can be used to get SKUs Inventory from SOLR Index instead of DB hits. The implementation involves two steps: Enable OOTB Inventory Index Make it usable by Store Front Pages Enable Inventory Index This step is well described at Infocenter at  Setting up and building the inventory index Enable Inventory Index for Store Front pages This involves following steps Define a Search resource Handler to accept Inventory fetch requests. SOLR Index Customization, if required Define a search Profile to expose Inventory Schema fields to Response Map SOLR schema fields to External Response fields Custom Expression Provider to get default fulfillment center Id. ...
Post a Comment
Read more