Scripting in ReadyAPI Virtualization for Dynamic Mocks
Hey Everyone.
I wanted to make a post about scripting in ReadyAPI Virtualization for the purpose of creating dynamic mocks. Scripted samples always help when I'm trying to achieve something, so I hope that these scripts will help guide you with dynamic mocks.
I've primarily used two resources to learn how to work with dynamic mocks. The first is a support document for SoapUI OS. This page has a comprehensive overview on working with mock services and provides examples on how to accomplish various tasks when working with the virtual service scripts. https://www.soapui.org/docs/soap-mocking/creating-dynamic-mockservices/
My intent here is to provide some scripted samples that I've worked on. I'd also like to hear if anyone has requests on scripted tasks with virtual services in ReadyAPI.
Below is a scripted example on taking the content of a payload in a POST request and routing the JSON nodes into a virtual response message. To read in the values of the request body I use the mockRequest.getRequestContent() method. This will return a string value that may include some extra content along with the request payload. You'll likely want to trim the extra content out so that the payload is extracted from the original string. Once we have the payload isolated, we can create a JSON slurper to easily extract the content of the JSON nodes. The nodes are then tied to a property value that I reference in the response message using the requestContext.value format, where valueis the name of the property that we'll reference in the response.
//Add slurper to isolate json. This makes it easier to parse the nodes in the response
import groovy.json.JsonSlurper
//Save the response content to a string
//This will result in some overhead
def logText = mockRequest.getRequestContent()
// Find the index of the first '{' character
def startIndex = logText.indexOf('{')
// Extract the substring starting from the '{' character
def result = startIndex != -1 ? logText.substring(startIndex) : logText
//pipe the result into a json slurper for easy parsing
def jsonSlurper = new JsonSlurper()
def JsonBody = jsonSlurper.parseText(result)
//We can map the individual nodes from the Json object that we created previously
requestContext.id = JsonBody.id
requestContext.categoryID = JsonBody.category.id
requestContext.categoryName = JsonBody.category.name
requestContext.name = JsonBody.name
requestContext.status = JsonBody.status
Here's an example on mapping values from a data source into a response message. This example reads in an Excel file, then uses a request parameter as a key value to find the values of a row of data in the Excel spreadsheet.
There's another example on the SoapUI documentation that discusses how to do this with a database connection. You can navigate here for that example.
This script is broken down into three sections. The first section reads in the request parameter that we'll use as our key. Request parameters can be accessed with the mockRequest.getRequest().getQueryString() methods. I take the output of this method and tie it to a string. You'll want to do some parsing on the string to isolate the exact value you want to use.
The second section then opens a workbook in Excel and looks for the row of data based on our key (the "q" property). The POI libraries make it fairly easy to work with Excel workbooks, and there's lots of resources online that can explain how to use the libraries better than I can. All we're doing here is opening the workbook and scanning each row to see if we find a row of data that matches our key.
The third section triggers if we find a row of data that matches our key. I use a switch statement here to map the values of the row to a property. The main thing to note is that we use the requestContext.valueformat to assign the values to a virtual service property.
Here's the script I use:
//Read in excel libraries
import org.apache.poi.ss.usermodel.*
import org.apache.poi.xssf.usermodel.XSSFWorkbook
//================================================================//
//Part 1. Read in request parameters.
//================================================================//
// Get the query string of the request, isolate the "q" parameter
// In this example, the request string looks like: "q=CityName&apikey=abc1234"
def inputString = mockRequest.getRequest().getQueryString()
def inputString2 = mockRequest.getRequest()
log.info inputString2
def q = null
//split query string
def keyValuePairs = inputString.split("&")
keyValuePairs.each { pair ->
def key = pair.split("=")[0]
def value = pair.split("=")[1]
if (key == "q") {
q = value
}
}
//================================================================//
//Part 2. Open Workbook. Scan for row of data
//================================================================//
// Specify the path to your Excel file
def filePath = "<path to your file here>"
// Specify the value to search in the first column
def searchValue = q
// Load the Excel file
def file = new File(filePath)
def workbook = new XSSFWorkbook(file)
// Assuming the data is in the first sheet, you can change the sheet index if needed
def sheet = workbook.getSheetAt(0)
// Find the row with the matching search value
def matchedRow = null
for (Row row : sheet) {
def cellValue = row.getCell(0)?.toString()
if (cellValue == searchValue) {
matchedRow = row
break
}
}
//================================================================//
//Part 3. Map cells of the row to response variables. Close workbook.
//================================================================//
if (matchedRow != null) {
for (Cell cell : matchedRow) {
int columnIndex = cell.getColumnIndex()
switch (columnIndex) {
case 0:
requestContext.cityCell = cell.toString()
break
case 1:
requestContext.countryCell = cell.toString()
break
case 2:
requestContext.abbrCell = cell.toString()
break
default:
break
}
}
}else {
//Do Something
}
// Close the workbook
workbook.close()
The response then looks like this:
{
"Response": "This is a dynamic response",
"Location":"${cityCell}",
"Country" : "${countryCell}",
"Country Code" : "${abbrCell}"
}
My example uses a spreadsheet which provides responses for the 50 most populated cities. As long as we hit a city on this list we'll return a response such as this:
The dataset that I'm using in this example looks like this: