Client access to adapters

Accessing adapters from a mobile client

IBM MobileFirst Platform Foundation provides a client API for accessing OAuth protected resources such as adapters. If you choose to use MobileFirst client for that purpose, it will automatically handle security for you. The following examples demonstrate how to use the client API to access an adapter resource:

Cordova JavaScript client

var request = new WLResourceRequest("adapters/adapter1/res1", WLResourceRequest.GET);
    request.send().then(
        function(response) {
            alert(JSON.stringify(response));
        },
    function(error) {
        alert(JSON.stringify(error));
    }
);

Native Android client

WLResourceRequest req = new WLResourceRequest(new URI("adapters/adapter1/res1"), WLResourceRequest.GET);
req.send(new WLResponseListener(){
    @Override
    public void onSuccess(WLResponse response) {
        // handle success
          
    }
    @Override
    public void onFailure(WLFailResponse response) {
        // handle failure
      
    }});

Native iOS client

NSString static *const RESOURCE_URL = @"adapters/adapter1/res1";
WLResourceRequest *request = [WLResourceRequest requestWithURL:[NSURL URLWithString:RESOURCE_URL] method:WLHttpMethodGet];
[request sendWithCompletionHandler:^(WLResponse *response, NSError *error) {
    NSString *httpStatus = [NSString stringWithFormat:@"%d", [response status]];
    self.httpStatusTextField.text = httpStatus;
    if (error != nil) {
        [self updateView:[error description]];
    } else {
        [self updateView:[response responseText]];
    }
}];

Native Windows 10 UWP and Windows 8 Universal

WLResourceRequest req = new WLResourceRequest("adapters/adapter1/res1", WLResourceRequest.GET);
InvokeListener listener = new InvokeListener();
req.send(listener);

public class InvokeListener : WLResponseListener {
    public void onSuccess(WLResponse response){
        //handle success
    }

    public void onFailure(WLFailResponse response){
        //handle failure
    }
}

RESTful access to Java adapters

You call an existing Java adapter over HTTP via REST URLs.

http(s)://<server>:<port>/<Context>/adapters/<adapter-name>/*

http://<hostname>:<port>/mfp/adapters/TodaysNews/getStory?story=world

Java adapters support all REST features, so you can use all HTTP request methods, headers, query parameters, and more.

RESTful access to JavaScript adapters

You call existing JavaScript adapter procedures over HTTP via REST URLs.

http(s)://<server>:<port>/<Context>/api/adapters/<adapter-name>/<procedure-name>

http://<hostname>:<port>/mfp/api/adapters/TodaysNews/getStories?params=['world']

Both the GET and POST methods can be used to call the adapter procedure. The procedure arguments are passed as the value of a parameter called params. This parameter is a query parameter for GET requests and a form parameter for POST requests. The value must be a JSON array of parameters that are provided in order.