IRISLIB database
All Classes Namespaces Functions Variables Pages
API Class Reference

REST.API is public interface to REST API Management More...

Inheritance diagram for API:
Collaboration diagram for API:

Static Public Member Functions

_.Library.Status CreateApplication (_.Library.String applicationName, _.Library.DynamicObject swagger, features, _.Library.Boolean newApplication, _.Library.Boolean internalError)
 CreateApplication creates a REST application from the OpenAPI 2.0 swagger description of the application. More...
 
_.Library.Status DeleteApplication (_.Library.String applicationName)
 This request deletes an application by deleting the specification class and the dispatch class that represent the application. More...
 
_.Library.Status GetAllRESTApps (_.Library.ListOfObjects appList)
 GetAllRESTApps returns a list of all REST applications in all namespaces. More...
 
_.Library.Status GetAllWebRESTApps (_.Library.ListOfObjects appList)
 GetAllWebRESTApps returns a list of all CSP.REST based REST applications in all namespaces. More...
 
_.Library.Status GetApplication (_.Library.String applicationName, _.Library.DynamicObject swagger)
 GetApplication returns the OpenAPI 2.0 swagger description of this application as a DynamicObject. More...
 
_.Library.Status GetRESTApps (_.Library.String namespace, _.Library.ListOfObjects appList)
 GetRESTApps returns a list of all REST applications in the current namespace. More...
 
_.Library.Status GetWebRESTApplication (_.Library.String namespace, _.Library.String webApplication, _.Library.DynamicObject swagger)
 GetWebRESTApplication returns the OpenAPI 2.0 swagger description based on the UrlMap of CSP.REST subclass for this REST application. More...
 
_.Library.Status GetWebRESTApps (_.Library.String namespace, _.Library.ListOfObjects appList)
 GetWebRESTApps returns a list of all CSP.REST based REST applications in the specified namespace. More...
 
 GetWebURLForApplication (_.Library.String applicationName)
 This request returns the web application name to which this application is deployed. More...
 

Additional Inherited Members

- Public Member Functions inherited from RegisteredObject
_.Library.Status OnAddToSaveSet (_.Library.Integer depth, _.Library.Integer insert, _.Library.Integer callcount)
 This callback method is invoked when the current object is added to the SaveSet,. More...
 
_.Library.Status OnClose ()
 This callback method is invoked by the <METHOD>Close</METHOD> method to. More...
 
_.Library.Status OnConstructClone (_.Library.RegisteredObject object, _.Library.Boolean deep, _.Library.String cloned)
 This callback method is invoked by the <METHOD>ConstructClone</METHOD> method to. More...
 
_.Library.Status OnNew ()
 This callback method is invoked by the <METHOD>New</METHOD> method to. More...
 
_.Library.Status OnValidateObject ()
 This callback method is invoked by the <METHOD>ValidateObject</METHOD> method to. More...
 
- Static Public Attributes inherited from RegisteredObject
 CAPTION = None
 Optional name used by the Form Wizard for a class when generating forms. More...
 
 JAVATYPE = None
 The Java type to be used when exported.
 
 PROPERTYVALIDATION = None
 This parameter controls the default validation behavior for the object. More...
 

Detailed Description

REST.API is public interface to REST API Management

Member Function Documentation

◆ CreateApplication()

_.Library.Status CreateApplication ( _.Library.String  applicationName,
_.Library.DynamicObject  swagger,
  features,
_.Library.Boolean  newApplication,
_.Library.Boolean  internalError 
)
static

CreateApplication creates a REST application from the OpenAPI 2.0 swagger description of the application.

CreateApplication replaces an existing REST application or creates a new REST application based from the specified OpenAPI 2.0 swagger definition. If the application does not exist, then a new default empty application is created. If the swagger argument = "", then the RESTSpec and dispatch classes are replaced with any empty application.
The method arguments hold values for:
applicationName, The name of the REST application which is the package name for the classes defining and implementing the application.
swagger, swagger is a JSON object, a URL or a filename specifying the swagger definition for this application or "" to create a new application.
features, features is a local of array of features which control application creation: features("addPing"), If the request body is empty, addPing determines if a ping method should be added to the empty swagger spec.
features("strict"), If false, then only the swagger properties which are needed for code generation are checked. If true, then all swagger properties are checked. The default value is true.
features("keep"), If true, then the generated classes will be kept even in the case of error. This feature is meant primarily for testing.
The return values are in these method arguments: newApplication, newApplication is set to true if a new application case been created.
internalError, internalError is set to true in the case of an internal server error.

◆ DeleteApplication()

_.Library.Status DeleteApplication ( _.Library.String  applicationName)
static

This request deletes an application by deleting the specification class and the dispatch class that represent the application.

The implementation class is not deleted.
The method arguments hold values for:
applicationName, The name of the REST application which is the package name for the classes defining and implementing the application.

◆ GetAllRESTApps()

_.Library.Status GetAllRESTApps ( _.Library.ListOfObjects  appList)
static

GetAllRESTApps returns a list of all REST applications in all namespaces.

The return values are in these method arguments: appList, A list of REST.Application objects. The name argument is the REST application name.

◆ GetAllWebRESTApps()

_.Library.Status GetAllWebRESTApps ( _.Library.ListOfObjects  appList)
static

GetAllWebRESTApps returns a list of all CSP.REST based REST applications in all namespaces.

The return values are in these method arguments: appList, A list of REST.Application objects. The name argument is web application name.

◆ GetApplication()

_.Library.Status GetApplication ( _.Library.String  applicationName,
_.Library.DynamicObject  swagger 
)
static

GetApplication returns the OpenAPI 2.0 swagger description of this application as a DynamicObject.

The application must be defined in the current namespace.
These method arguments hold values:
applicationName, The name of the REST application which is the package name for the classes defining and implementing the application.
The return values are in these method arguments: swagger, The DynamicObject containing the OpenAPI 2.0 swagger document.

◆ GetRESTApps()

_.Library.Status GetRESTApps ( _.Library.String  namespace,
_.Library.ListOfObjects  appList 
)
static

GetRESTApps returns a list of all REST applications in the current namespace.

These method arguments hold values:
namespace, The optional IRIS namespace as an additional filter. If not specified, then current namespace used.
The return values are in these method arguments: appList, A list of REST.Application objects. The name argument is the REST application name.

◆ GetWebRESTApplication()

_.Library.Status GetWebRESTApplication ( _.Library.String  namespace,
_.Library.String  webApplication,
_.Library.DynamicObject  swagger 
)
static

GetWebRESTApplication returns the OpenAPI 2.0 swagger description based on the UrlMap of CSP.REST subclass for this REST application.


The method arguments hold values for:
webApplication, The name of the web application which to which this CSP.REST based application is deployed.
The return values are in these method arguments: namespace, The IRIS namespace in which to perform the requested operation. The namespace defaults to web application's namespace.
swagger, The DynamicObject containing the OpenAPI 2.0 swagger document.

◆ GetWebRESTApps()

_.Library.Status GetWebRESTApps ( _.Library.String  namespace,
_.Library.ListOfObjects  appList 
)
static

GetWebRESTApps returns a list of all CSP.REST based REST applications in the specified namespace.


These method arguments hold values:
namespace, The optional IRIS namespace as an additional filter. If not specified, then current namespace used.
The return values are in these method arguments: appList, A list of REST.Application objects. The name argument is web application name.

◆ GetWebURLForApplication()

GetWebURLForApplication ( _.Library.String  applicationName)
static

This request returns the web application name to which this application is deployed.

If the application is deployed to multiple web applications, then the name of the first web application is returned. If the application is not deployed, then "" is returned.