Anypoint MQ Circuit Breaker - Mule4

In integration development there are lot of patterns that we can follow based on project requirements. Circuit Breaker is one of them.
In this article we will see how Circuit Breaker can be used and what we should consider while implementing it. 

Circuit breaker design pattern is used when:

• To handle error scenarios and message reprocessing strategy.

Mulesoft has provided circuit breaker capability with Anypoint MQ component.
You can add dependency inside your pom as below:

<dependency>
<groupId>com.mulesoft.connectors</groupId>
<artifactId>anypoint-mq-connector</artifactId>
<version>3.1.0</version>
<classifier>mule-plugin</classifier>
</dependency>

Now, I will show you how you can design and configure your mule flows for implementing Circuit Breaker capability.


Below is the sample circuit breaker mule flow design:

We will explain each and every part the above flow design below:

Circuit Breaker Configuration:

Go to global elements section create a Circuit breaker configuration as below:

This configuration can be shared across multiple Subscriber resources in the project.

On Error Types – Type of Errors based on which you want to Open the Circuit.
Errors Threshold – No. of Failures in Succession – Ex: 5
Trip Timeout – Duration to keep the Circuit Open once the ErrorThreshold is reached – Ex: 60 Minutes

Subscriber Configuration

Anypoint MQ Subscriber Source provides Circuit Breaking Capability.
                                                       

 
1. Select the Anypoint MQ Subscriber Source.
2. Click on the Advanced tab.
3. Provide the Circuit Breaker from Global Reference.

AMQ Message Processing\Listening Strategy:

This section describes the methodology how we are going to follow to process messages from Anypoint MQ. This process helps in effectively handling reprocessing and retrying scenarios and also simplifies the process from a maintenance perspective.


Steps:

1. Configure the Subscribe processor
2. Subscriber Type – Prefetch
3. Max Local Messages –  default it to 5, you can change based on requirement for further tuning.
4. Acknowledgment Mode – Set to MANUAL, As the Acknowledgement Mode is set to MANUAL, we need to Ack the message post successful completion of the flow. So that the message doesn’t get retried/consumed.

Circuit Breaker and AMQ Listening Strategy both need to be configured in our components where we want messages to be reprocessed and retried in a configurable manner.

In case of Error Scenarios,

Based on your requirement you can catch the error and subsequent to Error Handling, Nack the message so that the message stays on the queue and will be subsequently redelivered.

You can use Ack the message so that the message is removed from the queue in case of success scenarios.

This ackToken you can store in variable which can be used for Ack/Nack of the message.

MQ messages stores in queue after getting Nack

Please find sample Mule project in Github Error-Handling-using-Anypoint-MQ-Circuit-Breaker

Read More »

Queueable Apex - The middle way

The last post was a comparison between batch apex and @future apex. There are some advantage and disadvantage with both of them. When batch and @future needs to meet in between - queueable comes for rescue.

There are a few things that @future did not provide:

1. @future requires the arguments be primitives, which means reconstructing a structure once the method is called.
2. Difficult access to job ID. The executeBatch method returns a jobID, while calling an @future job does not give you the ID of the related job.
3. No chaining - Chaining of batch apex is not allowed.

Q - Why we go for queueable Apex?

A - When the job such as extensive database operations or external Web service callouts is long running and is running asynchronously and you want to monitor the job status. It can be done via queueable apex and adding a job to the ApexJob queue. In this way, your asynchronous Apex job runs in the background in its own thread and doesn’t delay the execution of your main Apex logic.

Queueable jobs are similar to future methods in that they’re both queued for execution, but they provide you with these additional benefits.

Getting an ID for your job: When you submit your job by invoking the System.enqueueJob method, the method returns the ID of the new job. This ID corresponds to the ID of the AsyncApexJob record.
This ID helps you identify your job and monitor its progress, either through the Salesforce user interface in the Apex Jobs page, or programmatically by querying your record from AsyncApexJob.

Using non-primitive types: Your queueable class can contain member variables of non-primitive data types, such as sObjects or custom Apex types.

Chaining Jobs: In queueable you can also chain Jobs from a running job. It is very helpful if some processing needs to be done which depends on the last results.

Example:
This example is an implementation of the Queueable interface. The execute method in this example inserts a new account.

public class QueueableExample implements Queueable {

    public void execute(QueueableContext context) {
        Account acc = new Account(Name='Test Account Neeraj');
        Insert acc;     
    }
}

To add this class as a job on the queue, call this method:
ID jobID = System.enqueueJob(new QueueableExample());

After you submit your queueable class for execution, the job is added to the queue and will be processed when system resources become available. We can monitor the status of our job programmatically by querying AsyncApexJob or through the user interface Setup --> Monitor --> Jobs --> Apex Jobs.

Test class for queueable apex:

@isTest
public class AsyncExecutionExampleTest {
    static testmethod void testAccount() {
     
        Test.startTest();     
        System.enqueueJob(new QueueableExample());
        Test.stopTest();

        Account acct = [SELECT Name FROM Account WHERE Name='Test Account Neeraj' LIMIT 1];
        System.assertEquals('Test Account Neeraj', acct.Name);
    }
}

Few things can be noted here:

• The execution of a queued job counts against the shared limit for asynchronous Apex method executions.
• We can add up to 50 jobs to the queue with System.enqueueJob in a single transaction.
• Use Limits.getQueueableJobs() to check how many queueable jobs have been added in one transaction.
• No limit is enforced on the depth of chained jobs.
• We can add only one job from an executing job with System.enqueueJob, that means only child job can exist for parent queueable job.

Read More »

Access Anypoint Platform in Anypoint Studio

Issue:

You can not access Anypoint Platform after configuring External Identity in Anypoint Studio.

Reason:

One of most common issues is the wrong Organization Domain configuration.

HowTo:

Please follow below steps to validate if the Organization domain is properly configured:

Open Anypoint Studio
Go to Window -->Preferences --> Anypoint Studio --> Authentication --> Add Button

 
Now click on Configure --> Select External Identity

Provide your valid Organisation domain --> Select OK
Please validate your Organization domain field. The value must be your valid Organization domain.

Once validated you can login your Anypoint Account with your user-id and password. You also can configure expires days.

Finally select Apply and Close button.


Happy Learning :)

Read More »

Configure Git plugin in Anypoint Studio

Objective

How to install Git plugin in Anypoint studio. 
The installation advantage of git plugin to Anypoint studio that you can do following things through AnypointStudio:

• You can clone a existing Git repository.
• Checkin your code to git repositories
• Create a git repositories and many more...

Steps to Install Git Plugin to AnypointStudio

1. Go to http://wiki.eclipse.org/EGit/FAQ#Where_can_I_find_older_releases_of_EGit.3F,  and copy the "p2 repository URL"  for the Eclipse version you are using (or select the closest version to what you have installed)

2. In Studio, click the Help menu --> select Install New Software…

3. In the Work with field of the Available Software panel, click on Add button, and add a New name and the URL copied. Click ok

4. Select Git integration for Eclipse, and continue installation as normal.

After Installation you will need to restart your AnypointStudio and then you will find your Git plugin perspective. You can get from the quick search option as below:

or from Menu Bar, 
Window--> Perspective--> Open Perspective --> Other--> Select Git:

Happy Learning :)

Read More »

Munit coverage for APIKit flows Part2 - Mule4

In my previous articles How to generate Mule flow using RAML and MUnit complete coverage for ApiKit flows Part1 - Mule4 we have seen how Mule application can be generated using APIkit RAML and how we can test our routing flows using MUnit Test Suites.

Now here in this article we will see how to write MUnit test cases for flows that were created with APIkit RAML for APIKit Validation scenarios.

APIkit Router validates the incoming requests, HTTP methods, URI and URI parameter, header and query parameters against the structure or validation defined in RAML. It also routes the message to the respective flow and serials response. Message routing consists of incoming API requests to existing Mule flows and returning outgoing HTTP response codes to exceptions.

Things to consider while writing MUnits for Validation flows:

Above configuration is needed to validate HTTP response code. This you can configure as per your test scenarios.

After adding MUnit for APIKit Validation flows your MUnit coverage report has been increased as shown below:

Please find sample Mule project in Github munit-for-apikit-flow-part2-mule4

Happy Learning :)

Read More »