Add INF-320 support attribute-based filter
[pti/o2.git] / o2ims / views / ocloud_route.py
index 6d5e8e3..26da34c 100644 (file)
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
-from flask_restx import Resource
+from flask import request
+from flask_restx import Resource, reqparse
 
-from o2ims.views import ocloud_view, api_ims_inventory_v1
-from o2common.config import config
+from o2common.service.messagebus import MessageBus
+from o2common.views.pagination_route import link_header, PAGE_PARAM
+from o2ims.views import ocloud_view
+from o2ims.views.api_ns import api_ims_inventory_v1
 from o2ims.views.ocloud_dto import OcloudDTO, ResourceTypeDTO,\
     ResourcePoolDTO, ResourceDTO, DeploymentManagerDTO, SubscriptionDTO
 
+from o2common.helper import o2logging
+logger = o2logging.get_logger(__name__)
 
-apibase = config.get_o2ims_api_base()
+
+def configure_api_route():
+    # Set global bus for resource
+    global bus
+    bus = MessageBus.get_instance()
 
 
 # ----------  OClouds ---------- #
 @api_ims_inventory_v1.route("/")
 @api_ims_inventory_v1.response(404, 'oCloud not found')
+@api_ims_inventory_v1.param(
+    'all_fields',
+    'Set any value for show all fields. This value will cover "fields" ' +
+    'and "all_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'fields',
+    'Set fields to show, split by comma, "/" for parent and children.' +
+    ' Like "name,parent/children". This value will cover "exculde_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_fields',
+    'Set fields to exclude showing, split by comma, "/" for parent and ' +
+    'children. Like "name,parent/children". This value will cover ' +
+    '"exclude_default".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_default',
+    'Exclude showing all default fields, Set "true" to enable.',
+    _in='query')
 class OcloudsListRouter(Resource):
     """Ocloud get endpoint
     O2 interface ocloud endpoint
@@ -44,18 +73,76 @@ class OcloudsListRouter(Resource):
 
 # ----------  ResourceTypes ---------- #
 @api_ims_inventory_v1.route("/resourceTypes")
+@api_ims_inventory_v1.param(PAGE_PARAM,
+                            'Page number of the results to fetch.' +
+                            ' Default: 1',
+                            _in='query', default=1)
+@api_ims_inventory_v1.param(
+    'all_fields',
+    'Set any value for show all fields. This value will cover "fields" ' +
+    'and "all_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'fields',
+    'Set fields to show, split by comma, "/" for parent and children.' +
+    ' Like "name,parent/children". This value will cover "exculde_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_fields',
+    'Set fields to exclude showing, split by comma, "/" for parent and ' +
+    'children. Like "name,parent/children". This value will cover ' +
+    '"exclude_default".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_default',
+    'Exclude showing all default fields, Set "true" to enable.',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'filter',
+    'Filter of the query.',
+    _in='query')
 class ResourceTypesListRouter(Resource):
 
     model = ResourceTypeDTO.resource_type_get
 
     @api_ims_inventory_v1.marshal_list_with(model)
     def get(self):
-        return ocloud_view.resource_types(bus.uow)
+        parser = reqparse.RequestParser()
+        parser.add_argument(PAGE_PARAM, location='args')
+        parser.add_argument('filter', location='args')
+        args = parser.parse_args()
+        kwargs = {}
+        if args.nextpage_opaque_marker is not None:
+            kwargs['page'] = args.nextpage_opaque_marker
+        kwargs['filter'] = args.filter if args.filter is not None else ''
+
+        ret = ocloud_view.resource_types(bus.uow, **kwargs)
+        return link_header(request.full_path, ret)
 
 
 @api_ims_inventory_v1.route("/resourceTypes/<resourceTypeID>")
 @api_ims_inventory_v1.param('resourceTypeID', 'ID of the resource type')
 @api_ims_inventory_v1.response(404, 'Resource type not found')
+@api_ims_inventory_v1.param(
+    'all_fields',
+    'Set any value for show all fields. This value will cover "fields" ' +
+    'and "all_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'fields',
+    'Set fields to show, split by comma, "/" for parent and children.' +
+    ' Like "name,parent/children". This value will cover "exculde_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_fields',
+    'Set fields to exclude showing, split by comma, "/" for parent and ' +
+    'children. Like "name,parent/children". This value will cover ' +
+    '"exclude_default".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_default',
+    'Exclude showing all default fields, Set "true" to enable.',
+    _in='query')
 class ResourceTypeGetRouter(Resource):
 
     model = ResourceTypeDTO.resource_type_get
@@ -72,18 +159,76 @@ class ResourceTypeGetRouter(Resource):
 
 # ----------  ResourcePools ---------- #
 @api_ims_inventory_v1.route("/resourcePools")
+@api_ims_inventory_v1.param(PAGE_PARAM,
+                            'Page number of the results to fetch.' +
+                            ' Default: 1',
+                            _in='query', default=1)
+@api_ims_inventory_v1.param(
+    'all_fields',
+    'Set any value for show all fields. This value will cover "fields" ' +
+    'and "all_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'fields',
+    'Set fields to show, split by comma, "/" for parent and children.' +
+    ' Like "name,parent/children". This value will cover "exculde_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_fields',
+    'Set fields to exclude showing, split by comma, "/" for parent and ' +
+    'children. Like "name,parent/children". This value will cover ' +
+    '"exclude_default".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_default',
+    'Exclude showing all default fields, Set "true" to enable.',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'filter',
+    'Filter of the query.',
+    _in='query')
 class ResourcePoolsListRouter(Resource):
 
     model = ResourcePoolDTO.resource_pool_get
 
     @api_ims_inventory_v1.marshal_list_with(model)
     def get(self):
-        return ocloud_view.resource_pools(bus.uow)
+        parser = reqparse.RequestParser()
+        parser.add_argument(PAGE_PARAM, location='args')
+        parser.add_argument('filter', location='args')
+        args = parser.parse_args()
+        kwargs = {}
+        if args.nextpage_opaque_marker is not None:
+            kwargs['page'] = args.nextpage_opaque_marker
+        kwargs['filter'] = args.filter if args.filter is not None else ''
+
+        ret = ocloud_view.resource_pools(bus.uow, **kwargs)
+        return link_header(request.full_path, ret)
 
 
 @api_ims_inventory_v1.route("/resourcePools/<resourcePoolID>")
 @api_ims_inventory_v1.param('resourcePoolID', 'ID of the resource pool')
 @api_ims_inventory_v1.response(404, 'Resource pool not found')
+@api_ims_inventory_v1.param(
+    'all_fields',
+    'Set any value for show all fields. This value will cover "fields" ' +
+    'and "all_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'fields',
+    'Set fields to show, split by comma, "/" for parent and children.' +
+    ' Like "name,parent/children". This value will cover "exculde_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_fields',
+    'Set fields to exclude showing, split by comma, "/" for parent and ' +
+    'children. Like "name,parent/children". This value will cover ' +
+    '"exclude_default".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_default',
+    'Exclude showing all default fields, Set "true" to enable.',
+    _in='query')
 class ResourcePoolGetRouter(Resource):
 
     model = ResourcePoolDTO.resource_pool_get
@@ -101,13 +246,59 @@ class ResourcePoolGetRouter(Resource):
 # ----------  Resources ---------- #
 @api_ims_inventory_v1.route("/resourcePools/<resourcePoolID>/resources")
 @api_ims_inventory_v1.param('resourcePoolID', 'ID of the resource pool')
+# @api_ims_inventory_v1.param('sort', 'sort by column name',
+#                             _in='query')
+# @api_ims_inventory_v1.param('per_page', 'The number of results per page ' +
+#                             '(max 100). Default: 30',
+#                             _in='query', default=30)
+@api_ims_inventory_v1.param(PAGE_PARAM,
+                            'Page number of the results to fetch.' +
+                            ' Default: 1',
+                            _in='query', default=1)
+@api_ims_inventory_v1.param(
+    'all_fields',
+    'Set any value for show all fields. This value will cover "fields" ' +
+    'and "all_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'fields',
+    'Set fields to show, split by comma, "/" for parent and children.' +
+    ' Like "name,parent/children". This value will cover "exculde_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_fields',
+    'Set fields to exclude showing, split by comma, "/" for parent and ' +
+    'children. Like "name,parent/children". This value will cover ' +
+    '"exclude_default".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_default',
+    'Exclude showing all default fields, Set "true" to enable.',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'filter',
+    'Filter of the query.',
+    _in='query')
 class ResourcesListRouter(Resource):
 
     model = ResourceDTO.resource_list
 
     @api_ims_inventory_v1.marshal_list_with(model)
     def get(self, resourcePoolID):
-        return ocloud_view.resources(resourcePoolID, bus.uow)
+        parser = reqparse.RequestParser()
+        parser.add_argument(PAGE_PARAM, location='args')
+        parser.add_argument('filter', location='args')
+        args = parser.parse_args()
+        kwargs = {}
+        # if args.per_page is not None:
+        #     kwargs['per_page'] = args.per_page
+        #     base_url = base_url + 'per_page=' + args.per_page + '&'
+        if args.nextpage_opaque_marker is not None:
+            kwargs['page'] = args.nextpage_opaque_marker
+        kwargs['filter'] = args.filter if args.filter is not None else ''
+
+        ret = ocloud_view.resources(resourcePoolID, bus.uow, **kwargs)
+        return link_header(request.full_path, ret)
 
 
 @api_ims_inventory_v1.route(
@@ -115,9 +306,31 @@ class ResourcesListRouter(Resource):
 @api_ims_inventory_v1.param('resourcePoolID', 'ID of the resource pool')
 @api_ims_inventory_v1.param('resourceID', 'ID of the resource')
 @api_ims_inventory_v1.response(404, 'Resource not found')
+@api_ims_inventory_v1.param(
+    'all_fields',
+    'Set any value for show all fields. This value will cover "fields" ' +
+    'and "all_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'fields',
+    'Set fields to show, split by comma, "/" for parent and children.' +
+    ' Like "name,parent/children". This value will cover "exculde_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_fields',
+    'Set fields to exclude showing, split by comma, "/" for parent and ' +
+    'children. Like "name,parent/children". This value will cover ' +
+    '"exclude_default".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_default',
+    'Exclude showing all default fields, Set "true" to enable.',
+    _in='query')
 class ResourceGetRouter(Resource):
 
-    model = ResourceDTO.resource_get
+    # dto = ResourceDTO()
+    # model = dto.get_resource_get()
+    model = ResourceDTO.recursive_resource_mapping()
 
     @api_ims_inventory_v1.doc('Get resource')
     @api_ims_inventory_v1.marshal_with(model)
@@ -131,19 +344,79 @@ class ResourceGetRouter(Resource):
 
 # ----------  DeploymentManagers ---------- #
 @api_ims_inventory_v1.route("/deploymentManagers")
+@api_ims_inventory_v1.param(PAGE_PARAM,
+                            'Page number of the results to fetch.' +
+                            ' Default: 1',
+                            _in='query', default=1)
+@api_ims_inventory_v1.param(
+    'all_fields',
+    'Set any value for show all fields. This value will cover "fields" ' +
+    'and "all_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'fields',
+    'Set fields to show, split by comma, "/" for parent and children.' +
+    ' Like "name,parent/children". This value will cover "exculde_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_fields',
+    'Set fields to exclude showing, split by comma, "/" for parent and ' +
+    'children. Like "name,parent/children". This value will cover ' +
+    '"exclude_default".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_default',
+    'Exclude showing all default fields, Set "true" to enable.',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'filter',
+    'Filter of the query.',
+    _in='query')
 class DeploymentManagersListRouter(Resource):
 
-    model = DeploymentManagerDTO.deployment_manager_get
+    model = DeploymentManagerDTO.deployment_manager_list
 
     @api_ims_inventory_v1.marshal_list_with(model)
     def get(self):
-        return ocloud_view.deployment_managers(bus.uow)
+        parser = reqparse.RequestParser()
+        parser.add_argument(PAGE_PARAM, location='args')
+        parser.add_argument('filter', location='args')
+        args = parser.parse_args()
+        kwargs = {}
+        if args.nextpage_opaque_marker is not None:
+            kwargs['page'] = args.nextpage_opaque_marker
+        kwargs['filter'] = args.filter if args.filter is not None else ''
+
+        ret = ocloud_view.deployment_managers(bus.uow, **kwargs)
+        return link_header(request.full_path, ret)
 
 
 @api_ims_inventory_v1.route("/deploymentManagers/<deploymentManagerID>")
 @api_ims_inventory_v1.param('deploymentManagerID',
                             'ID of the deployment manager')
+@api_ims_inventory_v1.param('profile', 'DMS profile: value supports "sol018"',
+                            _in='query')
 @api_ims_inventory_v1.response(404, 'Deployment manager not found')
+@api_ims_inventory_v1.param(
+    'all_fields',
+    'Set any value for show all fields. This value will cover "fields" ' +
+    'and "all_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'fields',
+    'Set fields to show, split by comma, "/" for parent and children.' +
+    ' Like "name,parent/children". This value will cover "exculde_fields".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_fields',
+    'Set fields to exclude showing, split by comma, "/" for parent and ' +
+    'children. Like "name,parent/children". This value will cover ' +
+    '"exclude_default".',
+    _in='query')
+@api_ims_inventory_v1.param(
+    'exclude_default',
+    'Exclude showing all default fields, Set "true" to enable.',
+    _in='query')
 class DeploymentManagerGetRouter(Resource):
 
     model = DeploymentManagerDTO.deployment_manager_get
@@ -151,8 +424,14 @@ class DeploymentManagerGetRouter(Resource):
     @api_ims_inventory_v1.doc('Get deployment manager')
     @api_ims_inventory_v1.marshal_with(model)
     def get(self, deploymentManagerID):
+        parser = reqparse.RequestParser()
+        parser.add_argument('profile', location='args')
+        args = parser.parse_args()
+        profile = (
+            args.profile if args.profile is not None and args.profile != ''
+            else 'default')
         result = ocloud_view.deployment_manager_one(
-            deploymentManagerID, bus.uow)
+            deploymentManagerID, bus.uow, profile)
         if result is not None:
             return result
         api_ims_inventory_v1.abort(
@@ -170,8 +449,47 @@ class SubscriptionsListRouter(Resource):
 
     @api_ims_inventory_v1.doc('List subscriptions')
     @api_ims_inventory_v1.marshal_list_with(model)
+    @api_ims_inventory_v1.param(
+        PAGE_PARAM,
+        'Page number of the results to fetch. Default: 1',
+        _in='query', default=1)
+    @api_ims_inventory_v1.param(
+        'all_fields',
+        'Set any value for show all fields. This value will cover "fields" ' +
+        'and "all_fields".',
+        _in='query')
+    @api_ims_inventory_v1.param(
+        'fields',
+        'Set fields to show, split by comma, "/" for parent and children.' +
+        ' Like "name,parent/children". This value will cover' +
+        ' "exculde_fields".',
+        _in='query')
+    @api_ims_inventory_v1.param(
+        'exclude_fields',
+        'Set fields to exclude showing, split by comma, "/" for parent and ' +
+        'children. Like "name,parent/children". This value will cover ' +
+        '"exclude_default".',
+        _in='query')
+    @api_ims_inventory_v1.param(
+        'exclude_default',
+        'Exclude showing all default fields, Set "true" to enable.',
+        _in='query')
+    @api_ims_inventory_v1.param(
+        'filter',
+        'Filter of the query.',
+        _in='query')
     def get(self):
-        return ocloud_view.subscriptions(bus.uow)
+        parser = reqparse.RequestParser()
+        parser.add_argument(PAGE_PARAM, location='args')
+        parser.add_argument('filter', location='args')
+        args = parser.parse_args()
+        kwargs = {}
+        if args.nextpage_opaque_marker is not None:
+            kwargs['page'] = args.nextpage_opaque_marker
+        kwargs['filter'] = args.filter if args.filter is not None else ''
+
+        ret = ocloud_view.subscriptions(bus.uow, **kwargs)
+        return link_header(request.full_path, ret)
 
     @api_ims_inventory_v1.doc('Create a subscription')
     @api_ims_inventory_v1.expect(expect)
@@ -191,6 +509,27 @@ class SubscriptionGetDelRouter(Resource):
 
     @api_ims_inventory_v1.doc('Get subscription by ID')
     @api_ims_inventory_v1.marshal_with(model)
+    @api_ims_inventory_v1.param(
+        'all_fields',
+        'Set any value for show all fields. This value will cover "fields" ' +
+        'and "all_fields".',
+        _in='query')
+    @api_ims_inventory_v1.param(
+        'fields',
+        'Set fields to show, split by comma, "/" for parent and children.' +
+        ' Like "name,parent/children". This value will cover' +
+        ' "exculde_fields".',
+        _in='query')
+    @api_ims_inventory_v1.param(
+        'exclude_fields',
+        'Set fields to exclude showing, split by comma, "/" for parent and ' +
+        'children. Like "name,parent/children". This value will cover ' +
+        '"exclude_default".',
+        _in='query')
+    @api_ims_inventory_v1.param(
+        'exclude_default',
+        'Exclude showing all default fields, Set "true" to enable.',
+        _in='query')
     def get(self, subscriptionID):
         result = ocloud_view.subscription_one(
             subscriptionID, bus.uow)
@@ -204,12 +543,3 @@ class SubscriptionGetDelRouter(Resource):
     def delete(self, subscriptionID):
         result = ocloud_view.subscription_delete(subscriptionID, bus.uow)
         return result, 204
-
-
-def configure_namespace(app, bus_new):
-
-    # Set global bus for resource
-    global bus
-    bus = bus_new
-
-    app.add_namespace(api_ims_inventory_v1, path=apibase)