The first step is to connect to EDAB server. After successfully connected to the server, a QbMenu object can be allocated. QbMenu is the main class containing contents for a Menu page.

The EDAB server is simply an object that resides in the ServletContext of the web application. Since you will want to put most Java code in your Java bean, you will need to pass the HttpServletRequest and ServletContext objects from the jsp to the bean. The following jsp and bean code illustrates this:

Example jsp (Menu_login.jsp):

<!-- import the bean class -->
<%@page language="java" import="help.examples.Menu.exampleMenuLogin"%>

<!-- include/instantiate the bean -->
<jsp:useBean id="exampleMenuLogin" scope="session" class="help.examples.Menu.exampleMenuLogin" />

<!-- pass the HttpServletRequest and ServletContext objects to the bean -->
<% exampleMenuLogin.processRequest(request, application); %>
                

where the jsp passes the request (HttpServletRequest) and application (ServletContext) to the Java bean MenuLogin's processRequest method. Next, you will need to implement code in the bean that allocates the QbMenu object from the ServletContext:

Example bean (MenuLogin.java):

public void processRequest(HttpServletRequest request, ServletContext context) throws IOException {

      QbMenu qbMenu = new QbMenu(context.getAttribute(QbMenu.QBMENUDATA));

}
                

where context.getAttribute(QbMenu.QBMENUDATA) is set when EDAB server started.

The second step uses the QbMenu object to authenticate the user. This is easy since all security and permission checks are performed by EDAB server. If login is successful, you can store the QbMenu object for the session so that for the duration of the session, the user will not have to login again. The following code illustrates this:

boolean loginSuccess = qbMenu.login(userName, password);
if (loginSuccess) {

      //store the QbMenu object in session

      session.setAttribute("QBMENUOBJ", qbMenu);

}
                

where “QBMENUOBJ” is the name that you can use later for retrieving the stored QbMenu. This means that after storing the QbMenu in the session, you can retrieve it in other jsp pages by doing session.getAttribute("QBMENUOBJ"). The QbMenu.login method returns true if and only if the user name and password match. If login failed, the user can be prompted again. Please note that login MUST succeed for the QbMenu object to return a valid Menu.

After authenticating the user, you can get a list of authorized Menu nodes, which contain reports or charts from the QbMenu. A node is either a project or a folder in EDAB Organizer.

MenuNode[] MenuNode = qbMenu.getMenuNodeList(null);
                

Passing in null to the getMenuNodeList method results in getting all the available Menu nodes. If you pass in a string, the method will return only those nodes items that contain the string.

Please note that the path for the Menu node will be a complete one i.e., Project1/Folder1/SubFolder2 .

Once you have retrieved the Menu nodes, the next step is get the node details, namely, the files contained in the node. Conceptually, each item in the node is a row and is represented by the MenuTableRow object. The following code iterates through each file in all nodes:

for (int i = 0; i < MenuNode.length; i++) {

      for (int j = 0; j < MenuNode[i].getRowItemCount(); j++) {
            MenuTableRow MenuTableRow = MenuNode[i].getMenuTableRowAt(j);

      }

}
                

You can obtain all the information of the file (such as file name, description, whether it is a chart or report, etc.) using the MenuTableRow class.

The following methods are used to obtain the file details:

String getDescription()
Returns the description for the row item

String getName()
Returns the name for the row item

String getPath()
Returns the path for the row item

String getSecurityLevel()
Returns the security level for the row item

String getURL()
Returns the URL for the row item

boolean isChart()
Returns whether the row item is a chart

boolean isReport()
Returns whether the row item is a report

boolean isDashboard()
Returns whether the row item is a dashboard
                

Using the above methods, you can get the various file details.