Struts-Menu使用指南-abin工作室-搜狐博客

Struts-Menu使用指南

一、介绍
Struts-menu是一个基于Struts框架的菜单生成应用框架，它是开源软件，可以从http://www.上获得。Struts-menu在没有权限控制时最简单，只需配置文件就可以生成需要的菜单；在要菜单权限控制时，可以和Tomcat（或其他J2EE容器）的认证机制结合实现权限控制，也可以利用后台数据库的方式实现权限控制。
       从获得Struts-menu后，将其解压，可以得到如下图1所示的一些文件：

其中struts-menu-2.3.jar为其核心包，struts-menu.tld为其对应的标签；struts-menu.war为Struts-menu自带的sample；doc目录下为帮助文档。
二、使用Struts-menu（无权限控制）
1.        将struts-menu.jar拷贝到WEB-INFlib目录下；
2.        将struts-menu.tld拷贝到WEB-INF目录下；
3.        将struts-menu.war中的scripts、styles、images目录拷贝到你的应用"/"目录下；
4.        此外，Struts-menu需要Log4j的支持，因此需要将log4j的包也拷贝到WEB-INF/lib；
5.        修改 web.xml 加入 taglib 的调用：
<taglib>
    <taglib-uri>/WEB-INF/struts-menu.tld</taglib-uri>
    <taglib-location>/WEB-INF/struts-menu.tld</taglib-location>
</taglib>
6.        修改struts-config.xml，在其中添加如下plugin代码：
<plug-in className="net.sf.navigator.menu.MenuPlugIn">
    <set-property property="menuConfig" value="/WEB-INF/menu-config.xml" />
</plug-in>
7.        配置menu-config.xml（此文件位于WEB-INF目录下）
<?xml version="1.0" encoding="UTF-8" ?>
<MenuConfig>
<Displayers>
<Displayer name="CoolMenu" type="net.sf.navigator.displayer.CoolMenuDisplayer"/>
<Displayer name="ListMenu" type="net.sf.navigator.displayer.ListMenuDisplayer"/>
<Displayer name="DropDown" type="net.sf.navigator.displayer.DropDownMenuDisplayer"/>
<Displayer name="Simple" type="net.sf.navigator.displayer.SimpleMenuDisplayer"/>
<Displayer name="CoolMenu4" type="net.sf.navigator.displayer.CoolMenuDisplayer4"/>
<Displayer name="MenuForm" type="net.sf.navigator.example.PermissionsFormMenuDisplayer"/>
<Displayer name="TabbedMenu" type="net.sf.navigator.displayer.TabbedMenuDisplayer"/>
<Displayer name="Velocity" type="net.sf.navigator.displayer.VelocityMenuDisplayer"/>
</Displayers>
<Menus>
 <!-- ====================   To Do List Menus   =========================== -->
  <Menu name="ToDoListMenuFile" title="OPERATOR" description="this is a file menu test" width="50" >
    <Item name="TDLnew" title="ADMIN">
      <Item name="TDLnewcase" title="GO TO ADMIN PAGE" image="images/case-new.png" location="/webModule/admin/admin.jsp"/>
      <Item name="TDLnewitem" title="NEW ITEM" image="images/item-new.png" location="index.jsp"/>
      <Item name="TDLnewparty" title="NEW PARTY" image="images/party-new.png" location="index.jsp"/>
        <Item name="TDLopen" title="OPEN">
     <Item name="TDLopencase" title="OPEN CASE" image="images/case-open.png" location="index.jsp"/>
      <Item name="TDLopenitem" title="OPEN ITEM" image="images/item-open.png" location="index.jsp"/>
      <Item name="TDLopenparty" title="OPEN PARTY" image="images/party-open.png" location="index.jsp"/>
    </Item>
    <Item name="TDLexit" title="EXIT" image="images/exit.png" location="index.jsp"/>
  </Menu>
<!-- ====================   To Do List Menu Edit   =========================== -->
  <Menu name="ToDoListMenuEdit" title="EDIT">
    <Item name="TDLselect" title="SELECT_ALL" image="images/select-all.png" location="index.jsp" width="100"/>
    <Item name="TDLprefs" title="USER_PREFERENCES" image="images/prefs.png" location="index.jsp" width="150"/>
  </Menu>
<!-- ====================   Permissions Menu   =========================== -->
  <Menu  name="Permissions" title="Permissions">
    <Item title="Change" location="permissionsForm.jsp?username=‘test‘" />
  </Menu>
</Menus>
</MenuConfig>
       注解：
Ø        <Displayers>与</Displayers>之间的代码定义了菜单的格式。
Ø        <Menus>与</Menus>之间的代码定义了要显示的菜单
Ø        <Menu>与<Menu>之间的代码具有定义一个菜单的各种属性，如：
<Menu name="ToDoListMenuFile" title="OPERATOR" description="this is a file menu test" width="50" >
      其中name指定了在JSP页面上显示此菜单时使用的name，title属性定义了菜单的显示名称，description属性定义了当鼠标移动到此菜单上时显示的描述信息，width属性定义了此菜单所占的宽度。
在<Menu>下的<Item/>标记用于定义此菜单的子项，如：
<Item title="Change" location="permissionsForm.jsp?username=‘test‘" />
其中title为子项显示的名称，location为当点击此项时所要执行的操作，如此处当点击“Change”菜单时，它将转向permissionsForm.jsp页面。
8.        在JSP页面中加入如下代码：
<menu:useMenuDisplayer name="ListMenu"　bundle="org.apache.struts.action.MESSAGE">
    <menu:displayMenu name="ToDoListMenuFile"/>
          <menu:displayMenu name="ToDoListMenuEdit"/>
    <menu:displayMenu name="Permissions"/>
</menu:useMenuDisplayer>
注解：
Ø        name属性指定要显示菜单的外观样式，由<Displayers></Displayers>中指定。
Ø        bundle为显示的菜单名称，必须为org.apache.struts.action.MESSAGE。
Ø        <menu:displayMenu />定义要显示的菜单，此处的name为要显示菜单的名称，由<Menu/>指定。
此外，对于各种不同的菜单外观，需要引用其指定的CSS及JavaScript代码。
       效果如下图所示：

三、基于Tomcat的权限控制的菜单显示
在Struts中要启用基于容器的安全认证：
1.        需要在web.xml中进行配置（请参考Struts相关书籍）：
<security-constraint>
    <web-resource-collection>
      <web-resource-name>AdminPages</web-resource-name>
      <description>Administroat only access</description>
      <url-pattern>/security.jsp</url-pattern>
      <http-method>POST</http-method>
      <http-method>GET</http-method>
    </web-resource-collection>
    <auth-constraint>
      <role-name>tomcat</role-name>
      <role-name>role1</role-name>
      <role-name>admin</role-name>
    </auth-constraint>
  </security-constraint>
  <login-config>
    <auth-method>BASIC</auth-method>
    <realm-name>adminRealm</realm-name>
  </login-config>
  <security-role>
    <description>Administrator</description>
    <role-name>tomcat</role-name>
  </security-role>
  <security-role>
    <description>A Second Role (to prove a comma-delimited list works)</description>

 

 

--------