mock-binding-project

ODL mock binding project

First Steps

First, you can try to build the netconf and controller projects:

mvn clean install              # Builds and installs artifacts into .m2, runs all checks and unit tests
mvn clean install -DskipTests  # Same as above but skips unit tests
mvn clean install -Pq          # Fast profile, skips all checks and unit tests, only compiles

Then, you can try running the Karaf distribution. You can find it in the karaf directory in the corresponding project.

sh ./karaf/target/assembly/bin/karaf

Or for a clean run of Karaf:

sh ./karaf/target/assembly/bin/karaf clean

This distribution will only have features from the project and its dependencies.
If you need the full distribution, you need to build the integration/distribution project and use the distribution from there.

ODL Mock Binding Project

First, you will need a YANG model.
You can get familiar with YANG here and create your own model, or use an existing one.

For the purpose of this tutorial, this simple YANG module is used:

module example {
    yang-version 1.1;
    namespace "urn:opendaylight:example";
    prefix "ex";
    revision "2024-07-10";

    container cont {
        leaf l {
            type string;
        }
    }
}

To implement your YANG model, put it into the api module directory.
Then build the project; it should generate Java bindings(Java classes in the target directory).

You can then use those bindings with the DataBroker that is injected in the impl module to write/read data to/from the datastore in the MockBindingProvider #init() method.

Example code for writing data to the datastore:

// Create write transaction
final WriteTransaction tx = dataBroker.newWriteOnlyTransaction();

// Create data
Cont data = new ContBuilder().setL("example string").build();

// Create InstanceIdentifier for Cont container
InstanceIdentifier<Cont> instanceIdentifier = InstanceIdentifier.create(Cont.class);

// Put data to datastore and commit them
tx.put(LogicalDatastoreType.CONFIGURATION, instanceIdentifier, data);
tx.commit().get();

Example code for reading data from the datastore:

// Create read transaction
final ReadTransaction rx = dataBroker.newReadOnlyTransaction();

// Get optional data which can be empty
FluentFuture<Optional<Cont>> future = rx.read(LogicalDatastoreType.CONFIGURATION, instanceIdentifier);
Optional<Cont> optionalData = future.get();
        
// Check if data is present and get them
if (optionalData.isPresent()){
    Cont dataOut = optionalData.get();
}

Build the project, run Karaf, and install the mock-binding-project feature to run your code:

feature:install features-mock-binding-project

Using RESTCONF

If you add the RESTCONF dependency to the Karaf POM, you can install the odl-restconf-nb feature and use RESTCONF to manipulate data.

Add the dependency and rebuild the project:

<dependency>
    <groupId>org.opendaylight.netconf</groupId>
    <artifactId>odl-restconf-nb</artifactId>
    <version>7.0.7</version>
    <classifier>features</classifier>
    <type>xml</type>
    <scope>runtime</scope>
</dependency>

Run Karaf and install the features:

feature:install features-mock-binding-project odl-restconf-nb

Then, you can use Postman to access and modify data:

For authentication, use Basic Auth with username and password set to "admin"
or use the header Authorizationwith the value Basic YWRtaW46YWRtaW4=

Writing data:

To write data to the datastore, execute the request:

POST http://127.0.0.1:8181/rests/data/

With payload:

<cont xmlns="urn:opendaylight:example">
    <l>Example content</l>
</cont>

Reading data:

To read data from the datastore, execute the request:

GET http://127.0.0.1:8181/rests/data?content=config

Or for direct targeting of the container Cont:

GET http://127.0.0.1:8181/rests/data/example:cont?content=config

Next Steps

As the next step, you can try the NETCONF test tool, which is part of the NETCONF project. More about the test tool can be found in the documentation.