Custom MBean - Attribute Display Order & Documentation

Question

Hi All,
I've implemented custom security providers for one of our customers. All Providers are working very well. However I've problems about displaying attributes of my MBeans in WLS console. Attributes of my custom mbean definitions are displayed in console in unsorted manner. They're not sorted as I put them in mbean definition file and as I know there is also no display order attribute specified in "commo.dtd". I also checked [MBean Definition|http://download.oracle.com/docs/cd/E15523_01/web.1111/e13718/mdf_ref.htm#i1035144] . Is there a way to specify display order of managed bean attributes that placed in mbean definition file ?
My second question is about generating description to display WLS console. I first tried to use "Description" attribute of MBeanAttribute element. It didn't worked. So I checked out out-of-the-box security providers to how they've done this before. I created "-doc.xml" files that uses "commodoc.dtd" schema and my attribute element's "Description" attributes as "See ...-doc.xml" in mbean definition file. It also didn't worked. I need to find a way to put my descriptions in WLS console . Any help would be appreciated.
I'm including sample mbean definition, mbean documentation definition and my mbean generation ant comments. By the way I'm trying all this by using WLS 10.3.2 environment with Sun JDK 1.6.0.18.
Thanks in advance.
ANT TASK
<java classname="weblogic.management.commo.WebLogicMBeanMaker" fork="true"
failonerror="true" >
     <jvmarg line=" -DdoCheckDescription=true -Dfiles=${build_dir} -DMDFDIR=${build_dir} -DMJF=${build_dir}/${myproviderjar} -DtargetNameSpace=${namespace} -DcreateStubs=true -Dverbose=true"/>
</java>
MBEAN DEFINITION
<?xml version="1.0" encoding="windows-1252" ?>
<!DOCTYPE MBeanType SYSTEM "commo.dtd">
<MBeanType Name="SpnegoCredentialMapper" DisplayName="SpnegoCredentialMapper"
     Package="com.dflora.security.wls.cm.spnego" Extends="weblogic.management.security.credentials.CredentialMapper"
     PersistPolicy="OnUpdate" Description="See SpnegoCredentialMapper-doc.xml.">
     <!-- Standard values -->
     <MBeanAttribute Name="ProviderClassName" Type="java.lang.String"
          Writeable="false"
          Preprocessor="weblogic.management.configuration.LegalHelper.checkClassName(value)"
          Default="&quot;com.dflora.security.wls.cm.spnego.SpnegoCredentialMapperProviderImpl&quot;"
          Description="See SpnegoCredentialMapper-doc.xml." />
     <MBeanAttribute Name="Description" Type="java.lang.String"
          Writeable="false"
          Default="&quot; DFlora's Identity Assertion Provider for Spnego Tokens &quot;"
          Description="See SpnegoCredentialMapper-doc.xml." />
     <MBeanAttribute Name="Version" Type="java.lang.String"
          Writeable="false" Default="&quot;1.0&quot;" Description="See SpnegoCredentialMapper-doc.xml." />
     <!-- Extended Attributes -->
     <MBeanAttribute Name="Debug" Type="boolean" Writeable="true"
          Default="false" Description="See SpnegoCredentialMapper-doc.xml." />
     <MBeanAttribute Name="ForwardTicket" Type="boolean"
          Writeable="true" Default="true" Description="See SpnegoCredentialMapper-doc.xml." />
</MBeanType>
MBEAN-DOC
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE MBeanType SYSTEM "commodoc.dtd">
<?xml-stylesheet alternate="yes" href="commodoc.css" type="text/css"?>
<MBeanType Name="SpnegoCredentialMapper"
Package="com.dflora.security.wls.cm.spnego">
<Description>
<Lead>
<p>This MBean represents configuration information for the Spnego credential mapper.</p>
</Lead>
<Detail>
Deprecation of MBeanHome and Type-Safe Interfaces
<p>Additional description about mbean </p>
</Detail>
</Description>
<MBeanAttribute Name="Debug">
<Description>
<Lead>
<p>Enables Disables Debug</p>
</Lead>
<Detail>
<p>Detailed description of debug attribute.</p>
</Detail>
</Description>
</MBeanAttribute>
</MBeanType>

Answer 1

Yes the description attribute doesnt work anymore the way it used to work in prev versions.
On further research it was found that the Mbean required for generating description was missing.
A bug was filed with the engineering the engineering team. I am not sure what happend after that.
Let me try to find out.
If the mean while if any one of u guys have a support contract, you can go ahead and open a case with Oracle.
As for the order on display in the console, it shows in the order in which its defined in the MDF, m not sure why its behaving differently in your case.
-Faisal
http://www.weblogic-wonders.com/weblogic/