Export to GitHub

full-hibernate-plugin-for-struts2 - 4_Hibernate_manager_WebTool.wiki


Introduction

This feature provides an WEB front-end tool for view, reload and test your Hibernate Core configurations.

Yout can provide this tool in your context in a public way or protect this by 2 ways: IPs/Hosts list or HTTP Autentication.

<hr/>

Usage

At first, install the plugin.

To access the Web Tool, use the url /your_context/hibernateManager/index.action

<hr/>

Screenshots

Main Page:
http://lh5.ggpht.com/_BudW2b3yOHU/SyfWdWjIJ0I/AAAAAAAAANo/dNL04xSBy78/s720/fhp_wtm01.PNG' />

<hr/>

Click in configuration(s) file(s):
http://lh5.ggpht.com/_BudW2b3yOHU/SyfWdebU1zI/AAAAAAAAANs/LSIqeSwx9og/s800/fhp_wtm02.PNG' />

<hr/>

After reload Hibernate Configurations:
http://lh5.ggpht.com/_BudW2b3yOHU/SyfWdQfgeLI/AAAAAAAAANw/5_zmKr5c_SE/s576/fhp_wtm03.PNG' />

<hr/>

Test JDBC Connection (2.1.1+):
http://lh5.ggpht.com/_BudW2b3yOHU/SyfWdo3vMiI/AAAAAAAAAN0/mclDVgABF9k/s576/fhp_wtm04.PNG' />

<hr/>

<hr/>

Security Configurations

IPs list

Configuration property: hibernatePlugin.manager.validIpsHosts
Comma-separated IP numbers or host names that can access the Hibernate Manager Web Tool. This property is Optional. Default 127.0.0.1 (the famous localhost);

Examples: 10.1.0.3, myhost, admim.mydomain, pc1.mydomain.com

HTTP Autentication Security

Configuration property: hibernatePlugin.manager.httpAuhtRoles
Comma-separated roles that can access the Hibernate Manager Web Tool. Example: manager, admin This property is Optional.

Public Access

Configuration property: hibernatePlugin.manager.publicAccessEnabled
If you want to allow public access to this tool, use the value true here. This property is Optional. Default false.

<hr/>

Optional Configurations

If you want to use a custom class as Hibernate Session Factory, you have to use some configuration in your struts.xml or struts.properties.

  • hibernatePlugin.customSessionFactoryClass: Full qualified name of the custom class used as a Hibernate Session Factory.
    This property is Optional. If not used, the Hibernate Plugin will use an internal Session Factory Class (com.googlecode.s2hibernate.struts2.plugin.util.HibernateSessionFactory).

<hr/>

  • hibernatePlugin.rebuildSessionFactoryMethod: Public method from the Hibernate Session Factory class for rebuild configurations.
    Optional, but Required if hibernatePlugin.customSessionFactoryClass property is used.

<hr/>

  • hibernatePlugin.staticRebuildSessionFactoryMethod: Set the access mode of the rebuild Session Factory method of the Session Factory class configured at hibernatePlugin.customSessionFactoryClass.
    If true the method if used in static mode (ie. MySessionFactoryClass.rebuildMySessionFactory()).
    If false the Hibernate Plugin will instantiate the Session Factory class.
    Optional, but Required if hibernatePlugin.customSessionFactoryClass property is used. Default true.

<hr/>