Unit/SONAR/Checkstyle in ONAP-REST
[policy/engine.git] / ONAP-REST / src / main / java / org / onap / policy / rest / util / PdpPolicyContainer.java
@@ -3,13 +3,14 @@
  * ONAP Policy Engine
  * ================================================================================
  * Copyright (C) 2017-2018 AT&T Intellectual Property. All rights reserved.
+ * Modifications Copyright (C) 2019 Nordix Foundation.
  * ================================================================================
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
- * 
+ *
  *      http://www.apache.org/licenses/LICENSE-2.0
- * 
+ *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 
 package org.onap.policy.rest.util;
 
+import com.att.research.xacml.api.pap.PDP;
+import com.att.research.xacml.api.pap.PDPGroup;
+import com.att.research.xacml.api.pap.PDPPolicy;
+import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.ObjectMapper;
 
 import java.util.ArrayList;
 import java.util.Collection;
@@ -32,69 +38,56 @@ import org.onap.policy.common.logging.flexlogger.Logger;
 import org.onap.policy.xacml.api.XACMLErrorConstants;
 import org.onap.policy.xacml.std.pap.StdPDPPolicy;
 
-import com.att.research.xacml.api.pap.PDP;
-import com.att.research.xacml.api.pap.PDPGroup;
-import com.att.research.xacml.api.pap.PDPPolicy;
-import com.fasterxml.jackson.databind.DeserializationFeature;
-import com.fasterxml.jackson.databind.ObjectMapper;
-
-public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements PolicyContainer.Indexed {
+public class PdpPolicyContainer extends PolicyItemSetChangeNotifier implements PolicyContainer.Indexed {
     private static final long serialVersionUID = 1L;
-    private static final Logger LOGGER = FlexLogger.getLogger(PDPPolicyContainer.class);
+    private static final Logger LOGGER = FlexLogger.getLogger(PdpPolicyContainer.class);
 
-     /**
-     * String identifier of a file's "Id" property.
-     */
     private static final String PROPERTY_ID = "Id";
-
-   /**
-     * String identifier of a file's "name" property.
-     */
     private static final String PROPERTY_NAME = "Name";
-
-    /**
-      * String identifier of a file's "name" property.
-      */
     private static final String PROPERTY_VERSION = "Version";
-     
-    /**
-     * String identifier of a file's "Description" property.
-     */
     private static final String PROPERTY_DESCRIPTION = "Description";
-    
-    /**
-     * String identifier of a file's "IsRoot" property.
-     */
     private static final String PROPERTY_ISROOT = "Root";
 
     /**
      * List of the string identifiers for the available properties.
      */
     private static Collection<String> pDPPolicyProperties;
+
     private final transient Object data;
     private transient List<PDPPolicy> policies;
-    
+
+    /**
+     * Instantiates a new pdp policy container.
+     *
+     * @param data the data
+     */
     @SuppressWarnings("unchecked")
-    public PDPPolicyContainer(Object data) {
+    public PdpPolicyContainer(Object data) {
         super();
         this.data = data;
         if (this.data instanceof PDPGroup) {
-            policies = new ArrayList<> (((PDPGroup) this.data).getPolicies());
+            policies = new ArrayList<>(((PDPGroup) this.data).getPolicies());
         }
         if (this.data instanceof PDP) {
-            policies = new ArrayList<> (((PDP) this.data).getPolicies());
+            policies = new ArrayList<>(((PDP) this.data).getPolicies());
         }
         if (this.data instanceof Set) {
-            policies = new ArrayList<> ((Set<PDPPolicy>)data);
+            policies = new ArrayList<>((Set<PDPPolicy>) data);
         }
         if (this.policies == null) {
             LOGGER.info("NULL policies");
-            throw new NullPointerException("PDPPolicyContainer created with unexpected Object type '" + data.getClass().getName() + "'");
+            throw new NullPointerException("PDPPolicyContainer created with unexpected Object type '"
+                            + data.getClass().getName() + "'");
         }
         this.setContainer(this);
     }
 
+    /**
+     * Next item id.
+     *
+     * @param itemId the item id
+     * @return the object
+     */
     @Override
     public Object nextItemId(Object itemId) {
         if (LOGGER.isTraceEnabled()) {
@@ -104,9 +97,15 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         if (index == -1 || ((index + 1) >= this.policies.size())) {
             return null;
         }
-        return new PDPPolicyItem(this.policies.get(index + 1));
+        return new PdpPolicyItem(this.policies.get(index + 1));
     }
 
+    /**
+     * Prev item id.
+     *
+     * @param itemId the item id
+     * @return the object
+     */
     @Override
     public Object prevItemId(Object itemId) {
         if (LOGGER.isTraceEnabled()) {
@@ -116,9 +115,14 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         if (index <= 0) {
             return null;
         }
-        return new PDPPolicyItem(this.policies.get(index - 1));
+        return new PdpPolicyItem(this.policies.get(index - 1));
     }
 
+    /**
+     * First item id.
+     *
+     * @return the object
+     */
     @Override
     public Object firstItemId() {
         if (LOGGER.isTraceEnabled()) {
@@ -127,9 +131,14 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         if (this.policies.isEmpty()) {
             return null;
         }
-        return new PDPPolicyItem(this.policies.get(0));
+        return new PdpPolicyItem(this.policies.get(0));
     }
 
+    /**
+     * Last item id.
+     *
+     * @return the object
+     */
     @Override
     public Object lastItemId() {
         if (LOGGER.isTraceEnabled()) {
@@ -138,9 +147,15 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         if (this.policies.isEmpty()) {
             return null;
         }
-        return new PDPPolicyItem(this.policies.get(this.policies.size() - 1));
+        return new PdpPolicyItem(this.policies.get(this.policies.size() - 1));
     }
 
+    /**
+     * Checks if is first id.
+     *
+     * @param itemId the item id
+     * @return true, if is first id
+     */
     @Override
     public boolean isFirstId(Object itemId) {
         if (LOGGER.isTraceEnabled()) {
@@ -152,6 +167,12 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         return itemId.equals(this.policies.get(0));
     }
 
+    /**
+     * Checks if is last id.
+     *
+     * @param itemId the item id
+     * @return true, if is last id
+     */
     @Override
     public boolean isLastId(Object itemId) {
         if (LOGGER.isTraceEnabled()) {
@@ -163,16 +184,32 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         return itemId.equals(this.policies.get(this.policies.size() - 1));
     }
 
+    /**
+     * Adds the item after.
+     *
+     * @param previousItemId the previous item id
+     * @return the object
+     */
     @Override
     public Object addItemAfter(Object previousItemId) {
         return null;
     }
 
+    /**
+     * Gets the container property ids.
+     *
+     * @return the container property ids
+     */
     @Override
     public Collection<?> getContainerPropertyIds() {
         return pDPPolicyProperties;
     }
 
+    /**
+     * Gets the item ids.
+     *
+     * @return the item ids
+     */
     @Override
     public Collection<?> getItemIds() {
         final Collection<Object> items = new ArrayList<>();
@@ -180,7 +217,30 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         return Collections.unmodifiableCollection(items);
     }
 
+    /**
+     * Gets the item ids.
+     *
+     * @param startIndex the start index
+     * @param numberOfItems the number of items
+     * @return the item ids
+     */
+    @Override
+    public List<?> getItemIds(int startIndex, int numberOfItems) {
+        if (LOGGER.isTraceEnabled()) {
+            LOGGER.trace("getItemIds: " + startIndex + " " + numberOfItems);
+        }
+        if (numberOfItems < 0) {
+            throw new IllegalArgumentException();
+        }
+        return this.policies.subList(startIndex, startIndex + numberOfItems);
+    }
 
+    /**
+     * Gets the type.
+     *
+     * @param propertyId the property id
+     * @return the type
+     */
     @Override
     public Class<?> getType(Object propertyId) {
         if (propertyId.equals(PROPERTY_ID)) {
@@ -201,6 +261,11 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         return null;
     }
 
+    /**
+     * Size.
+     *
+     * @return the int
+     */
     @Override
     public int size() {
         if (LOGGER.isTraceEnabled()) {
@@ -209,6 +274,12 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         return this.policies.size();
     }
 
+    /**
+     * Contains id.
+     *
+     * @param itemId the item id
+     * @return true, if successful
+     */
     @Override
     public boolean containsId(Object itemId) {
         if (LOGGER.isTraceEnabled()) {
@@ -217,11 +288,22 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         return this.policies.contains(itemId);
     }
 
+    /**
+     * Adds the item.
+     *
+     * @return the object
+     */
     @Override
     public Object addItem() {
         throw new UnsupportedOperationException("Cannot add an empty policy.");
     }
 
+    /**
+     * Removes the item.
+     *
+     * @param itemId the item id
+     * @return true, if successful
+     */
     @Override
     public boolean removeItem(Object itemId) {
         if (LOGGER.isTraceEnabled()) {
@@ -231,34 +313,59 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
         StdPDPPolicy pdpPolicy = null;
         try {
-            pdpPolicy = mapper.readValue(itemId.toString() , StdPDPPolicy.class);
-            for(int i = 0; i< policies.size(); i++){
-                if(policies.get(i).getId().equalsIgnoreCase(pdpPolicy.getId())){
+            pdpPolicy = mapper.readValue(itemId.toString(), StdPDPPolicy.class);
+            for (int i = 0; i < policies.size(); i++) {
+                if (policies.get(i).getId().equalsIgnoreCase(pdpPolicy.getId())) {
                     return this.policies.remove(this.policies.get(i));
                 }
             }
         } catch (Exception e) {
-            LOGGER.error(XACMLErrorConstants.ERROR_DATA_ISSUE + "Exception Occured While Mapping the Removing Policy from PDP Group to Std Policy"+e);
+            LOGGER.error(XACMLErrorConstants.ERROR_DATA_ISSUE
+                            + "Exception Occured While Mapping the Removing Policy from PDP Group to Std Policy" + e);
         }
         return this.policies.remove(itemId);
     }
 
+    /**
+     * Adds the container property.
+     *
+     * @param propertyId the property id
+     * @param type the type
+     * @param defaultValue the default value
+     * @return true, if successful
+     */
     @Override
-    public boolean addContainerProperty(Object propertyId, Class<?> type,
-            Object defaultValue) {
+    public boolean addContainerProperty(Object propertyId, Class<?> type, Object defaultValue) {
         return false;
     }
 
+    /**
+     * Removes the container property.
+     *
+     * @param propertyId the property id
+     * @return true, if successful
+     */
     @Override
     public boolean removeContainerProperty(Object propertyId) {
         return false;
     }
 
+    /**
+     * Removes the all items.
+     *
+     * @return true, if successful
+     */
     @Override
     public boolean removeAllItems() {
         return false;
     }
 
+    /**
+     * Index of id.
+     *
+     * @param itemId the item id
+     * @return the int
+     */
     @Override
     public int indexOfId(Object itemId) {
         if (LOGGER.isTraceEnabled()) {
@@ -267,6 +374,12 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         return this.policies.indexOf(itemId);
     }
 
+    /**
+     * Gets the id by index.
+     *
+     * @param index the index
+     * @return the id by index
+     */
     @Override
     public Object getIdByIndex(int index) {
         if (LOGGER.isTraceEnabled()) {
@@ -275,17 +388,12 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         return this.policies.get(index);
     }
 
-    @Override
-    public List<?> getItemIds(int startIndex, int numberOfItems) {
-        if (LOGGER.isTraceEnabled()) {
-            LOGGER.trace("getItemIds: " + startIndex + " " + numberOfItems);
-        }
-        if (numberOfItems < 0) {
-            throw new IllegalArgumentException();
-        }
-        return this.policies.subList(startIndex, startIndex + numberOfItems);
-    }
-
+    /**
+     * Adds the item at.
+     *
+     * @param index the index
+     * @return the object
+     */
     @Override
     public Object addItemAt(int index) {
         if (LOGGER.isTraceEnabled()) {
@@ -294,13 +402,23 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
         return null;
     }
 
-    public class PDPPolicyItem {
+    public class PdpPolicyItem {
         private final PDPPolicy policy;
 
-        public PDPPolicyItem(PDPPolicy itemId) {
+        /**
+         * Instantiates a new PDP policy item.
+         *
+         * @param itemId the item id
+         */
+        public PdpPolicyItem(PDPPolicy itemId) {
             this.policy = itemId;
         }
 
+        /**
+         * Gets the id.
+         *
+         * @return the id
+         */
         public String getId() {
             if (LOGGER.isTraceEnabled()) {
                 LOGGER.trace("getId: " + this.policy);
@@ -308,6 +426,11 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
             return this.policy.getId();
         }
 
+        /**
+         * Gets the name.
+         *
+         * @return the name
+         */
         public String getName() {
             if (LOGGER.isTraceEnabled()) {
                 LOGGER.trace("getName: " + this.policy);
@@ -315,6 +438,11 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
             return this.policy.getName();
         }
 
+        /**
+         * Gets the version.
+         *
+         * @return the version
+         */
         public String getVersion() {
             if (LOGGER.isTraceEnabled()) {
                 LOGGER.trace("getVersion: " + this.policy);
@@ -322,6 +450,11 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
             return this.policy.getVersion();
         }
 
+        /**
+         * Gets the description.
+         *
+         * @return the description
+         */
         public String getDescription() {
             if (LOGGER.isTraceEnabled()) {
                 LOGGER.trace("getDescription: " + this.policy);
@@ -329,6 +462,11 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
             return this.policy.getDescription();
         }
 
+        /**
+         * Gets the root.
+         *
+         * @return the root
+         */
         public boolean getRoot() {
             if (LOGGER.isTraceEnabled()) {
                 LOGGER.trace("isRoot: " + this.policy);
@@ -336,8 +474,13 @@ public class PDPPolicyContainer extends PolicyItemSetChangeNotifier implements P
             return this.policy.isRoot();
         }
 
+        /**
+         * Sets the root.
+         *
+         * @param root the new root
+         */
         public void setRoot(Boolean root) {
-            ((StdPDPPolicy)this.policy).setRoot(root);
+            ((StdPDPPolicy) this.policy).setRoot(root);
         }
 
     }