Home
MATRIXX Business API SDK
Creating Extensions
You create extensions using a Maven archetype and then add those extensions to the RS Gateway as JAR files.
Example Offer Purchase Extension Project
This section describes a project that creates a custom RS Gateway call that enhances offer purchasing. The project defines a custom offer purchase URL with a custom payload which returns balance impacts.
Creating the Offer Purchase Custom MDCs
In this section, you will create the custom MATRIXX Data Containers (MDCs) to hold the custom data.
Create a Private Request MDC
In this task, you create a custom MATRIXX Data Container (MDC) to hold the information that comprises the REST request. This custom offer purchase request for a subscriber defines the information needed to find the subscriber and to select an offer.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
- About MATRIXX Business API SDK
  MATRIXX Business API SDK provides the APIs, libraries, and other files needed to create a customized version of the RS Gateway.
- Business API SDK Overview
  The Business API SDK is a flexible framework that includes a set of tools to manage, customize and extend Rest Services Gateway (RS Gateway) for customer-specific business needs. Using the SDK, you can extend existing projects or create entirely new projects to add, replace, or modify services that leverage existing functionality.
- Business API Gateway
  The Business API Gateway is a development framework that includes the Business API SDK, Rest Services Gateway (RS Gateway), Gateway Proxy, and application tier. It allows custom mobile applications, web clients, and other custom implementations to integrate with MATRIXX.
- Creating Extensions
  You create extensions using a Maven archetype and then add those extensions to the RS Gateway as JAR files.
  - Installing and Initializing the SDK
    Before beginning RS Gateway extension development, you must install the MATRIXX dependencies in the local Maven repository. Use the provided installation script or do it manually.
  - Creating a Project
    After you install the SDK dependencies, create a project using the MATRIXX Extension Maven archetype.
  - Defining the Extension
    Creating an extension involves multiple steps, including defining custom MATRIXX Data Containers (MDCs) from MATRIXX Engine and RS Gateway in the Extensions module MDC files, defining the REST APIs, and defining the routing rules.
  - Testing Extensions
    During extension development, test your code at different stages.
  - Deploying the Extension
    Each extension module described in the discussion about creating an extension has a JAR file which you deploy to the RS Gateway pod.
  - Creating Multi-Request REST Services
    This section describes how to create new services that are an orderly set of atomic SubMan multi-requests.
  - Example Offer Purchase Extension Project
    This section describes a project that creates a custom RS Gateway call that enhances offer purchasing. The project defines a custom offer purchase URL with a custom payload which returns balance impacts.
    - Getting Started
      Before you begin, follow the instructions in the discussion about creating extensions to install and initialize the SDK and create a project.
    - Creating the Offer Purchase Custom MDCs
      In this section, you will create the custom MATRIXX Data Containers (MDCs) to hold the custom data.
      - Create a Custom MDC
        In this task, you create a custom _glossary/mdc.html with fields (type, amount, color) to extend the base MtxPurchasedOffer MDC.
      - Create a Private Request MDC
        In this task, you create a custom MATRIXX Data Container (MDC) to hold the information that comprises the REST request. This custom offer purchase request for a subscriber defines the information needed to find the subscriber and to select an offer.
      - Create a Private Response MDC
        In this task, you create a custom _glossary/mdc.html to hold the information that comprises the REST response. This custom offer purchase response for a subscriber defines the information needed to find the subscriber and to select an offer. All REST requests are derived from the out-of-the-box MtxRequest object.
      - Define the MDC Relationships
        In this task, you define the relationship between the input message (the request message) and the output message (the response message).
    - Creating the Offer Purchase REST Service
      This section describes how to create the REST service that enables you to purchase a custom product offer.
    - Creating the Offer Purchase Extension Class and Methods
      In this section, you define the extension class using stubs to test the extension and update the REST service to use the Spring object manager.
    - Build and Deploy the Extension
      When the custom extension is complete, add it to the classpath and restart the RS Gateway.
  - Example REST Tax Service
    This section describes a project that implements a tax service.
- Creating Custom Filters
  You can create a custom filter by creating a named filter or a filter class. A named filter is useful for simple filters while a filter class should be used for complex filters (for example, when the returned results must be modified).
- Upgrading the Business API SDK
  When you upgrade the MATRIXX software, you must upgrade the Business API SDK as it is possible that files have changed or have been deprecated. Use the manage_integration_project.py script to remove the current release from your project directory structure and upgrade to the latest release. You should do this even if your files are not checked into Subversion.
- Appendixes
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

Create a Private Request MDC

In this task, you create a custom MATRIXX Data Container (MDC) to hold the information that comprises the REST request. This custom offer purchase request for a subscriber defines the information needed to find the subscriber and to select an offer.

About this task

All REST requests are derived from the out-of-the-box MtxRequest MDC.

Procedure

Edit the projects/purchase/src/main/resources/extension-rest-mdc.xml file.

Define the private request MDC with five fields (SubscriberSearchData, Offer, Type, Amount, and Color).

You must define all MDC definitions and REST calls within the <configuration> … </configuration> nodes. Add the following code.

<container id="DemoRequestSubscriberPurchase">
    <doc_description>Demonstration of a custom offer purchase</doc_description>
    <created_schema_version>2</created_schema_version>
    <base_container id="2">MtxRequest</base_container>
    <field id="SubscriberSearchData">
        <created_schema_version>2</created_schema_version>
        <doc_description>Subscriber search data structure</doc_description>
        <doc_required/>
        <datatype>struct</datatype>
        <struct_id>MtxSubscriberSearchData</struct_id>
    </field>
    <field id="Offer">
        <created_schema_version>2</created_schema_version>
        <doc_description>Offer being purchased.</doc_description>
        <doc_required/>
        <datatype>struct</datatype>
        <struct_id>MtxPurchasedOfferData</struct_id>
    </field>
    <field id="Type">
        <created_schema_version>2</created_schema_version>
        <doc_description>Type of offer being created.</doc_description>
        <datatype>string</datatype>
        <max_size>15</max_size>
    </field>
    <field id="Amount">
        <created_schema_version>2</created_schema_version>
        <doc_description>Amount of the offer.</doc_description>
        <datatype>decimal</datatype>
    </field>
    <field id="Color">
        <created_schema_version>2</created_schema_version>
        <doc_description>Color of the offer.</doc_description>
        <datatype>string</datatype>
        <max_size>15</max_size>
    </field>
    <storage_size>large</storage_size>
</container>

Save the file.

What to do next

Create the private response MDC.