Saturday, May 30, 2015

WSO2 Application Manager (AppM)

WSO2 Application Manager (AppM)

What and Why?

WSO2 App Manager (AppM) is a solution to provide controlled access to several applications for many users in an organisation. In other words WSO2 AppM handles as a proxy between your web apps and the user and enables you to maintained a controlled and monitored environment.

Technical Aspects:

WSO2 App Manager is created on top of the Carbon platform, where it extends registry assets and provides the capability to add web applications. All the functionality can be extended with extension points provided by WSO2 App Manager. It is developed mainly using three technologies namely, SAML2 SSO, XACML policy definition and OAuth secured API invocations.  It is bundled with a set of features for app creation, publication, lifecycle management, versioning, monetization, governance, security etc. using proven WSO2 products such as, WSO2 Enterprise Store, WSO2 Enterprise Service Bus, WSO2 Identity Server, and WSO2 Governance Registry. In addition, it is also powered by the WSO2 Business Activity Monitor, and is immediately ready for massively scalable deployments.
WSO2 App Manager is a fully open sourced product and released under Apache Software License Version 2.0, one of the most business-friendly licenses available tod ay.

Mobile Support:

WSO2 App Manager supports publishing iOS, Android, Hybrid and Web apps with app versioning and lifecycle management. The storefront enables directly downloading mobile apps with the support for self-subscription and app rating. WSO2 App Manager is easily configurable with WSO2 device management solutions or any third-party device management solutions for device management purposes.

How to start?

You can download the AppM binary from here.

  • Unzip the binary
  • go to [binary] > bin 
  • (linux/mac) , wso2server.bat (windows)

WSO2 AppM Components


Tuesday, May 26, 2015

Database interaction WSO2 ESB

Database interaction WSO2 ESB

Lets say we have a requirement of getting the data (eg: may be configuration information) from database and store the same in a cache. This should be a onetime activity where we don’t want to interact with the database for every request. The newly created cache should be accessed for any further request in order to get the configuration information instead of from the database.

In this post I'm trying to explain you what are the options available and how to achieve the above requirement.

There are 2 options available to cater this requirement
  1. Cache Mediator
  2. Custom Mediator

Cache Mediator

Refer :
You can retrieve the values from database using a DB Lookup Mediator and cache the result.
And when the next request comes, it should only execute the dblookup mediator when the cache is empty.
But please note that using a DB lookup mediator you can retrieve only one data row from the database.

Custom Mediator 

Refer :
You can write a custom mediator to implement this requirement. Here you do not need a DB lookup mediator. And what this custom mediator would do is, it should have a cache and when a requests comes, if the cache it empty it should retrieve the data from the database directly. else it should use the cached values and update the messageContext properties. please refer the sample.

//Please note that this is only a sample code for you to get a basic idea

package org.example.mediator;

import org.apache.synapse.MessageContext;
import org.apache.synapse.Mediator;
import org.apache.synapse.mediators.AbstractMediator;
import org.apache.axiom.soap.SOAPBody;
import org.apache.axiom.soap.SOAPFactory;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import javax.cache.Cache;

import javax.xml.namespace.QName;

public class MyMediator extends AbstractMediator {

    private static final Log log = LogFactory.getLog(MyMediator.class);

    public MyMediator(){}

    public boolean mediate(MessageContext mc) {
      if( getDBValueCache().get(“dbValueCache”) == null){
//retrieve values from db
//update cache
//set values as MessageContext properties
return true;

    private Cache getDBValueCache() {
return Caching.getCacheManager(“dbValueCache".getCache(“dbValueCache”);

If you need to further improve the code and to load the values when synapse initializes, you can implement the ManagedLifecycle interface in your class mediator and implement the init() method to load the required data.

import org.apache.synapse.ManagedLifecycle;
public class MyMediator implements Mediator, ManagedLifecycle {
public void init(SynapseEnvironment synapseEnvironment)
public void destroy() {
// mediation logic here
{ // perform initialization here }

If you are using this in multiple places, there will be multiple instances of the class mediator created for each declaration of the class mediator in synapse configurations. Hence there will be multiple copies of the cache as well. If you need to eliminate having multiple copies, you can make the cache/map static.