com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links' is unknown.

Exposing a JNDI Datasource as a Data Service

Owned by Former user (Deleted)
Last updated: Sept 23, 2016
2 min read

Java Naming and Directory Interface (JNDI) is a Java API (application programming interface) providing naming and directory functionality for Java software clients to discover and look up data and objects via a name.  WSO2 Data Services Server supports the JNDI InitialContext implementation by inheriting the JNDI implementation of Tomcat (http://tomcat.apache.org/tomcat-7.0-doc/jndi-resources-howto.html). JNDI helps decouple object creation from the object look-up. When you have registered a datasource with JNDI, others can discover it through a JNDI lookup and use it.

 

Start the Create New Data Service wizard

Now, let's start creating the data service from scratch:

  1. Log in to the management console using the following URL on your browser:  "https://localhost:9443/carbon/".

  2. Click Create under the Data Service menu to open the Create Data Service wizard.

  3. Enter a name for the data service. Leave the default values for the other fields.

  4. Click Next to go to the Datasources screen.

Add a JNDI datasource

You can add a JNDI datasource by following the steps given below.

  1. Click Add New Datasource to open the following screen:

  2. Select JNDI Datasource as the data source type. The JNDI-specific options will be available for editing as shown below.

    The options in the above window are explained below:

    • JNDI Context Class: The corresponding context factory class.

    • Provider URL: The URL that specifies the location of a resource on the Web.

    • Resource Name: The name of the JNDI resource. 

 

You can also expose an RDBMS Carbon datasource as a JNDI datasource using the Configure > Datasources menu of the management console. For instructions, see Adding datasources.

Define a query for the datasource

Now let's start writing a query for getting data from the datasource. The query will specify the data that should be fetched by this query, and the format that should be used to display data when the query is invoked.

  1. Click Add New Query to open the Add New Query screen.
  2. Enter the following values:
    • Query ID: Enter an ID for the query.
    • Datasource: Select the datasource for which you are going to write a query. Select the JNDI datasource that you created previously.

    • SQL: In this field, enter the SQL statement describing the data that should be retrieved from the RDBMS datasource.

  3. Add input mappings: Input mappings allow you to add parameters to a query so that you can set the parameter value when executing the query. 

    Find out more about defining Input Mappings in WSO2 DSS.

  4. Add output mappings: Out mapping is used to specify how the data that is fetched from your query will be shown in the response.

    Find out more about defining Output Mappings in WSO2 DSS.

  5. Click Next to open the Operations screen.

Define an operation to invoke the query

Data service operations are written to invoke queries.

  1. Click Add New Operation to open Add New Operation screen.
  2. Add a name for your operation in the Operation Name field.
  3. In the Query ID field, select the query that you defined previously.
  4. Save the operation.

Finish creating the data service

Once you have defined the operation, click Finish to complete the data service creation process. You will now be taken to the Deployed Services screen, which shows all the data services deployed on the server.

com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.