Merge "fix typos and some Java improvements in ClusterManager"

[controller.git] / opendaylight / web / root / src / main / java / org / opendaylight / controller / web / IDaylightWeb.java

diff --git a/opendaylight/web/root/src/main/java/org/opendaylight/controller/web/IDaylightWeb.java b/opendaylight/web/root/src/main/java/org/opendaylight/controller/web/IDaylightWeb.java
index 84bbd94bae12b41654de7c906387a005db83896e..7421759d985086269e8b8dabfe4dcaf37bcf60c0 100644 (file)
--- a/opendaylight/web/root/src/main/java/org/opendaylight/controller/web/IDaylightWeb.java
+++ b/opendaylight/web/root/src/main/java/org/opendaylight/controller/web/IDaylightWeb.java
@@ -1,4 +1,3 @@
-
 /*
  * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
  *
@@ -11,16 +10,36 @@ package org.opendaylight.controller.web;
 
 import org.opendaylight.controller.sal.authorization.UserLevel;
 
-/**
- *
- *
- */
 public interface IDaylightWeb {
+    /**
+     * Returns the name of the bundle. In the GUI, this name will be displayed
+     * on the tab.
+     *
+     * @return Name assigned to the bundle.
+     */
     public String getWebName();
 
+    /**
+     * Returns the Id assigned to the web bundle.
+     *
+     * @return Id assigned to the web bundle.
+     */
     public String getWebId();
 
+    /**
+     * Returns the position where the bundle tab will be placed in the GUI.
+     *
+     * @return Position number for the bundle tab.
+     */
     public short getWebOrder();
-    
+
+    /**
+     * This method checks if the user is authorized to access the bundle.
+     *
+     * @param userLevel
+     *            user role level in the controller space.
+     *
+     * @return true, if user is authorized to access the bundle, else false.
+     */
     public boolean isAuthorized(UserLevel userLevel);
 }