Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The whole concept behind creating an ACE for Geronimo is that you are adding an extension in the form of portlets to the administrator console. In order to get your extenstion added, your deployable archive must do two things: You can package this however you like. Some options are as follows:

  1. Your portlets
  2. Your portlets + your related component
  3. Your portlets which declares a dependency on
  4. link to section declare a dependency on the "pluto-portal"
  5. link to section define an ACEGBean. Note
    titleWhat should be in my deployable archive (WAR or CAR)?
  6. A geronimo-web.xml file which:
    1. declares the dependency on the pluto-portal
    2. declares the ACEGBean
  7. (Optional)
  8. Your portlets
  9. Your portlets + your related component

Create a portlet

In their most fundamental state, an ACE defines where to place new/old portlets in your console. Portlets are the fundamental building block of the administrator console. We are using Pluto 2.x as our portal engine since it closely conforms to JSR 168 [link to JSR 168]. We will not go into the details of how to develop portlets since you can find many tutorials and tools that are much better at this. [many tutorial links here]. You will need the appropriate "web.xml" and "portlet.xml" files defined. As a simple example, refer to the [link to section] HelloWorldPortlet defined at the end of this section.

...

To add an ACEGBean to your deployable archive file, you need to include the following to your "geronimo-web.xml" deployment plan:

  1. Declare a dependency on the "pluto-portal"
    Code Block
    XML
    XML
    borderStylesolid
    <dependencies>
        ...
    <dependency>
        <groupId>org.apache.geronimo.portals</groupId>
        <artifactId>pluto-portal</artifactId>
    </dependency>
    </dependencies>
    
  2. declaration of Define an ACEGBean
    Code Block
    XML
    XML
    borderStylesolid
    <gbean name="example" class="org.apache.geronimo.pluto.ACEGBean">
        <attribute name="pageTitle">Testing</attribute>
        <attribute name="portletContext">/HelloWorldPortlet</attribute>
        <attribute name="portletList">[HelloWorldPortlet]</attribute>
    </gbean>
    
    where the attributes are defined as follows:

...