Introduction

Aptify has developed a new funtionality to drop a new custom end points that will be addressed by URI through SOA. It will allow customers to build  there own end point as per there requirement.

...

With Aptify SOA, you can define new service endpoints in metadata.Endpoint functionality is be provided by .NET classes that are defined as Plug-ins for the service endpoint.In addition to providing new service endpoints,this also allows for overrides of existing service endpoints for pre-processing,post-processing and complete overrides, if necessary.

Step-by-Step Guide For Creating Controller

...

In Visual Studio, create a new

...

Class Library to add a controller

...

.

...

Add Aptify.Services

...

.Framework.dll as reference in your

...

class library.

...

using System;
using Aptify.Services.Framework.Endpoints;
namespace ParamDemo

{
    public class TestController : Aptify.Services.Framework.Endpoints.ServiceController
    {
        public override Aptify.Services.Framework.Endpoints.ServiceResponse ProcessRequest(Aptify.Services.Framework.Endpoints.ServiceRequestContext context)
        {
            string param1 = (string)context.ServiceParameters["param1"];    //to pass parameter1 to service request
            ServiceResponse response = new ServiceResponse();
            response.Content = new StringContent("Parameter1 having value:" + param1); // response display to client
            return response;
        }
    }
}

...

The sample code shown below illustrates how to pass parameters and display parameter values.

Image Added

In the code above, the ServiceRequestsContext object contains information about the request, including the ControllerName, cookies, Headers, httpmethod, query

...

parameters, AuthenticatedContext, and service

...

parameters.

...

 Service parameters are non-literal values that are defined in route

...

. miscProperties are used in

...

the Authorization plugin

...

to put the results of parsing into

...

dictionary and provide the result to the service request.

...

The ServiceResponse object provides information about response content. 

1.  Build the Class to generate a compiled assembly for the new controller.
2. In Aptify you should put the controller into Object Repository  under services packages.

Image Removed 

 3. Next step is to add controller definition. Create a new record in Controller by giving name and  adding reference of dot net class Plugin which is class responsible for servicing actual request and getting data

Controller Genrated classes will be automatically genrated when you save controller record. It is genrally for aptify Internal use

Image Removed

...

1.  In Aptify, add the compiled assembly as an object in the Aptify Object Repository.
2.  Create a new .Net Class Plug Ins record to identify the object repository location, assembly name, and class name for the new controller.
   
   Image Added 
    
3.  Open a new record in the Controllers service (found in the Web Services application) and complete the information on the General tab:
   •   Name: Name of the controller
   •   dot Net Class Plugin: This links to the .Net Class Plug In record you created above for the new controller.
     
     Image Added 
      
4. Click the Controller Routes tab and identify at least one route definition. The Controller routes defines the URI format for how to access controller endpoint.You can add multiple controller routes.

...

1. The system stores the following information for each route:
   •  Name:

...

1. • Name of Controller

...

1. • Route
   •  Route Regular Expression:

...

1. • The Controllers entity plugin generates the Route Regular Expression automatically. You do not need to set this value manually.
   •  Route Help Text: This field lets you add summary information about the controller and parameters

...

1. • it expects from the endpoint. These are standard .

...

1. • NET /// comments.

...

1. • Once set, these comments

...

1. • will be displayed automatically

...

1. • in help

...

1. • pages.
     
     Image Added 
     

...

Controller Route Http Method: You can select any standard http method defined in list.There are seven types of standard http method available in aptify. DELETE,GET,HEAD, OPTIONS,POST,PUT and TRACE..

Controller Route Path Parts:defines how the controller can be accessed by defining path parts. It will correlate the URl  how  user will access URL.

Image Removed

Type: it will be any data type string, int, boolean etc.

...

1. Click the Controller Routes Path Parts tab and define the parts that Aptify will use to build the route’s URI. You can specify the following information for each path part:
   •  Type: Data type of the parameter, such as String or int.
   •  Value: This field identifies the part value or a variable that can be added to the URI. For example in the example below, ParamDemo is a part value which is included in the route regular expression, but param1 is a variable value which will be replaced by string variable in the URl.

...

1. •  Is Literal:

...

1. • If checked

...

Is Optional:  if checked for part  then value will be optional in the URI. But Is Optional checking should be logical. URI will be invalid if we checked Is Optional option for value but deselect for variable value.

...

1. • , then the route regular expression will include the value as written in the URI. If unchecked, then this identifies a variable who value can change.
   •  Is Optional: This check box identifies if the part is optional for the URI.
     
     Image Added 
      
2. Click the Controller Routes Http Methods tab and specify the appropriate HTTP Methods for the route. You can select any standard http method from the seven available types: DELETE, GET, HEAD, OPTIONS, POST, PUT and TRACE.
3. Save and close the Controllers record.
4. Open a new record in the Controller Configurations service (also found in the Web Services application) and complete the information on the General tab:  
   
   •  Name: Enter a name for the Controller Configuration.
   •  Controller: Enter the Controllers record you created above.
   •  Authorization Plugin: If required, select an authorization plugin to provide authorization with this controller.
   •  Caching Policy:  Select the Caching Policy for the controller, either Nocaching (not cached) or YearCaching, which is a timecache policy.
   •  Require Authentication: If checked, then the controller requires a valid authentication token when called. If unchecked, then the controller can be called without any credentials.
   •  Allow Anonymous: If checked, anonymous users can access the endpoint.
     
     Image Added 
    
5. Save and close the Controller Configurations record.
6.  Add the Controller Configuration you just created to a Controller Configuration Collection, which is another service in the Web Services application. You can use a collection to group together controllers with common settings. By default, Aptify includes one collection (the Aptify Web Collection).
   •   You can define a caching policy and authorization plugin at the collection level. However, any value you specified on the Controller Configuration record will override the collection’s settings for that particular controller.
   •   If you create your own collection, you need to add it to a Service Application in Aptify metadata.
     
     Image Added

You can now call your endpoint from Aptify SOA. Here are the settings that would be used for the sample controller shown in the example above.

Headers

No header required for this sample since the Require Authentication option is not checked. 

Sample Parameters

This endpoint accepts a single parameter passed as 'param1'.

https://<service base>/ParamDemo/test

Parameter with value:test

HTTP Status Code